Migrating a 1.x CD IBM MQ Operator to version 2.0.x

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

Before you begin

Important: This topic is for upgrading Continuous Delivery (CD) deployments of the IBM MQ Operator prior to version 2.0.x to version 2.0.x only. If this does not apply to your deployment, see 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.

To complete this upgrade, the following requirements for IBM MQ Operator 2.0.0 must be met:

Red Hat OpenShift Container Platform 4.12.
To upgrade, follow the procedure in Upgrading Red Hat OpenShift.
IBM Cloud Pak® foundational services 3.19

Procedure

Before following the link in step 2, you must read the following essential information for your upgrade:
- 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 2021.4):
    - Upgrade your IBM MQ Operator to at least version 1.8.0 in the v1.8 Operator Channel.
    - Upgrade your IBM MQ Operand (Queue Manager Container image) to at least version 9.2.5.0-r3.
      Note: It is recommended that you update your IBM MQ Operand to the current version (9.3.0.25-r1), 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.
Upgrade the IBM MQ Operator and queue managers, by completing Upgrade from IBM MQ Operator 1.8 (IBM Cloud Pak for Integration 2021.4) or earlier CD IBM MQ Operator version.

What to do next

You are now ready to upgrade the IBM MQ Operator and queue managers to the latest CD version (3.1.3). See Migrating to the current CD channel of the IBM MQ Operator.