Upgrading Self-Hosted Classic Edition (Docker)

To upgrade Classic Edition, follow these steps:

Upgrading a single-host Docker setup
Upgrading a dual-host Docker setup
Upgrading an air-gapped Docker setup
- On the external VM (Internet access required)
- On the target VM (No internet access required)

The upgrade policy provides that at most one release can be skipped, that is, it's possible to upgrade from release 245-x to release 247-x or release 249-x, but no further. If the policy does not allow you to do the required upgrade in one go, then you need to carry out more than one upgrade step.

Upgrading a single-host Docker setup

To upgrade a single-host Docker setup, follow the steps:

Upgrade your Instana console to a target version. For more information, see Upgrading the Instana console.
Upgrade your Instana backend. For more information, see Upgrading your Instana backend.

Upgrading a dual-host Docker setup

To upgrade a dual-host Docker setup, follow the steps:

Upgrade your Instana console to a target version on your ClickHouse host. For more information, see Upgrading the Instana console.
On the host machine where Instana is deployed, do the following actions:
1. Upgrade your Instana console to a target version on your Instana host. For more information, see Upgrading the Instana console.
2. Upgrade your Instana backend on your Instana host. For more information, see Upgrading your Instana backend.

Upgrading an air-gapped Docker setup

You can upgrade an air-gapped Docker setup either on the external virtual machine (VM) or on the target VM.

On the external VM (Internet access required)

Download and install the Instana console application.

The yum --showduplicates command populates a list of available versions of the Instana console application.

yum --showduplicates list instana-console
(...)
instana-console.x86_64   259_3-1   instana-product
instana-console.x86_64   259_4-1   instana-product
instana-console.x86_64   261_0-1   instana-product
instana-console.x86_64   261_1-1   instana-product
instana-console.x86_64   261_2-1   instana-product
instana-console.x86_64   263_0-1   instana-product
instana-console.x86_64   263_1-1   instana-product
instana-console.x86_64   263_2-1   instana-product
instana-console.x86_64   263_3-1   instana-product
instana-console.x86_64   265_0-1   instana-product

By using the Instana console, download all the required Instana images.
Export the Instana console application and Instana images to the air-gapped VM.

The following instana images export -k DOWNLOAD_KEY command downloads the Instana images to a .tar file, which can then be exported to an air-gapped VM:
```
instana images export -k DOWNLOAD_KEY
Images export ⣯ pull artifact-public.instana.io/backend/butler:3.265.276-0
(...)
-rw------- 1 root    root    8295586304 Feb  8 01:38 export-265-1.tar
```
The size of the Instana .tar file is ~8 GB.

On the target VM (No internet access required)

Install or update instana-console to the required version, see Upgrading the Instana console.

The following yum install --downloadonly command downloads instana-console to a specific location, and then you can export the file to the VM with no internet access:

yum install -y --downloadonly --downloaddir=/opt/instana instana-console-265_1-1
(...)
-rw-r--r-- 1 root    root      30581559 Feb 12 02:41 instana-console-265_1-1.x86_64.rpm

The following yum localinstall command installs the package from the local file (for example: Red Hat Package Manager (RPM)):

yum localinstall instana-console-259_2-1.x86_64.rpm
(...)
Total size: 29 M
Is this ok [y/N]: Y
Downloading Packages:
Running transaction check
Transaction check succeeded.
Running transaction test
Transaction test succeeded.
Running transaction
 Preparing        :                                                                                                                                                     1/1
 Upgrading        : instana-console-265_1-1.x86_64                                                                                                                      1/2
 Cleanup          : instana-console-259_2-1.x86_64                                                                                                                      2/2
 Running scriptlet: instana-console-259_2-1.x86_64                                                                                                                      2/2
 Verifying        : instana-console-265_1-1.x86_64                                                                                                                      1/2
 Verifying        : instana-console-259_2-1.x86_64                                                                                                                      2/2
 Installed products updated.

 Upgraded:
 instana-console-265_1-1.x86_64

Import the Instana images by using the following command:
```
instana images import -f /opt/instana/export-265-0.tar
```
The update procedure fails if the instana-console version is not supported.
Run Instana update process by using the following command:
```
instana update -f settings.hcl
```