Upgrading Data Cataloging service

Steps to upgrade Data Cataloging service.

Before you begin

If you plan to do a offline installation in IBM Storage Fusion 2.8.0 or 2.8.1, mirror the Data Cataloging 2.8.0 or 2.8.1 images accordingly to your enterprise registry. For the procedure and images to download, see Mirroring Data Cataloging images.

About this task

Sometimes, the Data Cataloging service upgrade may not be available after you upgrade IBM Storage Fusion. To know more about such issues and its resolutions, see Troubleshooting Data Cataloging service upgrade issues.

Important: If you have OpenShift® Container Platform version 4.15, then you cannot use Data Cataloging service.

Procedure

  1. Log in to IBM Storage Fusion HCI System user interface.
  2. Click Services menu to go to the Services page.
  3. In the Installed section, click Upgrade from the ellipsis menu of Data Cataloging.
    Only if an upgrade is available for Data Cataloging, the Upgrade option is displayed.
    The Upgrade pre-check window gets displayed.
  4. In the Upgrade pre-check window, monitor the progress of the pre-checks.
    The IBM Storage Fusion HCI System runs prechecks on the clusterOperatorHealth, OLM health, Catalog source health, registry access, Fusion operator status, DNS resolution.

    If all the checks pass or there are some conditions in warning state, you can proceed with the upgrade. Whenever blocker errors are found in prechecks, you cannot proceed with upgrade instead you must fix the issue to continue with upgrade.

    After the completion of all pre-checks, a summary of total number of issues found gets displayed. If there are no blocker issues, go to step 6.

  5. If there are blocker issues, do the following steps:
    1. To know more about blockers or warnings, click View details link.
      The IBM Storage Fusion HCI System user interface takes you to the Services page wherein a Upgrade pre-check report window displays all the Blocking issues and Issues (optional).
    2. Click on the corresponding BMYxxxxxx code to know more about how to fix the issue.
      If you find error resources in the Resources section of the individual issues, you can click the resource link to know more details about it.
    3. Fix all the blocking issues based on the guidance.
    4. Return to the Services page of the IBM Storage Fusion HCI System user interface and click Upgrade.
  6. After the pre-checks complete without any blocker issues, click Upgrade now.
    To know more details about the upgrade that is progress, click View details in the notification tab of the Services page. A slide out pane displays the following details:
    • Progress percentage
    • Upgrade pre-check. As this is complete, a check mark appears and the status shows complete.
    • Upgrade in progress.
  7. Wait for a minute or more for the upgrade to complete.
    After the completion of upgrade, a success notification gets displayed.
    Note: The upgrade consumes more time depending on the number of compute nodes in the rack.

    If you see “Service upgrade has failed” message, then wait for the upgrade to retry automatically. If issues do not exist in your setup, then upgrade completes successfully, or else you can contact IBM support.