Installing the IBM Cloud Pak foundational services

Starting from IBM RPA version 23.0.19, the IBM Cloud Pak foundational services is no longer installed with the IBM RPA operator. You must install the Cloud Pak foundational services in the same namespace that you want to install the IBM RPA operator.

IBM RPA supports IBM Cloud Pak foundational services versions 4.0.1 up and higher.

Before you begin

Choose one of the following methods to install the operator:

Installing the IBM Cloud Pak foundational services by using the OpenShift console

Complete these tasks from your Red Hat® OpenShift® cluster console.

Create the catalog source

  1. Log in to your cluster console.

  2. Click the plus icon. You see the Import YAML dialog box.

  3. Enter the following catalog source:

    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:4.10
        updateStrategy:
            registryPoll:
                interval: 45m
    
  4. Click Create. The catalog source is created.

  5. Verify that the source container is ready. The catalog source pod must have the Running status.

  6. On the cluster console, see Project: openshift-marketplace > Workloads > Pods.

Install the operator

  1. In the left side panel, go to All Projects > Operators > OperatorHub.
  2. In the All Items field, enter IBM Cloud Pak foundational services. The IBM Cloud Pak foundational services operator is displayed.
  3. Click the IBM Cloud Pak foundational services tile. The IBM Cloud Pak foundational services window is displayed.
  4. Click Install. You see the Install Operator page.
  5. Set Update Channel to the latest version.
  6. Set Installation Mode to A specific namespace on the cluster. Select the IBM RPA namespace from the Installed Namespace drop-down list. This is the namespace that you created in the Prepare namespace step.
  7. Set Update approval to Automatic.
  8. Click Install.

Installing the IBM Cloud Pak foundational services by using the CLI

  1. Log in to the cluster by using the oc login command.

  2. Create a YAML file named opencloud-operators.yaml with the following definition:

    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:4.10
        updateStrategy:
            registryPoll:
                interval: 45m
    
  3. Create the foundational services catalog source.

    oc apply -f opencloud-operators.yaml
    

Installing the operator

  1. Create a YAML file named def.yaml with the resources definitions that you need.

    apiVersion: v1
    kind: Namespace
    metadata:
        name: <your ibm-rpa namespace>
    
    ---
    apiVersion: operators.coreos.com/v1alpha2
    kind: OperatorGroup
    metadata:
        name: operatorgroup
        namespace: <your ibm-rpa namespace>
    spec:
        targetNamespaces:
        - <your ibm-rpa namespace>
    
    ---
    apiVersion: operators.coreos.com/v1alpha1
    kind: Subscription
    metadata:
        name: ibm-common-service-operator
        namespace: <your ibm-rpa namespace>
    spec:
        channel: v4.10
        installPlanApproval: Automatic
        name: ibm-common-service-operator
        source: opencloud-operators
        sourceNamespace: openshift-marketplace
    
  2. Create the resources that you specified in the definition file.

    oc apply -f def.yaml