Jump to: navigation, search
(Ready to publish for 9.0.000.80 release on Dec 21, 2020)
 
(79 intermediate revisions by 5 users not shown)
Line 1: Line 1:
−
= GWS Deployment with Docker =
+
= Deploying Web Services and Applications in Docker Compose =
  
−
The page provides instructions on preparing and deploying GWS with Docker. 
+
This page provides instructions on preparing and deploying Web Services and Applications with Docker.
 +
{{NoteFormat|
 +
* To support Gplus Adapter for Salesforce, Docker Compose must be deployed with HTTPS.
 +
* To upgrade Web Services and Applications, you must install the new version of Web Services Docker Compose.}}
  
 
== Prerequisites ==
 
== Prerequisites ==
−
=== System Requirements ===
+
For hardware, software, Workspace Web Edition, and Gplus Adapter for Salesforce requirements, refer to [[Prerequisites|Prerequisites]].
 +
Also, ensure your environment has access to [http://docker.io/library docker.io/library].
 +
If internet access is not available, manually load the following public container images to the Docker registry:
 +
* {{#Widget:ExtLink|link=https://hub.docker.com/_/elasticsearch|displaytext=Elasticsearch 7.8}}
 +
* {{#Widget:ExtLink|link=https://hub.docker.com/_/postgres|displaytext=Postgres 11}}
 +
* {{#Widget:ExtLink|link=https://hub.docker.com/_/redis|displaytext=Redis 5}}
 +
* {{#Widget:ExtLink|link=https://hub.docker.com/_/centos|displaytext=CentOS latest}}
  
−
* OS: Any Enterprise Linux distro version 7 (RHEL-7, CentOS-7)
+
==Configuring Web Services and Applications==
−
* {{#Widget:ExtLink|link=https://docs.docker.com/install|displaytext=Docker}}
+
To configure Web Services and Applications, refer to [[Documentation:HTCC:Dep:ConfigurationPremise|Configuring Web Services and Applications]].
−
* {{#Widget:ExtLink|link=https://docs.docker.com/compose/install|displaytext=Docker Compose}}
 
−
* Access to [http://docker.io/library docker.io/library]{{Editgrn_open}}Is this the correct link? The link redirects to Docker home page. Should it point to https://hub.docker.com/{{Editgrn_close}} 
 
−
** If Internet access is not available, the following images should be manually loaded to docker:
 
−
*** {{#Widget:ExtLink|link=https://hub.docker.com/_/centos|displaytext=centos:latest}}
 
−
*** {{#Widget:ExtLink|link=https://hub.docker.com/_/elasticsearch|displaytext=elasticsearch:6.6.2}}
 
−
*** {{#Widget:ExtLink|link=https://hub.docker.com/_/postgres|displaytext=postgres:9.5.12-alpine}}
 
−
*** {{#Widget:ExtLink|link=https://hub.docker.com/_/redis|displaytext=redis:4}}
 
  
 +
==Deploying Web Services and Applications==
  
−
 
+
# Unpack the installation package file (e.g. '''IP_HTCCDev_9000207b1_ENU_dockerlinux.zip''') , and navigate to the '''ip''' folder which should contain the following files:
−
==== RAM Requirements ===
+
#* '''gws-microservices.tgz'''
−
 
+
#* exported microservices in tar.gz format (e.g. '''gws-platform-configuration_9.0.000.50.tar.gz''')
−
* Minimum 16 GB of RAM
+
# Unpack the '''gws-microservices.tgz''' archive to the '''/opt/genesys/gws''' directory. <br />
−
 
+
#*<pre>mkdir -p /opt/genesys/gws </pre>
−
Implementation Steps
+
#*<pre>tar xvf gws-microservices.tgz -C /opt/genesys/gws</pre>
−
 
+
# Populate the Docker images (presented in *.tar.gz format) from the installation package: <br />
−
1) Unpack IP_HTCCDev_xxx_ENU_dockerlinux.zip file and navigate to &quot;ip&quot; folder which should contain following files:
+
#*<pre>for i in *.tar.gz; do sudo docker load --input $i; done</pre>
−
 
+
#:{{NoteFormat|This command must be run with Docker-capable privileges.}}
−
* gws-microservices.tgz
+
# Edit the following values in the '''/opt/genesys/gws/kubernetes/parameters.yaml''' file:
−
* exported microservices in tar.gz format (e.g. gws-platform-configuration_9.0.000.42.tar.gz)
 
−
 
 
−
2) Unpack gws-microservices.tgz archive to '''/opt/genesys/gws''' directory.
 
−
 
 
−
mkdir -p /opt/genesys/gws
 
−
 
 
−
tar xvf gws-microservices.tgz -C /opt/genesys/gws
 
−
 
 
−
3) Populate the Docker images (presented in *.tar.gz format) from installation package: 
 
−
 
 
−
for i in *.tar.gz; do sudo docker load --input $i; done
 
−
 
 
−
4) Edit the following values in the '''/opt/genesys/gws/docker/common-env''' file:
 
  
 
{|
 
{|
Line 48: Line 38:
 
| DOCKER_REPOSITORY
 
| DOCKER_REPOSITORY
 
|
 
|
−
| Should be empty in case GWS images are loaded manually.
+
| Should be empty if the Web Services and Applications images are loaded manually.
 
|-
 
|-
 
| REDIRECT_URIS
 
| REDIRECT_URIS
−
| \&quot;http://uri1\&quot;,\&quot;http://uri2\&quot;
+
| <nowiki>\&quot;http://uri1\&quot;,\&quot;http://uri2\&quot;</nowiki>
 
|
 
|
−
Specifies an array by using double quotes and comma to separate values with no whitespace between.
+
A comma-separated array of resolvable host names or IP addresses of the Docker host machine. Used as a part of the OAuth authentication flow.
 +
{{NoteFormat| To access the lab deployment, it is mandatory to set resolvable host names or IP addresses for the Docker host machine.  
  
−
It is mandatory to set resolvable hostname or ip address of docker host machine. Please note that quotes should be escaped with backslash.
+
The array should use double quotes and the quotes should be escaped using backslashes. The array should not have any white space between items.
 +
}}
 
|-
 
|-
 
| DOCKERHUB_MIRROR
 
| DOCKERHUB_MIRROR
 
|
 
|
−
| Should be empty in case Infrastructure components images are loaded manually.
+
| Should be empty if the images of the Infrastructure components are loaded manually.
 
|-
 
|-
 
| LOCATION
 
| LOCATION
−
| /USW2
+
| <tt>/USW2</tt>
−
| Location of Configuration Server
+
| The location of Configuration Server.
 +
{{NoteFormat|The Web Services and Applications cluster application object (typically names ''CloudCluster'') in the Configuration Database must be configured with a specified location for each connection to Genesys servers like Configuration Server, Stat Server, T-Server, and so on. This setting defines which server instance is visible by the Web Services and Applications node based on its position in the Web Services and Applications Cluster. }}
 +
|-
 +
| GWS_HTTPS_ENABLE
 +
| false
 +
| The option to enable https support for deployment.
 +
|-
 +
| GWS_HTTPS_SERVER_CERTIFICATE
 +
| server.crt
 +
| The path to server certificate, which will be used during the SSL handshake with clients.
 +
|-
 +
| GWS_HTTPS_SERVER_CERT_KEY
 +
| server.key
 +
| The path to server key, which will be used during the SSL handshake with clients.
 
|-
 
|-
 
| ENVIRONMENT_USERNAME
 
| ENVIRONMENT_USERNAME
 
| default
 
| default
−
| Username to connect to Configuration Server
+
| The username to connect to Configuration Server.
 
|-
 
|-
 
| ENVIRONMENT_APPNAME
 
| ENVIRONMENT_APPNAME
−
| Cloud
+
| GWS_App
−
| Application name to connect to Configuration Server
+
| The application name to connect to Configuration Server. For details, refer to [[ConfigurationPremise#gaxgwsclient| Creating GWS Client Application]].
 
|-
 
|-
 
| ENVIRONMENT_PASSWORD
 
| ENVIRONMENT_PASSWORD
 
| password
 
| password
−
| Password to connect to Configuration Server
+
| The password to connect to Configuration Server.
 
|-
 
|-
 
| ENVIRONMENT_CONFIG_SERVER_PORT
 
| ENVIRONMENT_CONFIG_SERVER_PORT
 
| 8888
 
| 8888
−
| Port of primary Configuration Server
+
| The port number of the primary Configuration Server.
 
|-
 
|-
 
| ENVIRONMENT_CONFIG_SERVER_PRIMARY_ADDRESS
 
| ENVIRONMENT_CONFIG_SERVER_PRIMARY_ADDRESS
 
| 127.0.0.1
 
| 127.0.0.1
−
| Address of primary Configuration Server
+
| The IP address of the primary Configuration Server.
 
|-
 
|-
 
| ENVIRONMENT_CONFIG_SERVER_TENANT
 
| ENVIRONMENT_CONFIG_SERVER_TENANT
 
| Environment
 
| Environment
−
| Configuration Server's tenant name
+
| The Configuration Server's tenant name.
 
|-
 
|-
 
| CONTACT_CENTER_DOMAIN_NAME
 
| CONTACT_CENTER_DOMAIN_NAME
−
| on_premise_lab
+
| <nowiki>onpremiselab.com</nowiki>
−
| Domain associated with this contact center
+
| The domain associated with this contact center. {{NoteFormat|While logging on to WWE, use the domain name as the tenant name.}}
 
|}
 
|}
  
−
5) For proper docker-compose invocation creation of following symbolic links may needed:
+
<ol start="5">
−
 
+
<li>For Elasticsearch, the default operating system limits on '''mmap''' counts is likely to be too low, which may result in out-of-memory exceptions. To mitigate it temporarily, run the following:
−
ln -s /usr/local/bin/docker-compose docker-compose
+
<pre>sudo sysctl -w vm.max_map_count=262144</pre>
−
 
 
−
sudo ln -s /usr/libexec/docker/docker-runc-current /usr/bin/docker-runc
 
−
 
 
−
6) 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
 
−
 
 
−
7) Navigate to the '''/opt/genesys/gws/docker/wwe''' directory.
 
−
 
 
−
8) Source common-env file with environment variables:
 
−
 
 
−
. ../common-env
 
−
 
 
−
9) Invoke docker-compose: 
 
−
 
 
−
docker-compose up -d
 
−
 
 
−
10) Wait until docker-compose is up and running. It may take up to 10 minutes.
 
  
−
Verification
+
To set this value permanently, update the '''vm.max_map_count''' setting in '''/etc/sysctl.conf'''. To verify after restarting, follow these steps:
 +
<pre>sudo sysctl vm.max_map_count</pre>
 +
</li>
 +
<li> Navigate to the '''/opt/genesys/gws/docker/wwe''' directory.</li>
 +
<li>Source the '''common-env''' file with environment variables:
 +
<pre>. ../common-env</pre>
 +
<li>Invoke<tt> docker-compose</tt>: 
 +
<pre>docker-compose up -d</pre>
 +
<li>Wait until <tt>docker-compose</tt> is up and running. It may take up to 10 minutes.</li>
  
−
Use the following links to get and verify that expected versions of the GWS services are correct:
+
==Verifying Web Services and Applications==
  
 +
Use the following links to get the expected versions of the Web Services and Applications components and verify they are correct:
 
{|
 
{|
 
! '''Service'''
 
! '''Service'''
−
!
 
 
! '''Verification URLs'''
 
! '''Verification URLs'''
 
|-
 
|-
−
| Auth API
+
| Authentication Service
−
|
+
| <nowiki>http://GWS_APPLICATIONS_IP:8080/auth/v3/version</nowiki>
−
| [http://gws_applications_ip/auth/v3/version http://GWS_APPLICATIONS_IP/auth/v3/version]
 
 
|-
 
|-
−
| Config API
+
| Configuration Service
−
|
+
| <nowiki>http://GWS_APPLICATIONS_IP:8080/configuration/v3/version</nowiki>
−
| [http://gws_applications_ip/auth/v3/version http://GWS_APPLICATIONS_IP/config/v3/version]
 
 
|-
 
|-
−
| Environment API
+
| Environment Service
−
|
+
| <nowiki>http://GWS_APPLICATIONS_IP:8080/environment/v3/version</nowiki>
−
| [http://gws_applications_ip/auth/v3/version http://GWS_APPLICATIONS_IP/environment/v3/versio]n
 
 
|-
 
|-
−
| Workspace API
+
| Data Collector Service
−
|
+
| <nowiki>http://GWS_APPLICATIONS_IP:8080/datacollector/v3/version</nowiki>
−
| [http://gws_applications_ip/workspace/v3/version http://GWS_APPLICATIONS_IP/workspace/v3/version]
 
 
|-
 
|-
−
| Workspace UI
+
| Workspace Web Edition
−
|
+
| <nowiki>http://GWS_APPLICATIONS_IP:8080/ui/wwe/index.html</nowiki>
−
| [http://gws_applications_ip/ui/wwe/index.html http://GWS_APPLICATIONS_IP/ui/wwe/index.html]
 
 
|}
 
|}
  
−
 
+
If the '''GWS_HTTPS_ENABLE''' option is set to <tt>true</tt>, HTTPS endpoints can be used for verification too:
−
---
 
−
 
 
−
= Deploying GWS in Test Labs =
 
−
 
 
−
=== Hardware Requirements ===
 
−
* Single node of 64 GB of RAM for a full WWE service set.
 
−
* At least 4 CPU cores are required.
 
−
* HDD 200 GB
 
−
 
 
−
=== Software Requirements ===
 
−
* Any Enterprise Linux version 7 (CentOS, RHEL, etc.)
 
−
 
 
−
==Install Docker and docker-compose==
 
−
 
 
−
# {{#Widget:ExtLink|link=https://docs.docker.com/install/linux/docker-ce/ubuntu/#install-docker-ce-1|displaytext=Install Docker}}
 
−
# {{#Widget:ExtLink|link=https://docs.docker.com/compose/install/|displaytext=Install Docker-Compose}}
 
−
 
 
−
==Install GWS micro-services==
 
−
<!--
 
−
# Create a '''premise''' directory under the '''/opt/genesys/gws''' directory and copy the contents of the package's '''docker''' directory in all target machines.
 
−
# Run the following command at all target machines: <pre># ./bin/preflight.sh</pre>{{NoteFormat|This script disables firewalls and sets SElinux to ''permissive'' mode.}}
 
−
# Run the following command at all target machines:<pre># ./bin/dump-restore.sh restore</pre>
 
−
-->
 
−
 
 
−
 
 
−
# Create a '''gws''' directory under the '''/opt/genesys''' directory and copy the contents of the package's '''docker''' directory .
 
−
# Navigate to the '''/opt/genesys/gws/docker/images''' directory.
 
−
# Populate the '''images''' directory with the Docker image tarballs in *.tar format: <pre>for i in *.tar; do sudo docker load —input $i; done</pre>
 
−
# Edit the following values in the '''opt/genesys/gws/docker/common-env''' file:
 
−
#* LOCATION=USW2 - Genesys-specific value which affect server visibility. (should corresponds with value specified in CloudCluster’s connections > Advanced tab).
 
−
#* REDIRECT_URIS=<nowiki>http://uri1</nowiki>,<nowiki>http://uri2</nowiki> - specified as an array of double-quoted, comma-separated values with no whitespace between. Should be resolved from outside the docker host.
 
−
#* DOCKER_REPOSITORY - just leave intact, for manual GWS-images distribution.
 
−
#* DOCKERHUB_MIRROR= - just leave empty for manual infrastructure images distribution, or fetching them from Dockerhub (assuming you have internet connection in your environment).
 
−
#* Set the respective GWS components versions.
 
−
# Create symbolic links for proper docker-compose invocation. <br /> <pre>ln -s /usr/local/bin/docker-compose docker-compose</pre> <br /> <pre>sudo ln -s /usr/libexec/docker/docker-runc-current /usr/bin/docker-runc </pre>
 
−
# Navigate to the '''/opt/genesys/gws/wwe''' directory.
 
−
# Invoke startup script: <br /><pre>sudo start-gws-sevices.sh</pre>
 
−
# Wait until docker-compose stabilizes. It can take up to 10 minutes.
 
−
 
 
−
 
 
−
<!--
 
−
==Create GWS-data service Containers==
 
−
 
 
−
# Create a ''systemd'' unit. <pre>SERVICE_NAME="data" ./bin/register-systemd-unit.sh</pre>
 
−
# Start the data services.<pre>systemctl start gws-data.service</pre>
 
−
# Configure Redis.<pre>./bin/redis-starter.sh</pre>
 
−
 
 
−
==Create GWS-applications Containers==
 
−
 
 
−
# Create a ''systemd'' unit. <pre>SERVICE_NAME="applications" ./bin/register-systemd-unit.sh</pre>
 
−
# Start the applications services. <pre>systemctl start gws-applications.service</pre>
 
−
# Create the client. <pre>./bin/client-curl-script.sh</pre>
 
−
# Check the status of applications. <pre>./bin/healthcheck.sh</pre>
 
−
-->
 
−
==Configure GWS ==
 
−
===Configure Config Server===
 
−
Refer to [[Documentation:HTCC:Dep:InstallationProcedures|InstallationProcedures]] for information on configuring GWS.
 
−
 
 
−
==Create a Genesys Environment==
 
−
===Mapping ===
 
−
<pre>POST http://<GWS_APPLICATIONS_IP>:80/environment/v3/environments </pre>
 
−
 
 
−
=== Object Description ===
 
 
{|
 
{|
 +
! '''Service'''
 +
! '''Verification URLs'''
 
|-
 
|-
−
! Name
+
| Authentication Service
−
! Type
+
| <nowiki>https://GWS_APPLICATIONS_IP:8443/auth/v3/version</nowiki>
−
! Description
 
−
! Required
 
−
! Default
 
 
|-
 
|-
−
| tenant
+
| Configuration Service
−
| String
+
| <nowiki>https://GWS_APPLICATIONS_IP:8443/configuration/v3/version</nowiki>
−
| Tenant name
 
−
| Y
 
−
| --
 
 
|-
 
|-
−
| appName
+
| Environment Service
−
| String
+
| <nowiki>https://GWS_APPLICATIONS_IP:8443/environment/v3/version</nowiki>
−
| Application name to connect to
 
−
| Y
 
−
| --
 
 
|-
 
|-
−
| username
+
| Data Collector Service
−
| String
+
| <nowiki>https://GWS_APPLICATIONS_IP:8443/datacollector/v3/version</nowiki>
−
| Username to connect to ConfigurationServer
 
−
| Y
 
−
| --
 
 
|-
 
|-
−
| password
+
| Workspace Web Edition
−
| String
+
| <nowiki>https://GWS_APPLICATIONS_IP:8443/ui/wwe/index.html</nowiki>
−
| Password to connect to ConfigurationServer
 
−
| Y
 
−
| --
 
−
|-
 
−
| connectionProtocol
 
−
| String
 
−
| Connection protocol
 
−
| N
 
−
| addp
 
−
|-
 
−
| localTimeout
 
−
| Integer
 
−
| Local timeout
 
−
| N
 
−
| 5
 
−
|-
 
−
| remoteTimeout
 
−
| Integer
 
−
| Remote timeout
 
−
| N
 
−
| 7
 
−
|-
 
−
| traceMode
 
−
| String
 
−
| Trace mode
 
−
| N
 
−
| CFGTMBoth
 
−
|-
 
−
| tlsEnabled
 
−
| Boolean
 
−
| Use tls to connect to Configuration Server
 
−
| N
 
−
| false
 
−
|-
 
−
| configServers
 
−
| Array
 
−
| List of Configuration Servers in this environment (see bellow)
 
−
| N
 
−
| empty array
 
 
|}
 
|}
−
 
−
=== Configuration Server Object ===
 
−
 
−
{|
 
−
|-
 
−
! Name
 
−
! Type
 
−
! Description
 
−
! Required
 
−
! Default
 
−
|-
 
−
| primaryAddress
 
−
| String
 
−
| Address of primary Configuration Server
 
−
| Y
 
−
| --
 
−
|-
 
−
| primaryPort
 
−
| Integer
 
−
| Port of primary Configuration Server
 
−
| Y
 
−
| --
 
−
|-
 
−
| backupAddress
 
−
| String
 
−
| Address of backup Configuration Server
 
−
| N
 
−
| --
 
−
|-
 
−
| backupPort
 
−
| Integer
 
−
| Port of backup Configuration Server
 
−
| N
 
−
| --
 
−
|-
 
−
| readOnly
 
−
| Boolean
 
−
| Indicates if Configuration Server works in read only mode
 
−
| Y
 
−
| --
 
−
|-
 
−
| locations
 
−
| String
 
−
| Location of Configuration Server
 
−
| Y
 
−
| --
 
−
|}
 
−
 
−
==== Example ====
 
−
<pre>
 
−
POST .../environment/v3/environments
 
−
{
 
−
"data": {
 
−
  "username": "default",
 
−
  "remoteTimeout": 7,
 
−
  "appName": "WS_Node",
 
−
  "traceMode": "CFGTMBoth",
 
−
  "tlsEnabled": false,
 
−
  "localTimeout": 5,
 
−
  "connectionProtocol": "addp",
 
−
  "password": "passowrd",
 
−
  "configServers": [
 
−
    {
 
−
      "primaryPort": 8888,
 
−
      "readOnly": false,
 
−
      "primaryAddress": "voice-p.dev",
 
−
      "locations": "usw1"
 
−
    },
 
−
    {
 
−
      "primaryPort": 8888,
 
−
      "primaryAddress": "10.20.10.1",
 
−
      "readOnly": false,
 
−
      "locations": "use2",
 
−
      "backupPort": 8888,
 
−
      "backupAddress": "10.20.20.1"
 
−
    }
 
−
  ],
 
−
  "tenant": "Environment"
 
−
}
 
−
}
 
−
</pre>
 
−
 
−
Response:
 
−
 
−
<pre>
 
−
{
 
−
"statusCode": 0,
 
−
"path": "/environments/2"
 
−
}
 
−
</pre>
 
−
 
−
==Create contact-center==
 
−
=== Mapping===
 
−
<pre>POST http://<GWS_APPLICATIONS_IP>:80/environment/v3/contact-centers</pre>
 
−
 
−
=== Object description===
 
−
{|
 
−
! Name
 
−
! Type
 
−
! Description
 
−
! Required
 
−
! Default
 
−
|-
 
−
| environmentId
 
−
| String
 
−
| Environment id
 
−
| Y
 
−
| --
 
−
|-
 
−
| name
 
−
| String
 
−
| Contact center name
 
−
| Y
 
−
| --
 
−
|-
 
−
| domains
 
−
| Array
 
−
| List of domains associated with this contact center
 
−
| N
 
−
| Empty list
 
−
|-
 
−
| auth
 
−
| String
 
−
| Authentication type for this contact center
 
−
| Y
 
−
| --
 
−
|-
 
−
|}
 
−
 
−
==== Example ====
 
−
<pre>
 
−
POST .../environment/v3/contactCenters
 
−
  {
 
−
    "data": {
 
−
      "environmentId": "5",
 
−
      “name”: “customer.com”
 
−
      "domains": ["customer.com"],
 
−
      "auth": "configServer"
 
−
    }
 
−
}
 
−
</pre>
 
−
 
−
Response:
 
−
 
−
<pre>
 
−
{
 
−
  "statusCode": 0,
 
−
  "path": "/conatctCenters/6"
 
−
}
 
−
</pre>
 
−
 
−
==Links==
 
−
# Auth API: <nowiki>http://<GWS_APPLICATIONS_IP>:80/auth/v3/*</nowiki>
 
−
# Config API:  <nowiki>http://<GWS_APPLICATIONS_IP>:80/configuration/v3/*</nowiki>
 
−
# Environment API:  <nowiki>http://<GWS_APPLICATIONS_IP>:80/environment/v3/*</nowiki>
 
−
# Provisioning API:  <nowiki>http://<GWS_APPLICATIONS_IP>:80/provisioning/v3/*</nowiki>
 
−
# Workspace API:  <nowiki>http://<GWS_APPLICATIONS_IP>:80/workspace/v3/*</nowiki>
 
−
# Workspace UI: <nowiki>http://<GWS_APPLICATIONS_IP>:80/ui/wwe/index.html</nowiki>
 
  
 
[[Category:V:HTCC:9.0.0DRAFT]]
 
[[Category:V:HTCC:9.0.0DRAFT]]

Latest revision as of 17:33, December 18, 2020

Deploying Web Services and Applications in Docker Compose

This page provides instructions on preparing and deploying Web Services and Applications with Docker.

Important
  • To support Gplus Adapter for Salesforce, Docker Compose must be deployed with HTTPS.
  • To upgrade Web Services and Applications, you must install the new version of Web Services Docker Compose.

Prerequisites

For hardware, software, Workspace Web Edition, and Gplus Adapter for Salesforce requirements, refer to Prerequisites. Also, ensure your environment has access to docker.io/library. If internet access is not available, manually load the following public container images to the Docker registry:

Configuring Web Services and Applications

To configure Web Services and Applications, refer to Configuring Web Services and Applications.

Deploying Web Services and Applications

  1. Unpack the installation package file (e.g. IP_HTCCDev_9000207b1_ENU_dockerlinux.zip) , and navigate to the ip folder which should contain the following files:
    • gws-microservices.tgz
    • exported microservices in tar.gz format (e.g. gws-platform-configuration_9.0.000.50.tar.gz)
  2. Unpack the gws-microservices.tgz archive to the /opt/genesys/gws directory. 
    • mkdir -p /opt/genesys/gws 
    • tar xvf gws-microservices.tgz -C /opt/genesys/gws
  3. Populate the Docker images (presented in *.tar.gz format) from the installation package: 
    • for i in *.tar.gz; do sudo docker load --input $i; done
    Important
    This command must be run with Docker-capable privileges.
  4. Edit the following values in the /opt/genesys/gws/kubernetes/parameters.yaml file:
Environment Variable Value Description
DOCKER_REPOSITORY Should be empty if the Web Services and Applications images are loaded manually.
REDIRECT_URIS \"http://uri1\",\"http://uri2\"

A comma-separated array of resolvable host names or IP addresses of the Docker host machine. Used as a part of the OAuth authentication flow.

Important
To access the lab deployment, it is mandatory to set resolvable host names or IP addresses for the Docker host machine.

The array should use double quotes and the quotes should be escaped using backslashes. The array should not have any white space between items.

DOCKERHUB_MIRROR Should be empty if the images of the Infrastructure components are loaded manually.
LOCATION /USW2 The location of Configuration Server.
Important
The Web Services and Applications cluster application object (typically names CloudCluster) in the Configuration Database must be configured with a specified location for each connection to Genesys servers like Configuration Server, Stat Server, T-Server, and so on. This setting defines which server instance is visible by the Web Services and Applications node based on its position in the Web Services and Applications Cluster.
GWS_HTTPS_ENABLE false The option to enable https support for deployment.
GWS_HTTPS_SERVER_CERTIFICATE server.crt The path to server certificate, which will be used during the SSL handshake with clients.
GWS_HTTPS_SERVER_CERT_KEY server.key The path to server key, which will be used during the SSL handshake with clients.
ENVIRONMENT_USERNAME default The username to connect to Configuration Server.
ENVIRONMENT_APPNAME GWS_App The application name to connect to Configuration Server. For details, refer to Creating GWS Client Application.
ENVIRONMENT_PASSWORD password The password to connect to 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 onpremiselab.com The domain associated with this contact center.
Important
While logging on to WWE, use the domain name as the tenant name.
  1. For Elasticsearch, the default operating system limits on mmap counts is likely to be too low, which may result in out-of-memory exceptions. To mitigate it temporarily, run the following: 
    sudo sysctl -w vm.max_map_count=262144

    To set this value permanently, update the vm.max_map_count setting in /etc/sysctl.conf. To verify after restarting, follow these steps: 

    sudo sysctl vm.max_map_count
  2. Navigate to the /opt/genesys/gws/docker/wwe directory.
  3. Source the common-env file with environment variables: 
    . ../common-env
  4. Invoke docker-compose:  
    docker-compose up -d
  5. Wait until docker-compose is up and running. It may take up to 10 minutes.

    6. Verifying Web Services and Applications

    Use the following links to get the expected versions of the Web Services and Applications components and verify they are correct:

    Service Verification URLs
    Authentication Service http://GWS_APPLICATIONS_IP:8080/auth/v3/version
    Configuration Service http://GWS_APPLICATIONS_IP:8080/configuration/v3/version
    Environment Service http://GWS_APPLICATIONS_IP:8080/environment/v3/version
    Data Collector Service http://GWS_APPLICATIONS_IP:8080/datacollector/v3/version
    Workspace Web Edition http://GWS_APPLICATIONS_IP:8080/ui/wwe/index.html

    If the GWS_HTTPS_ENABLE option is set to true, HTTPS endpoints can be used for verification too:

    Service Verification URLs
    Authentication Service https://GWS_APPLICATIONS_IP:8443/auth/v3/version
    Configuration Service https://GWS_APPLICATIONS_IP:8443/configuration/v3/version
    Environment Service https://GWS_APPLICATIONS_IP:8443/environment/v3/version
    Data Collector Service https://GWS_APPLICATIONS_IP:8443/datacollector/v3/version
    Workspace Web Edition https://GWS_APPLICATIONS_IP:8443/ui/wwe/index.html
This page was last edited on December 18, 2020, at 17:33.
Comments or questions about this documentation? Contact us for support!