Solution Prerequisites

The following are the solution setup prerequisites.

...

Software Requirements

OS Compatibility

We require the customer/partner to install the following software on the server.

...

Browser Compatibility

...

1. Download the deployment script supervisor-tools-deployment.sh. This script will:
   1. delete the supervisor-tools-deployment directory in the present working directory if it exists.
   2. clone the supervisor-tools-deployment repository from GitLab in the present working directory.

2. To execute the script, give it the execute permissions and execute it. 

   # chmod +x supervisor-tools-deployment.sh # ./supervisor-tools-deployment.sh

   
   

3. If the customer is not willing to put database password in environment variables file then follow these steps to configure Vault that will hold database password

4. Update environment variables  in the following files inside /supervisor-tools-deployment/docker/environment_variables folder.

   1. Update/wiki/spaces/UMM/pages/655652 in the umm-environment-variables.env file.

   2. Update Supervisor Tools Environment variables in the environment-variables.env. See also, (13.4) Caller Lists Environment Variables to specify variables of the Caller Lists microservice.

5. Get domain/CA signed SSL certificates for SupervisorTools FQDN/CN and place the files in /root/supervisor-tools-deployment/docker/certificates folder. The file names should be server.crt and server.key.

6. Copy the supervisor-tools-deployment directory to the second machine for HA. Execute below command 

   # scp -r supervisor-tools-deployment root@machine-ip:~/

   
   

7. Go to the second machine and update the environment variables where necessary.

8. Execute the following commands inside /root/supervisor-tools-deployment directory on both machines.

   # chmod 755 install.sh # ./install.sh

   
   

9. Run the following command to ensure that all the components are up and running. The screenshot below shows a sample response for a standalone non-HA deployment. 

   # docker ps

   
   

...

Repeat the following steps for all the machines in the HA cluster.

1. Download keepalived.sh script and place it in /root the directory.

2. Give execute permission and execute the script: 

   # chmod +x keepalived.sh # ./keepalived.sh

   
   

3. Configure keep.env file inside /root/keep-alived folder

   Name	Description
   KEEPALIVED_UNICAST_PEERS	Pear machine IP. 192.168.1.80
   KEEPALIVED_VIRTUAL_IPS	Virtual IP of the cluster. It should be available in the LAN. For example: 192.168.1.245
   KEEPALIVED_PRIORITY	Priority of the node. Instance with lower number will have a higher priority. It can take any value from 1-255.
   KEEPALIVED_INTERFACE	Name of the network interface with which your machine is connected to the network. On CentOS, ifconfig or ip addr sh will show all the network interfaces and assigned addresses.
   CLEARANCE_TIMEOUT	Corresponds to the initial startup time of the application in seconds which is being monitored by keepalived. A nominal value of 60-120 is good enough
   KEEPALIVED_ROUTER_ID	Do not change this value.
   SCRIPT_VAR	This script is continuously polled after 2 seconds. Keepalived relinquishes control if this shell script returns a non-zero response. It could be either umm or any backend microservice API. pidof dockerd && wget -O index.html http://localhost:7575/

   
   

4.  Update the SERVER_URL variable in environment variables to hold Virtual IP for front-end. Go to microservices table in UMM database, replace the name of tam, prompts and eabc microservices under ip_address column with Virtual IP. Change the ports to corresponding ports exposed in docker-compose file.

5. Give the execute permission and execute the script on both machine.

   
   

   # chmod +x keep-command.sh # ./keep-command.sh

   
   

Adding License

1. Browse to httpto http://<MACHINE_IP or FQDN>FQDN>/umm in umm in your browser (FQDN will be the domain name assigned to the IP/VIP). 
2. Click on the red warning icon on right, paste the license in the field and click save.