I haven't worked with the kubernetes based deployments. But, for a single server deployment of a self-hosted environment, these are the steps.
To get your current instana version:
instana versionTo get a list of all available versions:
apt-cache policy instana-consolePrevious command returns something like you see below:
instana-console:
Installed: 203-3
Candidate: 207-1
Version table:
207-1 500
500
https://self-hosted.instana.io/apt generic/main amd64 Packages
207-0 500
500
https://self-hosted.instana.io/apt generic/main amd64 Packages
205-2 500
To update to a specific version:
apt install instana-console=207-1
Finally, upgrade the server using:
instana update
or:
instana update -f <path to settings.hcl>
Remember, you should only upgrade 2 releases at a time.
------------------------------
Ben Stern
Executive IT Specialist / Monitoring and Analytics Best Practices and Technical Evangelist
IBM
Durham NC
919-224-1593
------------------------------
Original Message:
Sent: Fri October 01, 2021 03:54 AM
From: Mark Delaney
Subject: IBM Observability by Instana - Upgrading between versions
Hi. For IBM customers who are using the IBM Observability by Instana software from Passport Advantage or Software Access Catalog, what is the correct method to upgrade between releases for on-prem installations with docker containers? The supplied Readme file says to use the latest version of instana-console, import the docker images that are bundled with the software and then issue instana update. This produces an error message that direct updates are not possible.
Installed version: IBM Observability by Instana Application Performance Monitoring 1.0.203 Install English (G01Q1EN )
Latest version: IBM Observability by Instana Application Performance Monitoring 1.0.209 Install Multilingual (G02K5EN )
./instana update -f ~/settings.hcl
Setup host environment ✓
Handle certificates ✓
A direct update from version 203 to 209 is not supported. The latest supported version is 205
On Software Access Catalog, IBM Observability by Instana has releases with the following versions: 1.0.209, 1.0.203, 1.0.197 and 1.0.193 so there is no interim release such as 1.0.205 to upgrade to first. I've had the same issue previously with "A direct update from version 197 to 203 is not supported. The latest supported version is 199".
I raised this with Instana and they said "When updating, you can only skip one version. For example, from 203 to 207, and after this, you can update from 207 to 209.".
-----------------------------------
Mark Delaney
SYSTEMSMANAGED Ltd
-----------------------------------