This command adds nodes, implements failover, controls Hadoop services, or reports component version in the cluster.
Syntaxhcli [--option] system [addNode -n FQDN --type=type | failover | start | stop | restart [--stale] | version [option] ]
- hcli system addNode -n FQDN --type=DATA | EDGE | MASTER [-h | --help]
- Add a new node to the configuration.
Exit code 0 if adding the node was successful; exit code 1 if the node could not be added.
- -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.
- Example: hcli system addNode -n hostname --type=DATA
- hcli system setup_kerberos [OPTIONS]
Important:Configure local MIT KDC and prepare the Hadoop cluster for Kerberos enablement using this command and the Enable Kerberos wizard.
Run this command before using the Enable Kerberos wizard.
The output of the command provides values you need to enter when using the 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 and the Kerberos admin principal kadmin/admin@<REALM>.
A principal and headless keytab will be created for the ‘tdatuser’ service account.
The local YARN usercache directories will be cleared.
During the execution of this command the user will be prompted to restart the cluster after making several configuration changes to various Hadoop services. This cluster restart is not mandatory, but if it is skipped, services will have stale configurations until they are restarted.
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.
- 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 start | stop | restart [--stale] [OPTION]
- Start, stop, or restart cluster services using Ambari.
- start Starts the cluster services using Ambari
- stop Stops the cluster services using Ambari
- restart [--stale] Restarts the cluster services using Ambari. The stale option restarts only services with stale configurations.
Option Description --yes Automatically answer 'yes' to all confirmation prompts --no Automatically answer 'no' to all confirmation prompts --help Show help for this commandExit code 0 indicates the command succeeded; exit code 1 indicates the command failed.
- Example: Restart stale services in the cluster and show verbose output.
hcli --verbose system restart --stale
- hcli system version [hdp | ambari | tools | tdh]
- Display component version information.
Options Description None Displays version information for all tools ambari Displays version of the Ambari server hdp Displays version of the Hadoop component only tdh Displays information for the Teradata Hadoop Tools only tools Displays information for the Hadoop Tools component onlyExit code 0 indicates the command succeeded; exit code 1 indicates the command failed.
- Example: To show all the component versions, run hcli system version
+----------------+-----------+ | Name | Version | +-----------------------+-----------+ | HDP | 2.3 | | AMBARI_SERVER | 2.1.2 | | teradata-hadoop-tools | 126.96.36.199 | | teradata-hdp-release | 188.8.131.52 | +-----------------------+-----------+