[OpenShift Container Platform][IBM Cloud Pak for Integration][IBM MQ Operator 2.0.0]

Migrating to the LTS channel of the IBM MQ Operator

Upgrading the IBM® MQ Operator allows you to upgrade your queue managers.

Before you begin

Important: This topic is for upgrading deployments of the 1.3.x Long Term Support (LTS) IBM MQ Operator to the LTS stream of IBM MQ Operator 2.0.x only. If this does not apply to your deployment, see the alternative upgrade paths described in Upgrading the IBM MQ Operator and queue managers.

For deployments of the IBM MQ Operator in a Red Hat® OpenShift® cluster that has no internet connectivity, follow the procedure in Preparing to upgrade to the latest IBM MQ 2.x Operator or queue manager in an air-gap environment.

Important: IBM MQ Operator 2.0.x requires:
  • Red Hat OpenShift Container Platform 4.12.

    To upgrade, follow the procedure in Upgrading Red Hat OpenShift.

  • IBM Cloud Pak® foundational services 3.19.x

When you upgrade from IBM MQ Operator 1.3.x (2020.4), both instances of a multi-instance queue manager are restarted simultaneously. This occurs when you change the version of IBM MQ to 9.2.0.5-r3-eus. There is a rolling update of the IBM MQ queue manager when you upgrade from IBM MQ Operator 1.3.x to 2.0.x. If you have the IBM Cloud Pak for Integration Platform UI installed, there are additional restarts of IBM MQ when changing the version of the IBM Cloud Pak for Integration Platform UI to 2020.4.1-8-eus, and to 2022.2.1-0.

Procedure

  1. Before following the link in step 2, you must read the following essential information for your upgrade:
    • You should omit all substeps for components you do not have installed. This includes the IBM Cloud Pak for Integration Platform UI if you do not have this installed.
    • Step 2 takes you to the IBM Cloud Pak for Integration documentation. During the upgrade process you are brought back to the following IBM MQ topic, to upgrade the IBM MQ Operand: Upgrading an IBM MQ queue manager.
    • All IBM MQ users are recommended to complete at least the following tasks, using the instructions from the link in step 2, as well as any others that apply to your environment:
      • Patch IBM MQ Operator and operand (Patching 2020.4):
        • Upgrade your IBM MQ Operator to at least version 1.3.5 in the v1.3-eus Operator Channel.
        • Upgrade your IBM MQ Operand (Queue Manager Container image) to at least version 9.2.0.5-r3-eus.
          Note: It is recommended that you update your IBM MQ Operand to at least this version, but this is not mandatory.
      • Upgrade dependencies:
        • Upgrade IBM Cloud Pak foundational services.
        • Upgrade OpenShift Container Platform.
      • Upgrade the operators:
        • Upgrade IBM MQ Operator to 2.0.29.
      • Upgrade the capabilities:
        • Upgrade IBM MQ Operand (Queue Manager Container image) to the latest 9.3.0 version (9.3.0.25-r1) to receive the latest security fixes.
  2. Upgrade the IBM MQ Operator and queue managers, by completing Upgrade from IBM MQ Operator 1.3-eus (IBM Cloud Pak for Integration 2020.4).