Creating a service instance for Watson Query from the web client

After you install Watson Query, you must create at least one Watson Query service instance. Each service instance must be in a different Red Hat® OpenShift® Container Platform project. You can create a service instance in the operands project or in a project that is tethered to the operands project. If you are a Cloud Pak for Data user, you can use the web client to create service instances. The web client guides you through the process of creating service instances.

Who needs to complete this task?
To create a service instance from the web client, you must have the Create service instances permission in Cloud Pak for Data.
When do you need to complete this task?
Complete this task only if you want to create a service instance from the web client.
Alternative methods for creating a service instance

Before you begin

This task assumes that the following prerequisites are met:

Prerequisite Where to find more information
Watson Query is installed. If this task is not complete, see Installing Watson Query.

About this task

You can run only one Watson Query instance in a project. You can run multiple instances of Watson Query for the same Cloud Pak for Data instance by setting up tethered projects and then provisioning one Watson Query instance in each of the tethered projects. For information about setting up tethered projects, see Tethering projects to the IBM Cloud Pak for Data control plane.

The Watson Query service is provisioned to any compute node in the Cloud Pak for Data cluster that has the specified resources (cores, memory, and ephemeral storage) available.

Procedure

  1. On the navigation menu, click Services > Instances.
  2. Click New instance.
  3. From the list of services catalog, select Watson Query.
  4. On the Watson Query page, click New Instance.
  5. On the Configure service page, select the namespace where you want to deploy the instance and enter an optional short name. To see more namespaces in this list, create tethered namespaces. For more information, see: Manually creating projects (namespaces) for an instance of Cloud Pak for Data.
  6. Click Next.
  7. To configure the service, specify the resources that you want to allocate to the Watson Query worker nodes in the Nodes step.
    1. Specify the number of Watson Query worker nodes to allocate to the service.
      Recommended: One worker node is sufficient for many workloads.
      To understand the difference between compute nodes and worker nodes, see Preparing to install Watson Query.
    2. Specify the number of cores to allocate per node.
      You are constrained by the total number of available cores on the OpenShift compute nodes.
    3. Specify the amount of memory in GB to allocate per node.
      You are constrained by the total amount of memory on the OpenShift compute nodes. You can scale the Watson Query service up and down at any time after you provision it. For more information, see Scaling Watson Query.
  8. In the Storage step, specify the storage classes and persistent volume sizes that you want to use for the service nodes, caching storage, and audit log storage. For more information, see Storage requirements.
    1. In the Node storage section, select the block storage class and specify the size to allocate to your nodes. The default size that is shown in the Node storage section is 50Gi.
    2. In the Caching storage section, select the storage class and then specify the amount of storage to allocate to your data caches. If you are using OpenShift Data Foundation or IBM® Storage Fusion Data Foundation, select a block storage class. If you are using Portworx, select a file storage class.
    3. In the Audit log storage, select the file storage class and specify the amount of storage to allocate to your audit logs.
  9. Click Next.
  10. Ensure that the summary is correct and click Configure.
  11. Optional: If you want to use Cloud Pak for Data while you wait for the Watson Query provisioning process to complete, click Home.
    Repeat this procedure to provision additional instances of Watson Query in tethered projects. You must create a new tethered project for each instance of Watson Query that you want to provision. For more information about creating tethered projects, see Manually creating projects (namespaces) for an instance of Cloud Pak for Data.
    Note: The c-db2u-dv-dvcaching pod remains in the "0/1 Init" state during the entire Watson Query instance-provisioning process. The pod switches to the "1/1 Running" state after the process is complete.

What to do next

  1. When you provision the Watson Query service, you are automatically assigned the Watson Query Admin role. After you provision the service, you must give other users access to the service instance. For more information, see Managing users in Watson Query.
  2. To connect to the Watson Query service, use the JDBC URL that is provided in the Configure connection page for the service. Additionally, if you have a load balancer, you must open the port in your load balancer and your firewall. For more information, see Configuring network requirements for Watson Query.
Now you can use the Watson Query service. For more information, see Virtualizing data.