Use the QueueManager custom resource to deploy a queue manager onto a Red Hat® OpenShift® Container Platform cluster using the command line
interface (CLI). This task should be completed by a project administrator
Procedure
-
Deploy a queue manager.
The following example deploys a "quick start" queue manager, which uses ephemeral (non-persistent) storage, and turns off MQ security. Messages will not be persisted across restarts of the queue manager.
You can adjust the contents of the YAML to change many queue manager settings.
-
Create a
QueueManager YAML file
For example, to install a basic queue manager in
IBM Cloud Pak for Integration, create the file "mq-quickstart.yaml" with the following
contents:
apiVersion: mq.ibm.com/v1beta1
kind: QueueManager
metadata:
name: quickstart-cp4i
spec:
version: 9.2.5.0-r3
license:
accept: false
license: L-RJON-C7QG3S
use: NonProduction
web:
enabled: true
queueManager:
name: "QUICKSTART"
storage:
queueManager:
type: ephemeral
template:
pod:
containers:
- name: qmgr
env:
- name: MQSNOAUT
value: "yes"
This example also includes a web server deployed with the queue manager, with the web console
enabled with Single Sign-On with the IBM Cloud Pak Identity and Access Manager.
To install a basic queue manager independently of
IBM Cloud Pak for Integration, create the file "mq-quickstart.yaml" with the following
contents:
apiVersion: mq.ibm.com/v1beta1
kind: QueueManager
metadata:
name: quickstart
spec:
version: 9.2.5.0-r3
license:
accept: false
license: L-APIG-BZDDDY
web:
enabled: true
queueManager:
name: "QUICKSTART"
storage:
queueManager:
type: ephemeral
template:
pod:
containers:
- name: qmgr
env:
- name: MQSNOAUT
value: "yes"
Important:If you accept the MQ license agreement, change
accept: false to
accept: true. See
Licensing reference for mq.ibm.com/v1beta1 for details on the
license.
-
Create the
QueueManager object
oc apply -f mq-quickstart.yaml
-
Check the queue manager is running
You can validate the deployment by running
oc describe queuemanager <QueueManagerResourceName>
, and then checking the status.
For example, run
oc describe queuemanager quickstart
, and check that the
status.Phase field indicates
Running