Upgrading IBM Fusion HCI management software

This topic outlines the steps to upgrade IBM Fusion HCI management software from 2.9.0 release to 2.10.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 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.
Check the compatibility of your underlying storage before you proceed with the upgrade. For more information about the version support, see 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 does automatic prechecks during upgrade to help you detect and fix errors.
Upgrade path is from 2.9.0 to 2.10.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 fusion-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.10.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 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

Install the following hotfix before you proceed with any other activity: Failed to configure the SNMP settings on the BMC of the node

Otherwise, the SNMP configuration on the BMC of the node fails with an error.

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