5.12.1 - 5.13 - system - Cloudera Distribution for Hadoop

Cloudera Distribution for Hadoop for Teradata Administrator Guide

Cloudera Distribution for Hadoop
Release Number
November 2017
English (United States)
Last Update


This command adds nodes, implements failover, controls Hadoop services, or reports component version in the cluster.


hcli [--option] system [addNode -n FQDN --type=type | version [option] ]


hcli system addNode -n FQDN --type=DATA | EDGE | MASTER [-h | --help]
Add a new node to the configuration.
  • -n FQDN Name of the node and Fully Qualified Domain Name added to the configuration.
  • --type=type Type of the node, data or edge, or master to be added to the configuration.
  • -h | --help Show help for this command.
Exit code 0 if adding the node was successful; exit code 1 if the node could not be added.
hcli system addNode -n hostname --type=DATA
hcli system setup_kerberos [OPTIONS]

Run this command before using the Enable Kerberos wizard.

The output of the command provides values you need to enter when using the wizard.

Configure local MIT KDC and prepare the Hadoop cluster for Kerberos enablement using this command and the Enable Kerberos wizard.

Executing this command will install the krb5-server package on Master Node 1 and install the krb5-client package on all nodes in the Hadoop cluster.

During the execution of this command the user will be prompted to set the password for the KDC database master key, the Kerberos admin principal cloudera-scm/admin@<REALM>, and the HDFS Superuser principal hdfs@<REALM>.

A principal and headless keytab will be created for the ‘tdatuser’ service account.

The local YARN usercache directories and the YARN StateStore znode in ZooKeeper will be cleared. Before clearing the YARN StateStore znode, the user will be prompted to stop YARN, which is not mandatory, but if it is skipped the user must manually clear the znode before enabling Kerberos.

Option Description
-n | --node Optionally specify the Fully Qualified Domain Name of the host on which to install the MIT KDC.

If not specified, the default host is Master Node 1.

-r | --realm Optionally specify a custom Kerberos realm name.

If not specified, the default realm name will be based on the cluster name.

  • Run the command from Master Node 1.
  • You cannot run the command if Kerberos is already enabled on the cluster.
  • You cannot run the command if the cluster’s host names are not all lowercase.
  • Exit code 0 indicates the Kerberos setup succeeded; exit code 1 indicates the setup failed.

Once the command is complete, run the Enable Kerberos wizard.

hcli system version [--cdh | --cm | --tools]
Display component version information.
Options Description
None Displays version information for all tools
--cdh Displays information for the Hadoop component only
--cm Displays information for the Cloudera Manager component only
--tools Displays information for the Hadoop Tools component only
Exit code 0 indicates the command succeeded; exit code 1 indicates the command failed.
To show the component versions, run hcli system version
| Name                      | Version   |
| CDH                       | 5.4.5     |
| CM_SERVER                 | 5.4.6     |
| teradata-hadoop-tools-cdh | 5.4.50.x  |