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

---

Option B: Docker.

STEP 1 - Just download the helper script cbdocker

cd ~; wget https://raw.githubusercontent.com/ibmcb/cbtool/experimental/cbdocker; chmod +x ./cbdocker

STEP 2 - Quickly try out the helper script by starting the Orchestrator in "debug mode".

The container (automatically named <YOUR USERNAME>_cbon) will be started directly in interactive mode (i.e., docker CLI parameter -i/--interactive), displaying the CBTOOL CLI. Whenever you exit the CLI, the container will be killed.

./cbdocker -d --soft_reset

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

---