Installing TrueSight Orchestration in containers in the high-availability mode

Where you are in the installation process

In a classic mode, a secondary CDP (High Availability CDP) can be installed that provides failover capabilities. In container mode, you need not install a secondary CDP as basic failover situations (such as services down or Docker Engine down) are handled by Docker Swarm. In addition to the swarm mode, for data persistence, you configure Network File System (NFS), which is a client-server based application that enables a shared file system over a network. You can use NFS with multi-node containerized platform environment, where the repository and CDP are on separate nodes. 

You need to perform the following tasks to install and configure the CDP for high-availability and scalability.

Step A: Set up an NFS server outside the swarm

NFS server must reside on a separate server (physical or virtual) outside the swarm.

1. Open a terminal and SSH into the machine where you want to set up the NFS server. 

2. Go to the location where you have downloaded the installation files and extract the files from the DOCKER_TSO_INSTALLER.tgz zip folder:

   # tar -xvf DOCKER_TSO_INSTALLER.tgz

3. Go to the DOCKER_TSO_INSTALLER/files/NFS folder and run the NFS-server-setup.sh script.

   # ./NFS-server-setup.sh

    

4. Specify the host name that you want to designate as an NFS client.
   Do this for each NFS client. The current server is now set up as an NFS server.

Step B: Set up NFS clients on hosts in the swarm

You can choose to add a node in the swarm and designate it for CDP failover, or, you can use any other node apart from the CDP node (where the repository or the database is installed) for failover situations. Nodes that are designated to be used for failover, must have the CDP images available on the node.

1. Open a terminal and SSH into the machine where you want to set up the NFS client.
   Ensure that the host is a part of the swarm and you deploy the CDP image on this host later. 

2. Go to the location where you have downloaded the installation files and extract the files from the DOCKER_TSO_INSTALLER.tgz zip folder:

   # tar -xvf DOCKER_TSO_INSTALLER.tgz

3. Go to the DOCKER_TSO_INSTALLER/files/NFS folder and run the NFS-client-setup.sh script.

   # ./NFS-client-setup.sh
4. Specify the NFS server hostname. 
   CDP image is pulled, all required plugins are deployed, CDP volumes are mounted, and the current host is now set up as an NFS client. 
5. Perform Step 1 to Step 4 on all the nodes that you want to designate as NFS clients. 

Step C: Install the CDP on a client 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 the CDP, do one of the following steps:

• (Optional) Configure an external database. For instructions, see Configuring-the-repository-to-use-an-external-database-for-HA. 
• Install other components such as the Development Studio and LAP outside the containers. For instructions, see Installing Development Studio for TrueSight Orchestration in containers.