To take advantage of the latest features, enhancements, and fixes in new versions of Tanzu Service Mesh, you can install upgrades on your clusters.

When a new version of Tanzu Service Mesh is released, the version number is displayed at the top of the Software Updates page. You can upgrade your clusters to this version. The VMware Tanzu Service Mesh Data Plane Release Notes contains information about the released version. You can access the release notes by following a link on the Software Updates page.

When an upgrade is installed on a cluster, the data plane components that run on the cluster are upgraded to the versions released within the selected Tanzu Service Mesh version. You can see the versions of the data plane components released within a specific version in the VMware Tanzu Service Mesh Data Plane Release Notes.

If an upgrade fails for some reason, Tanzu Service Mesh automatically rolls back to the previous version installed on the cluster. You can also choose to roll back a cluster to the previous version manually.

Consider the following restrictions that apply to upgrades and rollbacks:

  • You can only upgrade from a major version to a minor or patch version released within that major version or to the next major version. An upgrade cannot skip major versions. For example, if your clusters are on version 2.0.0, you can upgrade to 2.0.1, 2.1.0, or 3.0.0, but not to 4.0.0.

  • You can roll back only to the minor version, the patch version, or the major version that was last installed on the clusters. For example, if your clusters are on version 4.0.1, you can roll back to version 4.0.0 or 3.0.0, but not to 2.0.0.

  • The latest minor version and the latest major version can be both available to upgrade to. For example, if your clusters are on version 2.0.0, you can choose to upgrade to 2.0.1 or to 3.0.0.

The following procedure describes how to install a Tanzu Service Mesh upgrade and roll back a cluster to the previously installed version.

Prerequisites

Verify that you are in the Tanzu Service Mesh Console. For information about accessing the Tanzu Service Mesh Console, see Access the Tanzu Service Mesh Console.

Procedure

  1. In the navigation pane on the left, click Tanzu Admin > Software Updates.

    The latest available version is displayed at the top of the Software Updates page. You can click the Release Notes link to open the release notes for this version and the past released versions.

    One of the following general statuses appears at the top of the page:

    • All clusters are up to date. All your clusters use the latest available version of Tanzu Service Mesh and don’t need an upgrade.

    • {Number} clusters have out of date software – The indicated number of clusters use an old version of Tanzu Service Mesh. You can upgrade the clusters to the latest version.

    • Updating {number} clusters – This status appears if an upgrade or a rollback is in progress for one or more clusters.

    The table below displays the names of your clusters and displays one of the following statuses for each cluster:

    • Up to Date – v{version} . The cluster has the latest version of Tanzu Service Mesh and does not need to be upgraded.

    • Out of Date – v{version}. The cluster uses an old version of Tanzu Service Mesh. You can upgrade it to the latest version.

    • Updating to v{version} - The cluster is being upgraded or rolled back to a specified version.

  2. To install an upgrade on a cluster, perform these steps:
    1. In the table, at the right end of the cluster row, click Update to v{version}.
    2. If both a minor version and a major version are available to upgrade to, click the three dots to the right of Update to v{version}, select the version to upgrade to, and then click Update to v{version}.

      The status of the cluster changes to Updating to v{version} , and a progress bar appears to the right of the status. The message Cluster {cluster_name} - Upgrading mesh dependencies with a progress bar appears in the lower-right corner.

      Note:

      You can upgrade more than one cluster simultaneously by clicking Update to v{version} at the end of each cluster row.

      When the upgrade is complete, Up to Date – v{version} Tanzu Service Mesh upgraded appears to the right of the cluster name in the table, and the message Cluster {cluster_name} - Tanzu Service Mesh upgraded appears in the lower-right corner.

      Note:
      • If you chose to upgrade the cluster to a version that is not the latest version available, a status of Out of Date – v{version} Tanzu Service Mesh upgraded appears to the right of the cluster name after the upgrade. You can upgrade to the latest version by clicking Update to v{version}.

      • If the upgrade fails for some reason, Tanzu Service Mesh displays an error message and automatically rolls the cluster back to the previously installed version.

  3. To roll back a cluster to the previously installed version of Tanzu Service Mesh, at the right end of the cluster row, click Rollback To v{version}.
    Note:

    The rollback option is available only for clusters with a status of Out of Date.

    The status of the cluster changes to Updating to v{version}, the message Upgrading mesh dependencies with a progress bar appears to the right of the status. The message Cluster {cluster_name} - Upgrading mesh dependencies with a progress bar also appears in the lower-right corner.

    Note:

    When Tanzu Service Mesh is automatically performing a rollback, the message Rolling back mesh dependencies appears to the right of the status. The message Cluster {cluster_name} - Rolling back mesh dependencies also appears in the lower-right corner.

    When a rollback is complete, Out of Date – v{version} Tanzu Service Mesh upgraded appears to the right of the cluster name in the table, and the message Cluster {cluster_name} - Tanzu Service Mesh upgraded appears in the lower-right corner.

    Note:

    When an automatic rollback is complete, Out of Date – v{version} Tanzu Service Mesh rolled back appears to the right of the cluster name in the table, and the message Cluster {cluster_name} - Tanzu Service Mesh rolled back appears in the lower-right corner.