About Release 8.0.0
This site contains documentation for HPE Data Fabric release 8.0.0, including installation, configuration, administration, and reference content, as well as content for the associated ecosystem components and drivers.
8.0.0 Installation
This section contains information about installing HPE 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.
8.0.0 Upgrade
This section describes how to upgrade HPE Data Fabric software.
8.0.0 Data Fabric
HPE Data Fabric is the industry-leading data platform for AI and analytics that solves enterprise business needs.
8.0.0 Administration
This section describes how to manage the nodes and services that make up a cluster.
- Working with Multiple Fabrics Using the Data Fabric UI
  This section describes how you can get started learning about, installing, and using the HPE Data Fabric.
- Administering Users and Clusters
  Lists topics that help manage a Data Fabric 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 HPE Data Fabric clusters.
- Administering Files and Directories
- Administering Tables
  Administration of the HPE Data Fabric Database is done primarily via the command line (maprcli) or with the Managed Control System (MCS). Regardless of whether the HPE Data Fabric Database table is used for binary files or JSON documents, the same types of commands are used with slightly different parameter options. HPE Data Fabric Database administration is associated with tables, columns and column families, and table regions.
- Administering Streams
- Administering Data Fabric Gateways
  A HPE Data Fabric gateway mediates one-way communication between a source HPE Data Fabric cluster and a destination cluster. You can replicate HPE Data Fabric Database tables (binary and JSON) and HPE Data Fabric Streams streams. HPE Data Fabric 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 Data Fabric clusters securely.
- Administering the Data Access Gateway
  The HPE Data Fabric Data Access Gateway is a service that acts as a proxy and gateway for translating requests between lightweight client applications and the HPE Data Fabric 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.
  - maprcli and REST API Syntax
    This section provides information about the HPE Data Fabric command API. Most commands can be run on the command-line interface (CLI), or by making REST requests programmatically or in a browser.
  - MinIO Client (mc) Commands
    Lists mc commands that you can use to perform operations, such as creating and editing buckets and accounts in HPE Data Fabric Object Store.
  - Utilities
    Contains information about various scripts and utilities, that help setup, maintain, and monitor clusters.
    - configure.sh
      Describes the syntax and parameters of the configure.sh script that you run for a number of tasks including setting up HPE Data Fabric client nodes, and configuring services for a node.
    - configure-crosscluster.sh
      Use the configure-crosscluster.sh utility to set up cross-cluster security between two clusters.
    - cldbguts
      Monitors the activity of the Container Location Database (CLDB). This utility prints information about the CLDB service that is running on the node from which you run the utility.
    - disksetup
      Describes the disksetup command that formats disks for use by HPE Data Fabric storage.
    - ectool
      Dumps or checks the validity of the stripelets in the backend volume that is associated with the volume configured for warm tiering.
    - expandaudit
      Describes how to use the expandaudit utility to expand IDs captured in the audit logs to their corresponding names.
    - fcdebug
      Dynamically sets the log level to debug a library.
    - fsck
      Detects and fixes inconsistencies in the file system.
    - gfsck
      Describes how you can use the gfsck command, under the supervision of HPE Data Fabric Support or Engineering, to perform consistency checks and appropriate repairs on a volume, or a volume snapshot.
    - guts
      guts is a tool to measure/analyse performance. In the default mode, it prints one line every second, and counts the number of operations or bytes-processed in one second intervals. guts is an internal utility, and is subject to change without notice.
    - manageSSLKeys.sh
      Use the manageSSLKeys.sh utility to create and manage SSL certificates.
    - mapr-support-collect.sh
      Collects information about a cluster's recent activity, to help Data Fabric Support diagnose problems.
    - mapr-support-dump.sh
      Collects node and cluster-level information for the node on which you invoke the script.
    - maprlogin
      Authenticates logins to secure HPE Data Fabric clusters.
    - mrconfig
      The mrconfig commands let you create, remove, and manage storage pools, disk groups, and disks; and provide information about containers.
    - mrdirectorystats
      Prints the space usage for each directory, for a container.
    - mrdiagnostics
      Gathers node metrics.
    - mrfscmd
      Returns the path to the file specified by ID (fid).
    - stubfuse
      Simulates a FUSE mount point to determine its read and write performance.
    - update_insights.sh
      Utility to manage Insight service related Iceberg tables.
  - Configuration Files
    This section contains reference information about various configuration files.
  - Alarms Reference
    The pages in this section provide details about all of the types of alarms.
  - HPE Data Fabric Environment
    This section provides information associated with the Data Fabric environment.
- Troubleshooting Cluster Administration
  Lists the common errors and their solutions.
- Best Practices for Backing Up HPE Data Fabric Information
  Lists the best practices and performance considerations to follow when backing up HPE Data Fabric information.
- IPv6 Support in Data Fabric
  Describes the IPv6 support feature for Data Fabric.
8.0.0 Development
This section contains information related to application development for Ezmeral ecosystem components and HPE Data Fabric products, including the file system, Database (Key-Value and JSON), and Event Streams.
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.

mrdiagnostics

Gathers node metrics.

The mrdiagnostics utility collects metrics on the node on which it is run. Metrics include IO statistics, network throughput, CPU performance, memory consumption, swap space usage, disk usage, disk latency, and MFS throughput for the node.

Syntax

/opt/mapr/server/mrdiagnostics start (or) stop (or) restart

Parameters

Parameter	Description
`start`	Starts the utility
`stop`	Stops the utility
`restart`	Restarts the utility

Output

The mrdiagnostics utility logs the collected metrics as a set of log files in the /opt/mapr/logs/stats/ directory. A sample collection is as follows:

ls /opt/mapr/logs/stats/
guts.m2-mapreng-vm167212.out             sar.dev.m2-mapreng-vm167212.out
gutsmfs.m2-mapreng-vm167212.out          sar.error.dev.m2-mapreng-vm167212.out
iostat.m2-mapreng-vm167212.out           topmfsparent.m2-mapreng-vm167212.out
mpstat.m2-mapreng-vm167212.out           topmfsthreads.m2-mapreng-vm167212.out
mrconfig_dbinfo.m2-mapreng-vm167212.out  top.processes.m2-mapreng-vm167212.out
mrconfig_info.m2-mapreng-vm167212.out    top.threads.m2-mapreng-vm167212.out
netstat.pan.m2-mapreng-vm167212.out      vmstat.m2-mapreng-vm167212.out
psOutput.m2-mapreng-vm167212.out

Configuration Parameters

The /opt/mapr/conf/mrdiagnostics.conf file contains the configuration for the mrdiagnostics utility. The parameters are as follows:

stats.log.path: Path in which the output files (*.out) files are placed. The default path is /opt/mapr/logs/stats.
stats.log.interval: Frequency at which the metrics are collected. The value is in seconds. The default value is 1 second.
stats.log.size: The size at which the output files are rotated. The value is in KB. The default value is 1000000 KB (1 GB). If the total size of all the output files inside the /opt/mapr/logs/stats folder exceeds this value, the output files are compressed to a single tar file and stored in the /opt/mapr/logs folder.

Partners Support Dev-Hub Community ALA Privacy Policy Glossary

HPE Data Fabric 8.0.0 Software Documentation
Abstract	This site contains documentation for HPE Data Fabric Software version 8.0.0 including installation, configuration, administration, and reference content, as well as content for the associated bundled ecosystem components and drivers.
Published	October 2025
Edition	8.0.0
Topic last updated	2020-12-16