Upgrading Backup & Restore service

Follow this procedure to upgrade the Backup & Restore version.

Before you begin

Go through the known issues and troubleshooting in Backup & Restore upgrade. See Backup & Restore service installation and upgrade issues.

About this task

Important: Backup & Restore 2.8.1 is not supported on OpenShift® Container Platform 4.16.
When you upgrade the Hub to 2.8, the AMQ streams operator does not get upgraded to the version that is normally installed by a new 2.8 installation. It is because at least one spoke is at a version less than 2.8. This down-level version of AMQ remains on the hub until, at least, you do the next 2.8 upgrade on the Hub.
When you add new Spokes, ensure that they are at the same upgraded version level as the Hub.
After you upgrade IBM Storage Fusion HCI System from 2.7.x to 2.8 or 2.8.1, the Backup & Restore service goes to a Unknown state. Upgrade Backup & Restore service for the state to change to Healthy.
If you plan to do a offline installation in IBM Storage Fusion 2.8.1, mirror the Backup & Restore 2.8.1 images to your enterprise registry. For the procedure and images to download, see Mirroring Backup & Restore images.

Procedure

Log in to IBM Storage Fusion HCI System user interface.
Click Services menu to go to the Services page.
In the Installed section, click Upgrade from the ellipsis menu of Backup & Restore Agent or Backup & Restore hub.
Only if an upgrade is available for Backup & Restore, the Upgrade option is displayed.
The Upgrade pre-check window gets displayed.
In the Upgrade pre-check window, monitor the progress of the pre-checks.
The IBM Storage Fusion HCI System runs prechecks on the ClusterOperatorHealth, CatalogSourceStatus, Registry access, Fusion operator status, DNS resolution, OLM health.
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.
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.
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.
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.

What to do next

Important: Apply the mandatory IBM Storage Fusion 2.8.0 hotfix on top of 2.8.0 version. The hotfix is not required if you migrate to 2.8.1. For more information about how to download the hotfix and the scope of issues covered in the hotfix, see IBM Storage Fusion 2.8.0 hotfix.