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 plan to do a offline installation, mirror the Global Data Platform 5.2.1.1 images to your enterprise registry. For the procedure and images to download, see Mirroring IBM Storage Scale images.
  • Make sure no Backup & Restore jobs are running.

About this task

You can perform service upgrades from the Services page or the Settings > Upgrades page of the IBM Fusion user interface.

For more information about the storage version support, see Data services version support matrix.

Procedure

  1. Log in to IBM Fusion HCI System user interface.
  2. Click Services menu to go to the Services page.
    Note: Alternatively, you can go to the Settings > Upgrades page and view the upgrade status and in progress upgrades. The Global Data Platform goes into rolling upgrade. If you can run service upgrades in parallel in a non-disruptive manner, click Upgrade (<number of upgrades available>). If there are any errors found in the automatic prechecks, then click the service tile for more details about the error.
  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 Fusion HCI System runs prechecks on conditions that impact the upgrade of the service. To know more about the prechecks and its coverage, see the user interface.

    If all the checks pass or there are some conditions in warning state, you can proceed with the upgrade. However, it is highly recommended to fix the warnings to prevent any potential impacts on the system during the upgrade process. Immediately address any blocker errors encountered during prechecks, as they require fixing before proceeding with the 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 upgrade details link in the Services page. The IBM 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). Alternatively, click the service tile in error state in the Settings > Upgrades page to view the Upgrade pre-check report with Blocking issues and Issues (optional) issues.
      You can also view the parallel upgrades from Settings > Upgrades page.
    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 or the Upgrade page of the IBM Fusion HCI System user interface and click Upgrade.
  6. After the pre-checks complete without any blocker issues, click Upgrade now.
  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 View details section of the individual sections, you can click the resource link to know more details about it.
  8. Wait for the upgrade to complete.
    After the completion of the upgrade, a success notification gets displayed.
    If you want to disable the kdump after a successful upgrade of Global data platform, see and follow the instructions for Disabling kdump.
    Note: The upgrade consumes more time depending on the number of compute nodes in the rack.

    To view the status of the upgrade, go to Settings > Upgrade or the Services page.

    If you see “Service upgrade has failed” message, see View details on the right pane for more details. If you are not able to fix the issue, contact IBM support.