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.
- 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.
  - Ezmeral Ecosystem Packs
  - Apache Airflow
    This topic provides an overview of Apache Airflow on HPE Ezmeral Data Fabric.
  - AsyncHBase
  - Cascading
  - Apache Drill
  - Flume
  - Hadoop
  - HBase
  - HBase Client and HPE Ezmeral Data Fabric Database Binary Tables
  - HCatalog
  - Hive
  - HttpFS
  - Hue
  - Impala
  - Livy
    Apache Livy is primarily used to provide integration between Hue and Spark.
  - HPE Ezmeral Data Fabric Streams Clients and Tools
    Describes the supported HPE Ezmeral Data Fabric Streams tools and clients.
  - S3 Gateway
    The S3 gateway is a service that provides an S3-compatible interface to expose data in HPE Ezmeral Data Fabric as objects. The S3 gateway manages all inbound S3 API requests to put data into and get data out of cloud storage.
    - Configuring S3 Gateway
      Describes how to configure the S3 gateway.
    - Configuring the S3 Gateway Client
      Describes how to configure the client and provides client configuration and operation examples.
    - Integrating S3 Gateway with LDAP/AD
      Describes how to configure LDAP/AD for S3 gateway 2.1.0 and later.
    - Using the HPE Ezmeral Data Fabric Streams for S3 Bucket Event Notifications
      You can use the HPE Ezmeral Data Fabric Streams to receive event notifications for buckets. For example, when an object is created in a bucket. Install the event store, create a stream and topic, and then enable notifications through the MinIO client (MC) located in /opt/mapr/objectstore-client/objectstore-client-<version>/util/mc.
    - AWS CLI for S3 Gateway
      You can install and use the AWS Command Line Interface (CLI) with the S3 gateway.
    - Logs for the S3 Gateway
      Logs for the S3 Gateway are available after the first run. You can access logs in /opt/mapr/objectstore-client/objectstore-client-<version>/logs/.
    - S3 Gateway Limitations
      The S3 Gateway has certain limitations and restrictions involving protocol support, object naming, and specific object and bucket APIs that are not supported.
  - Oozie
  - Pig
  - Sentry
  - Apache Spark
  - Sqoop
  - YARN
- 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.

AWS CLI for S3 Gateway

You can install and use the AWS Command Line Interface (CLI) with the S3 gateway.

Installing the AWS CLI

NOTICE The S3 gateway is included in EEP 6.0.0 - EEP 8.0.0 repositories.

To install the AWS CLI on Ubuntu, RedHat/CentOS, or SLES, run:

pip install awscli

To configure the AWS CLI, use the AWS configure command with the values shown in the following table:

Value	Description
AWS Access Key ID	Insert the `accessKey` for the user
AWS Secret Access Key	Insert the `secretKey` for the user
Default region name	Specify `'us-west-1'`
Default output format	Specify `json`

Using the AWS CLI

The following table provides examples of commands that can help you manage buckets and files.

NOTE The /opt/mapr/conf/ca/chain-ca.pem file is the public certificate for the node that is generated by Data Fabric.

# Create a bucket and upload a file
aws s3 mb s3://mybucket/ --endpoint-url https://<ip-address>:9000 --ca-bundle /opt/mapr/conf/ca/chain-ca.pem
        
echo "HelloS3World" > /tmp/helloS3world.txt
aws s3 cp /tmp/helloS3world.txt s3://mybucket/helloS3world.txt --endpoint-url https://<ip-address>:9000 --ca-bundle /opt/mapr/conf/ca/chain-ca.pem
        
# Move an object from one bucket to another
aws s3 mv s3://firstbucket/helloS3world.txt s3://mybucket/helloS3world.txt --endpoint-url https://<ip-address>:9000 --ca-bundle /opt/mapr/conf/ca/chain-ca.pem
        
# Delete an object from a bucket
aws s3 rm s3://mybucket/helloS3world.txt --endpoint-url https://<ip-address>:9000 --ca-bundle /opt/mapr/conf/ca/chain-ca.pem
        
# Delete the bucket
aws s3 rb s3://mybucket/ --endpoint-url https://<ip-address>:9000 --ca-bundle /opt/mapr/conf/ca/chain-ca.pem
        
# List all files in the bucket

aws s3 ls s3://mybucket/ --endpoint-url https://<ip-address>:9000 --ca-bundle /opt/mapr/conf/ca/chain-ca.pem
        
# Show all files on the filesystem
ls -al /mapr/demo.mapr.com/apps/s3/$(hostname)/mybucket/

AWS CLI Limitations

If you list a folder in FS deployment mode and at least one of the files or buckets has permissions that deny access, an access-deny error is returned.