Upgrading IBM Storage Fusion HCI System management software

This topic outlines the steps to upgrade IBM Storage Fusion HCI System management software from any version in the 2.7.x release to 2.8.0 and from 2.8.0 to the latest version (2.8.2) in the 2.8.x release series. If you are already on 2.8.1, then you can use this procedure to upgrade to 2.8.2. The upgrade from the base version to any increment of that version can be performed in a single upgrade step, avoiding a series of incremental updates in between.

Before you begin

  • Go through the prerequisites before you upgrade. For more information about the prerequisites, see Prerequisites.
  • Go through the following considerations that impact the IBM Storage Fusion HCI System upgrade procedure:
    • The IBM Storage Fusion HCI System does automatic prechecks during upgrade to help you detect and fix errors. Go through the automated prechecks for better planning. For more information about the prechecks, see Prechecks.
  • If you upgrade IBM Storage 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 Storage Fusion HCI images.

About this task

  • This procedure outlines how to upgrade the Fusion operator. To accomplish the task, edit the CatalogSource to indicate the new image path, and then approve the install plan. It accomplishes the upgrade of IBM Storage Fusion HCI System 2.7.x to the 2.8.0, 2.8.0 to 2.8.2, or 2.8.1 to 2.8.2. You do not have to upgrade to 2.8.1 prior to the upgrade of 2.8.2.
  • Upgrade paths:
    Source version Target 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 HCI System management software 2.8.1.

Procedure

  1. Log in to the OpenShift® Container Platform management console as a cluster administrator.
  2. From the navigation menu, click Operators > Installed Operators and ensure that you select ibm-spectrum-fusion-ns project.
  3. From the Installed Operators list, select IBM Storage Fusion that is on your existing version. The Details tab opens by default.
  4. Go to Subscription tab and check whether the Update approval is Manual or Automatic. If it is Automatic, change the Update approval to Manual.
  5. 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.
  6. In the YAML tab, update the value of the image under the spec section to reference the target image.
    1. For online upgrade:
      2.8.0
      
spec:
  displayName: IBM Spectrum Fusion Catalog
  image: 'icr.io/cpopen/isf-operator-catalog:2.8.0-linux.amd64'                <-- Updated index image name
  publisher: IBM
  sourceType: grpc
      2.8.2
      
spec:
  displayName: IBM Spectrum Fusion Catalog
  image: 'icr.io/cpopen/isf-operator-catalog:2.8.2-linux.amd64'                <-- Updated index image name
  publisher: IBM
  sourceType: grpc
    2. For upgrade using your enterprise registry:

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

      2.8.0
      
spec:
  displayName: IBM Spectrum Fusion Catalog
  image: '$TARGET_PATH/isf-operator-catalog:2.8.0-linux.amd64'                 <-- Updated index image name
  publisher: IBM
  sourceType: grpc
      2.8.2
      
spec:
  displayName: IBM Spectrum Fusion Catalog
  image: '$TARGET_PATH/isf-operator-catalog:2.8.2-linux.amd64'                 <-- Updated index image name
  publisher: IBM
  sourceType: grpc
  7. Save the YAML.
  8. In the OpenShift Container Platform management console, change the namespace to the ibm-spectrum-fusion-ns and then click the installed IBM Storage Fusion HCI operator.
  9. 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 Storage Fusion record.
    3. In the InstallPlan details, click Preview InstallPlan. It lists all the install components before approving.
    4. Click Approve to begin upgrade.
  10. Verify whether the IBM Storage 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

  • Upgrade Fusion services. For more information about upgrade, see Upgrading IBM Storage Fusion HCI System services.
  • 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.