Preparing the cluster for the Watson Knowledge Catalog service

Before the Watson Knowledge Catalog service can be installed, the OpenShift cluster administrator and system administrator must prepare the Red Hat OpenShift cluster.

Prerequisite: Complete the tasks to configure your Red Hat OpenShift cluster software. See Changing required node settings.

As a system administrator, perform these tasks:

Set the timezone for the master node

As the OpenShift cluster administrator, perform this task:

Run the admin setup command for the service

Set the timezone for the master node

If you installed the Watson Studio service and set the timezone for the master node, you can skip this task.

If the service will be installed on a remote machine that runs in a different time zone than the master node, the time zone for the master node is overwritten by the time zone for the installer node. This time zone discrepancy results in scheduled jobs that don’t run at the correct time.

If necessary, log in as a system administrator and set the timezone for the master node:

Locate the tz database code format associated with the master node time zone.
If the override.yaml file does not exist, create it.
Add the tz database code value to the override.yaml file. For example, if you’re using the America/Los_Angeles database code, add the following value:
```
 global:
    masterTimezone: 'America/Los_Angeles'
```
Inform the user who is installing the service to include the --override override.yaml option in the installation command.

Run the cpd adm command for the service

Ensure that the Mac OS or Linux machine where you will run the commands meets the appropriate requirements for your environment. See Setting up your Cloud Pak for Data environment.

If you are installing the service on an air-gapped cluster, ensure that you completed the steps in Preparing for air-gapped installations to download the required files for the service.

Log in to your Red Hat OpenShift cluster as the cluster administrator and run the appropriate admin setup command for the Watson Knowledge Catalog service:

Run this command on a cluster that can connect to the internet:

 ./cpd-<Operating_System> adm --repo repo.yaml \
     --assembly wkc \
     --arch <Processor_architecture> \
     --namespace <Project>
     --apply

Replace the following variables:

Variable	Replace with
`<Operating_System>`	For Linux, specify `linux`. For MacOS, specify `darwin`.
`<Process_architecture>`	For x86-64, remove this flag or specify `x86_64`.
`<Project>`	The project where you will install Watson Knowledge Catalog.

Run this command on an air-gapped cluster:

Before you can run the cpd adm command on an air-gapped cluster, you must first run a command to download the installation files for the service while connected to the internet.

Run this command while connected to the internet:

 ./cpd-<Operating_System> adm --repo repo.yaml \
--assembly wkc \
--arch <Processor_architecture> \

Run this command on an air-gapped cluster:

 ./cpd-<Operating_System> adm \
--assembly wkc \
--arch <Processor_architecture> \
--version <Assembly_version> \
--namespace <Project> \
--load-from <Image_directory_location> \
--apply

Replace the following variables:

Variable	Replace with
`<Operating_System>`	For Linux, specify `linux`. For MacOS, specify `darwin`.
`<Process_architecture>`	For x86-64, remove this flag or specify `x86_64`.
`<Assembly_version>`	The version of the assembly that is specified in the `cpd-Operating_System-workspace/assembly/wkc/versions.yaml` file.
`<Project>`	The project where you will install Watson Knowledge Catalog.
`<Image_directory_location>`	The location of the `cpd-<Operating_System>-workspace` directory.

Next step

Install the service