[OpenShift Container Platform][Amazon EKS][IBM Cloud Pak for Integration]

Adding annotations to queue managers by using the IBM MQ Operator

You can add annotations to queue managers either on creation, or by updating existing queue managers by using the spec.annotations.

About this task

These instructions apply only if both the following statements are true:
  • You are using the IBM® MQ Operator. If you are self-deploying queue managers on Kubernetes, see IBM MQ container license annotations instead.
  • You are editing an existing queue manager. For new queue managers, add the annotations on creation instead.
Important: Updating the queue manager YAML triggers a pod restart.

Procedure

  • Option 1: Add annotations by using the command line interface (CLI).
    1. Log into your cluster from the command line.
    2. Set your project (namespace) to the one in which your queue manager is deployed:
      • For deployments on the Red Hat OpenShift Container Platform:
        oc project <QUEUE-MANAGER-NAMESPACE>
      • For deployments on Amazon EKS:
        kubectl config set-context --current --namespace=<QUEUE-MANAGER-NAMESPACE>
    3. Identify the name of the queue manager that you want to update:
      • For deployments on the Red Hat OpenShift Container Platform:
        oc get queuemanager
        
      • For deployments on Amazon EKS:
        kubectl get queuemanager 
    4. Add the required annotations to your queue manager by editing the queue manager:
      • For deployments on the Red Hat OpenShift Container Platform
        oc edit queuemanager <QUEUE-MANAGER-NAME>
        
      • For deployments on Amazon Amazon EKS:
        kubectl edit queuemanager <QUEUE-MANAGER-NAME>
    5. Repeat these steps for other queue managers as required.
  • Option 2: Add annotations by using the Red Hat OpenShift console, for deployments on Red Hat OpenShift.
    1. Navigate to your queue manager
      1. Log in to the Red Hat OpenShift console with your Red Hat OpenShift Container Platform cluster administrator credentials.
      2. Change the Project to the namespace where you installed the IBM MQ Operator. Select the namespace from the Project drop-down list.
      3. In the navigation pane, click Operators > Installed Operators.
      4. In the list on the Installed Operators panel, find and click IBM MQ.
      5. Click the Queue Manager tab.
      6. Click the required Queue Manager name.
    2. Add the required annotations to your queue manager.
      1. Click the YAML tab.
      2. Locate the spec field.
      3. Add the required annotations to the queue manager. Create the annotations field if it is not already present.
      4. Click Save.

        The queue manager pod restarts and the annotations are applied.

    3. Repeat these steps for other queue managers as required.