Deployment of Web Services and Applications

Important: This content is restricted and not viewable without a login supplied by Genesys. The information contained in this documentation is not considered final and is managed under the terms and conditions found in the Pre-release Agreement. This documentation provides the most up-to-date reference information available for this pre-release version and is restricted for use by those who have signed the Pre-release Agreement with Genesys to acquire an early version of the software.

Hardware recommendations

The solution can be deployed at a Kubernetes cluster with a minimal size of 3 nodes with an overall amount of 96 GB RAM. Recommended hardware requirements for each Kubernetes node:

• CPU: 4 - 8 cores
• RAM: 32 GB
• HDD: 500 GB

Prerequisites

1. Kubernetes cluster deployed and available. The following Kubernetes distributions are currently supported:
   • Red Hat Openshift Enterprise
   • Openshift Kubernetes Deployment
   • Rancher Kubernetes Deployment
   • Google Kubernetes Engine (GKE)
   • Amazon Elastic Kubernetes Service (EKS)

1. Client-side utilities installed at deployment host:
   • Kubectl tool
   • gcloud utility (for GKE deployments)
   • eksctl (for Amazon EKS)
   • Genesys applications package from Genesys Software Distribution Services.

Deploying GWS

1. Unpack the Genesys Applications package tarball and change to the kubernetes directory:
   

   $ cd kubernetes

2. Create an environment configuration file (gws.env) from template located
   • The versions of GWS applications should be specified by setting environment variables in the created gws.env file:
     

     export GWS_SOME_SERVICE_VERSION="9.0.000.00.470"

3. Run the environment file you have created and see all available commands:
   

   * $ . ./gws.env

4. Import GWS applications docker images to the client's container registry.

Deployment Steps

1. Validate your Kubernetes credentials:
   • Follow the registration web-UI steps. and type gcloud container clusters list command to see all GKE clusters available to you, if any.

1. • 1. Unpack the gws-microservices.tgz file with the following command:
        

tar -zxf gws-microservices.tgz

1. Go to the kubernetes directory:
   cd gws-microservices/kubernetes

1. Modify the <ToBeChanged: …'''> values defined in the configurations files with the actual values required by deployment.

1. • the conf/gke.env file for GKE deployments
   • the conf/openshift.env file for OpenShift deployments

1. Apply the modified configuration file to the current bash session:
   source conf/gke.env for GKE deployments
   source conf/openshift.env for OpenShift deployments

1. Deploy the monitoring stack using gws-monitoring-deploy.sh script. The script will deploy Prometheus and Grafana solutions at your Kubernetes cluster.
2. Deploy GWS infrastructure using gws-infra-deploy.sh script. The script will deploy GWS dependency servers - ElasticSearch, Redis, Consul, etc., at your Kubernetes cluster.
3. Deploy GWS microservices using gws-app-deploy.sh script.
4. Initialize GWS using gws-postinstall.sh script. The script uses GWS REST API to provision environment, contact center, and authentication client.

Upgrade Procedure

1. Download new version of gws-microservices.tgz package from Genesys FTP to the deployment host.
2. Unpack the gws-microservices.tgz file with the following command:
   tar -zxf gws-microservices.tgz
3. Go to the kubernetes directory:
   cd gws-microservices/kubernetes
4. Modify the <ToBeChanged: …> values defined in the conf/gke.env file with the actual values required by deployment. Refer to the file used in deployment.
5. Apply the modified configuration file to the current bash session:
   source conf/gke.env
6. Upgrade GWS microservices using gws-app-deploy.sh script.