HPE Ezmeral Data Fabric 6.1.x is In Maintenance and transitions to "End of Maintenance" in June 2024. Please see the latest documentation.

About MapR 6.1
This site contains the main documentation for Version 6.1 of the MapR Converged Data Platform, including installation, configuration, administration, and reference information.
6.1 Installation
This section contains information about installing and upgrading MapR software. It also contains information about how to migrate data and applications from an Apache Hadoop cluster to a MapR cluster.
6.1 MapR Data Platform
MapR Data Platform is the industry-leading data platform for AI and analytics that solves enterprise business needs.
6.1 Administration
This section describes how to manage the nodes and services that make up a cluster.
6.1 Development
This section contains information related to application development for Ezmeral ecosystem components and MapR Data Platform products, including the file system, Database (Key-Value and JSON), and Event Streams.
- Application Development Process
  Before you start developing applications on the MapR Data Platform platform, consider how you will get the data into the platform, the storage format of the data, the type of processing or modeling that is required, and how the data will be accessed.
- MapR XD and Apps
  The following sections provide information about accessing the MapR XD with C and Java applications.
- MapR Database and Apps
  This section contains information about developing client applications for JSON and key-value tables.
- MapR Event Store For Apache Kafka and Apps
  MapR Event Store For Apache Kafka brings integrated publish and subscribe messaging to MapR Data Platform.
- MapReduce and Apps
  This section contains information associated with developing YARN applications.
- MapR Data Science Refinery
  The MapR Data Science Refinery product is an easy-to-deploy and scalable data science toolkit with native access to all platform assets and superior out-of-the-box security.
- MapR Data Fabric for Kubernetes
  This section describes how to leverage the capabilities of the MapR Data Fabric for Kubernetes.
- Ecosystem Components
  The following sections provide information about each open-source project that is supported by the MapR Data Platform.
  - Ezmeral Ecosystem Packs
  - AsyncHBase
  - Cascading
  - Apache Drill
    - Drill Tutorial
    - Drill-on-YARN
      - Drill-on-YARN Overview
      - Configuring Drill to Run Under YARN
        Step 1: Configure Drill
        Step 2: Configure Drill-on-YARN
        Step 3: Configure YARN to Run Drill
        Step 4: Launch Drill Under YARN
        Step 5: Validate Cluster Configuration and Status
      - Migrate Drill to Run Under YARN
        Explains how to migrate Drill to run under YARN instead of the MapR Warden service.
      - Additional Drill-on-YARN Configuration Options
      - Multiple Drill Clusters within YARN
      - Drill-on-YARN Command Line Tool
      - Application Master Web UI
      - Drill-on-YARN Limitations
      - Configuring Drill-on-Yarn on a Secure Cluster
        If you intend to run Drill on YARN on a secure cluster, you must manually enable SASL for the Apache ZooKeeper client.
    - Configuring Drill
      Lists the MapR-specific configuration for Drill.
    - Working with Drill
    - Securing Drill
      An administrator can install Drill with the default security configuration or manually configure custom security for Drill.
    - Drill Drivers
      HPE Ezmeral Data Fabric provides Drill ODBC and JDBC drivers that you can download and use to connect Drill to BI tools. The drivers are updated periodically to include support for new functionality in Drill.
    - Drill Configuration Files
      The Drill installation includes configuration files with start-up options that you can modify prior to starting Drill.
    - Monitoring Drill Metrics
    - Optimizing Queries with Indexes
      MapR Database provides a highly scalable key-value database platform on which you can run SQL queries using Drill. As of the 6.0 release of the MapR Data Platform, MapR Database natively supports indexes on secondary fields in JSON tables.
    - Drill Limitations
      Provides information about Drill limitations and solutions where applicable.
    - Vulnerability Reports
      Provides vulnerability information in relation to Drill.
  - Flume
  - HBase
  - HBase Client and MapR Database Binary Tables
  - HCatalog
  - Hive
  - HttpFS
  - Hue
  - Impala
  - Livy
    Apache Livy is primarily used to provide integration between Hue and Spark.
  - MapR Event Store For Apache Kafka Clients and Tools
    Describes the supported MapR Event Store For Apache Kafka tools and clients.
  - S3 Gateway
    The S3 gateway is a service that provides an S3-compatible interface to expose data in MapR Data Platform as objects. The S3 gateway manages all inbound S3 API requests to put data into and get data out of cloud storage.
  - Myriad
  - Oozie
  - Pig
  - Sentry
  - Apache Spark
  - Sqoop
  - YARN
  - Zeppelin
- Maven and MapR
  This section discusses topics associated with Maven and MapR.
- Developer's Reference
  This section contains in-depth information for the developer.
- API Documentation
  MapR Data Platform supports public APIs for MapR File System, MapR Database, and MapR Event Store For Apache Kafka. These APIs are available for application-development purposes.
Other Docs
This section contains release-independent information, including: MapR Installer documentation, Ecosystem release notes, interoperability matrices, security vulnerabilities, and links to other MapR version documentation.
Glossary
Definitions for commonly used terms in MapR Converged Data Platform environments.

Step 4: Launch Drill Under YARN

Now that the Drill and YARN configuration is complete, you can issue the start command from the Drill-on-YARN client to launch Drill under YARN. Launching Drill-on-YARN from the client starts Drill and brings Drill up on other nodes.

Issuing the start command starts the YARN Application Master, which then works with YARN to start the Drillbits. The Application Master provides a web UI to monitor the cluster.

NOTE To simplify debugging, you can set the cluster size to a single node. Once you confirm that a single node works, increase the node count.

Launch Drill under YARN as the mapr user. For example, if you installed Drill as mapr launch Drill as the mapr user.

NOTE If you launch Drill as root and the system returns an error failing the launch attempt, launch Drill as a user with permissions, such as mapr.

Issue the following command to start Drill under YARN:

$DRILL_HOME/bin/drill-on-yarn.sh --site $DRILL_SITE start

NOTE To run SQLLine, you must also add the --site option:

$DRILL_HOME/bin/sqlline --site $DRILL_SITE

TIP To avoid typing the site argument each time you launch Drill under YARN, set an environment variable:

export DRILL_CONF_DIR=$DRILL_SITE
$DRILL_HOME/bin/drill-on-yarn.sh start

After you issue the start command, a number of lines describing the start-up process print. The tool automatically archives and uploads the site directory, which YARN copies (along with the Drill software) onto each node. A URL that includes both the host and the port number displays. Enter the URL in a web browser to access the Application Master web UI.

NOTE When you launch Drill from the Drill-on-YARN client, the Application Master can come up on any node. Save the provided URL to share with other users so they can also access the Application Master. Alternatively, you can run the status command to see the URL or go to the YARN Resource Manager UI to get the link.

See Drill-on-YARN Command Line Tool for additional commands, including stop, status, and resize. See Application Master Web UI for cluster monitoring information.