Upgrade

Calisti provides safe upgrades for its main components and their dependencies:

Service Mesh Manager,
Streaming Data Manager, and
the Istio control plane.

CAUTION:

Supported upgrade paths

Service Mesh Manager supports upgrades from the prior minor release and patch releases. The current supported upgrade path is: v1.11.x to v1.12.x

How to upgrade

The procedure to upgrade Calisti depends on how you have installed Calisti.

If you have installed Calisti in imperative mode, upgrade it using the CLI.
If you have installed Calisti in operator mode, upgrade the operator.
If you have installed Calisti using the GitOps guide, see Upgrade SMM - GitOps - single cluster.

Overview of the upgrade procedure

Upgrading Calisti consists of the following high-level steps. The exact method to perform each step depends on the way you have installed Calisti (from the CLI, in operator mode, or using GitOps methodology).

Upgrading the Service Mesh Manager control plane. This is needed regardless of the target Istio version. This step ensures that all Service Mesh Manager components are containing the latest features and security fixes.

This upgrade also upgrades Istio to the latest patch level. For example: if before the upgrade the cluster had Istio 1.11.0, and the target Service Mesh Manager version contains Istio 1.11.2, then this step upgrades Istio to 1.11.2.

For details on performing this step, see How to upgrade.
If the new version of Service Mesh Manager contains a new minor or major version of Istio (for example, you have Istio 1.11.2 installed, and the new version contains Istio 1.12), complete the Upgrading your business applications procedure after upgrading Service Mesh Manager.

Service Mesh Manager avoids big changes to the production traffic by running two versions of the Istio control planes in parallel (for example, 1.11.2 and 1.12.0) on the same cluster. After the upgrade, the existing workloads continue using the older version of Istio (for example, 1.11.2). You can gradually (on a per-namespace basis) move workloads to the new (in the example the 1.12.0) version. This allows operators to start moving services with less business value or risk associated to the new Istio version before moving on to more mission critical services.
If you have Streaming Data Manager installed, upgrade Streaming Data Manager. For details, see Upgrade.