Adding a CDH cluster (CCMv2)

You must register CDH clusters in CDP before you can use them with CDP Public Cloud services and components.

About this task

To ensure optimal security, clusters within the customer environment are not accessible for communication; They have private IP addresses and cannot be accessed outside the firewall. To add your cluster to the CDP, a communication line needs to be established.

The CCM inverted proxy solves the problem by establishing a connection from the on-premise cluster to CDP. You must download and install the jumpgate agent and the connectivity install scripts to establish a secure two-way communication channel. The jumpgate agent ensures that the connectivity is stable. The connectivity scripts and their installation ensure safe connectivity and communication.

The high-level steps to register a CDH cluster using CCM are as follows:

  1. In the CDP Management Console, you enter the private IP address of your cluster and provide the cluster details.

  2. You download the jumpgate agent rpm from the specified location and the connectivity installation scripts from CDP on to the cluster.

  3. You install jumpgate agent on the cluster.

  4. You register the cluster for performing further operations.

Detailed steps are provided below.

Before you begin

  • CDH clusters must have been created using Cloudera Manager. Clusters that are not managed by Cloudera Manager cannot be registered to CDP.

  • All clusters must meet the requirements identified in Prerequisites for adding classic clusters.


Perform the following steps to add a CDH cluster:

  1. Log in to CDP and navigate to the Management Console.

  2. Click Classic Clusters in the left navigation panel.

  3. Click Add Cluster.

    CDP displays the Cluster Details dialog box.

  4. Click CDH.

  5. Provide the connectivity information for your new cluster:
    1. Cloudera Manger IP address

    2. Cloudera Manager Port

    3. Data center

    4. Select the My cluster runs on HTTPS option if the CDH cluster uses HTTPS.

    Step 1 might take up to five minutes if you are adding the cluster for the first time. After Step 1 is complete, CDP will highlight Step 2.
  6. Start the download and installation process for the connectivity files by clicking the Files button in the Step 2 pane.
  7. Follow the instructions in the Setup Connectivity Client dialog box. You need to download the jumpgate-agent rpm file and the cluster_connectivity_setup_files zip file onto Cloudera Manager host in your new cluster:
    1. Download the jumpgate-agent RPM and cluster_connectivity_setup_files.

    2. In the command line interface, copy the two files to the Cloudera Manager host.

    3. SSH to the Cloudera Manager host.

    4. Install the jumpgate-agent rpm using:
      yum --nogpgcheck localinstall < 
      downloaded-jumpgate-agent-rpm >
    5. Unzip the cluster_connectivity_setup_files file. Inside this zip file there is a script
    6. Run by using ./ command.
    7. Check service status to see if the agent has been connected:
      systemctl status jumpgate-agent.service 

    On the Classic Clusters page, click Test Connection in the Step 2 pane to verify whether the connection is successful.

    After CDP successfully connects to your new cluster, it will highlight Step 2. the connectivity with the cluster. When the connectivity is successful, proceed to Step 3 in the UI.

    If the connection attempts fail or if there is an error in the connectivity, CDP displays troubleshooting information in the Step 2 pane. Follow the troubleshooting information to fix the connectivity error, then click Test connection.

  8. Click Register in the Step 3 pane.
  9. Provide the username and password of the Cloudera Manager user to access the cluster.
  10. Finishing registering the cluster by providing the following information:
    1. Cluster Location

    2. Data Center

    3. Tags (optional)

    4. Description (optional)

  11. Click Submit.


Once the cluster has been registered, you can use it with CDP.