This section contains hardware and software requirements for successful installation of .

Platform Node Requirements

Node Installation Requirements

If the is installed in a Hadoop environment, the software must be installed on an edge node of the cluster.

• If it is integrated with a Cloudera cluster, it must be installed on a gateway node that is managed by Cloudera Manager.
  • If it is integrated with Cloudera Data Platform, it must be installed on an edge node of the cluster.
•  If it is integrated with a Hortonworks cluster, it must be installed on an Ambari/Hadoop client that is managed by Hortonworks Ambari.
  
• If it is integrated with an HDI cluster, it must be installed on an edge node.
• Customers who originally installed an earlier version on a non-edge node will still be supported. If the software is not installed on an edge node, you may be required to copy over files from the cluster and to synchronize these files after upgrades. The cluster upgrade process is more complicated.
• This requirement does not apply to the following cluster integrations:
  • AWS EMR
  • Azure Databricks

Hardware Requirements

Minimum hardware:

Recommended hardware:

Operating System Requirements

The following operating systems are supported for the . The requires 64-bit versions of any supported operating system.

CentOS/RHEL versions:

• CentOS  7.4 - 7.7, 8.1

  NOTE: MySQL 5.7 Community is not supported on CentOS/RHEL 8.1.

• RHEL 7.4 - 7.7, 8.1

Notes on CentOS/RHEL installation:

• For security reasons, RHEL 7.3 is not supported for installation of Release 5.0 or later of the . Please upgrade to RHEL 7.4 or a later supported release.
• Installation on CentOS/RHEL versions 7.4 or earlier requires an upgrade of the RPM software on the . Details are provided during the installation process.
  
• Disabling SELinux on the is recommended. However, if security policies require it, you may need to apply some changes to the environment.
  

Ubuntu versions:

• Ubuntu 18.04 (codename Bionic Beaver)

• Ubuntu 16.04 (codename Xenial)

Notes on Ubuntu installation:

• For Ubuntu installations, some packages must be manually installed. Instructions are provided later in the process.

For more information on RPM dependencies, see System Dependencies.

Database Requirements

The following database versions are supported by the for storing metadata and the user's recipes.

Supported database versions:

• PostgreSQL 12.3
  

• PostgreSQL 9.6

• MySQL 5.7 Community

  NOTE: MySQL 5.7 Community is not supported on CentOS/RHEL 8.1.

Notes on database versions:

• MySQL 5.7 is not supported for installation in Amazon RDS.
  

  NOTE: If you are installing or upgrading a deployment of that uses or will use a remote database service, such as Amazon RDS, for hosting the , please contact . For this release, additional configuration may be required.

  
  

  
  

• If you are installing the databases into MySQL, you must download and install the MySQL Java driver onto the . For more information, see Install Databases for MySQL in the Databases Guide.

• H2 database type is used for internal testing. It is not a supported database.
  

For more information on installing and configuring the database, see Install Databases in the Databases Guide.

Other Software Requirements

The following software components must be present.

Java

Where possible, you should install the same version of Java on the and on the cluster with which you are integrating.

• Java 1.8

Notes on Java versions:

• OpenJDK 1.8 is officially supported. It is installed on the during the installation process.
  

  NOTE: If you are using Azure Databricks as a datasource, please verify that openJDKv1.8.0_242 or earlier is installed on the . Java 8 is required. There is a known issue with TLS v1.3.

• There are additional requirements related to Java JDK listed in the Hadoop Components section listed below.
• If you are integrating your with S3, you must install the Oracle JRE 1.8 onto the . No other version of Java is supported for S3 integration. For more information, see Enable S3 Access in the Configuration Guide.

Other Software

For Ubuntu installations, the following packages must be manually installed using Ubuntu-specific versions:

• NginX: 1.17.7
• NodeJS 12.19.1

Instructions and version numbers are provided later in the process.

Root User Access

Installation must be executed as the root user on the .

SSL Access

(Optional) If users are connecting to the , an SSL certificate must be created and deployed. See Install SSL Certificate in the Install Guide.

Internet Access

(Optional) Internet access is not required for installation or operation of the platform. However, if the server does not have Internet access, you must acquire additional software as part of the disconnected install. For more information, see Install Dependencies without Internet Access  in the Install Guide.

Hadoop Cluster Requirements

The following requirements apply if you are integrating the with an enterprise Hadoop cluster.

• For general guidelines on sizing the cluster, see Sizing Guidelines.
• If you have upgrades to the Hadoop cluster planned for the next year, you should review those plans with Support prior to installation. For more information, please contact .

Supported Hadoop Distributions

The supports the following minimum Hadoop distributions.

• The only supports the latest major release and its minor releases of each distribution.
• The only supports the versions of any required components included in a supported distribution. Even if they are upgraded components, use of non-default versions of required components is not supported.
  

Cloudera supported distributions

• CDH 6.3 Recommended

• CDH 6.2

• CDH 6.1

  NOTE: CDH 6.x requires that you use the native Spark libraries provided by the cluster. Additional configuration is required. For more information, see Configure for Spark in the Configuration Guide.

• CDH 5.16  Recommended
• Cloudera Data Platform 7.1

See Supported Deployment Scenarios for Cloudera in the Install Guide.

Hortonworks supported distributions

• HDP 3.1   Recommended

• HDP 3.0
  
  

  NOTE: HDP 3.x requires that you use the native Spark libraries provided by the cluster. Additional configuration is required. For more information, see Configure for Spark in the Configuration Guide.

• HDP 2.6

See Supported Deployment Scenarios for Hortonworks  in the Install Guide.

EMR supported distributions

See Configure for EMR in the Configuration Guide.

HDInsight supported distributions

See Configure for HDInsight in the Configuration Guide.

Azure Databricks supported distributions

See Configure for Azure Databricks in the Configuration Guide.

Node Requirements

Each cluster node must have the following software:

• Java JDK 1.8 (some exceptions may be listed below)

Hadoop Component Access

The must have access to the following.

Java and Spark version requirements

The following matrix identifies the supported versions of Java and Spark on the Hadoop cluster. Where possible, you should install the same version of Java on the and on the cluster with which you are integrating.

Notes:

• Java must be installed on each node of the cluster. For more information, see https://www.cloudera.com/documentation/enterprise/latest/topics/cdh_ig_jdk_installation.html.
• The versions of Java on the and the Hadoop cluster do not have to match.

• If you are integrating with an EMR cluster, there are specific version requirements for EMR. See Configure for Spark in the Configuration Guide.

Other components

• HDFS Namenode

  • WebHDFS

    • In HDFS, Append Mode must be enabled. See Prepare Hadoop for Integration with the Platform.

    • If you are enabling high availability failover, you must use HttpFS, instead of WebHDFS. See Enable Integration with Cluster High Availability in the Configuration Guide.

• For YARN:

  • ResourceManager is running.
  • ApplicationMaster's range of ephemeral ports are open to the .
• HiveServer2:
  • HiveServer2 is supported for metadata publishing.
  • WebHCat is not supported.

Hadoop System Ports

For more information, see System Ports.

Site Configuration Files

Hadoop cluster configuration files must be copied into the . See Configure for Hadoop in the Configuration Guide.

Security Requirements

• Kerberos supported:
  • If Kerberos is enabled, a keytab file must be accessible to the .
  • See Configure for Kerberos Integration in the Configuration Guide.
• If Kerberos and secure impersonation are not enabled:
  • A user must be created on each node of the Hadoop cluster.
  • A directory must be created on the cluster.
  • The user must have full access to the directory. which enables storage of the transformation recipe back into HDFS.
  • See Configure for Hadoop in the Configuration Guide.

Cluster Configuration

For more information on integration with Hadoop, see Prepare Hadoop for Integration with the Platform.

User Requirements

Users must access the through one of the supported browser versions. For more information on user system requirements, see Desktop Requirements.

I/O Requirements

See Supported File Formats in the User Guide.