Deploy Workspace Web Edition

Learn how to deploy Workspace Web Edition.

Related documentation:

• How Agent Workspace works
• Suite-level guide
• All services
• Workspace Web Edition Release Notes

RSS:

• For private edition

Important

Make sure to review Before you begin for the full list of prerequisites required to deploy Workspace Web Edition.

Deploy in OpenShift

Login to OpenShift cluster

Use the following command to log in to OpenShift cluster from the host where you will run deployment:

oc login --token <token> --server <url of api server>

Select your WWE Project

Use the following command to select the default WWE project that was created as a prerequisite:

oc project wwe

Render the templates

To ensure that resources are created correctly, you can render the templates for debugging purposes without installing them. Use the following command to render the templates:

helm template --debug -f values.yaml wwe-helm wwe-nginx/

Kubernetes descriptors are displayed. The values are generated from Helm templates, based on settings from values.yaml and values-test.yaml. Ensure that no errors are displayed. This configuration will be applied to your Kubernetes cluster.

Deploy WWE

Use the following command to deploy WWE:

helm install --debug --namespace wwe --create-namespace -f values.yaml wwe-helm wwe-nginx

This process takes several minutes. Wait until all objects are created and allocated, and the Kubernetes descriptors applied to the environment appear.

Check the deployment

Use the following command to check the installed Helm release:

helm list –all-namespaces

Use the following command to check the status of the WWE project:

oc status

Use the following command to check the WWE OpenShift objects created by Helm:

oc get all -n wwe

Expose the WWE service

Make WWE accessible from outside the cluster, using the standard HTTP port. Use the following command to expose the WWE service:

oc create route edge --service=wwe-helm-wwe-nginx --hostname=<hostname>

Validate the deployment in OpenShift

Use the following command to verify that the new route is created in the WWE project:

oc get route -n wwe

The result should show details similar to the following:

NAME   HOST/PORT                         PATH   SERVICES             PORT   TERMINATION   WILDCARD
wwe    wwe.apps.vce-c0.eps.genesys.com          wwe-helm-wwe-nginx   http   edge/Allow    None

where <host> is the host name generated by OpenShift.

Verify that you can access WWE at the following URL:

http://wwe.<host>