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.
- 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 Ezmeral Data Fabric clusters.
- Administering Files and Directories
- Administering Tables
  Administration of the HPE Ezmeral Data Fabric Database is done primarily via the command line (maprcli) or with the Managed Control System (MCS). Regardless of whether the HPE Ezmeral 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 Ezmeral Data Fabric Database administration is associated with tables, columns and column families, and table regions.
- Administering Streams
- Administering Data Fabric Gateways
  A HPE Ezmeral Data Fabric gateway mediates one-way communication between a source HPE Ezmeral Data Fabric cluster and a destination cluster. You can replicate HPE Ezmeral Data Fabric Database tables (binary and JSON) and HPE Ezmeral Data Fabric Streams streams. HPE Ezmeral 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.
  - Monitoring Using the Control System and the CLI
    Describes the Overview page in the Control System, which displays information about the cluster.
  - Using HPE Ezmeral Data Fabric Monitoring (Spyglass Initiative)
    HPE Ezmeral Data Fabric Monitoring (part of the Spyglass initiative) provides the ability to collect, store, and view metrics and logs for nodes, services, and jobs/applications.
    - HPE Ezmeral Data Fabric Monitoring Architecture
      HPE Ezmeral Data Fabric Monitoring integrates with open-source components to collect, aggregate, store, and visualize metrics and logs.
    - Metric Collection
      Metrics are collected from each node in the cluster so that administrators can use the data to monitor the cluster. In general, the collectd service collects metrics every 10 seconds. The exception is volume metrics which are collected every 10 minutes.
    - Configure the OpenTSDB Service Heap Size
      By default, the OpenTSDB service is configured to use a default heap size of 6 gigabytes. The default heap size can be adjusted by modifying certain configuration files.
    - Metric Visualization
      Use dashboards to visualize metrics across multiple nodes and clusters.
      - Access the Grafana UI
        You can launch the Grafana UI from the Control System or directly from a web browser.
        Logging on to Grafana
        This page describes the credentials needed to log on to Grafana for secure and nonsecure clusters for HPE Ezmeral Data Fabric 6.0 and later.
        Logging on to Grafana Without Using the Cluster Admin
        In secure Grafana installations where the cluster admin (typically mapr) has no password and is not allowed to log in as a user, special steps are required to enable login with a user other than the cluster admin.
        Changing the Password for Grafana
        Describes how to change the Grafana password for secure and nonsecure clusters.
        Adding a New Grafana User to a Secure Data Fabric Cluster
        In a secure data-fabric cluster, adding a new Grafana user requires an extra step to ensure that the user can be authenticated through the CLDB.
      - Sample Dashboards in Grafana
        Use the sample dashboards to get familiar with the types of graphs you can create. As of EEP 1.1, sample dashboards are available by default in Grafana.
      - Update the OpenTSDB Data Source For Grafana
        Grafana connects to a single OpenTSDB node to read metrics. If Grafana cannot read the metrics because an OpenTSDB node has failed, you must configure Grafana to connect to a different OpenTSDB node.
    - Log Collection
      Fluentd collects log events from each node in the cluster and stores them in a centralized location so that administrators can search the logs when troubleshooting issues in the cluster. The process that fluentd uses to parse and send log events to Elasticsearch differs based on the formatting of log events in each log file.
    - Log Aggregation and Storage
      Fluentd uses a round-robin approach when writing logs to Elasticsearch nodes. If an Elasticsearch node in unavailable, Fluentd can fail over log storage to another Elasticsearch node.
    - Log Visualization
      Use dashboards to visualize the logs across multiple nodes and clusters.
    - HPE Ezmeral Data Fabric Monitoring Tips and Troubleshooting
      Lists the nuances of monitoring clusters.
    - Reconfiguring MapR Monitoring
      Changes to an existing cluster, such as the addition of services, may require additional steps to enable the collection of metrics and logs.
- 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 Data Access Gateway
  The HPE Ezmeral 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 Ezmeral 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.
- Troubleshooting Cluster Administration
  Lists the common errors and their solutions.
- Best Practices for Backing Up HPE Ezmeral Data Fabric Information
  Lists the best practices and performance considerations to follow when backing up HPE Ezmeral Data Fabric information.
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.
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.

Adding a New Grafana User to a Secure Data Fabric Cluster

In a secure data-fabric cluster, adding a new Grafana user requires an extra step to ensure that the user can be authenticated through the CLDB.

Beginning with EEP 5.0.0, Grafana no longer uses its own database to authenticate on secure data-fabric clusters. On secure clusters, when you enter your user name and password into the browser, the Grafana server sends the user name and password to the CLDB, and the CLDB authenticates using the Pluggable Authentication Module (PAM) and HTTPS.

Because authentication relies on the CLDB, any new user that you add to Grafana must also exist on the data-fabric cluster. Therefore, to add a new Grafana user in a secure data-fabric cluster:

Add the user to the Linux system first. This user must have the same Linux UID and GID on every node in the data-fabric cluster.
Add the same user to Grafana, making sure that you use the user ID you added to the Linux system. In Grafana: Settings > ServerAdmin > Users > Add new user.