Setting up the cluster for Master Data Connect

If you plan to install Master Data Connect on IBM® Cloud Pak for Data, a cluster administrator must set up the cluster for Master Data Connect.

Before you begin

Required role: To complete this task, you must be a cluster administrator.

Before you set up the cluster for Master Data Connect, ensure that:

The Cloud Pak for Data control plane is already installed on your Red Hat® OpenShift® cluster. For details, see Installing IBM Cloud Pak for Data.
The cluster meets the minimum requirements for installing Master Data Connect. For details, see System requirements for services.
The machine from which you will run the commands meets the requirements described in Preparing your installation node.
On air-gapped clusters: You completed the steps in Preparing for air-gapped installations to download the required files for the service.

Tip: For a list of all available options, enter the following command:

./cpd-cli adm --help

Set up the cluster for Master Data Connect by completing the appropriate task for your environment:
- Preparing clusters connected to the internet
- Preparing air-gapped clusters
Complete the tasks listed in What to do next

From your installation node:

Change to the directory where you placed the Cloud Pak for Data command-line interface and the repo.yaml file.
Log in to your Red Hat OpenShift cluster as an administrator:
```
oc login OpenShift_URL:port
```

Run the following command to see a preview of the list of resources that must be created on the cluster:

./cpd-cli adm \
--repo ./repo.yaml \
--assembly mdc \
--arch Cluster_architecture \  
--namespace Project

Replace the following values:

Variable	Replace with
`Cluster_architecture`	Specify the architecture of your cluster hardware: For x86-64 hardware, remove this flag or specify `x86_64`
`Project`	The project where the Cloud Pak for Data control plane is installed.

The command returns a list of the changes that you must make to your cluster to ensure that Master Data Connect can run on your cluster.

From your installation node:

Change to the directory where you placed the Cloud Pak for Data command-line interface.
Log in to your Red Hat OpenShift cluster as an administrator:
```
oc login OpenShift_URL:port
```

Run the following command to see a preview of the list of resources that must be created on the cluster:

./cpd-cli adm \
--assembly mdc \
--arch Cluster_architecture \
--namespace Project \
--load-from Image_directory_location \
--latest-dependency

Replace the following values:

Variable	Replace with
`Cluster_architecture`	Specify the architecture of your cluster hardware: For x86-64 hardware, remove this flag or specify `x86_64`
`Project`	The project where the Cloud Pak for Data control plane is installed.
`Image_directory_location`	The location of the cpd-cli-workspace directory.

The command returns a list of the changes that you must make to your cluster to ensure that Master Data Connect can run on your cluster.

Make the necessary changes to your cluster. You can choose one of the following methods to make the changes:

To automatically apply the changes to your cluster:

Re-run the cpd adm command with the --apply flag: