Upgrading to a New Version

During a migration, it is strongly recommended that you avoid changing the configuration files if the changes are not required by the migration procedure. Configuration changes can cause the migration to fail.

In the event of a failure, you must rollback to the previous version instead of rolling back only the changed options. To perform rollback, please invoke:

helm rollback gws 0 -n gws-service

Where:

• gws is the deployment name.
• 0 is an option to roll back to the last successful release.
• -n gws-service is the Kubernetes namespace name to deploy to.

Implementation Steps

1. Unpack the installation package (e.g. IP_HTCCDev_9000197b1_ENU_dockerlinux.zip file) and navigate to the ip folder which contains the following files:
   • gws-microservices.tgz
   • exported microservices in tar.gz format (e.g. gws-platform-configuration_9.0.000.42.tar.gz)
2. Unpack the gws-microservices.tgz archive to the /opt/genesys/gws directory.

   mkdir -p /opt/genesys/gws
   tar xvf gws-microservices.tgz -C /opt/genesys/gws

3. Populate Docker images (presented in *.tar.gz format) from the installation package to your corporate docker registry.

   for i in *.tar.gz; do /opt/genesys/gws/kubernetes/bin/push-containers-to-local-registry.sh $i %corporate_registry_address% --push; done

   Important

   This script must be run with Docker-capable privileges and you must log in to your registry before pushing.
4. Navigate to /opt/genesys/gws/kubernetes.
5. Invoke Helm:

   helm upgrade gws gws/ -n gws-service -f gws-versions.yaml -f parameters.yaml -i

   Where:

   • gws is the name of deployment.
   • gws/ is the helm chart directory.
   • -n gws-service is the Kubernetes namespace name to deploy to.
   • -f gws-versions.yaml is the config file where versions of containers are defined.
   • -f parameters.yaml is the previously customized config file of the customer where deployment parameters are defined.
6. Wait until the Helm upgrade Web Services and Applications and Kubernetes cluster start all the requested containers.