Installing the IBM MQ Operator using the Red Hat OpenShift web console
The IBM® MQ Operator can be installed onto Red Hat® OpenShift® using the Operator Hub.
Before you begin
Procedure
- Optional:
Add the IBM Common Services Operators to the list of installable operators.
Note:
This step applies to releases of IBM MQ Operator 1.5 and earlier. The step adds a separate Common Services catalog. For later releases of the Operator, the Common Services are included in the IBM catalog.
- Click the plus icon in the top right of the screen. You see the Import YAML dialog box.
-
Paste the following resource definition in the dialog box.
apiVersion: operators.coreos.com/v1alpha1 kind: CatalogSource metadata: name: opencloud-operators namespace: openshift-marketplace spec: displayName: IBMCS Operators publisher: IBM sourceType: grpc image: icr.io/cpopen/ibm-common-service-catalog:latest updateStrategy: registryPoll: interval: 45m
- Click Create.
-
Add the IBM operators to the list of installable operators
- Click the plus icon in the top right of the screen. You see the Import YAML dialog box.
-
Paste the following resource definition in the dialog box.
apiVersion: operators.coreos.com/v1alpha1 kind: CatalogSource metadata: name: ibm-operator-catalog namespace: openshift-marketplace spec: displayName: IBM Operator Catalog image: icr.io/cpopen/ibm-operator-catalog:latest publisher: IBM sourceType: grpc updateStrategy: registryPoll: interval: 45m
- Click Create.
-
Create a namespace to use for the IBM MQ Operator
The IBM MQ Operator can be installed scoped to a single namespace or all namespaces. This step is only needed if you want to install into a particular namespace which does not already exist.
-
From the navigation pane, click the Home > Projects.
The Projects page is displayed.
- Click Create Project. A Create Project area is displayed.
- Enter details of the namespace that you are creating. For example, you can specify "ibm-mq" as the name.
- Click Create. The namespace for your IBM MQ Operator is created.
-
From the navigation pane, click the Home > Projects.
-
Install the IBM MQ Operator.
-
From the navigation pane, click Operators > OperatorHub.
The OperatorHub page is displayed.
-
In the All Items field, enter "IBM MQ".
The IBM MQ catalog entry is displayed.
-
Select IBM MQ.
The IBM MQ window is displayed.
-
Click Install.
You see the Create Operator Subscription page.
- Review Version support for the IBM MQ Operator to determine which operator channel to choose.
-
Set Installation Mode to either the specific namespace that you created, or the cluster-wide
scope.
Choosing the cluster-wide scope is recommended, because installing different versions of an Operator in different namespaces can lead to problems. Operators are designed to be extensions of the control plane.
-
Click Subscribe.
You will see IBM MQ on the Installed Operators page.
- Check the status of the Operator on the Installed Operators page, the status will change to Succeeded when the installation is complete.
-
From the navigation pane, click Operators > OperatorHub.