Getting Started
Also available as:
PDF

General requirements for DataPlane installation

Understanding the requirements and recommendations indicated below can help to avoid common issues during and after DataPlane installation.

  • Be sure to review the DP Platform Support Matrix to confirm you meet the environment and system requirements, including Docker and networking.
  • You need to have root access to the nodes on which all DP services will be installed.
  • 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.

  • DataPlane supports only PEM-encoded certificates and only with OpenSSL 1.0.2k or later.
  • 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).

  • Have your enterprise LDAP details available.

    See Enterprise LDAP Requirements for more details.

  • Determine which DP Apps you plan to install and which cluster(s) you plan to add to DataPlane.

    Be sure to review the app-specific documentation thoroughly to make sure you can meet the app-specific requirements. For example, depending on your choice of apps, your cluster requirements might change. This includes (but is not limited to) a minimal HDP or HDF version, setup and configuration of Knox, and other cluster requirements. See Preparing Your Cluster for more details.

The high-level installation procedure involves two work streams:

Installing DataPlane & the DP Apps

Install and configure the DP Platform and your target DP Apps.

Proceed to the DP Platform Installation guide.

Preparing Your Clusters for DataPlane

Prepare your clusters, which can include upgrading, adding and configuring Knox, and adding required DP Agents (per your choice of DP Apps).

Proceed to General requirements for clusters.