HOWTO: Initial Installation

Option A: Automated installer.

• Tested on Ubuntu 12.04, Ubuntu 14.04, RHEL 6.4, RHEL 6.5 and CentOS 6.5:

STEP 1 - Clone the git repository (any user other than root):

git clone https://github.com/ibmcb/cbtool.git

STEP 2 - Run the CBTOOL's automated installer and just follow the instructions there:

~/cbtool/install -r orchestrator

After the install is executed successfully (i.e., the message All dependencies are in place is displayed).

NEXT STEP: Proceed to the section [Run the tool for the first time] (https://github.com/ibmcb/cbtool/wiki/HOWTO:-Running-the-tool-for-the-first-time)

Option B: Docker.

STEP 1 - Build the docker image

cd cbtool/docker/orchestrator/; docker build .

STEP 2 - Run the orchestrator node as a Docker

```docker run -it --privileged=true cb_orchestrator````

NOTE: This is a self-contained "fat" docker, running copies of all CBTOOL stores processes (e.g., Redis and MongoDB). While this can be used for small-scale experiments (few hundreds of VMs), larger ones (e.g., tens of thousands of VMs) might require dedicated nodes just for the stores, given the resource requirements.

NEXT STEP: Proceed to the section [Run the tool for the first time] (https://github.com/ibmcb/cbtool/wiki/HOWTO:-Running-the-tool-for-the-first-time)

Option C: Manual installation

• Before starting, make sure that some specific packages are installed

Here the steps to install the tool are shown. These were extracted from an actual installation done on an Ubuntu VM on Amazon EC2. Please make sure that you execute all the steps:

STEP 0 - Before starting, make sure that some specific packages are installed

RHEL

• It is a good idea add the EPEL repository (e.g., sudo rpm -Uvh http://download.fedoraproject.org/pub/epel/6/i386/epel-release-6-8.noarch.rpm) as an additional source of packages
• sudo yum install git make gcc python-setuptools python-devel python-daemon python-pip python-twisted-web python-webob python-beaker nc screen ganglia-gmond R ganglia-gmond-python libvirt-python net-snmp-python ntp

Ubuntu

• sudo apt-get install git make gcc python-setuptools python-dev python-daemon python-pip python-twisted-web python-webob python-beaker netcat-openbsd screen ganglia-monitor r-base-core python-libvirt libsnmp-python ntp

Common (both Ubuntu and RHEL)

• sudo pip install setuptools-git pbr requests
• sudo pip install redis pymongo boto setuptools-git python-novaclient apache-libcloud pypureomapi

Please make sure that the user that you selected can perform passwordless sudo (if not please edit the sudoers file) and make sure that the line that says #Defaults requiretty on the sudoers file is commented out.

STEP 1 - Clone the git repository:

STEP 2 - Run the CBTOOL's "configure" utility:

STEP 3: Install the dependencies:

ubuntu@ip-10-245-25-28:~$ cd /home/ubuntu/cbtool//3rd_party; git clone https://github.com/ibmcb/bootstrap.git; cd ~

ubuntu@ip-10-245-25-28:~/cbtool$ cd /home/ubuntu/cbtool//3rd_party; git clone https://github.com/ibmcb/d3.git; cd ~

ubuntu@ip-10-245-25-28:~$ cd /home/ubuntu/cbtool//3rd_party; wget http://fastdl.mongodb.org/linux/mongodb-linux-x86_64-2.2.2.tgz; tar -zxf mongodb-linux-.tgz; cd mongodb-linux-; sudo cp bin/* /usr/bin; cd ~

.......

ubuntu@ip-10-245-25-28:~$ cd /home/ubuntu/cbtool//3rd_party; git clone https://github.com/ibmcb/Bootstrap-Wizard.git; cd ~

STEP 4 - Run "configure" again, to ensure that all dependencies are installed:

STEP 5 - Create a personal copy of the configuration file to be used on experiments:

cp ~/cbtool/configs/cloud_definitions.txt ~/cbtool/configs/${LOGNAME}_cloud_definitions.txt

NEXT STEP: Proceed to the section [Run the tool for the first time] (https://github.com/ibmcb/cbtool/wiki/HOWTO:-Running-the-tool-for-the-first-time)