Upgrading Global Data Platform

Upgrade Global Data Platform service.

Before you begin

  • Optionally, before you upgrade the Global Data Platform, enable kdump to save the core that gets created in the event of any IBM Storage Scale crash. You need the core dump for debugging and analysis. For the steps to enable kdump, see Enabling kdump.
  • Run the following command to check the pidslimits.
    
for node in `oc get nodes -o name`; do oc debug $node -- chroot /host grep podPidsLimit /etc/kubernetes/kubelet.conf; done
    Example output:
    for node in `oc get nodes -o name`; do  oc debug $node -- chroot /host grep podPidsLimit  /etc/kubernetes/kubelet.conf; done
Starting pod/compute-1-ru5rackm02mydomaincom-debug ...
To use host binaries, run `chroot /host`
  "podPidsLimit": 12228,

Removing debug pod ...
Starting pod/compute-1-ru6rackm02mydomaincom-debug ...
To use host binaries, run `chroot /host`
  "podPidsLimit": 12228,

Removing debug pod ...
Starting pod/compute-1-ru7rackm02mydomaincom-debug ...
To use host binaries, run `chroot /host`
  "podPidsLimit": 12228,

Removing debug pod ...
    Note: Ensure that the pidslimit is not lesser than 12228 for each node in any condition.
  • If you want to continue to use Global Data Platform 5.1.9.x, then you can upgrade IBM Storage Fusion HCI System to 2.8.0 but must not upgrade OpenShift® Container Platform from version 4.12. Ensure you do not upgrade Global Data Platform without upgrading OpenShift Container Platform first.
  • If you want to use Global Data Platform storage in 2.8.1, do not upgrade OpenShift Container Platform to 4.16.
  • If you want to continue to use Global Data Platform 5.2.0.0, then the OpenShift Container Platform version must be higher than 4.13.
  • If you plan to do a offline installation in IBM Storage Fusion 2.8.1, mirror the Global Data Platform 5.2.0.1 images to your enterprise registry. For the procedure and images to download, see Mirroring IBM Storage Scale images.

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 Global data platform.
    Only if an upgrade is available for Global data platform, 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 cluster operator health, compute health, DNS resolution, Fusion operator status, PID limit, disk health, version, Machine configuration pool (MCO) status, Red Hat® OpenShift Container Platform version, OpenShift node status, Registry accessibility, storage cluster health, Virtual Machine PVC RWO access mode, PDB, Daemon network, and disaster recovery.

    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 you want to disable the kdump after a successful upgrade of Global data platform, see and follow the instructions for Disabling kdump.

  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. When the upgrade is in progress, in the side panel, you can click view details link for advanced monitoring.
    If you find error resources in the Resources section of the individual sections, you can click the resource link to know more details about it.
  8. 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.

What to do next

Important: Apply the mandatory IBM Storage Fusion 2.8.0 hotfix on top of 2.8.0 version. For more information about how to download the hotfix and the scope of issues covered in the hotfix, see Hotfixes.