Installing the scheduling service

A Red Hat® OpenShift® cluster administrator can install the scheduling service in the IBM Cloud Pak® foundational services operator namespace.

Permissions you need for this task

You must be a cluster administrator.

When you need to complete this task

If you plan to install the Watson™ Machine Learning Accelerator service, you must install the scheduling service.

In general, it is strongly recommended that you install the scheduling service, because it enables you to programmatically enforce the quotas that you set for the Cloud Pak for Data control plane or various Cloud Pak for Data services. For details on quota enforcement, see Monitoring the platform.

Information you need to complete this task

The scheduling service is installed in the same project as the IBM Cloud Pak foundational services, typically ibm-common-services. (The ${PROJECT_CPFS_OPS} environment variable identifies the project.)

Before you begin

Best practice: You can run the commands in this task exactly as written if you set up environment variables for your installation. For instructions, see Best practice: Setting up install variables.

Ensure that you run the environment variable script before you run the commands in this task.

Ensure that the cluster meets the minimum requirements for installing the scheduling service. For details, see System requirements.

Verify that you completed the required Pre-installation tasks for your environment. Specifically, verify that:

The ${PROJECT_CPFS_OPS} project (typically ibm-common-services) exists and has the required operator group. For details, see Setting up projects (namespaces) on Red Hat OpenShift Container Platform.
For environments that use a private container registry, such as air-gapped environments, the scheduling service images are mirrored to the private container registry. For details, see Mirroring images to your container registry.
The cluster is configured to pull the software images. For details, see Configuring your cluster to pull Cloud Pak for Data images.
The scheduling service catalog source exists. For details, see Creating catalog sources.
The scheduling service operator subscription exists. For details, see Creating operator subscriptions.

If these tasks are not complete, the scheduling service installation will fail.

Procedure

Complete the following tasks to install the scheduling service:

Installing the scheduling service
Verifying the installation
What to do next

Installing the scheduling service

To install the scheduling service:

Log in to Red Hat OpenShift Container Platform as a user with sufficient permissions to complete the task:
```
oc login ${OCP_URL}
```

Create a Scheduling custom resource to install the scheduling service.

Create a custom resource with the following format.

cat <<EOF |oc apply -f -
apiVersion: scheduler.spectrumcomputing.ibm.com/v1
kind: Scheduling
metadata:
  labels:
    release: cpd-scheduler
  name: ibm-cpd-scheduler
  namespace: ${PROJECT_CPFS_OPS}
spec:
  version: 1.3.5
  license:
    accept: true
  registry: cp.icr.io/cp/cpd
  releasename: ibm-cpd-scheduler
EOF

When you create the custom resource, the scheduling service operator installs the scheduling service.

Verifying the installation

When you create the custom resource, the scheduling service operator processes the contents of the custom resource and starts up the microservices that comprise the scheduling service, including Scheduling. (The Scheduling microservice is defined by the ibm-cpd-scheduler custom resource.) The scheduling service is installed when the Scheduling status is Completed.

To check the status of the installation:

Change to the project where you installed the scheduling service:
```
oc project ${PROJECT_CPFS_OPS}
```
Get the status of the scheduling service (ibm-cpd-scheduler):
```
oc get scheduling -o jsonpath='{.items[0].status.cpd-schedulingStatus} {"\n"}'
```
The scheduling service is ready when the command returns Completed.

What to do next

The scheduling service is ready to use. The Cloud Pak for Data control plane and Watson Machine Learning Accelerator will automatically integrate with the scheduling service when they are installed.

You can now install Cloud Pak for Data.