Upgrading the Platform UI

Upgrade the IBM Cloud Pak Platform UI by upgrading the PlatformNavigator custom resource.

This task must be performed by an administrator. For more information about this role, see OpenShift Roles and permissions.

Before you begin

Review Upgrading before you upgrade the Platform UI. Pay attention to the required order of all upgrade tasks for Cloud Pak for Integration.

Before you can upgrade the instance, the IBM Cloud Pak for Integration operator must already be upgraded. For more information, see Upgrading operators. The upgraded IBM Cloud Pak for Integration operator supports new versions of the Platform UI custom resource. You can confirm what versions are available for a specific instance of Platform UI by checking the status.versions.available section of the custom resource. For more information about available versions, see Operator and instance versions for this release.

Important: Upgrading the Platform UI installs the new identity and access management system. You can configure the identity and access management before upgrading other instances. For more information, see Identity and access management.

Upgrading by using the OpenShift web console

  1. Click to expand Project and select the project in which you deployed the Platform UI.

  2. In the navigation panel, click Operators > Installed Operators.

  3. In the list on the Installed Operators panel, find and click IBM Cloud Pak for Integration.

  4. Click the Platform UI tab.

  5. Click the instance that is listed.

  6. Click YAML. A YAML editor opens.

  7. For spec.version, enter 16.1.0.

  8. For spec.license.license, enter either L-JTPV-KYG8TF or L-BMSF-5YDSLR. For more information about specific licenses, see Licensing.

  9. Save your changes. The Platform UI now begins to upgrade.

  10. Click the Details tab.

  11. Scroll to the end of the page, to the Conditions section. Here you can monitor the progress of the upgrade. Some Error conditions are transient and change back to Pending after a few minutes. The length of time for upgrade can be from between 15 minutes to 1 hour, depending on what version you are upgrading from.

Important: Do not proceed until the Conditions status changes to Ready.

When the upgrade of Platform UI is complete, you can configure identity and access management. For more information, see Identity and access management.

Upgrading by using the CLI

  1. Log into your cluster with your OpenShift user credentials:

    oc login

  2. Get the list of Platform UI instances running on your cluster:

    oc get pn --all-namespaces

  3. Identify the instance you want to upgrade (and the namespace where that instance is deployed) and edit the custom resource:

    oc edit PlatformNavigator <instance-name> -n <namespace>

    This opens the custom resource in your default editor.

    Enter the following values:

    • For spec.version - 16.1.0.

    • For spec.license.license - either L-JTPV-KYG8TF or L-BMSF-5YDSLR. For more information about specific licenses, see Licensing.

    Save your changes. The Platform UI now begins upgrading.

  4. Get the list of Platform UI instances running on your cluster to track the status of the upgrade.

    oc get pn --all-namespaces

What to do next

When the upgrade of Platform UI is complete, regenerate your upgrade plan as described in Upgrading from 2023.4 or Upgrading from 2022.2 to get updated guidance and to validate that you can proceed to the next step.