Upgrading IBM Fusion HCI System management software

This topic outlines the steps to upgrade IBM Fusion HCI System management software from 2.8.2 release to 2.9.0.

Before you begin

Go through the prerequisites before you upgrade. For more information about the prerequisites, see Prerequisites.
If you upgrade IBM Fusion HCI System that is part of a Metro-DR configuration, then see Upgrading a disaster recovery setup.
If you are using a private image registry, mirror the Fusion images to the registry before you upgrade. For the procedure and images to download, see Mirroring IBM Fusion HCI images.
Before you upgrade Fusion operator, you must perform preventive steps so that the operator upgrade does not get stuck. For more information about the steps, see Operator upgrade can get stuck for IBM Fusion HCI System.
Check the compatibility of your underlying storage before you proceed with the upgrade. For more information about the storage version support, see Data services version support matrix and Storage configuration support for multi rack.

About this task

The IBM Fusion HCI System does automatic prechecks during upgrade to help you detect and fix errors.
Upgrade paths:
Source version Target version

2.8.0 2.8.2 > 2.9.0

2.8.1 2.8.2 > 2.9.0

2.8.2 2.9.0
Note: If you use Backup & Restore service, direct upgrade from 2.8.1 or lower to 2.9.0 is not supported because support does not exist for OADP lower then 1.4.1 in 2.9.0. In this case, the upgrade path must be upgrade Fusion and to 2.8.2 first, which should upgrade OADP to 1.4.1 level,and then upgrade to 2.9.0.
In this case, the upgrade path must be as follows:
1. Upgrade IBM Fusion and Backup & Restore to 2.8.2 first. It upgrades OADP to 1.4.1 level.
2. Upgrade IBM Fusion to 2.9.0.

Source version	Target version
2.8.0	2.8.2 > 2.9.0
2.8.1	2.8.2 > 2.9.0
2.8.2	2.9.0

Procedure

Log in to the OpenShift Container Platform management console as a cluster administrator.
From the navigation menu, click Operators > Installed Operators and ensure that you select ibm-spectrum-fusion-ns project.
From the Installed Operators list, select IBM Fusion that is on your existing version. The Details tab opens by default.
Go to Subscription tab and check whether the Update approval is Manual or Automatic. If it is Automatic, change the Update approval to Manual.
Find CatalogSource section in the same tab, click isf-catalog link.

Note: If you upgrade from 4.14 to 4.15 or higher, then it is fusion-catalog and not isf-catalog. For more information about the steps to change the CatalogSource, see catalogsource isf-catalog does not get updated with status.

In the YAML tab, update the value of the image under the spec section to reference the target image.

For online upgrade:


spec:
  displayName: IBM Spectrum Fusion Catalog
  image: 'icr.io/cpopen/isf-operator-catalog:2.9.0-linux.amd64'                <-- Updated index image name
  publisher: IBM
  sourceType: grpc

For upgrade using your enterprise registry:

Here, replace the $TARGET_PATH with your enterprise registry where the images got mirrored.


spec:
  displayName: IBM Spectrum Fusion Catalog
  image: '$TARGET_PATH/isf-operator-catalog:2.9.0-linux.amd64'                 <-- Updated index image name
  publisher: IBM
  sourceType: grpc

Save the YAML.
In the OpenShift Container Platform management console, change the namespace to the ibm-spectrum-fusion-ns and then click the installed IBM Fusion HCI operator.
Approve the install plan manually:
1. Go to the Subscription tab.
2. Click Upgrade available in the Upgrade status section. Alternatively, go to Operators > Installed Operators and click Upgrade available in the Status of the IBM Fusion record.
3. In the InstallPlan details, click Preview InstallPlan. It lists all the install components before approving.
4. Click Approve to begin upgrade.
Wait for the upgrade to complete.
Verify whether the IBM Fusion HCI System management software is in succeeded state and the version is displayed correctly. Also, in the Subscription tab, ensure that the upgrade status displays Up to date.

What to do next

Important: After you upgrade IBM Fusion HCI System, the Backup & Restore service goes to a Unknown state. Upgrade Backup & Restore service for the state to change to Healthy.

If you use IBM Cloud® Satellite, make sure that you update the network type of your IBM Cloud Satellite setup. For the procedure to update the network type, contact IBM support.