Upgrading Self-Hosted 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 will fail to run.
For air‑gapped installations, the stanctl commands continue to work.

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.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.

Upgrading the stanctl tool

Edit online

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

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

Online environment

Edit online

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

Air-gapped environment

Edit online

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.

Upgrading the Instana backend

Edit online

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.

Upgrading the backend

Edit online

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, it’s shown in the command output. A sample output is shown 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 the cluster is set up, the upgrade is complete.