Installing Watson Discovery

Before you begin

Ensure that the cluster meets the minimum requirements for installing Watson Discovery. For details, see System requirements.

Additionally, ensure that a cluster administrator completed the required Pre-installation tasks for your environment. Specifically, verify that a cluster administrator completed the following tasks:

1. Cloud Pak for Data is installed. For details, see Installing Cloud Pak for Data.
2. For environments that use a private container registry, such as air-gapped environments, the Watson Discovery software images are mirrored to the private container registry. For details, see Mirroring images to your container registry.
3. The cluster is configured to pull the Watson Discovery software images. For details, see Configuring your cluster to pull images.
4. The Watson Discovery catalog source exists. For details, see Creating catalog sources.
5. The Watson Discovery operator subscription exists. For details, see Creating operator subscriptions.
6. The node settings are adjusted for Watson Discovery. For details, see Changing required node settings.

If these tasks are not complete, the Watson Discovery installation will fail.

Procedure

Complete the following tasks to install Watson Discovery:

1. Installing the service
2. Verifying the installation
3. What to do next

Installing the service

To install Watson Discovery:

1. Log in to Red Hat® OpenShift Container Platform as a user with sufficient permissions to complete the task:

   oc login OpenShift_URL:port

2. Create a WatsonDiscovery custom resource to install Watson Discovery. Follow the appropriate guidance for your environment.
   Important: By creating a WatsonDiscovery custom resource with spec.license.accept: true, you are accepting the license terms for Watson Discovery. You can find links to the relevant licenses in IBM Cloud Pak for Data License Information.
   Tip: For additional properties that you can specify in the custom resource, see Additional installation options.

   The cluster uses the recommended storage class names.

   The recommended storage class names are described in Setting up shared persistent storage.

   Create a custom resource with the following format.

   cat <<EOF |oc apply -f -
   apiVersion: discovery.watson.ibm.com/v1
   kind: WatsonDiscovery
   metadata:
     annotations:
       oppy.ibm.com/disable-rollback: "true"
     name: wd # Do not change the name.
     namespace: project-name # Replace with the project where Cloud Pak for Data is installed.
   spec:
     license:
       accept: true
     version: 4.0.9
     shared:
       storageClassName: storage-class-name  # See the guidance in "Information you need to complete this task"
     watsonGateway:
       version: main
   EOF

3. When you create the custom resource, the Watson Discovery operator installs Watson Discovery.

Additional installation options

Verifying the installation

When you create the custom resource, the Watson Discovery operator processes the contents of the custom resource and starts up the microservices that comprise Watson Discovery, including WatsonDiscovery. (The WatsonDiscovery microservice is defined by the wd custom resource.) Watson Discovery is installed when the WatsonDiscovery status is Completed.

To check the status of the installation:

1. Change to the project where you installed Watson Discovery:

   oc project project-name

2. Get the status of Watson Discovery (wd):

   oc get WatsonDiscovery wd -o jsonpath='{.status.watsonDiscoveryStatus} {"\n"}'

   Watson Discovery is ready when the command returns Completed

What to do next

The service is ready to use now. For more information, see Getting started.