Steps to upgrade

SUSE Observability Self-hosted

To upgrade from StackState 6.0 to SUSE Observability follow the migration guide.

Overview

This document describes the upgrade procedure for SUSE Observability.

Before you upgrade

When executing a SUSE Observability upgrade, be aware of the following:

Always read the version-specific upgrade notes before upgrading SUSE Observability.

When upgrading a StackPack, any changes you have made to configuration items from that StackPack will be overwritten. See Configuration Locking for more information.

If there are hotfixes installed in your SUSE Observability installation, contact SUSE Observability technical support prior to upgrading.

Steps to upgrade

Minor or maintenance SUSE Observability release

A minor release of SUSE Observability is indicated by a change in the second digit of the version number, for example 4.1.0. Maintenance releases are identified by a change in the third digit of the version number, for example 4.1.1.

If you are upgrading to a new minor SUSE Observability release or a maintenance release, SUSE Observability itself and the StackPacks will be compatible with the current installation.

A minor upgrade consists of the following steps:

1. Create a backup

2. Upgrade SUSE Observability

3. Verify the new installation

4. Check if any installed StackPacks require an upgrade

Major SUSE Observability release

A major release of SUSE Observability is indicated by a change in the first digit of the version number, for example 4.0.0.

If you upgrade to a new major SUSE Observability release, SUSE Observability and the installed StackPacks may be incompatible with the current installation. For details, check the version-specific upgrade notes.

A major upgrade consists of the following steps:

1. Create a backup
2. Optional: Uninstall StackPacks
3. Upgrade SUSE Observability
4. Optional: Install StackPacks
5. Verify the new installation

Walkthrough of an upgrade

Create a backup

Before upgrading SUSE Observability it's recommended to back up your configuration and topology data:

• Kubernetes backup
• Configuration backup

Note that it won't be possible to restore the backup on the upgraded version of SUSE Observability. The SUSE Observability backup can only be restored in the SUSE Observability version before the upgrade.

Upgrade SUSE Observability

Be sure to check the release notes and any optional upgrade notes before running the upgrade.

Kubernetes

1. Get the latest helm chart by running helm repo update.

2. Check the version specific upgrade notes for all changes between your current version and the version that you will upgrade to. If there have been changes made to configuration items specified in your values.yaml file, the file should be updated.
3. To upgrade, use the same helm command as for the first time Kubernetes installation. The new helm chart will pull newer versions of Docker images and handle the upgrade.

OpenShift

1. Get the latest helm chart by running helm repo update.

2. Check the version specific upgrade notes for all changes between your current version and the version that you will upgrade to. If there have been changes made to configuration items specified in your values.yaml file, the file should be updated.
3. Update the openshift-values.yaml file.
4. To upgrade, use the same helm command as for the first time OpenShift installation. The new helm chart will pull newer versions of Docker images and handle the upgrade.

Verify the new installation

Once SUSE Observability has been upgraded and started, verify that the new installation of SUSE Observability is reachable and that the application is running.

See also

• Manually upgrade a StackPack
• Version-specific upgrade notes