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, Global Data Platform storage support for multi rack, and Fusion Data Foundation storage 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.
1. 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
```
2. For upgrade using your enterprise registry:
  Apply the catalog source from the mirrored location
  1. Go to the directory that contains the image-set-config.yaml file that is referenced in the IBM Fusion mirroring instructions. See Mirroring IBM Fusion HCI images.
```
cd /root/.ibm-pak/data/mirror/${CASE_NAME}/${CASE_VERSION}/
```
    This directory contains multiple files that were generated automatically by CloudPak.
  2. Apply the generated IBM Fusion catalogsource file to your cluster:
```
oc apply -f catalog-sources-linux-amd64.yaml
```
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.