Upgrading IBM Storage Fusion

This topic outlines the steps to upgrade IBM Storage Fusion management software, Fusion services, and Red Hat® OpenShift® Container Platform. For IBM Storage Fusion management software, you can upgrade from any version in the 2.7.x release to 2.8.0 and from 2.8.0 to the latest version in the 2.8.x release series.

Before you begin

  • For IBM Storage Fusion 2.8, you must be on IBM Storage Fusion version 2.7.x.
  • For 2.8.2, you must be at a minimum level of 2.8.0. If you are already on 2.8.1, upgrade to 2.8.2.
  • If you installed the existing version of IBM Storage Fusion using online or your enterprise registry installation mode, then ensure that you do not change the mode during the upgrade to 2.8.x version. To change the installation mode, reinstall IBM Storage Fusion.
  • Download the logs that you collected by using IBM Storage Fusion. The Collect logs user interface page gets deleted after the upgrade process completes so download the needed logs before you begin the upgrade.
  • If you installed the earlier version of IBM Storage Fusion by using your enterprise registry, then do these additional mirroring prerequisites steps. See Prerequisites for enterprise registry upgrade.
  • Before you upgrade, go through the supported storage services in IBM Storage Fusion, see Storage version support matrix.
  • Because of a known Red Hat issue, the Fusion operator upgrade can get stuck during upgrade. Run the following commands before you begin the IBM Storage Fusion operator upgrade to prevent this scenario.
    
oc project $(oc get spectrumfusion -A -o custom-columns=NS:metadata.namespace --no-headers)
oc get fusionserviceinstance -o jsonpath='{.items[*].metadata.name}' |tr ' ' '\n' | xargs -I {} oc patch fusionserviceinstance {} --type=merge --subresource=status -p '{"status": {"triggerCatSrcCreateStartTime": 0}}'
oc get fusionserviceinstance -o jsonpath='{.items[*].metadata.name}' |tr ' ' '\n' | xargs -I {} oc patch fusionserviceinstance {} --type=merge --subresource=status -p '{"status": {"currentInstallStartTime": 0}}'
oc get fusionserviceinstance -o jsonpath='{.items[*].metadata.name}' |tr ' ' '\n' | xargs -I {} oc patch fusionserviceinstance {} --type=merge --subresource=status -p '{"status": {"operatorLastUpdateTime": 0}}'
oc get fusionserviceinstance -o jsonpath='{.items[*].metadata.name}' |tr ' ' '\n' | xargs -I {} oc patch fusionserviceinstance {} --type=merge --subresource=status -p '{"status": {"operatorUpgradeStartTime": 0}}'
oc get fusionservicedefinition -o jsonpath='{.items[*].metadata.name}' |tr ' ' '\n' | xargs -I {} oc patch fusionservicedefinition {} --type=merge -p '{"spec": {"serviceInformation": {"lastUpdated": 0}}}'

About this task

Upgrade paths for Fusion operator:
Source IBM Storage Fusion version Target IBM Storage Fusion version
2.7.x 2.8.0
2.8.0 2.8.2
2.8.1 2.8.2
Note: Do not upgrade to IBM Storage Fusion management software 2.8.1.

Procedure

  1. Log in to the OpenShift Container Platform management console as the cluster administrator.
  2. Upgrade IBM Storage Fusion:
    1. From the navigation menu, click Operators > Installed Operators.
    2. From the Installed Operators list, click IBM Storage Fusion operator.
      The Details tab opens by default.
    3. Go to Subscription tab.
    4. View the Subscription details section for the upgrade status.
      Note: If this is an offline setup, then update the image path in IBM Storage Fusion catalog source with new catalog source image.
    5. If an upgrade is available for the operator, then click Approve to manually initiate the upgrade. If you do not agree to the upgrade, click Deny.
      Note: You can ignore this step if you have set auto-approval to true. By default, the upgrade of the IBM Storage Fusion is Automatic. However, you can change it to Manual.
      If no new upgrade is available, then Upgrade status displays Up to date.
    6. After the upgrade is successful, refresh your browser and clear your cache.
    7. Verify whether the IBM Storage Fusion is in succeeded state and the version is 2.8.0 or 2.8.2. Also, in the Subscription tab, ensure that the upgrade status displays Up to date.
  3. Upgrade IBM Storage Fusion services.
    For the steps to upgrade services, see Upgrading IBM Storage Fusion services.
  4. Upgrade Red Hat OpenShift Container Platform from Red Hat OpenShift Container Platform console.
    Note: The Red Hat OpenShift Container Platform version must be upgraded only to the version supported by IBM Storage Fusion. Do not upgrade or rollback your Red Hat OpenShift Container Platform version manually until the support is included in IBM Storage Fusion.
    For the upgrade procedure, Red Hat OpenShift Container Platform, see Understanding OpenShift Container Platform updates.