Skip to content

HOWTO: Initial Installation

ibmcb edited this page Feb 29, 2016 · 63 revisions

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 [Runnning 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 -t orchestrator .

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. You might be willing to consider a dedicate node just for the CBTOOL stores, as explained here

NEXT STEP: Proceed to the section [Runnning 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:

git clone

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

first configure run

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:

run configure final

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 [Runnning the tool for the first time] (https://github.com/ibmcb/cbtool/wiki/HOWTO:-Running-the-tool-for-the-first-time)

Clone this wiki locally