Installing the IBM Licensing operator

Starting from IBM RPA version 23.0.19, the IBM Cloud Pak foundational services operator is no longer installed automatically by the IBM RPA operator. Thus, the License Service provided by the IBM Licensing operator, must be installed before you install the IBM Cloud Pak foundational services.

You must install the IBM Licensing operator in the same namespace that you want to install the IBM RPA operator and the IBM Cloud Pak foundational services.

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 Licensing operator 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: ibm-licensing-catalog
    namespace: openshift-marketplace
spec:
    displayName: IBM License Service Catalog
    publisher: IBM
    sourceType: grpc
    image: icr.io/cpopen/ibm-licensing-catalog
    updateStrategy:
    registryPoll:
        interval: 45m

Click Create. The catalog source is created.

Install the operator

Go to OperatorHub and search for the IBM Licensing operator.

Note:It might take a few minutes to display the operator in the OperatorHub. If the operator is not displayed in the OperatorHub, there is an issue with the CatalogSource.
Select IBM Licensing and click Install.
The image shows the IBM Licensing installation window.
Set the Update Channel to the v4.2 version.
Set the Installation mode to A specific namespace on the cluster.
Set the Installed Namespace to Select a Namespace, and select the namespace that you want to install IBM RPA, for example, the ibm-rpa namespace.
Set Update approval to Automatic.
Click Install.

Installing the IBM Licensing operator by using the CLI

Log in to the cluster by using the oc login command.
Create the License Service catalog source:

Create a YAML file named license-service-catalog.yaml with the following definition:

apiVersion: operators.coreos.com/v1alpha1
kind: CatalogSource
metadata:
    name: ibm-licensing-catalog
    namespace: openshift-marketplace
spec:
displayName: IBM License Service Catalog
publisher: IBM
sourceType: grpc
image: icr.io/cpopen/ibm-licensing-catalog
updateStrategy:
    registryPoll:
        interval: 45m

Apply the YAML file to create the License Service catalog source.
```
oc apply -f license-service-catalog.yaml
```

Verify that the CatalogSource for your IBM License Service operator is created.

oc get pods -n openshift-marketplace
oc get catalogsource -n openshift-marketplace

Install the IBM License Service operator

Create the operator group to deploy the OperatorGroup resource.

cat <<EOF | oc apply -f -
apiVersion: operators.coreos.com/v1
kind: OperatorGroup
metadata:
    name: licensing-og
    namespace: ibm-licensing
spec:
    targetNamespaces:
    - ibm-licensing
EOF

Create the subscription for License Service.

export LS_CHANNEL=v4.2
cat <<EOF | oc apply -f -
apiVersion: operators.coreos.com/v1alpha1
kind: Subscription
metadata:
    name: ibm-licensing-operator-app
    namespace: ibm-licensing
spec:
    channel: $LS_CHANNEL
    installPlanApproval: Automatic
    name: ibm-licensing-operator-app
    source: ibm-licensing-catalog
    sourceNamespace: openshift-marketplace
EOF

Verify that your License Service operator is installed:
```
oc get pod -n $NAMESPACE
```
Tip:It might take up to 15 minutes for all the pods to show the Running status.
Update the License Service instance that was created during installation to accept the license.
Create the accept-license.yaml file with the following content:
```
spec:
    license:
        accept: true
```

Run the following command:

oc patch IBMLicensing instance --type merge --patch-file accept-license.yaml

What to do next

After you install the License Service, proceed to install the IBM Cloud Pak foundational services operator. For more information, see Installing IBM Cloud Pak foundational services.