HOWTO: Initial Installation

Option A: Automated installer.

• Tested on Ubuntu 16.04, Ubuntu 14.04, RHEL 7.1 and CentOS 7.1:

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 cb_orchestrator .

STEP 2 - Run the orchestrator node as a Docker

docker run -it --privileged=true --cap-add=SYS_PTRACE --name cbo 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 at least a dedicated node for all 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)

---