Installing TrueSight Orchestration in containers

Where you are in the installation process

The procedure in this section describes the steps to install TrueSight Orchestration component images on multiple hosts or nodes in a Docker Swarm. BMC recommends installing components on separate hosts for your production environments. 

You must install the container images in this order: 

1. Database (includes all content such as application adapters, base adapters, Operations Actions Management Modules, and runbooks)
2. Repository
3. Configuration Distribution Peer (CDP)

This topic describes the steps to install images on a three-node cluster.

To install the database image on the first node

1. Open a terminal and SSH into a host where you want to install the database image (includes content) and extract the DOCKER_TSO_INSTALLER.tgz installer zip file. 

   tar -xvf DOCKER_TSO_INSTALLER.tgz

2. Go to the DOCKER_TSO_INSTALLER folder and run the setup.sh script using this command:

   # ./setup.sh

   The installation process verifies whether Docker Engine is installed on the host and the Docker Daemon service is running. It also verifies whether this host is a part of a swarm.

3. To obtain images for installation, specify the host name and port where the Docker Registry is created in the following format:
   <hostname>:<port>
   The script verifies whether the Docker Registry is running and the component installation options are displayed. 

4. To install the database, type 1. 
   Database image is pulled from the registry and the script deploys the tso_content_db image on the host.

   Note

   The tso_content_db image consists of the Apache Derby database and TrueSight Orchestration Content.

5.  To verify whether the database and content image is successfully deployed, run the following command: 

   # docker stack ps tso_stack

   Details such as the host or node name, image name, and whether the service is running are displayed. 

   You can now install the repository on the second node. 

To install the repository on a second node

Before installing the repository image, you must ensure that the database image is running and the status is displayed as healthy. 

1. On a new node in the swarm, extract the installation files from the DOCKER_TSO_INSTALLER.tgz zip folder:

   # tar -xvf DOCKER_TSO_INSTALLER.tgz

2. Go to the DOCKER_TSO_INSTALLER folder and run the setup.sh script using this command:

   # ./setup.sh

   The installation process verifies whether Docker Engine is installed on the host and the Docker Daemon service is running. It also verifies whether this host is a part of a swarm.

3. To obtain images for installation, specify the host name and port where the Docker Registry is created in the following format:
   <hostname>:<port>
   The script verifies whether the Docker Registry is running and the component installation options are displayed. 

4. To install the repository, type 2.
   You are asked to verify whether the content database is installed and running. 

5. To continue with the installation, type Y.
   Repository image is pulled from the registry and the script deploys the tso_repo image on the host. 

6. To verify whether the repository image is successfully deployed, run the following command:

   # docker stack ps tso_stack

   Information about the database and the repository image is displayed.

7. To verify whether the repository is running, log on to the Repository Manager application by using these credentials.

   Note

   Default URL and user credentials for the repository:

   • URL: http(s)://FullyQualifiedDomainName:repoWebServerPort/ux
   • Username:aoadmin
   • Password: admin123

   You can now continue to install the CDP on the third node. 

To install the CDP image on a third node

Before installing the CDP, ensure that the repository is up and running. 

1. On a new node in the swarm, extract the installation files from the DOCKER_TSO_INSTALLER.tgz zip folder:

   # tar -xvf DOCKER_TSO_INSTALLER.tgz

2. Go to the DOCKER_TSO_INSTALLER folder and run the setup.sh script using this command:

   # ./setup.sh

   The installation process verifies whether Docker Engine is installed on the host and the Docker Daemon service is running. It also verifies whether this host is a part of a swarm.

3. To obtain images for installation, specify the host name and port where the Docker Registry is available in the following format:
   <hostname>:<port>
   The script verifies whether the Docker Registry is running and the component installation options are displayed. 
4. To install the CDP, type 3.
   You are asked to verify whether the repository is up and running. 
5. To continue with the installation, type Y.
   CDP image is pulled from the registry and the script deploys the tso_cdp image on the host. 

6. To verify whether the CDP image is successfully deployed, run the following command:

   # docker stack ps tso_stack

7. To verify whether the CDP is running, log on to the Grid Manager application by using these credentials. 

   Note

   Default URL and credentials for the CDP:

   URL: http(s)://fullyQualifiedDomainName:webServerPort/baocdp

   Username: aoadmin

   Password: admin123

Troubleshooting installation issues

If you face issues while installing TrueSight Orchestration on Docker Containers, see Troubleshooting containers.

Next step in the installation process

Now that you have successfully installed containerized platform, you can continue with installing other components such as the Development Studio and LAP outside the containers. For instructions, see Installing Development Studio for TrueSight Orchestration in containers.