Data Governance Guide

Hortonworks Data Platform

Except where otherwise noted, this document is licensed under Creative Commons Attribution ShareAlike 3.0 License

http://creativecommons.org/licenses/by-sa/3.0/legalcode

Hortonworks Data Platform (HDP) and any of its components are not anticipated to be combined with any hardware, software or data, except as expressly recommended in this documentation.

2015-12-21

Abstract

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.

Contents

1. HDP Data Governance

1. Falcon Overview
2. Atlas Overview

2. Data Pipelines (Falcon)

1. Understanding Data Pipelines

2. Quick Start: Using the Falcon Web UI to Define Data Pipelines

2.1. Creating a Cluster Entity
2.2. Creating a Feed Entity
2.3. Creating a Process Entity

3. Search For and Manage Data Pipeline Entities

4. Mirroring Data (Falcon)

5. Using the Falcon CLI to Define Data Pipelines

5.1. Deploying Data Pipelines
5.2. Replicating Data (Falcon)
5.3. Viewing Alerts in Falcon
5.4. Late Data Handling
5.5. Setting a Retention Policy
5.6. Setting a Retry Policy
5.7. Enabling Email Notifications

6. Understanding Dependencies in Falcon

7. Viewing Dependencies

3. Metadata Services Framework (Atlas)

1. Understanding the HDP Metadata Services Framework
2. Using the Atlas Web UI to Search Metadata

4. Reference (Falcon)

1. Cluster

1.1. Valid Cluster Tag Attributes
1.2. Cluster Interfaces
1.3. Cluster XSD Specification

2. Feed Entity

3. Process Entity

4. Using the CLI to Manage Entities and Instances

4.1. Managing Entities with the CLI
4.2. Managing Instances with the CLI

5. Troubleshooting (Falcon)

1. Falcon logs
2. Falcon Server Failure
3. Delegation Token Renewal Issues
4. Invalid Entity Schema
5. Incorrect Entity
6. Bad Config Store Error
7. Unable to set DataSet Entity
8. Oozie Jobs

6. Configuring High Availability (Falcon Server)

1. Configuring Properties and Setting Up Directory Structure for High Availability
2. Preparing the Falcon Servers
3. Manually Failing Over the Falcon Servers

7. Metadata Store REST API Reference (Atlas)

1. Data Model
2. AdminResource
3. EntityResource
4. HiveLineageResource
5. MetadataDiscoveryResource
6. RexsterGraphResource
7. TypesResource

List of Figures

1.1. Falcon Architecture
1.2. Atlas Overview
2.1. Data Pipeline
2.2. Data Pipeline Flow
2.3. Ambari Dashboard Falcon and Oozie Service Indicators
2.4. New Cluster Configuration Dialog
2.5. New Feed Configuration Dialog
2.6. New Process Configuration Dialog
2.7. Falcon Search UI
2.8. New Mirror Configuration Dialog
2.9. Graph_view.png
3.1. Atlas Architecture
3.2. Enter Tag to Search in Atlas Dashboard
3.3. Click the Tag Link to View Details
3.4. Details Tab
3.5. Schema Tab
3.6. Output Tab

List of Tables

2.1. Cluster Entity Configuration Values
2.2. General Feed Configuration Values
2.3. General Process Configuration Values
2.4. Mirror Configuration Values
2.5. Available Falcon Event Alerts
2.6. Email Notifications Startup Properties
4.1. Cluster tag elements
4.2. Cluster Interfaces
4.3. Entity Actions
4.4. Instance Actions

Legal notices