Upgrading the IBM MQ Operator using Red Hat OpenShift

The IBM® MQ Operator can be upgraded from the Red Hat® OpenShift® console or command line.

• Option 1 : Upgrade the IBM MQ Operator using the Red Hat OpenShift console.
  1. Log into your Red Hat OpenShift cluster console.
  2. Mirror images (air-gap only).
     If your cluster is in a restricted (air-gapped) network environment, you must mirror the IBM MQ images using the following values:

     export OPERATOR_PACKAGE_NAME=ibm-mq
     export OPERATOR_VERSION=3.9.0

     For information about the contents of the IBM MQ CASE, which is used for air-gap installs and upgrades, see IBM MQ CASE for air-gap install and upgrade.

     To create mirror images, see Mirroring images for an air-gapped cluster.

  3. Apply latest Catalog source.

     If you are using the specific catalog source for the IBM MQ Operator, rather than the ibm-operator-catalog, you must apply the catalog source for the new IBM MQ version.

     To move from using the IBM Operator Catalog to using the specific catalog source for the IBM MQ Operator, and gain greater control over upgrades, refer to the steps in Moving to the specific catalog source for the IBM MQ Operator before returning to complete the next step.

     If you are using the IBM Operator catalog (some online installs only), proceed to the next step.

     Otherwise, follow the instructions in Adding the IBM MQ Operator catalog source then proceed to the next step.

  4. Upgrade the IBM MQ Operator. New major/minor IBM MQ Operator versions are delivered through new Subscription Channels. To upgrade your Operator to a new major/minor version, you need to update the selected channel in your IBM MQ Operator Subscription.
     1. From the navigation pane, click Operators > Installed Operators.

        All installed Operators in the specified project are displayed.

     2. Select the IBM MQ Operator.
     3. Navigate to the Subscription tab.
     4. Click the Channel.

        The Change Subscription Update Channel window is displayed.

     5. Select the desired channel, then click Save.

        The operator upgrades to the latest version available to the new channel. See Version support for the IBM MQ Operator.

• Option 2 : Upgrade the IBM MQ Operator using the Red Hat OpenShift command line.
  1. Log into your cluster using oc login.
  2. Mirror images (air-gap only).
     If your cluster is in a restricted (air-gapped) network environment, you must mirror the IBM MQ images using the following values:

     export OPERATOR_PACKAGE_NAME=ibm-mq
     export OPERATOR_VERSION=3.9.0

     For information about the contents of the IBM MQ CASE, which is used for air-gap installs and upgrades, see IBM MQ CASE for air-gap install and upgrade.

     To create mirror images, see Mirroring images for an air-gapped cluster.

  3. Apply latest Catalog source.

     If you are using the specific catalog source for the IBM MQ Operator, rather than the ibm-operator-catalog, you must apply the catalog source for the new IBM MQ version.

     To move from using the IBM Operator Catalog to using the specific catalog source for the IBM MQ Operator, and gain greater control over upgrades, refer to the steps in Moving to the specific catalog source for the IBM MQ Operator before returning to complete the next step.

     If you are using the IBM Operator catalog (some online installs only), proceed to the next step.

     Otherwise, follow the instructions in Adding the IBM MQ Operator catalog source then proceed to the next step.

  4. Upgrade the IBM MQ Operator. New major or minor IBM MQ Operator versions are delivered through new subscription channels. To upgrade your Operator to a new major or minor version, complete the following steps to update the selected channel in your IBM MQ Operator Subscription.
     1. Ensure the required IBM MQ Operator Upgrade Channel is available.

        oc get packagemanifest ibm-mq -o=jsonpath='{.status.channels[*].name}'

     2. Patch the Subscription to move to the desired update channel (where vX.Y is the desired update channel identified in the previous step.

        oc patch subscription ibm-mq --patch '{"spec":{"channel":"vX.Y"}}' --type=merge