Upgrading IBM MQ queue managers on Amazon EKS

You can upgrade an IBM® MQ queue manager that was deployed by using the IBM MQ Operator in Amazon EKS, by using the command line.

Before you begin

Note: The latest CD version of the IBM MQ queue manager is 10.0.0.0-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 Amazon EKS.

Important: For air-gap deployments, you must mirror the images of the IBM MQ Operator version that released alongside the queue manager version you want to upgrade to. You must do this before you can upgrade the queue manager. If you are upgrading your queue managers to the latest version that released alongside of the IBM MQ Operator that you have deployed, you should have already mirrored the queue manager images during the IBM MQ Operator upgrade. You can look up which IBM MQ CASE version contains the operator and queue manager version that you require in the IBM MQ CASE Lookup Tables.

Procedure

Log in to your cluster's command line interface.
Edit the version and license fields in the QueueManager resource.
Important: In an air-gap environment, the QueueManager custom resource YAML for each queue manager must also include spec.imagePullSecrets if the private registry that contains the images requires credentials. This field must reference a Kubernetes secret that contains the private registry credentials. For example:
```
spec:
    imagePullSecrets:
        - name: <KUBERNETES_SECRET_NAME>
```
This code will already exist for a queue manager that is being upgraded.
1. Run the following command to open the QueueManager resource for editing, replacing <QUEUEMANAGER_NAME> with the metadata.name of the queue manager that you are upgrading and <NAMESPACE> with the namespace that the queue manager is installed in:
```
kubectl edit queuemanager <QUEUEMANAGER_NAME> -n <NAMESPACE>
```
2. In the resource, update the following fields (where necessary) to match your desired IBM MQ queue manager version upgrade.
  - spec.version
  - spec.license.license
  For more information on valid licenses for different IBM MQ versions, see Licensing and API references for the IBM MQ Operator.
  
  The following table lists the latest version of the IBM MQ queue manager for each active Operator channel.
  
  Operator channel Latest IBM MQ queue manager
  
  v4.0 (CD) 10.0.0.0-r1
  
  You can look up which IBM MQ CASE version contains the operator and queue manager version that you require in the IBM MQ CASE Lookup Tables.
  
  Note: If you are installing in an air-gap environment, you must upgrade only to queue manager versions where you already mirrored the corresponding images. The CASE lookup tables show which queue manager version images were mirrored when you mirrored each IBM MQ CASE.
Verify the queue manager status by running the following command, replacing <NAMESPACE> and <QUEUEMANAGER_NAME> as before:
```
kubectl get queuemanager <QUEUEMANAGER_NAME> -n <NAMESPACE>
```