This page provides the guidance for installing MQ for Red Hat OpenShift both on-prem and on IBM Cloud.
- Make sure permissions are set
- Create MQ instance in Cloud Pak for Integration
- Monitoring the Deployment
- Register with Tracing Service
You can open up permissions for install in you
mq namespace by issing
the following commands:
oc adm policy add-scc-to-group ibm-anyuid-scc system:serviceaccounts:mqoc adm policy add-scc-to-group anyuid system:serviceaccounts:mq
Create an instance of MQ queue manager by clicking on “Add new instance” in the MQ tile in Platform Navigator.
This will open a pop up window showing requirements for deploying MQ. Click Continue.
This will open the MQ helm chart to deploy MQ to the cluster. Click Overview to review the requirements to deploy MQ chart.
Unless you require fine grained rights to be defined for your installation, the default rbac settings defined on install will be sufficient.
MQ also requires Storage class or Persistent volume to be pre-defined if persistence is being used. It is possible to deploy MQ chart without using persistence. However, it is highly recommended to use persistent storage as any changes you make in the MQ UI will be lost if the pods were recreated.
If you are using the entitled registry, your image pull secret will already be created for you as
If you are not using entitled registry, obtain an image pull secret using the command below:To obtain the secret for pulling the image login to the OCP CLI and run:```oc get secrets -n mq```The pull secret starts with **deployer-dockercfg**
After performing the above pre-requisites, click on Configuration tab to provide the values required to deploy MQ chart.
Provide the name for the chart, select mq as Target namespace and select local-cluster as Target-Cluster. Also check the ‘License’ box to accept license.
Expand the ‘Quick Start’ twisty to expose the Configuration Settings for TLS.
Set the Cluster Hostname as the proxy node address for your installation. Omit the
https://in the url.
Next, click to expand ‘All parameters’ to configure the chart for deployment.
Untickthe box “Production usage” box. Double check your image repository is correct. For entitled registry it will look like
Image Pull Secretto
ibm-entitlement-keyfor the entitled registry or the deployer-dockercfg value specific to your environment as indicated in the step above.
Moving down, under the
IBM Cloud Pak for Integrationheading it will ask for the location of your platform navigator is installed at. In most installations, this will be the
integrationnamespace, but check to be sure.
Moving down, under the
Configuration Settings for TLS. Tick the
Generate Certificatebox. The cluster hostname value should already be populated with the proxy node value defined earlier.
Persistenceheading. If you choose to use persistent storage then you will need to tick both the
Use dynamic provisioningboxes.
Data PVCheading. Populate the
Storage Class namewith the requisite storageclass. Use
oc get storageclassesto get a list on your system. If you are using IBM Cloud this can be the
ibmc-file-bronze. Either way, file storage (not block) is required for use with MQ.
There is no need to repeat this for the other sections (Log PVC and QM PVC etc) for a dev environment. If you want to use a separate storage class for these items, you can individually specify the storageclasses as required.
Moving down, under Security, ensure the check box for
Initialize volume as rootis ticked. This is the default.
Last item to configure is to enable OD Tracing for the MQ instance. At the bottom of the MQ Chart you will find the
Operation Dashboard Configuration.
Click the Tick Box for
Enable Operations Dashboard
At the bottom, populate the
OD tracing instance namespacewith the name of the tracing namespace, which in this sample is
Scroll to the bottom and then click install.
- Once all the pods are up, it will resemble the following. Use the
oc get podscommand to view the pods in flight
- Near the end of the install of MQ, a job will be created that has the
odtracing.registration. This job will not complete until the Registration is completed inside of the Tracing capability.
- What will happen is that a request will be created inside of tracing
that you need to act upon. Navigate to the Platform Navigator and via
the Hamburger menu select Tracing and then when the window pops out
select the name of your tracing instance which should be called
- Within tracing, select the
Manageicon from the menu. Looks like a cog wheel.
- Click on the
- You should see a new registration request for your MQ install.
- You will see a pop up window with some lines to copy to your clipboard. Click the 2 boxes icon in the top right icon to copy the commands required.
- Ensuring you have an active
ocsession and in the
mqproject. Paste the commands to the window and it will run then and finish the processing.
- If you are slow in doing the steps above. It is possible you might
odtracing.registrationjob fail. No worries. Once you complete the pasting of the commands to create your secret, the job will re-create itself.