Installing the IBM MQ Operator using the OpenShift web console

The IBM MQ Operator can be installed onto OpenShift using the Operator Hub.


Before starting

Log in to the OpenShift cluster's web console.


Procedure

  1. Add the IBM Common Services operators to the list of installable operators
    1. Click the plus icon. You see the Import YAML dialog box.
    2. 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: docker.io/ibmcom/ibm-common-service-catalog:latest
        updateStrategy:
          registryPoll:
            interval: 45m
    3. Click Create.

  2. Add the IBM operators to the list of installable operators
    1. Click the plus icon. You see the Import YAML dialog box.
    2. 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 
        publisher: IBM Content
        sourceType: grpc
        image: docker.io/ibmcom/ibm-operator-catalog
        updateStrategy:
          registryPoll:
            interval: 45m
    3. Click Create.

  3. 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 we want to install into a particular namespace which does not already exist.
    1. From the navigation pane, click the Home > Projects. The Projects page is displayed.
    2. Click Create Project. A Create Project area is displayed.
    3. Enter details of the namespace that we are creating. For example, we can specify "ibm-mq" as the name.
    4. Click Create. The namespace for the IBM MQ Operator is created.

  4. Install the IBM MQ Operator.
    1. From the navigation pane, click Operators > OperatorHub. The OperatorHub page is displayed.
    2. In the All Items field, enter "IBM MQ". The IBM MQ catalog entry is displayed.
    3. Select IBM MQ. The IBM MQ window is displayed.
    4. Click Install. You see the Create Operator Subscription page.
    5. Set Installation Mode to either the specific namespace that you created, or the cluster wide scope
    6. Click Subscribe. You will see IBM MQ on the Installed Operators page.
    7. Check the status of the Operator on the Installed Operators page, the status will change to Succeeded when the installation is complete.


What to do next

Deploying IBM MQ certified containers using the IBM MQ Operator Parent topic: Install and uninstall the IBM MQ Operator on OpenShift