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

Preparing your Red Hat OpenShift project for IBM MQ using the Red Hat 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 you begin

Note: If you 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 your cluster using cloudctl login (for IBM Cloud Pak for Integration), or oc login.

About this task

The IBM MQ Operator 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 you 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 you 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 Red Hat OpenShift CLI