Installing the IBM Cloud Pak foundational services for Cloud Pak for Data

Before you can install the IBM Cloud Pak for Data control plane, you must install the IBM Cloud Pak foundational services that Cloud Pak for Data requires. Each instance of Cloud Pak for Data has its own instance of the IBM Cloud Pak foundational services.

Installation phase
  • You are not here. Setting up a client workstation
  • You are not here. Setting up a cluster
  • You are not here. Collecting required information
  • You are not here. Preparing to run installs in a restricted network
  • You are not here. Preparing to run installs from a private container registry
  • You are not here. Preparing the cluster for Cloud Pak for Data
  • You are not here. Preparing to install an instance of Cloud Pak for Data
  • You are here icon. Installing an instance of Cloud Pak for Data
  • You are not here. Setting up the Cloud Pak for Data control plane
  • You are not here. Installing solutions and services
Who needs to complete this task?

Instance administrator An instance administrator must install IBM Cloud Pak foundational services for the instance.

When do you need to complete this task?

Repeat as needed This task must be completed for each instance of Cloud Pak for Data that you plan to install.

Before you begin

A cluster administrator must complete the tasks in Preparing to install an instance of IBM Cloud Pak for Data.

Specifically, the cluster administrator must complete Applying the required permissions to the projects (namespaces) for an instance of IBM Cloud Pak for Data against the projects associated with this instance of Cloud Pak for Data.

Best practice: You can run the commands in this task exactly as written if you set up environment variables. For instructions, see Setting up installation environment variables.

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

About this task

You must run the setup-instance-topology command to:
  • Install the required IBM Cloud Pak foundational services software in the operators project.
  • Create the ConfigMap for the NamespaceScope operator.

    The ConfigMap identifies which project or projects the operators should watch.

Procedure

  1. 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.
  2. Run the cpd-cli manage setup-instance-topology to install IBM Cloud Pak foundational services and create the required ConfigMap:
    Instances without tethered projects 
    cpd-cli manage setup-instance-topology \
--release=${VERSION} \
--cpd_operator_ns=${PROJECT_CPD_INST_OPERATORS} \
--cpd_instance_ns=${PROJECT_CPD_INST_OPERANDS} \
--license_acceptance=true \
--block_storage_class=${STG_CLASS_BLOCK}
    Instances with tethered projects 
    cpd-cli manage setup-instance-topology \
--release=${VERSION} \
--cpd_operator_ns=${PROJECT_CPD_INST_OPERATORS} \
--cpd_instance_ns=${PROJECT_CPD_INST_OPERANDS} \
--additional_ns=${PROJECT_CPD_INSTANCE_TETHERED_LIST} \
--license_acceptance=true \
--block_storage_class=${STG_CLASS_BLOCK}
    Tip: Before you run this command against your cluster, you can preview the oc commands that this command will issue on your behalf by running the command with the --preview=true option.

    The oc commands are saved to the preview.sh file in the work directory.

What to do next

Now that you've installed the IBM Cloud Pak foundational services, you're ready to complete Installing the IBM Cloud Pak for Data control plane.