CLI - multi-cluster upgrade

This document shows you how to upgrade Service Mesh Manager in a multi-cluster mesh scenario. For details on how to set up a multi-cluster mesh, see the multi-cluster installation guide. To access the latest binary files, see Accessing the Service Mesh Manager binaries.

Upgrade from 1.12.0 to 1.12.1

To upgrade Service Mesh Manager from 1.12.0 to 1.12.1 for a multi-cluster setup, complete the following steps.

  1. Download the Service Mesh Manager command-line tool for version 1.12.1. The archive contains the smm and supertubes binaries. Extract these binaries and update your local copy on your machine. For details, see Accessing the Service Mesh Manager binaries.

    smm --version
    

    The output should be similar to:

    Service Mesh Manager CLI version  1.12.1 (4c8509faa) built on 2023-05-05T20:57:58Z
    
  2. Deploy a new version of Service Mesh Manager.

    The following command upgrades the Service Mesh Manager control plane. The new version 1.12.1 has the same Istio control plane (version 1.15.3) from the previous version, so there is no need to worry about upgrading istio version for Service Mesh Manager from 1.12.0 to 1.12.1.

    In the following examples, smm refers to version 1.12.1 of the binary.

    • If you want to upgrade only Service Mesh Manager:

      smm install -a
      
      • In case you want to have custom settings for your Istio control plane, you can provide that during the installation:

        smm install -a --istio-cr-file <custom-istio-cr-file.yaml>
        
  3. Rerun the attach command with --force flag to upgrade Service Mesh Manager on the peer cluster:

    smm istio cluster attach <PEER_CLUSTER_KUBECONFIG_FILE> --force
    

Upgrade existing workloads

The new version 1.12.1 has the same Istio control plane (version 1.15.3) as the previous version, so there is no need to upgrade and restart workloads.