Hortonworks Data Platform December 15, 2017
ii
Hortonworks Data Platform: Apache Ambari Operations
Copyright © 2012-2017 Hortonworks, Inc. Some rights reserved.
The Hortonworks Data Platform, powered by Apache Hadoop, is a massively scalable and 100% open
source platform for storing, processing and analyzing large volumes of data. It is designed to deal with
data from many sources and formats in a very quick, easy and cost-effective manner. The Hortonworks
Data Platform consists of the essential set of Apache Hadoop projects including MapReduce, Hadoop
Distributed File System (HDFS), HCatalog, Pig, Hive, HBase, ZooKeeper and Ambari. Hortonworks is the
major contributor of code and patches to many of these projects. These projects have been integrated and
tested as part of the Hortonworks Data Platform release process and installation and configuration tools
have also been included.
Unlike other providers of platforms built using Apache Hadoop, Hortonworks contributes 100% of our
code back to the Apache Software Foundation. The Hortonworks Data Platform is Apache-licensed and
completely open source. We sell only expert technical support, training and partner-enablement services.
All of our technology is, and will remain free and open source.
Please visit the Hortonworks Data Platform page for more information on Hortonworks technology. For
more information on Hortonworks services, please visit either the Support or Training page. Feel free to
Contact Us directly to discuss your specific needs.
Except where otherwise noted, this document is licensed under
Creative Commons Attribution ShareAlike 4.0 License.
http://creativecommons.org/licenses/by-sa/4.0/legalcode
Hortonworks Data Platform December 15, 2017
iii
Table of Contents
1. Ambari Operations: Overview ...................................................................................... 1
1.1. Ambari Architecture .......................................................................................... 1
1.2. Accessing Ambari Web ...................................................................................... 2
2. Understanding the Cluster Dashboard ......................................................................... 5
2.1. Viewing the Cluster Dashboard ......................................................................... 5
2.1.1. Scanning Operating Status ..................................................................... 6
2.1.2. Viewing Details from a Metrics Widget ................................................... 7
2.1.3. Linking to Service UIs ............................................................................. 7
2.1.4. Viewing Cluster-Wide Metrics ................................................................. 8
2.2. Modifying the Cluster Dashboard ...................................................................... 9
2.2.1. Replace a Removed Widget to the Dashboard ...................................... 10
2.2.2. Reset the Dashboard ............................................................................ 10
2.2.3. Customizing Metrics Display ................................................................. 11
2.3. Viewing Cluster Heatmaps .............................................................................. 11
3. Managing Hosts ......................................................................................................... 13
3.1. Understanding Host Status .............................................................................. 13
3.2. Searching the Hosts Page ................................................................................ 14
3.3. Performing Host-Level Actions ......................................................................... 17
3.4. Managing Components on a Host ................................................................... 18
3.5. Decommissioning a Master or Slave ................................................................. 19
3.5.1. Decommission a Component ................................................................ 20
3.6. Delete a Component ....................................................................................... 20
3.7. Deleting a Host from a Cluster ........................................................................ 21
3.8. Setting Maintenance Mode ............................................................................. 21
3.8.1. Set Maintenance Mode for a Service .................................................... 22
3.8.2. Set Maintenance Mode for a Host ........................................................ 22
3.8.3. When to Set Maintenance Mode .......................................................... 23
3.9. Add Hosts to a Cluster .................................................................................... 24
3.10. Establishing Rack Awareness ......................................................................... 25
3.10.1. Set the Rack ID for Ambari ................................................................. 26
3.10.2. Set the Rack ID Using a Custom Topology Script ................................. 27
4. Managing Services ..................................................................................................... 28
4.1. Starting and Stopping All Services ................................................................... 29
4.2. Displaying Service Operating Summary ............................................................ 29
4.2.1. Alerts and Health Checks ...................................................................... 30
4.2.2. Modifying the Service Dashboard ......................................................... 30
4.3. Adding a Service ............................................................................................. 32
4.4. Performing Service Actions .............................................................................. 36
4.5. Rolling Restarts ............................................................................................... 36
4.5.1. Setting Rolling Restart Parameters ........................................................ 37
4.5.2. Aborting a Rolling Restart .................................................................... 38
4.6. Monitoring Background Operations ................................................................ 38
4.7. Removing A Service ......................................................................................... 40
4.8. Operations Audit ............................................................................................ 40
4.9. Using Quick Links ............................................................................................ 40
4.10. Refreshing YARN Capacity Scheduler ............................................................. 41
4.11. Managing HDFS ............................................................................................ 41
4.11.1. Rebalancing HDFS ............................................................................... 42
Hortonworks Data Platform December 15, 2017
iv
4.11.2. Tuning Garbage Collection ................................................................. 42
4.11.3. Customizing the HDFS Home Directory ............................................... 43
4.12. Managing Atlas in a Storm Environment ....................................................... 43
4.13. Enabling the Oozie UI ................................................................................... 44
5. Managing Service High Availability ............................................................................. 46
5.1. NameNode High Availability ............................................................................ 46
5.1.1. Configuring NameNode High Availability .............................................. 46
5.1.2. Rolling Back NameNode HA ................................................................. 51
5.1.3. Managing Journal Nodes ...................................................................... 61
5.2. ResourceManager High Availability ................................................................. 66
5.2.1. Configure ResourceManager High Availability ....................................... 66
5.2.2. Disable ResourceManager High Availability ........................................... 67
5.3. HBase High Availability .................................................................................... 69
5.4. Hive High Availability ...................................................................................... 74
5.4.1. Adding a Hive Metastore Component .................................................. 74
5.4.2. Adding a HiveServer2 Component ........................................................ 74
5.4.3. Adding a WebHCat Server .................................................................... 75
5.5. Storm High Availability .................................................................................... 75
5.5.1. Adding a Nimbus Component .............................................................. 75
5.6. Oozie High Availability .................................................................................... 76
5.6.1. Adding an Oozie Server Component ..................................................... 76
5.7. Apache Atlas High Availability ......................................................................... 77
5.8. Enabling Ranger Admin High Availability ......................................................... 79
6. Managing Configurations ........................................................................................... 80
6.1. Changing Configuration Settings ..................................................................... 80
6.1.1. Adjust Smart Config Settings ................................................................ 81
6.1.2. Edit Specific Properties ......................................................................... 82
6.1.3. Review and Confirm Configuration Changes ......................................... 82
6.1.4. Restart Components ............................................................................. 84
6.2. Manage Host Config Groups ........................................................................... 84
6.3. Configuring Log Settings ................................................................................. 87
6.4. Set Service Configuration Versions ................................................................... 89
6.4.1. Basic Concepts ...................................................................................... 89
6.4.2. Terminology ......................................................................................... 90
6.4.3. Saving a Change ................................................................................... 90
6.4.4. Viewing History .................................................................................... 91
6.4.5. Comparing Versions .............................................................................. 92
6.4.6. Reverting a Change .............................................................................. 93
6.4.7. Host Config Groups .............................................................................. 93
6.5. Download Client Configuration Files ................................................................ 94
7. Administering the Cluster ........................................................................................... 96
7.1. Using Stack and Versions Information ............................................................. 96
7.2. Viewing Service Accounts ................................................................................ 98
7.3. Enabling Kerberos and Regenerating Keytabs ................................................. 99
7.3.1. Regenerate Key tabs .......................................................................... 100
7.3.2. Disable Kerberos ................................................................................. 100
7.4. Enable Service Auto-Start .............................................................................. 101
8. Managing Alerts and Notifications ........................................................................... 104
8.1. Understanding Alerts .................................................................................... 104
8.1.1. Alert Types ......................................................................................... 105
8.2. Modifying Alerts ............................................................................................ 106
Hortonworks Data Platform December 15, 2017
v
8.3. Modifying Alert Check Counts ....................................................................... 106
8.4. Disabling and Re-enabling Alerts ................................................................... 107
8.5. Tables of Predefined Alerts ........................................................................... 107
8.5.1. HDFS Service Alerts ............................................................................. 108
8.5.2. HDFS HA Alerts .................................................................................. 111
8.5.3. NameNode HA Alerts ......................................................................... 112
8.5.4. YARN Alerts ....................................................................................... 113
8.5.5. MapReduce2 Alerts ............................................................................ 114
8.5.6. HBase Service Alerts ........................................................................... 114
8.5.7. Hive Alerts .......................................................................................... 115
8.5.8. Oozie Alerts ....................................................................................... 116
8.5.9. ZooKeeper Alerts ................................................................................ 116
8.5.10. Ambari Alerts ................................................................................... 116
8.5.11. Ambari Metrics Alerts ....................................................................... 117
8.5.12. SmartSense Alerts ............................................................................. 118
8.6. Managing Notifications ................................................................................. 118
8.7. Creating and Editing Notifications ................................................................. 118
8.8. Creating or Editing Alert Groups ................................................................... 120
8.9. Dispatching Notifications ............................................................................... 121
8.10. Viewing the Alert Status Log ....................................................................... 121
8.10.1. Customizing Notification Templates .................................................. 122
9. Using Ambari Core Services ...................................................................................... 125
9.1. Understanding Ambari Metrics ...................................................................... 125
9.1.1. AMS Architecture ............................................................................... 125
9.1.2. Using Grafana .................................................................................... 126
9.1.3. Grafana Dashboards Reference ........................................................... 132
9.1.4. AMS Performance Tuning ................................................................... 170
9.1.5. AMS High Availability ......................................................................... 175
9.2. Ambari Log Search (Technical Preview) .......................................................... 177
9.2.1. Log Search Architecture ...................................................................... 177
9.2.2. Installing Log Search ........................................................................... 178
9.2.3. Using Log Search ................................................................................ 178
9.3. Ambari Infra ................................................................................................. 182
9.3.1. Archiving & Purging Data ................................................................... 182
