Upgrading the instance of API Connect on IBM Z

Upgrade the instance of API Connect (containing the Management and Portal subsystems) that was installed on Linux for IBM Z for use in IBM Cloud Pak® for Integration.

Before you begin

This task applies only to deployments where the Management and Portal subsystems were installed as the API Connect instance on Linux for IBM Z. If you installed all subsystems on Linux x86_64, follow the instructions in Upgrading all API Connect cluster subsystems on amd64 instead.

Procedure

  1. Upgrade the Platform UI as explained in Upgrading the Platform UI.
  2. Use the OpenShift web console to upgrade the API Connect operator by changing the subscription channel to the v5.2-sc2 version.
  3. Start the upgrade to API Connect v10.0.8.7.
    1. In the Platform UI dashboard, click Integration instances.
    2. Verify that the status displays "Ready" for your instance.
      Attention: The operator must be fully upgraded before you proceed to the next step.
    3. Next to the API Connect instance that you are upgrading, click to open the actions menu and select Edit.
    4. Click Update.
  4. Complete the upgrade for API Connect by updating the channel and selecting a new license.
    1. In the Platform UI dashboard, click Integration instances.
    2. Next to the API Connect instance that you are upgrading, click to open the actions menu and select Change version.
    3. In the Select a new channel or version field, select the new version (do not confirm the change yet -- wait until you accept the new license in step 4.e).
    4. In the list of licenses, select the license that matches your entitlement.

      To review the available License IDs for API Connect, see API Connect licenses in the API Connect documentation.

    5. Click the License accept toggle to enable it and apply the new license.
    6. Click Change version to save your selections and start the upgrade.
    7. When the confirmation message displays, click to refresh the Integration instances page.

      The Status for the instance displays as "Pending" message during the upgrade. The upgrade is complete when the Status is "Ready" and the Version displays the new version number.

What to do next

Proceed to Upgrading the Gateway subsystem on Linux x86_64.