Installing the operators by using the CLI

1. Specify the namespace where you want to install the operator:

   export NAMESPACE=<namespace_name>

   For the placeholder <namespace_name>, if you are installing:

   • in all namespaces mode, enter openshift-operators.

   • in a specific namespace mode, enter a custom name.

2. If the installation mode that you want is a specific namespace on the cluster, create a new project for installing the operator:

   oc new-project <project_name>

   For example:

   oc new-project integration

3. Switch to the namespace where you want to install the operator (openshift-operators if you are installing in all namespaces, or a custom name if you are installing in a specific namespace):

   oc project ${NAMESPACE}

4. (Only if your preferred installation mode is a specific namespace on the cluster) Create an OperatorGroup similar to the following example.

   . Create a YAML file similar to the following example:

   apiVersion: operators.coreos.com/v1
   kind: OperatorGroup
   metadata:
     name: ibm-integration-operatorgroup
     labels:
       backup.integration.ibm.com/component: operatorgroup        
   spec:
     targetNamespaces:
     - <namespace>

   Replace the following placeholders:

   • For <namespace>, use the namespace you want to install the workload in.

   b. Save to a file called operator-group.yaml.

   c. Run the following command: oc apply -f operator-group.yaml

5. Create a Subscription for the IBM Cloud Pak for Integration operator.

   a. Create a YAML file similar to the following example:

   apiVersion: operators.coreos.com/v1alpha1
   kind: Subscription
   metadata:
     name: ibm-integration-platform-navigator
     labels:
       backup.integration.ibm.com/component: subscription        
   spec:
     channel: <current_channel>
     name: ibm-integration-platform-navigator
     source: <catalog_source_name>
     sourceNamespace: openshift-marketplace

   Replace the following placeholders:

   • For <current_channel>, use one of the versions from the "Operator channel" column in Operator and instance versions for this release.

   • For <catalog_source_name>, enter the name of the catalog source that was created for this operator in Adding catalog sources to a cluster. To get the catalog source names on your cluster, run:

     oc get catalogsource -n openshift-marketplace

   b. Save to a file called subscription.yaml.

   c. Run the following command:

   oc apply -f subscription.yaml

6. Create a subscription for each operator that you want to install.

   a. Create a YAML file similar to the following example:

   apiVersion: operators.coreos.com/v1alpha1
     kind: Subscription
     metadata:
       name: <operator_name>
     spec:
       channel: <current_channel>
       name: <operator_name>
       source: <catalog_source_name>
       sourceNamespace: openshift-marketplace

   Replace the following placeholders, as indicated:

   • For <operator_name>, enter the intended operator literal name from the complete list in Operators available to install.

   • For <current_channel>, use one of the versions from the "Operator channel" column in Operator and instance versions for this release.

   • For <catalog_source_name>, enter the name of the catalog source that was created for this operator in Adding catalog sources to a cluster. To get the catalog source names on your cluster, run:

     oc get catalogsource -n openshift-marketplace

   b. Save to a file called subscription.yaml.

   c. Run the following command:

   oc apply -f subscription.yaml

To validate that an operator is installed, run the following command:

oc get csv

The command returns a list similar to the following example. Successfully installed operators have the value Succeeded in the PHASE column.

NAME                                          DISPLAY                                              VERSION   PHASE
ibm-integration-platform-navigator.v7.2.0     IBM Cloud Pak for Integration                        7.2.0     Succeeded
ibm-mq.v3.1.0                                 IBM MQ                                               3.1.0     Succeeded

When the operator is successfully installed (PHASE value of Succeeded), you can deploy instances that the operator manages.