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.
  - Managing Users and Groups
    Provides a brief introduction to user management on a MapR cluster.
  - Managing the Cluster
    Lists the settings for managing the MapR cluster.
    - Managing Auditing
      Provides instructions for using MapR auditing features.
    - Configuring Balancer Settings
      Provides an overview of the MapR disk space and replication role balancers.
      - Disk Space Balancer
        Describes the role of the disk space balancer.
        Enabling and Configuring Disk Balancer
        Describes how to enable or disable the disk space balancer and other settings using the Control Panel and the CLI.
        Configuring Disk Balancer Execution
        Explains how to tune the disk balancer execution parameters.
        Configuring Bin Size
        Explains how to configure the sizes of the various bins used by the disk balancer.
        Balancing Overused and Above Average Bins
        Describes how to balance highly utilized Overused and Above Average bins.
        Balancing Average and Below Average Bins
        Provides an overview of how the disk balancer balances the Average and Below Average storage pool bins.
        Configuring Throttling
        Explains how to throttle the number of container moves.
        Retrieving Status of Storage Pools
        Describes the CLI command to retrieve the status of Storage Pools.
        Retrieving Balancer Status
        Describes how to view the active container movement information from the Control Panel and the CLI.
        Viewing the List of Active Container Moves
        Explains how to view the list of containers being moved, from the CLDB page.
      - Volume Balancer
        Describes the role of the volume balancer.
      - Replication Role Balancer
        Describes the features of the replication role balancer.
    - Managing Licenses
      Provides a synopsis of adding licenses using the Control System and the CLI.
    - Setting Quota Defaults for Users and Groups
      Explains how to set disk space quotas for users and groups.
    - Specifying the Location of Gateways
      Describes how to set the location of the MapR gateways using either the Control System or the CLI.
    - Managing Alarms
    - Working with Multiple Instances of the File System
      The Multi-MapR File System feature allows multiple instances of the file server to run on a single node in a single process.
    - Converting a Cluster from Root to Non-Root User from the Command-Line
      Provides a synopsis of changing the running user from root to a non-root user on a cluster.
    - Starting Up a Cluster
      Lists the steps to start a cluster that was previously shut down.
    - Shutting Down a Cluster
      Lists the considerations to note and the procedure to shutdown a cluster.
    - Managing Another Unsecure Cluster Using the Control System
      When logged into the Control System of one cluster, you can navigate to the Control System of another unsecure cluster.
    - Allocating Cluster Resource from the Command-Line
      Provides a general overview on allocating cluster resources for a MapR Hadoop 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
- 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.

Configuring Bin Size

Explains how to configure the sizes of the various bins used by the disk balancer.

The number of bins used by the disk balancer is not constant and is determined by the sizes of different bins. You can configure the size of each of the bins (Below Average, Average, Above Average, and Overused) individually at run time. The larger the size of the bins, the greater the chance that two SPs that are in the vicinity of each other with respect to utilization fall in the same bin.

The default size of overused bins is only 3%, because SPs in this bin must be balanced at a finer granularity. The default size of above average, average, and below average bins is 20%. You can aggressively balance the storage pools across bins by reducing the size of each bin, forcing the SPs to fall into different bins. To reduce the size of each bin, specify the value for the following parameters using the maprcli config save command:

Parameter	Description
`dbal.above.avg.bin.size`	Specifies the bin size (%) of SPs whose usage is above the cluster average. The default is 20%.
`dbal.avg.bin.size`	Specifies the bin size (%) of SPs whose usage is in the average range. The default is 20%.
`dbal.below.avg.bin.size`	Specifies the bin size (%) of SPs whose usage is below the cluster average. The default is 20%.
`dbal.overused.bin.size`	Specifies the bin size (%) of SPs whose usage is in the overused range. The default is 3%.

For example, to reduce the size of the Below Average bin to 10%, run the following command:

maprcli config save -values {"dbal.below.avg.bin.size":"10"}