Deploying GCXI using OpenShift

Beginning with release 9.0.016, Genesys CX Insights supports deployment using Red Hat OpenShift.

Prerequisites for deploying using OpenShift

This page provides an outline, illustrating one scenario to help you visualize the overall process. Genesys does not provide support for OpenShift or other third party products, so you must have knowledge of OpenShift and other products to complete this installation. GCXI supports OpenShift Cluster 4.5.16, which is described on this page.

The following prerequisites apply:

• Your OpenShift cluster must be configured and running in a suitable environemnt, with nodes in Ready state.
• OpenShift client and Helm-3 are installed on the host where the deployment will run.
• The images gcxi and gcxi_control are loaded and tagged on each OpenShift worker node.
• On each worker node, ensure that values are set for kernel.sem, vm.max_map_count, as required by MicroStrategy. For example:

  echo "kernel.sem = 250 1024000 250 4096" >> /etc/sysctl.conf
  echo "vm.max_map_count = 5242880" >> /etc/sysctl.conf
  sysctl -p

Procedure: 1. Preconfiguration steps

Purpose: Prepare the environment for deployment.

Steps

1. Ensure that the GCXI project has been created. (Writer's Note: Steps? What's this?)
2. Ensure that four NFS PersistentVolume (PV) have been created, as described in Deploying GCXI using Helm.
3. Ensure that four NFS PersistentVolumeClaim (PBC) with the following names have been created in the gcxi workspace, as described in Deploying GCXI using Helm:
   • gcxi-backup-pvc
   • gcxi-log-pvc
   • gcxi-postgres-pvc
   • gcxi-share-pvc
4. To configure OpenShift Security Context Constraints to allow pods to run under non-root user with UID=500, configure the following users inside the GCXI container:

   root:root (0:0)
   genesys:genesys (500:500)

   You can use either of these users to run the container. Running it with any other user causes an error such as:

   "500 is not an allowed group spec.containers[0].securityContext.securityContext.runAsUser: Invalid value: 500: must be in the ranges: [1000570000, 1000579999]]"

   Genesys recommends the preceding method all production environments. For test environments, execute the following command if you wish to run pods as any user:

   oc adm policy add-scc-to-user anyuid -z default

Procedure: 2. Prepare

Steps

Procedure: 3. Deploy

Steps

Procedure: Troubleshooting

Steps

Procedure: Uninstall

Steps