Upgrade Guide CX5.2.0 to CX5.3.0

Before upgrading, ensure that the system is idle, i.e, all agents are logged out from the AgentDesk.

Custom Configuration Strategy

For detailed guidelines on applying environment-specific configurations using custom values.yaml layering,

Refer to the CX Helm Chart Custom Configuration Strategy guide.

  1. Update Helm repo

    helm repo update expertflow
    
  2. Clone the CX repository on the target server

    # Create CX-5.3.0 directory from root
      mkdir CX-5.3.0
    # Navigate to CX-5.3.0
      cd CX-5.3.0
    # Clone the CX-5.3.0 branch of the cim-solution repository
      git clone -b CX-5.3.0 https://efcx:RecRpsuH34yqp56YRFUb@gitlab.expertflow.com/cim/cim-solution.git $HOME/CX-5.3.0
    # Navigate to current release /kubernetes
      cd <current-release>/kubernetes
    
  3. Update Application Gateway (APISIX)

    # Update the apisix-custom-values.yaml file with latest updates from 5.3.0 version, make sure to save any customisation and add once the apisix-custom-values.yaml is updated.
      helm show values expertflow/apisix --version 5.3.0  > helm-values/apisix-custom-values.yaml
      helm upgrade --install --namespace ef-external --values helm-values/apisix-custom-values.yaml apisix expertflow/apisix --version 5.3.0
    
  4. Deploy the AgentDesk helm chart

    # Copy the unified agent translation directory to the current release 
      Copy From CX-5.3.0/kubernetes/pre-deployment/app-translations/unified-agent/i18n/ To ./pre-deployment/app-translations/unified-agent
      
    # Delete and Create the ConfigMap of Unified Agent-based translations
      kubectl delete cm ef-app-translations-cm -n expertflow
      kubectl -n expertflow create configmap ef-app-translations-cm --from-file=pre-deployment/app-translations/unified-agent/i18n/
      
    # Deploy the new chart version using the helm-values/cx-agent-desk-custom-values.yaml
      helm upgrade --install --namespace expertflow --set global.efCxReleaseName="ef-cx"  cx-agent-desk  --debug --values helm-values/cx-agent-desk-custom-values.yaml expertflow/agent-desk --version 5.3.0  
    
  5. Deploy the Core helm chart

    # Deploy the new chart version using the helm-values/ef-cx-custom-values.yaml 
      helm upgrade --install --namespace expertflow --create-namespace   ef-cx  --debug --values helm-values/ef-cx-custom-values.yaml expertflow/cx --version 5.3.0
    
  6. Deploy the Channels helm chart

    # Deploy the new chart version using the helm-values/cx-channels-custom-values.yaml
    # A new connector for Apple Store has been added to the Channels. You can enable it by updating following in your helm-values/cx-channels-custom-values.yaml
    apple-store-connector:
       enabled: true
      helm upgrade --install --namespace expertflow --set global.efCxReleaseName="ef-cx" --debug cx-channels --values helm-values/cx-channels-custom-values.yaml  expertflow/channels --version 5.3.0
    
  7. Deploy the QM helm chart (for single-tenant only)

    # Deploy the new chart version using the helm-values/cx-qm-custom-values.yaml
      helm upgrade --install --namespace=expertflow --set global.efCxReleaseName="ef-cx" qm  --debug --values=helm-values/cx-qm-custom-values.yaml expertflow/qm --version 5.3.0 
    
  8. Deploy the MTT helm chart

    Copy CX-5.3.0/kubernetes/pre-deployment/nginx-router/nginx-router-manifests.yaml to <current-release>/pre-deployment/nginx-router/nginx-router-manifests.yaml
    # Delete and Apply the nginx-router-manifests.yaml
      k delete -f pre-deployment/nginx-router/nginx-router-manifests.yaml
      k -n expertflow apply -f pre-deployment/nginx-router/nginx-router-manifests.yaml
      
    # Deploy the new chart version using the helm-values/mtt-single-custom-values.yaml
      helm upgrade --install --namespace <tenant-ns> --debug  <tenant-id> --values helm-values/mtt-single-custom-values.yaml  expertflow/MTT-single --version 5.3.0 
    

Configuration Guide(s):