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 Management subsystems on Linux x86_64 instead.

About this task

Table 1 lists the highest (newest) operator version for the current version of API Connect and the previous versions that you can upgrade from.

Table 1. API Connect versions and operators for Cloud Pak for Integration
Cloud Pak for Integration API Connect (operand) API Connect Operator channel Highest API Connect Operator DataPower Operator
2022.4.1 10.0.5.5 v3.5 3.5.0 1.6.10
2022.4.1 10.0.5.4 v3.4 3.4.0 1.6.8
2022.4.1 10.0.5.3 v3.3 3.3.0 1.6.6
2022.4.1 10.0.5.2 v3.2 3.2.0 1.6.3
2022.2.1 10.0.5.1 v3.1 3.1.0 1.6.2
2022.2.1 10.0.5.0 v3.0 3.0.0 1.6

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 v3.5 version.
  3. Start the upgrade to API Connect 10.0.5.5
    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. Click Actions menu next to the API Connect instance that you are upgrading, 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. Click Actions menu next to the API Connect instance that you are upgrading, and select Change version.
    3. In the Select a new channel or version field, look under Channel and select 10.0.5.5 (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 Refresh icon 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.