Add a cluster

You must register clusters with DataPlane instance before you can use those clusters with DP Apps.

	Caution
	After you register a cluster in DP Platform, do not change the cluster name in Ambari. A cluster name change in Ambari does not currently propagate to DataPlane, which can result in issues when using clusters with DP Apps.

You must be logged in using the DataPlane Admin (DP Admin) role with valid LDAP credentials, to perform this task.
If your clusters are configured for Knox Gateway and you are using a self-signed SSL certificate with Knox, you must have uploaded your certificate to DataPlane prior to starting this task (or you can disable certificate validation on registration). Refer to “Upload a certificate to DataPlane” for more information.
Clusters must have been created using Apache Ambari.
Clusters that are not managed by Ambari cannot be registered to DataPlane.
All clusters must meet the requirements identified in DataPlane Getting Started.

In the DP Platform navigation pane, click the (Clusters) icon.
Click Add Cluster.
(Optional) Check Ambari and Cluster Services Behind Knox Gateway only if you are using Knox Gateway to proxy Ambari, cluster services(including DP App agents).
(Optional) Check Validate the SSL certificate and only allow trusted connections only if your cluster is SSL-enabled.
When checked, DataPlane validates the SSL certificate.
If you plan to validate the SSL certificate but the certificate is self-signed, be sure to upload the certificate to DataPlane. Refer to “Upload a certificate to DataPlane” for more information.

Enter the URL of the Ambari host that manages the cluster.

If the cluster is behind a Knox Gateway, use the following format:
```
https://knox_host_fqdn:knox_port/gateway_name/dp-proxy/ambari
```
By default, the gateway_name is gateway.
If the cluster is not using Knox Gateway, use the following format:
```
https://ambari_host_fqdn:ambari_port/
```
You can use HTTP or HTTPS. HTTPS is used if Wire Encryption is enabled for Ambari.

You can also enter the IP address instead of the FQDN, but the FQDN is recommended.

The host name must either be in a DNS server or configured in the etc/hosts file.

	Important
DP Platform host must be able to resolve and reach the Ambari URL, whether you are using the FQDN or the IP address. That is, you should be able to use curl or wget to access the Ambari URL from the DP Platform host. If this requirement is not met, cluster registration fails. If host names are resolved from /etc/hosts, you should explicitly register the cluster host names on the DataPlane container before the cluster is registered with DataPlane.

Important

DP Platform host must be able to resolve and reach the Ambari URL, whether you are using the FQDN or the IP address. That is, you should be able to use curl or wget to access the Ambari URL from the DP Platform host. If this requirement is not met, cluster registration fails.

If host names are resolved from /etc/hosts, you should explicitly register the cluster host names on the DataPlane container before the cluster is registered with DataPlane.

Click Go.
The cluster name, IP address, and enabled cluster services are displayed.
Add the following cluster details:
- Cluster Location
- Data Center
- Tags (optional)
- Description (optional)

You can now enable the registered cluster for the DP App you want to use it with.