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

About Release 6.2
This site contains documentation for HPE Ezmeral Data Fabric release 6.2 including installation, configuration, administration, and reference content, as well as content for the associated bundled ecosystem components and drivers.
6.2 Installation
This section contains information about installing and upgrading HPE Ezmeral Data Fabric software. It also contains information about how to migrate data and applications from an Apache Hadoop cluster to a HPE Ezmeral Data Fabric cluster.
6.2 Data Fabric
HPE Ezmeral Data Fabric is the industry-leading data platform for AI and analytics that solves enterprise business needs.
6.2 Administration
This section describes how to manage the nodes and services that make up a cluster.
6.2 Development
This section contains information related to application development for Ezmeral ecosystem components and HPE Ezmeral Data Fabric products, including the file system, Database (Key-Value and JSON), and Event Streams.
- Application Development Process
  Before you start developing applications on the HPE Ezmeral Data Fabric 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.
- File Store and Apps
  The following sections provide information about accessing the File Store with C and Java applications.
- HPE Ezmeral Data Fabric Database and Apps
  This section contains information about developing client applications for JSON and key-value tables.
  - Installing the mapr-client Package
    The mapr-client package must be installed on each node where you will be building and running your applications. This package installs all of the MapR Libraries needed for application development regardless of programming language or type of HPE Ezmeral Data Fabric Database table (binary or JSON).
  - Passing the HPE Ezmeral Data Fabric Database Table Path
    This topic describes the methods for passing a HPE Ezmeral Data Fabric Database table name. Binary table names can be passed by either specifying the table path in the API or by setting the table path in the core-site.xml file. JSON table names are passed by specifying the table path in the API.
  - Tuning Parameters for Client Apps
    Though tuning client applications is generally not necessary, MapR does offer tuning parameters to change the behavior of client-side caching.
  - Developing Applications for Binary Tables
    HPE Ezmeral Data Fabric Database provides a C API, libMapRClient and partially supports the Apache HBase 1.1 Java APIs for performing operation on HPE Ezmeral Data Fabric Database binary tables.
    - Creating C Apps - Binary Tables
      MapR provides a library of C APIs – libMapRClient – for performing operations on HPE Ezmeral Data Fabric Database binary tables.
      - libMapRClient C APIs
        This section provides the HPE Ezmeral Data Fabric Database libMapRClient C API library. This library is MapR's extension of the libhbase C API library. The libMapRClient header files are in the directory: /opt/mapr/include/hbase.
      - C API Examples
        This section provides examples using the HPE Ezmeral Data Fabric Database libMapRClient C API to operate on HPE Ezmeral Data Fabric Database binary tables.
        Filtering SCAN Operation Results Example
        This example shows filtering on the results of a SCAN operation.
        Filtering GET Operation Results Example
        This example shows filtering on the results of a GET operation.
        Impersonation Example
        This sample application demonstrates the capabilities of the new C API for impersonation.
        Set Time Range Example
        This example scans HPE Ezmeral Data Fabric Database binary tables and sets the time range.
        Set Time Stamp Example
        This example scans HPE Ezmeral Data Fabric Database binary tables and sets the time stamp.
        Delete Specific Cells Example
        This example deletes specific cells that correspond to a specific timestamp.
      - HPE Ezmeral Data Fabric Database Sample C Application
        MapR provides a sample C application that accesses and performs operations on HPE Ezmeral Data Fabric Database binary tables. This section describes the various operation performed by the application.
      - Building and Launching C Applications
        This topic describes basic setup for building and launching C application using the MapR libMapRClient C API library
      - HBase Java Filters Support
        The hb_get_set_filter() and hb_scanner_set_filter() C APIs are used to filter the results of GET and SCAN operations. These APIs are in the get.h and scanner.h header files.
    - Creating Java Apps - Binary Tables
      This topics describes the supported Apache HBase Java APIs used for CRUD operations on HPE Ezmeral Data Fabric Database binary tables.
    - Impersonation through the HBase REST Gateway
      Impersonation enables access to tables via user IDs other than the user that runs the Gateway.
    - Mapping to HBase Table Namespaces
      This section describes mapping table namespaces between Apache HBase tables and HPE Ezmeral Data Fabric Database binary tables.
    - Thread-pool Settings for Performance
    - Building MapReduce Applications
      This section provides information about building and running custom MapReduce application that access HPE Ezmeral Data Fabric Database binary tables.
  - Setting for OJAI Applications to Use Data Fabric Client Features
    Describes how to set the classpath for OJAI applications to use data-fabric client features.
  - Developing Applications for JSON Tables
    As part of its support for JSON tables, HPE Ezmeral Data Fabric Database implements the OJAI API. The OJAI API provides methods for creating, reading, updating, and deleting JSON documents in HPE Ezmeral Data Fabric Database JSON tables. It is available in Java, and starting in EEP 6.0, also available in Node.js, Python, C#, and Go. HPE Ezmeral Data Fabric Database also provides a HPE Ezmeral Data Fabric Database JSON Client API for managing JSON tables and a HPE Ezmeral Data Fabric Database JSON REST API for performing basic operations using HTTP calls.
- HPE Ezmeral Data Fabric Streams and Apps
  HPE Ezmeral Data Fabric Streams brings integrated publish and subscribe messaging to HPE Ezmeral Data Fabric.
- MapReduce and Apps
  This section contains information associated with developing YARN applications.
- Kubernetes Interfaces for Data Fabric
  This section describes how to leverage the capabilities of the Kubernetes Interfaces for Data Fabric.
- Ecosystem Components
  The following sections provide information about each open-source project that is supported by the HPE Ezmeral Data Fabric.
- Maven and the HPE Ezmeral Data Fabric
  This section discusses topics associated with Maven and the HPE Ezmeral Data Fabric.
- Developer's Reference
  This section contains in-depth information for the developer.
- API Documentation
  HPE Ezmeral Data Fabric supports public APIs for file system, HPE Ezmeral Data Fabric Database, and HPE Ezmeral Data Fabric Streams. These APIs are available for application-development purposes.
Other Docs
This section contains release-independent information, including: Installer documentation, Ecosystem release notes, interoperability matrices, security vulnerabilities, and links to other data-fabric version documentation.
Glossary
Definitions for commonly used terms in MapR Converged Data Platform environments.

Impersonation Example

This sample application demonstrates the capabilities of the new C API for impersonation.

The sample also shows how to use the API in your own programs. The application is located in the /opt/mapr/examples/interactive directory.

Prerequisite for compiling and running this sample application

Install the mapr-client package on the node where you will build the application. See Installing the Data Fabric Client. If the mapr-core package is already installed, you do not need to install the mapr-client package.

Compiling this sample application

To compile and run this sample application, set the MAPR_IMPERSONATION_ENABLED environment variable to true and then read the instructions in the README file in the /opt/mapr/examples/interactive directory.

Though the application links against libjvm, a Java virtual machine (JVM) is not spawned. However, the libMapRClient does have Java dependencies.