This is the documentation for Cloudera Manager 5.1.x.
Documentation for other versions is available at Cloudera Documentation.

Cloudera Manager Requirements

Cloudera Manager interacts with a diversity of entities such as operating systems, databases, and browsers. This topic provides information about which major release version and minor release version of each entity is supported. In some cases, such as some browsers, a minor version may not be provided. After installing each entity, upgrade to the latest patch version and apply any other appropriate updates. The available updates may be specific to the operating system on which it is installed. For example, you might be using CentOS in your environment. You could choose 6 as the major version and 4 as the minor version. These choices would mean you would be using CentOS 6.4. After installing this operating system, apply any and all relevant CentOS 6.4 upgrades and patches.

The following sections describe various requirements for Cloudera Manager.

Supported Operating Systems

Cloudera Manager supports the following operating systems:
  • RHEL-compatible systems
    • Red Hat Enterprise Linux and CentOS 5.7, 64-bit
    • Red Hat Enterprise Linux and CentOS 6.4, 64-bit
    • Red Hat Enterprise Linux and CentOS 6.4 in SE Linux Mode
    • Red Hat Enterprise Linux and CentOS 6.5, 64-bit
    • Oracle Enterprise Linux 5.6 (UEK R2), 64-bit
    • Oracle Enterprise Linux 6.4 (UEK R2), 64-bit
    • Oracle Enterprise Linux 6.5 (UEK R2, UEK R3), 64-bit
  • SLES - SUSE Linux Enterprise Server 11, 64-bit. Service Pack 2 or later is required for CDH 5 and Service Pack 1 or later is required for CDH 4. To use the embedded PostgreSQL database that is installed when you follow Installation Path A - Automated Installation by Cloudera Manager, the Updates repository must be active. The SUSE Linux Enterprise Software Development Kit 11 SP1 is required on hosts running the Cloudera Manager Agents.
  • Debian - Debian 7.0 and 7.1, 6.0 (deprecated), 64-bit
  • Ubuntu - Ubuntu 12.04, 10.04 (deprecated), 64-bit
  • Debian 6.0 and Ubuntu 10.04 are supported only for CDH 4.
  • Using the same version of the same operating system on all cluster hosts is strongly recommended.

Supported JDK Versions

Cloudera Manager supports Oracle JDK 7u55 and Oracle JDK 6u31, and installs them during installation and upgrade.

Supported Browsers

The Cloudera Manager Admin Console, which you use to install, configure, manage, and monitor services, supports the following browsers:
  • Firefox 11 or later
  • Google Chrome
  • Internet Explorer 9 or later
  • Safari 5 or later

Supported Databases

Cloudera Manager requires several databases. The Cloudera Manager Server stores information about configured services, role assignments, configuration history, commands, users, and running processes in a database of its own. You must also specify a database for the Activity Monitor and Reports Manager management services.

The database you choose to use must be configured to support UTF8 character set encoding. The embedded PostgreSQL database that is installed when you follow Installation Path A - Automated Installation by Cloudera Manager automatically provides UTF8 encoding. If you install a custom database, you may need to enable UTF8 encoding. The commands for enabling UTF8 encoding are described in each database's section under Cloudera Manager and Managed Service Databases.

After installing a database, upgrade to the latest patch version and apply any other appropriate updates. The available updates may be specific to the operating system on which it is installed.

Cloudera Manager and its supporting services can use the following databases:
Database OS CDH Version
MySQL 5.0 RHEL 5.7 CDH 4
MySQL 5.1 RHEL 6.4, Ubuntu 10.04, Debian 6.0 CDH 4
MySQL 5.5 SLES 11, Ubuntu 12.04, Debian 7.0 CDH 5
MySQL 5.6 CentOS 6.4 CDH 5
Oracle 11gr2 Oracle Database 11g Enterprise Edition Release CDH 4 and CDH 5
PostgreSQL 8.4 RHEL5.7, RHEL 6.4, Ubuntu 10.04, Ubuntu 12.04, Debian 6.0 CDH 4
PostgreSQL 9.1 SLES 11, Debian 7.0 CDH 5
PostgreSQL 9.2 CentOS 6.4 CDH 5

For information about the databases supported by CDH, see CDH 4 Supported Databases and CDH 5 Supported Databases.

Supported CDH and Managed Service Versions

The following versions of CDH and managed services are supported:
  Warning: Cloudera Manager 5 does not support CDH 3 and you cannot upgrade Cloudera Manager 4 to Cloudera Manager 5 if you have a cluster running CDH 3. Therefore, to upgrade CDH 3 clusters to CDH 4 using Cloudera Manager you must use Cloudera Manager 4.
  • CDH 4 and CDH 5. The latest released versions of CDH 4 and CDH 5 are strongly recommended. For information on CDH 4 requirements, see CDH 4 Requirements and Supported Versions. For information on CDH 5 requirements, see CDH 5 Requirements and Supported Versions.
  • Cloudera Impala - Cloudera Impala is included with CDH 5. Cloudera Impala 1.2.1 with CDH 4.1.0 or later. For further information on Cloudera Impala requirements with CDH 4, see Cloudera Impala Requirements.
  • Cloudera Search - Cloudera Search is included with CDH 5. Cloudera Search 1.2.0 with CDH 4.6.0. For further information on Cloudera Search requirements with CDH 4, see Cloudera Search Requirements.
  • Apache Spark - 0.90 or later with CDH 4.4.0 or later.
  • Apache Accumulo - 1.4.3 with CDH 4.3.0, 1.4.4 with CDH 4.5.0, and 1.6.0 with CDH 4.6.0.
For more information, see the Cloudera Product Compatibility Matrix.

Resource Requirements

Cloudera Manager requires resources of the following types:
  • Disk Space
    • Cloudera Manager Server
      • 5 GB on the partition hosting /var.
      • 500 MB on the partition hosting /usr.
      • For parcels, the space required depends on the number of parcels you download to the Cloudera Manager Server and distribute to Agent hosts. You can download multiple parcels of the same product, of different versions and builds. If you are managing multiple clusters, there will be only one parcel of a given product/version/build/distribution downloaded on the Cloudera Manager Server—not one per cluster. In the local parcel repository on the Cloudera Manager Server the approximate sizes of the various parcels are as follows:
        • CDH 4.6 - ~700 MB per parcel, CDH 5 - ~1 GB per parcel
        • Impala - ~200 MB per parcel
        • Solr - ~ 400 MB per parcel
    • Cloudera Management Service - The Host Monitor and Service Monitor databases are stored on the partition hosting /var. Ensure that you have at least 20 GB available on this partition. For further information, see Monitoring Data Storage.
    • Agents - On Agent hosts each unpacked parcel requires about three times the space of the downloaded parcel on the Cloudera Manager Server. By default unpacked parcels are located in /opt/cloudera/parcels.
  • RAM - 4 GB is appropriate for most cases, and is required when using Oracle databases. 2 GB may be sufficient for non-Oracle deployments involving fewer than 100 hosts. However, if you want to run the Cloudera Manager Server on a machine with 2 GB of RAM, you must tune down its maximum heap size (by modifying -Xmx in /etc/default/cloudera-scm-server). Otherwise the kernel may kill the Server for consuming too much RAM.
  • Python - Cloudera Manager uses Python. All supported operating systems contain a Python version 2.4 or higher. Cloudera Manager and CDH 4 require at least Python 2.4, but Hue in CDH 5 requires Python 2.6 or 2.7.

Networking and Security Requirements

  • Cluster hosts must have a working network name resolution system and correctly formatted /etc/hosts file. All cluster hosts must have properly configured forward and reverse host resolution through DNS. The /etc/hosts files must contain consistent information about host names and addresses across all hosts. A properly formatted /etc/hosts should be similar to the following example:	localhost.localdomain	localhost	cluster-01	cluster-02	cluster-03 
    The /etc/hosts file must not have duplicate IP addresses.
  • In most cases, the Cloudera Manager Server must have SSH access to the cluster hosts when you run the installation or upgrade wizard. You must log in using a root account or an account that has password-less sudo permission. For authentication during the installation and upgrade procedures, you must either enter the password or upload a public and private key pair for the root or sudo user account. If you want to use a public and private key pair, the public key must be installed on the cluster hosts before you use Cloudera Manager.

    Cloudera Manager uses SSH only during the initial install or upgrade. Once your cluster is set up, you can disable root SSH access or change the root password. Cloudera Manager does not save SSH credentials and all credential information is discarded once the installation is complete. For further information, see Permission Requirements.

  • The Cloudera Manager Agent runs as root so that it can make sure the required directories are created and that processes and files are owned by the appropriate user (for example, the hdfs and mapred users).
  • No blocking by Security-Enhanced Linux (SELinux).
  • Disable Ipv6 on all hosts.
  • No blocking by iptables or firewalls; make sure port 7180 is open because it is the port used to access Cloudera Manager after installation. Cloudera Manager communicates using specific ports, which must be open. See Configuring Ports for Cloudera Manager.
  • For RedHat and CentOS, make sure the/etc/sysconfig/network file on each system contains the hostname you have just set (or verified) for that system.
  • Cloudera Manager and CDH use several user accounts and groups to complete their tasks. The set of user accounts and groups varies according to which components you choose to install. Do not delete these accounts or groups and do not modify their permissions and rights. Ensure no existing systems obstruct the functioning of these accounts and groups. For example, if you have scripts that delete user accounts not in a white-list, add these accounts to the list of permitted accounts. Cloudera Manager, CDH, and managed services create and use the following accounts and groups:
    Account Type Product
    User and group Cloudera Manager
    User and group CDH 4, CDH 5
    Group CDH 4, CDH 5
    User and group CDH 4, CDH 5
    User and group. Must also be a member of the hadoop group. CDH 4, CDH 5
    User and group CDH 4, CDH 5
    User and group CDH 4, CDH 5
    User and group CDH 4, CDH 5
    User and group. Must also be member of the hdfs and hive groups. CDH 4.1 or later, CDH 5
    User and group CDH 5
    User and group. Must also be a member of the hadoop group. CDH 4, CDH 5
    User and group CDH 4, CDH 5
    User and group CDH 4.3 and later, CDH 5
    User and group Spark, CDH 5
    User and group CDH 4, CDH 5
    User. Must be member of the sqoop group. CDH 4.2 and later, CDH 5
    User and group CDH 4, CDH 5
    User and group CDH 4, CDH 5