[OpenShift Container Platform][IBM Cloud Pak for Integration]

Upgrading an IBM MQ queue manager using Red Hat OpenShift

An IBM® MQ queue manager, deployed using the IBM MQ Operator, can be upgraded in Red Hat® OpenShift® by using any of the following interfaces: Operator Hub; Command Line; IBM Cloud Pak® for Integration Platform UI.

Before you begin

Note: To upgrade an IBM MQ queue manager deployed by using the IBM MQ Operator on Amazon EKS, see Upgrading IBM MQ queue managers on Amazon EKS.

As part of the process to upgrade the IBM MQ queue managers, you might have been sent to this topic from the IBM Cloud Pak for Integration documentation.

Note:
  • The latest CD version of the IBM MQ queue manager is 9.4.5.0-r2.
  • The latest SC2 version of the IBM MQ queue manager is 9.4.0.20-r1.
For the latest IBM MQ queue manager release notes, see Release history for queue manager container images.

Ensure that your IBM MQ Operator is at the required version. To upgrade your IBM MQ Operator, see Upgrading the IBM MQ Operator on Red Hat OpenShift.

Before you can upgrade the queue manager in an air-gap environment, you must mirror the latest IBM Cloud Pak for Integration images through the air-gap specific steps that are completed during an upgrade of the IBM MQ Operator. For an example of these steps, see Upgrading to the current CD channel of the IBM MQ Operator on Red Hat OpenShift.

About this task

This task offers three options for upgrading an IBM MQ queue manager that is deployed on OpenShift:

  1. Upgrading an IBM MQ queue manager using the Red Hat OpenShift console.
  2. Upgrading an IBM MQ queue manager using the Red Hat OpenShift CLI
  3. Upgrading an IBM MQ queue manager in Red Hat OpenShift using the Platform UI

Procedure

  • Option 1: Upgrading an IBM MQ queue manager using the Red Hat OpenShift console.
    1. Log in to your Red Hat OpenShift cluster web console.
    2. From the navigation pane, click Operators > Installed Operators.
      All installed Operators in the specified project are displayed.
    3. Select the IBM MQ Operator.
      The IBM MQ Operator window is displayed.
    4. Navigate to the Queue Manager tab.
      The Queue Manager Details window is displayed.
    5. Select the queue manager that you want to upgrade.
    6. Navigate to the YAML tab.
    7. Update the following fields, where necessary, to match the desired IBM MQ queue manager version upgrade.
      • spec.version
      • spec.license.licence

      See Release history for queue manager container images for a mapping of IBM MQ Operator versions and IBM MQ queue manager container images.

    8. Save the updated queue manager YAML.
  • Option 2: Upgrading an IBM MQ queue manager using the Red Hat OpenShift CLI
    1. Log in to the Red Hat OpenShift command line interface (CLI) using oc login.
    2. Edit the QueueManager resource to update the following fields, where necessary, to match the desired IBM MQ queue manager version upgrade.
      • spec.version
      • spec.license.licence
      See Version support for the IBM MQ Operator for a mapping of channels to IBM MQ Operator versions and IBM MQ queue manager versions.
      Use the following command:
      oc edit queuemanager my_qmgr
      where my_qmgr is the name of the QueueManager resource that you want to upgrade.
  • Option 3: Upgrading an IBM MQ queue manager in Red Hat OpenShift using the Platform UI.

    Follow the relevant instructions in Managing versions and upgrades by using the Platform UI in the IBM Cloud Pak for Integration documentation.