Deployment procedure

Prerequisites

1. Kubernetes cluster deployed and available. The following Kubernetes distributions are currently supported:
   • Google Kubernetes Engine (GKE).
2. Client-side utilities installed at deployment host:
   • Kubectl tool
   • Helm client, Tiller is not required.
   • gcloud utility (for GKE deployments)
3. Valid credentials for your Kubernetes cluster.
4. The gws-microservices.tgz package downloaded from Genesys FTP to the deployment host.
5. Images of GWS components uploaded into target Kubernetes registry.

Configuring GWS in Configuration Server

Use Genesys Administrator to configure Applications and Users for Genesys Web Services and Applications.

1. Configure (or use existing) super administrator account. It will be used by GWS to connect and perform read and write operations.
2. Create an application of type Genesys Generic Server. Suggested name is GWS.
3. For this application, add connections to Config Server, TServer (SIPServer), StatServer. In the Advanced tab of Connection in Application parameters, add the following locations, e.g. locations=/USW2 - as configured in environment variable, GWS_REGION.
4. Create an application of type, Genesys Generic Client. Suggested name is GWS_app.
5. Add a connection to the Genesys Generic Server application created in Step 2.

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.

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.

5. Apply the modified configuration file to the current bash session:
   source conf/gke.env

6. Deploy the monitoring stack using gws-monitoring-deploy.sh script. The script will deploy Prometheus and Grafana solutions at your Kubernetes cluster.

7. Deploy GWS infrastructure using gws-infra-deploy.sh script. The script will deploy GWS dependency servers - ElasticSearch, Redis, Consul, etc., at your Kubernetes cluster.

8. Deploy GWS microservices using gws-app-deploy.sh script.

9. 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.