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.
- Administering Users and Clusters
  Lists topics that help manage a MapR cluster.
- Administering Nodes
  Provides a synopsis of managing nodes in a cluster.
- Administering Volumes
  This section provide information about how to organize and manage data using volumes, a unique feature of MapR clusters.
- Administering Files and Directories
  - Using Global File System Checking
    Describes how to use the gfsck command to check and repair file system errors.
  - Setting MapR File System Permissions
  - Managing File and Directory ACEs
    Describes the implications of setting access control expressions on files and directories.
  - Managing Chunk Size
    Describes the considerations for managing the chunk size for map tasks.
  - Managing Compression
    Lists the advantages of using compression.
  - Managing Hard Links
    Explains what hard links are, and their limitations.
  - Managing Extended Attributes
    Describes what extended attributes are, and the POSIX permissions that you need to manage them.
  - Managing Core Files
    Describes how to set the location for core files.
  - Migrating Files from the Edge Cluster to AWS S3
    Describes how new or changed files are automatically uploaded to AWS S3 by the File Migration service.
  - Managing Tiered Files from the Command-line
    - Offloading a File to a Tier Using the CLI and REST API
      Describes how to offload files to a tier using the CLI and the REST API.
    - Recalling a File to MapR File System Using the CLI and REST API
    - Terminating a Running File-Level Tiering Job
      Explains how to terminate file tiering jobs using the Control System and the CLI.
    - Running Tiering Commands when maprcli and hadoop Commands are not Available
    - Retrieving Status of File-level Tiering Operation and File Data
- Administering Tables
  Administration of the MapR Database is done primarily via the command line (maprcli) or with the Managed Control System (MCS). Regardless of whether the MapR Database table is used for binary files or JSON documents, the same types of commands are used with slightly different parameter options. MapR Database administration is associated with tables, columns and column families, and table regions.
- Administering Streams
- Administering MapR Gateways
  A MapR gateway mediates one-way communication between a source MapR cluster and a destination cluster. You can replicate MapR Database tables (binary and JSON) and MapR Event Store For Apache Kafka streams. MapR gateways also apply updates from JSON tables to their secondary indexes and propagate Change Data Capture (CDC) logs.
- Administering Services
- Monitoring the Cluster
  This section describes how to monitor the health and performance of a MapR cluster.
- Configuring Security
  Describes how to configure security and manage secure clusters.
- Managing Secure Clusters
  Provides procedures that will enable you to use MapR clusters securely.
- Administering the MapR Data Access Gateway
  The MapR Data Access Gateway is a service that acts as a proxy and gateway for translating requests between lightweight client applications and the MapR cluster. This section describes considerations when upgrading the service, how to modify configuration settings, and how to administer and manage the service.
- Planning for High Availability
- Administrator's Reference
  This section contains in-depth reference information for the administrator.
- Troubleshooting Cluster Administration
  Lists the common errors and their solutions.
- Best Practices for Backing Up MapR Information
  Lists the best practices and performance considerations to follow when backing up MapR information.
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.
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.

Running Tiering Commands when maprcli and hadoop Commands are not Available

You can offload and/or recall a file with NFS, loopbacknfs, and FUSE-based POSIX clients even if maprcli or hadoop commands are not available. To perform file-level data tiering operations like offload and/or recall using NFS, loopbacknfs, and FUSE-based POSIX clients when maprcli or hadoop commands are not available, after mounting, provide the tiering command such as offload, recall, tierjobstatus, and/or tierjobabort as described below. When you run the command, the command creates a hidden .tier_attributes file (similar to .dfs_attributes file) that is purged immediately after the operation is submitted to the server.

NOTE When you run the command, the tiering command is triggered immediately and storage policy (or rule), if any, at the volume-level is ignored.

Usage

/bin/echo "<command> <file-name>" > .tier_attributes

NOTE Do not use echo in the terminal; instead, use /bin/echo.

Options

Option	Description
command	The tiering related command to run. The following commands are supported: `offload` `recall` `tierjobstatus` `tierjobabort`
file-name	The name of the file.

Return Values

On success, the command returns nothing. Otherwise, the command returns one of the following /bin/echo return codes, which are displayed as write errors:

Code	Message	Description
EEXIST	File exists	Indicates tier job is queued or is already in progress.
ENOTEMPTY	Directory not empty	Indicates that tier job queue is full.
ENOENT	No such file or directory	Indicates that the specified file or job ID does not exist.
EIO	I/O error	Indicates that the job could not be submitted. Run the `tierjobstatus` command to determine the reason for this error.
EINVAL	Invalid argument	Indicates that the given command is invalid or not available. See Options for the list of supported commands.

Examples

Offload file named test

# /bin/echo "offload test" > .tier_attributes
/bin/echo: write error: File exists

Recall a file named test

# /bin/echo "recall test" > .tier_attributes
/bin/echo: write error: File exists

Check the status of a running job for a file

# /bin/echo "tierjobstatus test" > .tier_attributes

Abort a running job

# /bin/echo "tierjobabort test" > .tier_attributes
/bin/echo: write error: No such file or directory