CloudCannon Documentation

Bootstrap your own private open source PaaS in seconds.

At the start, install OpenJDK8 and cassandra for which the following are needed.

Supported Platforms

Operating System Status
Ubuntu 14.04, 16.04, Debian 8.5 Well tested
CentOS 7.2 experimental, report issues

Ubuntu 14.04

OpenJDK8

$ sudo apt-add-repository -y ppa:openjdk-r/ppa

$ sudo apt-get -y update

$ sudo apt-get -y install openjdk-8-jdk

Ruby2.3

$ sudo apt-add-repository ppa:brightbox/ruby-ng

$ sudo apt-get -y update

$ sudo apt-get -y install ruby2.3 ruby2.3-dev

Ubuntu 16.04

$ sudo apt-get install openjdk-8-jre-headless

Debian Jessie

$ echo "deb http://http.debian.net/debian jessie-backports main" > /etc/apt/sources.list

$ sudo apt-get update

$ sudo apt-get install openjdk-8-jre-headless

$ sudo apt-get install openjdk-8-jdk

$ sudo /usr/sbin/update-java-alternatives -s java-1.8.0-openjdk-amd64

CentOS 7.2

$ wget --no-cookies --no-check-certificate --header "Cookie: gpw_e24=http%3A%2F%2Fwww.oracle.com%2F; oraclelicense=accept-securebackup-cookie" "http://download.oracle.com/otn-pub/java/jdk/8u45-b14/jdk-8u45-linux-x64.rpm"

$ rpm -ivh jdk-8u45-linux-x64.rpm

Cassandra 3.7

Install cassandra 3.7 by following the link for your operating system.

Operating System Link
Ubuntu 14.04/16.04/Debian 8.5 Ubuntu/Debian
CentOS 7.2 CentOS
Using tarball All Linux using tarball
Ubuntu 14.04

In case you find issues in installing cassandra 3.7 in Ubuntu 14.04, follow the instructions given below:


$ sudo echo "deb http://debian.datastax.com/datastax-ddc 3.7 main" | sudo tee -a /etc/apt/sources.list.d/cassandra.sources.list

$ sudo curl -L https://debian.datastax.com/debian/repo_key | sudo apt-key add -

$ sudo apt-get update

$ sudo apt-get install datastax-ddc

Enable access using private_ip

Open the file /etc/cassandra/cassandra.yaml in your favourite EDITOR.

Lets use nano


$ nano  /etc/cassandra/cassandra.yaml

  • Change listen_address to private_ip

  • Change rpc_address to private_ip

  • Change seeds to private_ip

Restart the cassandra (in all operating systems)


$ service cassandra restart


Install OpenSource VirtEngine

Ubuntu 14.04


  sudo apt-add-repository "deb [arch=amd64] http://get.virtengine.com/repo/1.5/ubuntu/14.04/stable trusty stable"

  sudo apt-key adv --keyserver keyserver.ubuntu.com --recv-keys 9B46B611

  sudo apt-get update

  sudo apt-get install virtenginenilavu virtenginegateway nsqd virtengine virtenginevnc

To start VirtEngine then


  sudo start nsqd

  sudo start nsqadmin

  sudo start nsqlookupd

  sudo start virtenginegateway

  sudo start virtenginevnc

  sudo start virtengine

  sudo sv start nginx

  sudo sv start unicorn

To stop VirtEngine then


  sudo stop nsqd

  sudo stop nsqadmin

  sudo stop nsqlookupd

  sudo stop virtenginegateway

  sudo stop virtenginevnc

  sudo stop virtengine

  sudo sv stop nginx

  sudo sv stop unicorn

Ubuntu 16.04/Debian Jessie


  sudo apt-add-repository "deb [arch=amd64] https://get.virtengine.com/repo/1.5/ubuntu/16.04/stable xenial stable"

  sudo apt-key adv --keyserver keyserver.ubuntu.com --recv-keys 9B46B611

  sudo apt-get update

  sudo apt-get install virtenginenilavu virtenginegateway nsqd virtengine virtenginevnc

To start VirtEngine


  sudo systemctl start nsqd

  sudo systemctl start nsqadmin

  sudo systemctl start nsqlookupd

  sudo systemctl start virtenginegateway

  sudo systemctl start virtenginevnc

  sudo systemctl start virtengine

  sudo sv start nginx

  sudo sv start unicorn

To stop VirtEngine


  sudo systemctl stop nsqd

  sudo systemctl stop nsqadmin

  sudo systemctl stop nsqlookupd

  sudo systemctl stop virtenginegateway

  sudo systemctl stop virtenginevnc

  sudo systemctl stop virtengine

  sudo sv stop nginx

  sudo sv stop unicorn

CentOS 7.2 experimental

At the start, install Ruby2.3 and Runit for VerticeNilavu.

Ruby2.3

$ wget https://github.com/feedforce/ruby-rpm/releases/download/2.3.1/ruby-2.3.1-1.el7.centos.x86_64.rpm

$ sudo yum install -y libyaml

$ sudo rpm -ivh ruby-2.3.1-1.el7.centos.x86_64.rpm

Runit

$ curl -s https://packagecloud.io/install/repositories/imeyer/runit/script.rpm.sh | sudo bash

$ sudo yum install -y runit-2.1.1-7.el7.centos.x86_64


  cat << EOT > /etc/yum.repos.d/virtengine.repo
[virtengine]
name=virtengine
baseurl=https://get.virtengine.com/repo/1.5/centos/7.2/stable
enabled=1
gpgcheck=0
EOT

  sudo yum update

  sudo yum install virtenginenilavu virtenginegateway nsqd virtengine virtenginevnc

To start VirtEngine


  sudo systemctl start nsqd

  sudo systemctl start nsqadmin

  sudo systemctl start nsqlookupd

  sudo systemctl start virtenginegateway

  sudo systemctl start virtenginevnc

  sudo systemctl start virtengine

  if sv service does not start to run the following command

  runsvdir /var/service &

  then do this

  sudo sv start nginx

  sudo sv start unicorn

To stop VirtEngine


  sudo systemctl stop nsqd

  sudo systemctl stop nsqadmin

  sudo systemctl stop nsqlookupd

  sudo systemctl stop virtenginegateway

  sudo systemctl stop virtenginevnc

  sudo systemctl stop virtengine

  sudo sv stop nginx

  sudo sv stop unicorn

Docker Images

Here you may be in a position to use Habitat - Docker images. Your choice is open to contribute habitat packages by intimating your interest to the forum.