Preparing the OpenShift project for IBM MQ using the OpenShift CLI

Prepare your Red Hat OpenShift Container Platform cluster, so that it's ready to deploy a queue manager using the IBM MQ Operator. This task should be completed by a project administrator.

Before starting

Note: If we plan to use IBM MQ in a project with other IBM Cloud Pak for Integration components already installed, you may not need to follow these instructions.

Log into the cluster using cloudctl login (for IBM Cloud Pak for Integration), or oc login.

About this task

The IBM MQ Advanced certified container images are pulled from a container registry that performs a license entitlement check. This check requires an entitlement key that is stored in a docker-registry pull secret. If we do not yet have an entitlement key, follow these instructions to get an entitlement key and create a pull secret.

Procedure

1. Get the entitlement key that is assigned to your ID.
   1. Log in to MyIBM Container Software Library with the IBM ID and password that are associated with the entitled software.
   2. In the Entitlement keys section, select Copy key to copy the entitlement key to the clipboard.

2. Create a secret containing your entitlement key, in the project where we want to deploy your queue manager. Run the following command, where <entitlement-key> is the key retrieved in step 1, and <user-email> is the IBM ID associated with the entitled software.

   oc create secret docker-registry ibm-entitlement-key \
   --docker-server=cp.icr.io \
   --docker-username=cp \
   --docker-password=<entitlement-key> \
   --docker-email=<user-email>

What to do next

Deploying a queue manager using the OpenShift CLI Parent topic: Deploying IBM MQ certified containers using the IBM MQ Operator