Installation Files Location

Place all build files provided with the release in /root on all machines where the application’s being deployed.

System Access Requirements

Administrative privileges (root) are required to follow the deployment steps.

Installation

Loading all images

Load the images in docker engine on all the machines running following commands (execute each command separately, the command starts after $ sign) :

$ docker load < ecm.tar

$ docker load < umm.tar

$ docker load < ecm-services.tar

$ docker load < ecm-frontend.tar

Configuration

Application Configurations

Create new databases in the MSSQL server with any names corresponding to umm and ecm and edit the corresponding settings in “docker-compose.yml” file for configuration. Details have been written in the comments.
Update the DB name required urls and cisco related (IP, Username and Password) configuration in the “ecm_variables.env” file. DB configurations for umm can be updated directly in “docker-compose.yml”.

HTTPS Configuration

Replace the content of “https” folder h any https certificate and key. The names of the certificate and the key should be “server.crt” and “server.key” respectively.

Execution

Start the compose service on all machines (in case of HA, there’d be multiple machines) using the following command:

$ docker-compose up -d

For fetching UCCX campaigns on interface

Once the application settings are defined from the web interface. Remove the container ecm backend using command $ docker container rm -f <container_id> , once the container is removed, now again run the command $ docker-compose up -d go to the campaigns menu and verify that cisco campaigns are appearing in dropdown menu.

Log Rotation

Add following lines in /etc/docker/daemon.json file and restart the docker daemon using systemctl. Restart docker on all machines.

{ 
	"log-driver": "json-file", 

	"log-opts": 
		{
			"max-size": "20m", # Max size of the log files. 

			"max-file": "3" # The maximum number of log files.
		} 
}

{ "log-driver": "json-file",

"log-opts": {

"max-size": "20m", # Max size of the log files.

"max-file": "3" # The maximum number of log files.

}

Troubleshooting

Logs for each container are available in files as well as within docker daemon. To see the logs for any container, execute docker ps and get the id of the container. Use that id to see the logs using docker logs <container_id>. At any given time, the active machine would be the one with highest keepalived priority, so the logs would be stored there.

Deployment Guide