HOWTO: Initial Installation

Option A: Automated installer.

• Tested on Ubuntu 18.04, and CentOS 7.2:

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/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 - Build the docker image

cd cbtool/docker/; ./build_orchestrator.sh

STEP 2 - Run the orchestrator node as a Docker

cd cbtool; ./cbdocker

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

---