Migrating to the current CD channel of the IBM MQ Operator

Upgrade from an earlier IBM® MQ Operator to version 3.1.3. Upgrading the operator allows you to upgrade your queue managers.

Before you begin

This topic is for upgrading Continuous Delivery (CD) deployments of the IBM MQ Operator prior to version 3.1.0, to version 3.1.3 only. If this does not apply to your deployment, see the alternative upgrade paths described in Upgrading the IBM MQ Operator and queue managers.

To upgrade to IBM MQ Operator 3.1.3 you must be running Red Hat® OpenShift® Container Platform 4.12 or later. To upgrade the platform, see Upgrading Red Hat OpenShift.

Procedure

Optional: Upgrade an IBM MQ Operator that is currently at a CD version prior to 2.0.0.

If your IBM MQ Operator is currently at a 1.x CD version, first follow the procedure in Migrating a 1.x CD IBM MQ Operator to version 2.0.x, then return here to upgrade to the latest CD version.
Optional: Upgrade an IBM MQ Operator that is currently at version 2.2.x or 2.3.x to 2.4.x.

If your IBM MQ Operator is currently at a 2.2.x or 2.3.x version, follow the relevant steps in Migrating to the v2.4 channel of the IBM MQ Operator, then return here to upgrade to the latest CD version. Note that this is a mandatory prerequisite step before upgrading to version 3.1.3.
Upgrade components.
Choose one of the following options:
- Option 1: If you are a CP4I user, or you have deployed at least one of your queue managers using a CP4I license, follow the relevant steps to upgrade all of your components, including your IBM MQ Operator and queue managers, through the generated upgrade plan:
  - To upgrade from version 2023.2, see Upgrading from 2023.2 by generating an upgrade plan.
  - To upgrade from version 2022.2, see Upgrading from 2022.2 by generating an upgrade plan.
- Option 2: For all other users:
  1. Mirror images (air-gap only).
    You must mirror the IBM MQ images. Complete the steps at the following link, using only these values:
    export OPERATOR_PACKAGE_NAME=ibm-mq export OPERATOR_VERSION=3.1.3
    You should omit section 3.5 "Configure the cluster", because the connection to the image registry should have been set up during previous installs or upgrades.
    
    Link: Mirroring images for an air-gapped cluster.
  2. Upgrade your IBM MQ Operator to 3.1.3.
    See Upgrading the IBM MQ Operator using Red Hat OpenShift.
  3. Upgrade the instances.
    To receive the latest features and security fixes, upgrade the IBM MQ Operand (Queue Manager Container image) to the latest CD version (9.3.5.1-r2). See Upgrading an IBM MQ queue manager using Red Hat OpenShift.
Optional: Upgrade Red Hat OpenShift Container Platform 4.12 to 4.14.

From IBM MQ Operator 3.0.0, Red Hat OpenShift Container Platform 4.12 is required. Note that you can optionally choose to upgrade further to Red Hat OpenShift 4.14. To verify the compatible versions for each IBM MQ Operator channel, see Compatible Red Hat OpenShift Container Platform versions. To upgrade, see Upgrading Red Hat OpenShift.
Optional: Pin the specific catalog source for the IBM MQ Operator.

If the installation that you are upgrading uses the IBM MQ Operator Catalog, you should pin the specific catalog source for the IBM MQ Operator. See Moving to specific catalog sources for each operator.