Before you begin
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
The following components are cluster-wide components, which means that they are installed
once and shared by all instances of Cloud Pak for Data on
the cluster.
Cluster-wide component |
Notes |
Certificate manager |
A certificate manager is required. The IBM Cloud Pak foundational services
Certificate manager is recommended over the Red Hat® OpenShift®
cert-manager or a community certificate manager. However, if the cpd-cli detects another certificate manager on the cluster, it will not install the
IBM Cloud Pak foundational services
Certificate manager.
|
License Service |
The IBM Cloud Pak foundational services
License Service is required. You are required to keep a record of the size of your deployments to report to IBM
as requested. If you are using Container
Licensing, you can use the License Service to measure Cloud Pak for Data usage.
|
Scheduling service |
The scheduling service is required if you plan to use:
- The quota enforcement feature in Cloud Pak for Data
- The node scoring
feature for pod placement
- The Watson™ Machine Learning Accelerator service
- Priority scheduling and co-scheduling in the Analytics Engine powered by Apache Spark service
If none of these scenarios applies to you, the scheduling service is optional but strongly
recommended.
|
Procedure
- Log the
cpd-cli
in to the
Red Hat OpenShift Container Platform cluster:
Remember:
CPDM_OC_LOGIN
is an alias for the cpd-cli
manage
login-to-ocp
command.
- Install the Certificate manager and the License Service:
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.
cpd-cli manage apply-cluster-components \
--release=${VERSION} \
--license_acceptance=true \
--cert_manager_ns=${PROJECT_CERT_MANAGER} \
--licensing_ns=${PROJECT_LICENSE_SERVICE}
Wait for the
cpd-cli
to return the following message before
proceeding to the next
step:
[SUCCESS]... The apply-cluster-components command ran successfully.
- Install the scheduling service:
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.
cpd-cli manage apply-scheduler \
--release=${VERSION} \
--license_acceptance=true \
--scheduler_ns=${PROJECT_SCHEDULING_SERVICE}
Wait for the
cpd-cli
to return the following message before
proceeding to the next
step:
[SUCCESS]... The apply-scheduler command ran successfully.
What to do next
Now that you've installed the shared cluster components, you're ready to complete Configuring persistent storage for IBM Cloud Pak for Data.