Installing Red Hat OpenShift Serverless Knative Eventing

If you plan to install IBM® watsonx Assistant, you must have Red Hat OpenShift Serverless Knative Eventing and IBM Events on the cluster.

Installation phase

Setting up a client workstation

Setting up a cluster

Collecting required information

Preparing to run installs in a restricted network

Preparing to run installs from a private container registry

Preparing the cluster for Cloud Pak for Data

Preparing to install an instance of Cloud Pak for Data

Installing an instance of Cloud Pak for Data

Who needs to complete this task?

Cluster administrator A cluster administrator must install this software.

When do you need to complete this task?

Complete this task only if you plan to install the watsonx Assistant service.

One-time setup The Red Hat OpenShift Serverless Knative Eventing and IBM Events are installed once and shared by all instances of watsonx Assistant on the cluster.

Before you begin

If your cluster is in a restricted network, you have two options for ensuring you can access the required images:

You can run the deploy-knative-eventing command while the workstation is connected to the cluster and the following websites:
- Red Hat OpenShift image registry
- IBM Entitled Registry
- GitHub
You can preinstall the Red Hat OpenShift Serverless Operator and IBM Events Operator:
1. You must install the Red Hat OpenShift Serverless Operator before you complete this task. For more information, see Installing the OpenShift Serverless Operator:
  - Version 1.30
  - Version 1.31
  - Version 1.32 (recommended)
  Private container registry users
  If you want to mirror the images for the Red Hat OpenShift Serverless Operator to a private container registry, see Mirroring images for a disconnected installation
2. You must have the IBM Cloud Pak foundational services CASE package in the work directory on the workstation from which you will complete this task.
  If you do not have the CASE package, you must run the following command while the client workstation is connected to the internet:
```
cpd-cli manage mirror-images \
--components=cpfs \
--release=${VERSION} \
--from_oci=true \
--case_download=true \
--target_registry=127.0.0.1:12443
```
3. If the IBM Events Operator is not installed on your cluster, run the following commands:
  1. Authorize the projects where the software will be installed to communicate:
```
cpd-cli manage authorize-instance-topology \
--release=${VERSION} \
--cpd_operator_ns=ibm-knative-events \
--cpd_instance_ns=knative-eventing
```
  2. Install the IBM Events Operator in the ibm-knative-events project:
```
cpd-cli manage setup-instance-topology \
--release=${VERSION} \
--cpd_operator_ns=ibm-knative-events \
--cpd_instance_ns=knative-eventing \
--license_acceptance=true
```

Best practice: You can run the commands in this task exactly as written if you use your installation environment variables script.

Ensure that you source the environment variables before you run the commands in this task.

About this task

When a user adds, modifies, or deletes actions in an assistant, watsonx Assistant starts a training job. The watsonx Assistant user interface communicates with the machine learning model through a message broker.

Red Hat OpenShift Serverless Knative Eventing and IBM Events provide a central Kafka broker for any instances of watsonx Assistant on the cluster.

You can run the deploy-knative-eventing command to install the Red Hat OpenShift Serverless Knative Eventing and IBM Events software.

The command is recommended for the following scenarios:

Installing a proof-of-concept or evaluation environment
Setting up a simple Kafka instance for use with Cloud Pak for Data

If you want to set up a custom Kafka instance or you want to connect to an existing Kafka instance, follow the Red Hat OpenShift Serverless documentation:

When you run the deploy-knative-eventing command, the following operators are installed as cluster-wide operators, which means that they are installed once and shared by all instances of IBM Cloud Pak for Data on the cluster:

Software	Installation project
Red Hat OpenShift Serverless Operator	This software is installed in the `openshift-serverless` project.
Knative Eventing Operator	This software is installed in the `knative-eventing` project.
Knative Kafka Operator	This software is installed in the `knative-eventing` project.
IBM Events Operator	This software is installed in the `ibm-knative-events` project. However, you can optionally point to an existing cluster-scoped instance of the IBM Events Operator.

In addition, the command sets up a Knative broker in the knative-eventing project. The broker is backed by an instance of Apache Kafka that is managed by the IBM Events Operator.

Procedure

To install Red Hat OpenShift Serverless Knative Eventing:

Log the cpd-cli in to the Red Hat OpenShift Container Platform cluster:
```
${CPDM_OC_LOGIN}
```
Remember: CPDM_OC_LOGIN is an alias for the cpd-cli manage login-to-ocp command.
Install the Red Hat OpenShift Serverless Knative Eventing software.
The command that you run depends on whether you want to install the IBM Events Operator in the ibm-knative-events project or whether you want to point to an existing cluster-scoped instance of the IBM Events Operator.
Install the operator in the ibm-knative-events project

The command that you run depends on the type of storage on your cluster:
Portworx storage
cpd-cli manage deploy-knative-eventing \ --release=${VERSION} \ --storage_vendor=portworx
All other storage
cpd-cli manage deploy-knative-eventing \ --release=${VERSION} \ --block_storage_class=${STG_CLASS_BLOCK}
Use an existing cluster-scoped instance of the operator

The command that you run depends on the type of storage on your cluster:
Portworx storage
cpd-cli manage deploy-knative-eventing \ --release=${VERSION} \ --storage_vendor=portworx \ --events_operator_ns=${PROJECT_IBM_EVENTS}
All other storage
cpd-cli manage deploy-knative-eventing \ --release=${VERSION} \ --block_storage_class=${STG_CLASS_BLOCK} \ --events_operator_ns=${PROJECT_IBM_EVENTS}

What to do next

Now that you've installed Red Hat OpenShift Serverless Knative Eventing and IBM Events, you're ready to complete Installing IBM App Connect in containers.