GWS Deployment with Docker

The page provides instructions on preparing and deploying GWS with Docker.

Prerequisites

OS: Any Enterprise Linux distro version 7 (RHEL-7, CentOS-7)
Docker
Docker Compose
Access to docker.io/libraryIs this the correct link? The link redirects to Docker home page. Should it point to https://hub.docker.com/
- If Internet access is not available, the following images should be manually loaded to docker:

Unpack the IP_HTCCDev_xxx_ENU_dockerlinux.zip file and navigate to the ip folder which should contain following files:
- gws-microservices.tgz
- exported microservices in tar.gz format (e.g. gws-platform-configuration_9.0.000.42.tar.gz)

Unpack the gws-microservices.tgz archive to /opt/genesys/gws directory.

tar xvf gws-microservices.tgz -C /opt/genesys/gws

Populate the Docker images (presented in *.tar.gz format) from installation package:
- ```
for i in *.tar.gz; do sudo docker load --input $i; done
```
Edit the following values in the /opt/genesys/gws/docker/common-env file:

Environment Variable	Value	Description
DOCKER_REPOSITORY		Should be empty if the GWS images are loaded manually.
REDIRECT_URIS	\"http://uri1\",\"http://uri2\"	A comma-separated array of resolvable hostnames or IP addresses of the Docker host machine. Important The array should use double quotes and the quotes should be escaped using backslashes. Teh array should not have any whitespace between items.
DOCKERHUB_MIRROR		Should be empty if the images of the Infrastructure components are loaded manually.
LOCATION	`/USW2`	The location of Configuration Server.
ENVIRONMENT_USERNAME	default	The username to connect to the Configuration Server.
ENVIRONMENT_APPNAME	Cloud	The application name to connect to the Configuration Server.
ENVIRONMENT_PASSWORD	password	The password to connect to the Configuration Server.
ENVIRONMENT_CONFIG_SERVER_PORT	8888	The port number of the primary Configuration Server.
ENVIRONMENT_CONFIG_SERVER_PRIMARY_ADDRESS	127.0.0.1	The IP address of the primary Configuration Server.
ENVIRONMENT_CONFIG_SERVER_TENANT	Environment	The Configuration Server's tenant name.
CONTACT_CENTER_DOMAIN_NAME	on_premise_lab	The domain associated with this contact center.

For proper docker-compose invocation creation of following symbolic links may needed:

ln -s /usr/local/bin/docker-compose docker-compose

sudo ln -s /usr/libexec/docker/docker-runc-current /usr/bin/docker-runc

For Elasticsearch default operating system limits on mmap counts is likely to be too low, which may result in out of memory exceptions. To mitigate:
```
sysctl -w vm.max_map_count=262144
```
Navigate to the /opt/genesys/gws/docker/wwe directory.
Source common-env file with environment variables:
```
. ../common-env
```
Invoke docker-compose:
```
docker-compose up -d
```
Wait until docker-compose is up and running. It may take up to 10 minutes.

Use the following links to get and verify that expected versions of the GWS services are correct:

Service	Verification URLs
Auth API	http://GWS_APPLICATIONS_IP/auth/v3/version
Config API	http://GWS_APPLICATIONS_IP/config/v3/version
Environment API	http://gws_applications_ip/auth/v3/version
Workspace API	http://GWS_APPLICATIONS_IP/workspace/v3/version
Workspace UI	http://GWS_APPLICATIONS_IP/ui/wwe/index.html