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
  - Flume
  - HBase
  - HBase Client and MapR Database Binary Tables
  - HCatalog
  - Hive
    - Getting Started with Hive
    - Configuring Hive
    - Integrating Hive
      - Hive and MapR Database Integration
      - Hive and HBase Integration
      - Hive and HPL/SQL Integration
      - Hive and HCatalog Integration
      - Hive and WebHCat Integration
      - Hive and Tez Integration
        You can use Tez, instead of MapReduce, for generic data processing tasks. Tez significantly increases the processing speed. Tez, working with Hive, provides lower latency for interactive queries and higher throughput for batch queries.
        Configuring Hive and Tez
        Known Issues and Restrictions
        SQL Limitations
        Hive-on-Tez User Interface
        Tez Shuffle
        Queue Management with Hive-on-Tez
    - Managing Hive Services
    - Connecting to Hive
    - Enabling High Availability for Hive
      This section describes how to enable High Availability for HiveServer2 and HiveMetastore.
    - Hive Features in MapR Data Platform
      Describes MapR Data Platform-specific features in Hive.
    - Hive 2.3 API Changes
      This topic describes the public API changes that occurred between Hive 2.1 EEP 5.0.0 and Hive 2.3 EEP 6.0.0.
    - Hive 2.1 API
    - Troubleshooting Hive and Tez
    - Hive Logging
      This section describes Hive logging for Hive 2.1 and later releases and includes information about log splitting.
  - 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.

Known Issues and Restrictions

Sqoop importing data into Hive fails when the entire cluster is configured to use Tez.

This is because of Sqoop's incompatibility with Tez.

Workaround: Do not configure the entire cluster to use Tez.

Percentage sampling is not supported in org.apache.hadoop.hive.ql.io.HiveInputFormat.

Hive uses org.apache.hadoop.hive.ql.io.HiveInputFormat by default and so queries like 'SELECT * FROM tablename TABLESAMPLE(20 percent);' will not work for Hive on Tez.

Workaround: Instead of org.apache.hadoop.hive.ql.io.HiveInputFormat, use org.apache.hadoop.hive.ql.io.CombineHiveInputFormat.

To change input format, do one of the following:

Set hive.tez.input.format in hive shell. For example:

hive> set hive.tez.input.format=org.apache.hadoop.hive.ql.io.CombineHiveInputFormat;

Add org.apache.hadoop.hive.ql.io.CombineHiveInputFormat to hive-site.xml file. For example:

<property>
  <name>hive.tez.input.format</name>
  <value>org.apache.hadoop.hive.ql.io.CombineHiveInputFormat</value>
</property>

Hive on Tez does not work well with Sequence Files Schema changes

TEZ-2741

Limitations with common joins

HIVE-11693: The CommonMergeJoinOperator only sets big table position when it has inputs for big table. If the input is empty, the method is not called.

HiveServer2 on Tez doesn't support concurrent queries within one session

HIVE-9223: When multiple queries are submitted in the same HS2 session concurrently, some queries fail with an error.

Tez upgrade issues

No support for preserving configuration from EEP-5.0.0 and EEP-4.1.1 (ECO-1803) to EEP-6.0.0(1808) or EEP-5.0.1(1808) on Ubuntu.
No support for preserving Tomcat configuration from previous EEPs to EEP-6.0.0 (1808).
You should manually stop the Tomcat service and delete the tomcat folder as a precondition if you are updating or upgrading Tez from the following EEPs:
EEP-4.0.0
EEP-4.1.0

Tez shuffle SSL encryption issue

During a shuffle phase, the javax.net.ssl.SSLException error could occur on a multi-node cluster due to insufficient Tez shuffle SSL encryption configuration, see Tez Shuffle for a solution.