Install CDP Private Cloud
Follow the steps in this topic to install CDP Private Cloud.
- Ensure that your Kubernetes
kubeconfighas permissions to create Kubernetes namespaces.
- You require persistent storage classes defined in your OpenShift cluster. Storage classes can be defined by OpenShift cluster administrators.
- Only TLS-enabled custom Docker Registry is supported. Ensure that you use a TLS certificate to secure the custom Docker Registry. The TLS certificate can be self-signed, or signed by a private or public trusted Certificate Authority (CA).
- Only TLS 1.2 is supported for authentication with Active Directory/LDAP. You require TLS 1.2 to authenticate the CDP control plane with your LDAP directory service like Active Directory.
In Cloudera Manager, click the Private Cloud link in the left menu. This
opens the Private Cloud installation wizard. The wizard will guide you through
the steps to install CDP Private Cloud.
The CDP Private Cloud installation wizard appears. The wizard will guide you through the steps to install CDP Private Cloud.
On the Getting Started page of the installation wizard,
you can select the repository that contains the installer. The Select Repository
field contains the CDP Private Cloud repository download link. If you wish to
use a custom repository link provided to you by Cloudera, click
After you select the repository, the installation wizard shows you a list of prerequisites in this version of the CDP Private Cloud.
Verify the prerequisites for the version that you’re installing and then click
You can also apply a template that you may have downloaded during a previous installation. The template contains all the installation configurations. Click Apply Previously Download Template to browse and upload a template stored on your machine.
In the Configure Docker Registry page, enter your local
Docker Repository in the Custom Docker Repository field in the following
format:[*DOCKER REGISTRY*]/[*REPOSITORY NAME*].
Alternatively, you can use Cloudera's default Docker Repository if you are
setting up CDP Private Cloud in non-production environments. You can follow
these steps to prepare your Docker Repository from a machine that is running
Docker locally and has access to all the Docker images either directly from
Cloudera or a local HTTP mirror in your network.
- Click Generate the copy-docker script on the wizard or download the script file.
Log in to your custom Docker Registry and run the script using the
docker login <your_custom_registry> -u <user_with_write_access> bash copy-docker.txt
- Enter your Docker user name and password.
- Click Choose File to upload your Docker certificate.
In the Configure Databases page, follow the instructions
in the wizard to use your external existing databases with CDP Private
For production environments, Cloudera recommends that you use databases that you have previously created. These databases must all be on the same host and that host must be a PostgreSQL database server running version 10.6 or later.
Ensure that you have selected the Use TLS for Connections Between the Control Plane and the Database option if you have plan to use Cloudera Data Warehouse (CDW) Private Cloud. Enabling the base cluster PostgreSQL database to use an SSL connection to encrypt client-server communication is a requirement for CDW in CDP Private Cloud.
the databases must be created before you can proceed with the installation, and the database user must have permissions to create and drop databases on the server.
- Enter your Kubernetes, Docker, database, and vault information.
Upload a Kubernetes configuration (kubeconfig) file from your existing
environment. You can obtain this file from your OpenShift Container Platform
administrator. Ensure that this kubeconfig has permissions to create Kubernetes
In the Kubernetes Namespace field, enter the Kubernetes
namespace that you want to use with this CDP Private Cloud deployment.
Kubernetes virtual clusters are called namespaces. For more information, see Kubernetes namespaces.
Enter your Vault information and upload a CA certificate.
Cloudera recommends that you use an external Vault for production environments. Enter the Vault address and token, and upload a CA certificate.
Enter a Storage Class to be configured on the Kubernetes
cluster. CDP Private Cloud uses Persistent Volumes to provision storage. You can
leave this field empty if you have a default storage class configured on your
If you want to use this installation configuration again to install CDP Private
Cloud, you have the option to download this information as a template.
The template file is a text file that contains the database and vault information that you entered for this installation. This template is useful if you will be installing Private Cloud again with the same databases, as the template will populate the fields here automatically. Note that the user password information is not saved in the template.
Click Next to start the installation. Once the
installation completes, you can access your CDP Private Cloud using the
- Click Launch CDP to launch your CDP Private Cloud.
- Log in using the default user name and password
- In the Welcome to CDP Private Cloud page, click Change Password to change the Local Administrator Account password.
- Set up external authentication using the URL of the LDAP server and a CA certificate of your secure LDAP. Follow the instructions on the Welcome to CDP Private Cloud page to complete this step.
- Click Test Connection to ensure that you are able to connect to the configured LDAP server.
- Register a CDP Private Cloud environment
- Create your first Virtual Warehouse in the CDW experience
- Provision an ML Workspace in the CML experience