Upgrading Self-Hosted Standard Edition

Upgrade Standard Edition and the stanctl tool.

To find the Instana® versions that are compatible with Standard Edition, see Compatibility matrix.

Important:

Rollback of the Instana backend after an upgrade is not supported for Standard Edition.

Upgrade notes

See the following notes for release-specific requirements.

Attention:

Self-Hosted Standard Edition 1.10.3 and earlier versions:

For online (non–air‑gapped) installations, most stanctl lifecycle commands, such as stanctl up fail to run.
For air‑gapped installations, the stanctl commands remain functional.

Required action: Upgrade stanctl to 1.10.4 or later versions before you perform a lifecycle operation.

Example: On online deployments that run stanctl 1.10.3 or earlier versions, any workflow that stops services, such as a stanctl down command, before a backup, cannot complete because the subsequent stanctl up command fails. Upgrade stanctl to 1.10.4 or later versions before you start these steps.

Upgrading to 1.15.x

If you are on Standard Edition 1.13.x or later, you can upgrade to 1.15.x or later.

If you are on Standard Edition 1.9.x versions, you must upgrade to 1.10.4 first before you upgrade to 1.12.x or later.

If you are on Standard Edition 1.8.x or earlier versions, you must upgrade to 1.9.4 first before you upgrade to 1.12.x or later.

Note:

The minimum supported CPU architecture is updated from x86‑64‑v2 to x86‑64‑v3. Before you install or upgrade, verify that all target hosts provide x86‑64‑v3 CPU support.

Upgrading to 1.14.x

If you are on Standard Edition 1.11.x or later, you can upgrade to 1.14.x or later.

If you are on Standard Edition 1.9.x versions, you must upgrade to 1.10.4 first before you upgrade to 1.12.x or later.

If you are on Standard Edition 1.8.x or earlier versions, you must upgrade to 1.9.4 first before you upgrade to 1.12.x or later.

Upgrading to 1.13.x

If you are on Standard Edition 1.10.x, you can upgrade to 1.13.x or later.

If you are on Standard Edition 1.9.x versions, you must upgrade to 1.10.4 first before you upgrade to 1.13.x or later.

If you are on Standard Edition 1.8.x or earlier versions, you must upgrade to 1.9.4 first before you upgrade to 1.13.x or later.

Upgrading to 1.12.x

If you are on Standard Edition 1.10.x, you can upgrade to 1.12.x or later.

If you are on Standard Edition 1.9.x versions, you must upgrade to 1.10.4 first before you upgrade to 1.12.x or later.

If you are on Standard Edition 1.8.x or earlier versions, you must upgrade to 1.9.4 first before you upgrade to 1.12.x or later.

Upgrading to 1.11.x

If you are on Standard Edition 1.10.x, you can upgrade to 1.11.x or later.

If you are on Standard Edition 1.9.x, you must upgrade to 1.10.4 first before you upgrade to 1.11.x or later.

If you are on Standard Edition 1.8.x or earlier versions, you must upgrade to 1.9.4 first before you upgrade to 1.11.x or later.

Upgrading to 1.10.4 or later

If you are on Standard Edition 1.9.x, you can upgrade to 1.10.4.

If you are on Standard Edition 1.8.x or earlier versions, you must upgrade to 1.9.4 first before you upgrade to 1.10.x or later.

Upgrading to 1.9.4

If you are on Standard Edition 1.8.x or earlier versions, you can upgrade to 1.9.4.

Upgrade the stanctl tool

Complete the steps in the section that is applicable to your environment.

Note:

For multi-node cluster, run commands on node0 (instana0).

Online environment

If your Instana host has access to the internet, complete the steps in Installing stanctl command-line tool to upgrade stanctl.

Air-gapped environment

Complete the following steps on your bastion host:

Upgrade stanctl by completing the steps in Installing stanctl command-line tool.
Create the air-gapped installation package.

Then, to upgrade stanctl and to import the new air-gapped package on the Instana host that is in the air-gapped environment, complete the steps in Transferring the air-gapped installation package.

Upgrade the Instana backend

First, complete the steps in Upgrading the stanctl tool that are applicable to your environment.

Then, upgrade the backend.

Note:

For commands to see the list of available Instana backend versions and images, see Instana backend and image versions.

Upgrade the backend

After you decide on the Instana backend upgrade version, complete the following steps to upgrade the backend:

Note:

For multi-node cluster, run commands on node0 (instana0). You do not need to run commands on node1 (instana1) and node2 (instana2) separately.

To start the upgrade, run the following command on the Instana host as applicable.

For the online environment:
```
stanctl up
 
```
For the air-gapped environment:
```
stanctl up --air-gapped
 
```
If an update is available, you see it in the command output. You see a sample output in the following example:
```
? An update is available.
  [Use arrows to move, type to filter]
> Install Instana version: 3.283.450-0
  Proceed without installing the updates
> Cancel
 
```
To upgrade the backend, select Proceed with installing the updates.

You see the ⠇ Setting up the Kubernetes cluster [7s] message. After you set up the cluster, the upgrade completes.