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
- The IBM Cloud Pak foundational services operator requires the
cert-manager
operator for Red Hat OpenShift. For more information, see Installing thecert-manager
operator for Red Hat OpenShift. - Install the IBM Licensing service before you install the IBM Cloud Pak foundational services operator. For more information, see Installing the IBM Licensing operator.
Choose one of the following methods to install the operator:
-
Installing the IBM Licensing operator by using the OpenShift console
If you prefer using the OpenShift web console to manage your cluster. -
Installing the IBM Licensing operator by using the CLI
If you prefer using the command line to manage your cluster.
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
-
Log in to your cluster console.
-
Click the plus icon. You see the Import YAML dialog box.
-
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
-
Click Create. The catalog source is created.
-
Verify that the source container is ready. The catalog source pod must have the Running status.
-
On the cluster console, see Project: openshift-marketplace > Workloads > Pods.
Install the operator
- In the left side panel, go to All Projects > Operators > OperatorHub.
- In the All Items field, enter IBM Cloud Pak foundational services. The IBM Cloud Pak foundational services operator is displayed.
- Click the IBM Cloud Pak foundational services tile. The IBM Cloud Pak foundational services window is displayed.
- Click Install. You see the Install Operator page.
- Set Update Channel to the latest version.
- 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.
- Set Update approval to Automatic.
- Click Install.
Installing the IBM Cloud Pak foundational services by using the CLI
-
Log in to the cluster by using the
oc login
command. -
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
-
Create the foundational services catalog source.
oc apply -f opencloud-operators.yaml
Installing the operator
-
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
-
Create the resources that you specified in the definition file.
oc apply -f def.yaml