Adding an HDP classic cluster

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

About this task

To ensure optimum 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 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.

Before you begin

  • HDP clusters must be managed by Ambari. HDP clusters that are not managed by Ambari cannot be registered to CDP.
  • HDP clusters must include Knox.
  • HDP clusters must include Ranger policy settings
  • LDAP/AD must be set up and synced in Ambari.

    LDAP settings are automatically detected from the default topology setup in Knox. If the default topology does not have the LDAP setup, you will be asked to provide another topology name where you have configured the LDAP. If that topology has LDAP, the setup continues. If the LDAP is not configured, you will receive an error message.

  • Kerberos must be enabled on the HDP cluster and the LDAP/AD must be set up in the Kerberos authentication so that the same set of LDAP/AD credentials can be used to access Ambari APIs as well as Beacon APIs.
  • All clusters must meet the requirements identified in Prerequisites for adding classic clusters.


The process to register an HDP cluster is as follows:

  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. If you are a first time user, under Step 1 in the Register Classic Cluster wizard, click GET STARTED. If you are not a first time user, click the ADD CLUSTER button on the right side of the listing page.

    CDP displays the Cluster Details dialog box.

  5. Select HDP.
  6. Provide the following connectivity information for your new cluster:
    1. Knox IP Address

    2. Knox port

    3. Data center

    4. Click CONNECT

    Step 1 might take up to 5 minutes if you are adding the cluster for the first time. After Classic Cluster establishes connection, CDP will highlight Step 2 in the Register Classic Cluster wizard.

  7. Start the download and installation process for the connectivity files by clicking the Files button in Step 2 of the wizard.
  8. 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 files and copy them to your Knox node. Or if your Knox is running in HA mode, you need to copy the files to the Knox proxy host in the cluster:
    1. Download the jumpgate-agent RPM and

    2. In the command line interface, copy the two files to the Knox or Knox proxy host.

    3. SSH to the host.

    4. Install the jumpgate-agent rpm using:

      yum --nogpgcheck localinstall < downloaded-jumpgate-agent-rpm >
    1. Unzip the cluster_connectivity_setup_files file. Inside this zip file there is a script

    2. Run by using ./ command.

    3. Check service status to see if the agent has been connected:
      systemctl status jumpgate-agent.service 
  9. Enter the following information as the install script prompts for it:
    1. Enter Ambari URL (http(s)://host:[port]):

    2. Enter Ambari Username:

    3. Enter Ambari Password:

  10. If Knox is not installed on a proxy server, proceed to Step 12. Classic Cluster sets up the topology for the Knox server and establishes the connection.
  11. If Knox is installed on a proxy server, Classic Cluster displays the following message:We discovered that your Knox is installed in HA mode. Please confirm if this node is your proxy node (yes/no):Enter yes.Classic Cluster generates XML content that you will need to add to your Knox hosts. Classic Cluster also displays three steps you must perform on all of your Knox hosts:
    1. Copy the generated XML to /usr/hdp/current/knox-server/conf/topologies/cdp_default.xml

    2. Run chown knox:knox cdp_default.xml

    3. Check the Knox logs/deployment directory to verify that the cdp_default topology is deployed.

    4. After you have completed steps a through c on all of your Knox hosts, type Enter to continue.This sets up the topology for the Knox server or Knox proxy host and establishes the connection.

  12. On the Classic Clusters page, click Test Connection in the Step 2 pane to verify whether the connection is successful.
  13. CDP starts checking the connectivity with the HDP cluster. When the connectivity is successful, proceed to Step 3 in the wizard.
    If the connection attempts fail or if there is an error in the connectivity,CDP displays troubleshooting information in Step 2 of the registration wizard. Follow the troubleshooting information to fix the connectivity error, then click Test connection.
  14. Click Register in Step 3 of the registration wizard.
  15. In the Cluster Details dialog box, provide the username and password to access the cluster, then click CONNECT.

    The user should have admin access to the cluster services.

  16. Finish registering the cluster by providing the following information.
    1. Cluster Location

    2. Data Center

    3. Tags (optional)

    4. Description (optional)

    If LDAP is not set up on the default topology, the system will ask for the following additional information: Enter knox topology name that contains LDAP setup.
  17. Click ADD.


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