Upgrading Self-Hosted Standard Edition

Edit online

Upgrade Standard Edition and the stanctl tool.

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

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.