Revision as of 06:24, November 29, 2018

Deployment procedure

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

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

Configure (or use existing) super administrator account. It will be used by GWS to connect and perform read and write operations.
Create an application of type Genesys Generic Server. Suggested name is GWS.
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.
Create an application of type, Genesys Generic Client. Suggested name is GWS_app.
Add a connection to the Genesys Generic Server application created in Step 2.

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.

Unpack the gws-microservices.tgz file with the following command:
tar -zxf gws-microservices.tgz

Modify the <ToBeChanged: …> values defined in the conf/gke.env file with the actual values required by deployment.
Apply the modified configuration file to the current bash session:
source conf/gke.env

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

Download new version of gws-microservices.tgz package from Genesys FTP to the deployment host.
Unpack the gws-microservices.tgz file with the following command:
tar -zxf gws-microservices.tgz
Go to the kubernetes directory:
cd gws-microservices/kubernetes
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.
Apply the modified configuration file to the current bash session:
source conf/gke.env
Upgrade GWS microservices using gws-app-deploy.sh script.

@@ Line 51: / Line 51: @@
 <ol style="list-style-type: decimal;">
 <li><p>Download new version of '''gws-microservices.tgz''' package from Genesys FTP to the deployment host.</p></li>
-<li><p>Unpack the ''gws-microservices''.tgz file with the following command:</p>
+<li><p>Unpack the ''gws-microservices''.tgz file with the following command:<br />
-<p>'''tar -zxf ''gws-microservices''.tgz'''</p></li>
+<tt> tar -zxf gws-microservices.tgz</tt>
-<li><p>Go to the '''kubernetes''' directory:</p>
+</p></li>
-<p>'''cd gws-microservices/kubernetes'''</p></li>
+<li><p>Go to the '''kubernetes''' directory:<br />
+<tt>cd gws-microservices/kubernetes</tt></li>
 <li><p>Modify the '''&lt;ToBeChanged: …&gt;''' values defined in the '''conf/gke.env''' file with the actual values required by deployment. Refer to the file used in deployment.</p></li>
-<li><p>Apply the modified configuration file to the current bash session:</p>
+<li><p>Apply the modified configuration file to the current bash session:<br />
-<p>'''source conf/gke.env'''</p></li>
+<tt>source conf/gke.env</tt></p></li>
 <li><p>Upgrade GWS microservices using '''gws-app-deploy.sh''' script.</p></li></ol>
 [[Category:V:HTCC:9.0.0DRAFT]]