Installation prerequisites

Product binaries

Prior to starting the DataPlane Installation, you must download the DataPlane repository tarballs (i.e. the “product binaries”) from the Hortonworks Customer Portal following the instructions provided as part of the subscription fulfillment process. DP Platform and the DP Apps (and related Agents) are provided as RPMs in tarball repositories.

Check DNS

Your system must be configured for both forward and reverse DNS.

Every host name used with DataPlane must be resolvable by DNS or configured in the /etc/hosts file on the DataPlane container, so that host names can be resolved between all cluster nodes. Using a DNS server is the recommended method, but if the instances are added to /etc/hosts, you must explicitly register the cluster host names within the DataPlane Docker containers. It is not sufficient to have the host names included in the /etc/hosts file on the DP Platform host. See the DP Platform Administration guide for instructions.

	Note
	If you are using AWS, do not use the public DNS to access DataPlane. Use a public IP address or set up and use a DNS (Route 53) fully qualified domain name (FQDN).

Check ports

The DP Host requires the following ports to be available on the host:


Port	Description
80, 443	The DP Instance Web UI. Port 80 is redirected to port 443 for SSL. Refer to Configuring DP Platform to configure your own certificate.
8500	Used by Consul which handles the Docker container networking.

Disable SELinux

You must disable SELinux enforcement of permissions before installing the DataPlane service, due to an issue with SELinux and Docker.

If you do not disable SELinux, then DataPlane will not install and run properly, and you will have to destroy and reinstall the containers.

setenforce 0    #A zero, not a letter
sed -i 's/^SELINUX=.*/SELINUX=disabled/g' /etc/sysconfig/selinux

	Important
	The second command prevents SELinux from being automatically re-enabled after a reboot.

Install Docker

Docker containers are used to install each DataPlane service. You must install either Docker Enterprise Edition (EE) or Community Edition (CE). You might be required to reboot your system after installing Docker.

For general information about installing Docker, see Install Docker.

For Docker installation instructions for your operating system, access the appropriate Docker instructions:

LDAP

You need access to an enterprise LDAP setup when configuring DataPlane. Refer to Enterprise LDAP requirements for more information on the LDAP settings and options.

External Database

By default, DP Platform includes an embedded PostgreSQL instance for testing and evaluation purposes only. You should configure your DP instance to use an external PostgreSQL instance. We strongly recommend configuring DP Platform with an existing external database when running in production, and not use the embedded PostgreSQL. Refer to Configuring DP Platform for more information.