Deploying License Service

License Service collects and measures the license usage of IBM Cloud Pak® for Integration at the cluster level. You can retrieve this data upon request for monitoring and compliance. You can also retrieve an audit snapshot of the data that is audit evidence. License Service for Cloud Pak for Integration is not deployed automatically.

For more information about License Service, see About License Service in the foundational services documentation.

You can deploy License Service:

Using the OpenShift web console
Using the OpenShift CLI

Deploying by using the OpenShift web console

To deploy License Service in the UI, first install the operator, then deploy the instance.

Installing the operator by using the OpenShift console

Log in to the OpenShift web console with your OpenShift cluster administrator credentials.
Make sure the Administrator perspective is selected.
Click Operators > OperatorHub.
Use the search filter to locate the IBM Licensing operator, and click the tile.
Click Install.
In the Install Operator pane that opens:
1. Select the latest operator channel.
2. Keep the pre-selected (default) installation options.
Click Install. The IBM Licensing operator is now installed in the ibm-licensing namespace.

Deploying the instance by using the OpenShift console

Log in to the OpenShift web console with your OpenShift cluster admin credentials.
Click the arrow for Project, and from the list, select the ibm-licensing namespace. If this namespace does not already exist, create a namespace called ibm-licensing by clicking Home > Projects in the navigation pane, then clicking Create Project. Select this namespace when it is created.
In the navigation panel, click Operators > Installed Operators.
In the list on the Installed Operators panel, find and click IBM Licensing.
Click the IBM License Service tab.
Click Create IBMLicensing. The Create IBMLicensing panel opens.
Click Create. You are redirected to the IBM License Service tab. Your instance is added to the list of instances.

Deploying by using the OpenShift CLI

Installing the operator by using the CLI

Log in to your cluster, using your OpenShift user credentials:
```
oc login
```
Use the namespace called ibm-licensing to install the operator. If it does not yet exist, create it:
```
oc new-project ibm-licensing
```
Create a Subscription for the IBM Licensing operator.

a. Create a Subscription YAML file, for example, subscription.yaml. Use the following configuration:
```
apiVersion: operators.coreos.com/v1alpha1
kind: Subscription
metadata:
  name: ibm-licensing-operator
spec:
  channel: v4.2
  name: ibm-licensing-operator-app
  source: opencloud-operators
  sourceNamespace: openshift-marketplace
```
b. Run the following command to add the subscription in the ibm-licensing namespace:
```
oc apply -f subscription.yaml -n ibm-licensing
```
The IBM Licensing operator is now installed in the ibm-licensing namespace. You can now validate License Service.

Installing the instance by using the CLI

Create an IBMLicensing YAML file, for example, ibm-licensing.yaml. Use the following configuration:

kind: IBMLicensing
apiVersion: operator.ibm.com/v1alpha1
metadata:
  labels:
    app.kubernetes.io/instance: ibm-licensing-operator
    app.kubernetes.io/managed-by: ibm-licensing-operator
    app.kubernetes.io/name: ibm-licensing
  name: instance
spec:
  version: 1.16.6
  apiSecretToken: ibm-licensing-token
  datasource: datacollector
  httpsEnable: true

Apply the YAML file to the cluster:

oc apply -f ibm-licensing.yaml -n ibm-licensing

Validating License Service

After you deploy License Service, you can validate it. For more information, see Verifying completeness of license usage data and troubleshooting in the foundational services documentation.