Hortonworks Data Platform

Ambari Reference Guide

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at


Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.



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.


1. Installing Ambari Agents Manually
1. Download the Ambari Repo
2. Install the Ambari Agents Manually
2. Customizing HDP Services
1. Defining Service Users and Groups for a HDP 2.x Stack
2. Setting Properties That Depend on Service Usernames/Groups
3. Configuring Storm for Supervision
4. Using Custom Host Names
1. How to Customize the name of a host
5. Moving the Ambari Server
1. Back up Current Data
2. Update all Agents
3. Install the New Ambari Server
6. Configuring LZO Compression
1. Configure core-site.xml for LZO
2. Running Compression with Hive Queries
2.1. Create LZO Files
2.2. Write Custom Java to Create LZO Files
7. Using Non-Default Databases
1. Using Non-Default Databases - Ambari
1.1. Using Ambari with Oracle
1.2. Using Ambari with MySQL
1.3. Using Ambari with PostgreSQL
1.4. Troubleshooting Non-Default Databases with Ambari
2. Using Non-Default Databases - Hive
2.1. Using Hive with Oracle
2.2. Using Hive with MySQL
2.3. Using Hive with PostgreSQL
2.4. Troubleshooting Non-Default Databases with Hive
3. Using Non-Default Databases - Oozie
3.1. Using Oozie with Oracle
3.2. Using Oozie with MySQL
3.3. Using Oozie with PostgreSQL
3.4. Troubleshooting Non-Default Databases with Oozie
8. Setting up an Internet Proxy Server for Ambari
1. How To Set Up an Internet Proxy Server for Ambari
9. Configuring Network Port Numbers
1. Default Network Port Numbers - Ambari
2. Optional: Changing the Default Ambari Server Port
10. Change the JDK Version
11. Using Ambari Blueprints
12. Configuring HDP Stack Repositories for Red Hat Satellite
1. How To Configure HDP Stack Repositories for Red Hat Satellite
13. Tuning Ambari Performance
14. Tuning Ambari Metrics
1. Collector Modes
2. Aggregated Metrics TTL Settings
3. Memory Settings
4. (Optional) Enabling HBase Region and Table Metrics
5. General Guidelines
15. Moving the Ambari Metrics Collector

loading table of contents...