Triggering the Rolling Software Upgrade

cnSGW-C utilizes the SMI Cluster Manager to perform a rolling software update.

To update cnSGW-C using SMI Cluster Manager, use the following configurations:

Important

Before you begin, ensure that cnSGW-C is up and running with the current version of the software.

  1. Log in to the SMI Cluster Manager Ops Center.

  2. Download the latest tarall from the URL.

    software-packages download url 

    NOTES:

    • software-packages download url —Specifies the software packages to be downloaded through HTTP/HTTPS.

    Example:

    SMI Cluster Manager# software-packages download <url> 
    
  3. Verify whether the tarall is loaded.

    software-packages list 

    NOTES:

    • software-packages list —Specifies the list of available software packages.

    Example:

    SMI Cluster Manager# software-packages list 
    [ cnSGW-2019-08-21 ] 
    [ sample ] 
    
  4. Update the product repository URL with the latest version of the product chart.

    Note

    If the repository URL contains multiple versions, the Ops Center automatically selects the latest version.

    configure
      cluster cluster_name
       ops-centers app_name cnSGW_instance_name
            repository url
             exit
           exit 

    Example:

    SMI Cluster Manager# config 
    SMI Cluster Manager(config)# clusters test2 
    SMI Cluster Manager(config-clusters-test2)# ops-centers cnSGW data 
    SMI Cluster Manager(config-ops-centers-cnSGW/data)# repository <url> 
    SMI Cluster Manager(config-ops-centers-cnSGW/data)# exit 
    SMI Cluster Manager(config-clusters-test2)# exit 
    
  5. To update to the latest version of the product chart, run the cluster sync command using the following command:

    clusters cluster_name actions sync run 

    Example:

    SMI Cluster Manager# clusters test2 actions sync run

NOTES:

  • cluster —Specifies the K8s cluster.

  • cluster_name —Specifies the name of the cluster.

  • ops-centers app_name instance_name —Specifies the product Ops Center and instance. app_name is the application name. instance_name is the name of the instance.

  • repository url —Specifies the local registry URL for downloading the charts.

  • actions —Specifies the actions performed on the cluster.

  • sync run —Triggers the cluster synchronization.

Important
  • The cluster synchronization updates the cnSGW-C Ops Center, which in turn updates the application pods (through helm sync command) one at a time automatically.

  • When you trigger rolling upgrade on a specific pod, the cnSGW-C avoids routing new calls to that pod.

  • The cnSGW-C honors in-progress call by waiting for 30 seconds before restarting the pod where rolling upgrade is initiated. Also, the cnSGW-C establishes all the in-progress calls completely within 30 seconds during the upgrade period (maximum call-setup time is 10 seconds).