MapR 5.2 is at End of Life (EOL) and no longer supported. Please see the latest documentation. This documentation is not being updated.

Home
5.2 Cluster Administration
This section contains information on administering the cluster and MapR-DB, configuring Gateways, and configuring and managing particular aspects of the MapR security infrastructure.
Administrator's Reference
This section contains in-depth reference information for the administrator.
maprcli and REST API Syntax
This section provides information about the MapR command API. Most commands can be run on the command-line interface (CLI), or by making REST requests programmatically or in a browser.
volume
Manages volumes, snapshots and mirrors.
volume dump create
Creates a volume dump file containing data from a volume for distribution or restoration. Permissions required: dump or fc on the volume.

MapR 5.2 Documentation

5.2 Cluster Administration
This section contains information on administering the cluster and MapR-DB, configuring Gateways, and configuring and managing particular aspects of the MapR security infrastructure.
- Administering the Cluster
  This section describes how to manage the nodes and services that make up a cluster.
- Monitoring the Cluster
  This section describes how to monitor the health and performance of a MapR cluster.
- Configuring and Managing MapR Gateways
  A MapR gateway mediates one-way communication between a source MapR cluster and a destination cluster. MapR-DB tables and MapR Streams streams can be replicated.
- Administering MapR-DB
  Administration of the MapR-DB is done primarily via the commmand line (maprcli) or with the MapR Control System (MCS). Regardless of whether the MapR-DB table is used for binary files or JSON documents, the same types of commands are used with slightly different parameter options. MapR-DB administration is associated with tables, columns and column families, and table regions.
- Configuring Security
  Describes tasks for configuring MapR security, managing secure clusters, and administering auditing.
- Administrator's Reference
  This section contains in-depth reference information for the administrator.
  - maprcli and REST API Syntax
    This section provides information about the MapR command API. Most commands can be run on the command-line interface (CLI), or by making REST requests programmatically or in a browser.
    - Overview
      Each command reference page includes the command syntax, a table that describes the parameters, and examples of command usage.
    - acl
      Describes the acl commands used to access control lists (ACLs).
    - alarm
      Describes the alarm commands that perform functions related to system alarms.
    - audit
      Describes commands used to audit operations related to cluster management and data access.
    - blacklist
      Describes commands used to blacklist and to list blacklisted users.
    - cluster
      Manages cluster features, gateways, and cluster-wide settings.
    - config
      Manages configuration values for the MapR cluster.
    - dashboard info
      Displays a summary of information about the cluster.
    - dialhome
    - disk
      Describes command for working with disks.
    - dump
      Returns key information about volumes, containers, storage pools, and MapR cluster services for debugging and troubleshooting.
    - entity
      Manages entities (users and groups).
    - fid
      Displays information about MapR-DB or file-system components that are identified by a FID.
    - job
      Manages Hadoop jobs running on the cluster.
    - license
      Manages MapR licenses.
    - nagios generate
      Generates a Nagios Object Definition file that describes the cluster nodes and the services running on each.
    - nfsmgmt
      Refreshes NFS exports and server cache.
    - node
      Manages nodes in the cluster
    - rlimit
      Manages resource usage limits for the cluster.
    - schedule
      Manages schedules.
    - service list
      Lists all services on the specified node, the memory allocated for each service, the state of each service, and log path for each service.
    - setloglevel
      Sets log level on individual services.
    - stream
      Manages stream functionality.
    - table
      Performs functions related to MapR-DB tables.
    - task
      Manipulates information about the Hadoop jobs that are running on your cluster.
    - trace
      Lets you view and modify the trace buffer, and the trace levels for the system modules.
    - urls
      Displays the status page URL for the specified service.
    - virtualip
      Manages virtual IP addresses for NFS nodes.
    - volume
      Manages volumes, snapshots and mirrors.
      - volume audit
        Enables or disables auditing on the specified volume.
      - volume container move
        Moves a container. Permissions required: fc or m on the volume.
      - volume container switchmaster
        Switches the master replica for a specified container to another replica in the replica chain.
      - volume create
        Creates a volume. Permissions required: cv or fc on the volume.
      - volume dump create
        Creates a volume dump file containing data from a volume for distribution or restoration. Permissions required: dump or fc on the volume.
        Create and Maintain Volume Dump File
        Describes how to create full dump files and add incremental volume dump files.
      - volume dump restore
        Restores or updates a volume from a dump file. Permissions required: fc or restore on the volume.
      - volume fixmountpath
        Corrects the mount path of a volume. Permissions required: fc or m on the volume.
      - volume info
        Displays information about the specified volume. For best results, use the -json option when running the command.
      - volume link create
        Creates a link to a volume. Permissions required: fc or m on the volume.
      - volume link remove
        Removes the specified symbolic link. Permissions required: fc or m on the volume.
      - volume list
      - volume mirror push
        Pushes the changes in a volume to all of its mirror volumes in the same cluster, and waits for each mirroring operation to complete.
      - volume mirror start
        Starts mirroring on the specified volume from its source volume.
      - volume mirror stop
        Stops mirroring on the specified volume.
      - volume modify
        Modifies an existing volume. Permissions required: m or fc on the volume.
      - volume mount
        Mounts one or more specified volumes. Permissions required: fc or m on the volume.
      - volume move
        Moves the specified volume or mirror to a different topology. Permissions required: m or fc on the volume.
      - volume remove
        Removes the specified volume or mirror. Permissions required: d or fc on the volume.
      - volume rename
        Renames the specified volume or mirror. Permissions required: fc or d on the volume.
      - volume showmounts
        Returns a list of mount points for the specified volume.
      - volume snapshot create
        Creates a snapshot of the specified volume, using the specified snapshot name.
      - volume snapshot list
        Displays info about a set of snapshots.
      - volume snapshot preserve
        Preserves one or more snapshots from expiration.
      - volume snapshot remove
        Removes one or more snapshots.
      - volume unmount
        Unmounts one or more mounted volumes. Permissions required: fc or m on the volume.
      - volume upgradeformat
        Upgrades and old-type volume to a new-type volume, which can in turn be used as a promotable mirror volume. Permissions required: m or fc on the volume.
  - Utilities
    This section contains information about various scripts and utilities.
  - 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.
  - MapR Environment
    This section provides information associated the MapR environment.
- Glossary
  This section contains defintions for commonly used terms in MapR Converged Data Platform environments.

volume dump create

Creates a volume dump file containing data from a volume for distribution or restoration. Permissions required: dump or fc on the volume.

Syntax

CLI

maprcli volume dump create
    [ -cluster <cluster> ]
    [ -s <start state file> ]
    [ -e <end state file> ]
    [ -o ]
    [ -dumpfile <dump file> ]
    -name <volumename>

REST

None.

Parameters

Parameter	Description
cluster	The cluster on which to run the command.
dumpfile	The name of the dump file (ignored if -o is used).
e	The name of the state file to create for the end point of the dump.
name	A volume name.
o	This option dumps the volume to stdout instead of to a file.
s	The start point for an incremental dump.

NOTE: In a secure cluster, you must use the MapR user ID. Using root or any other user ID results in the system hanging.

Examples

Create a full dump:

CLI

maprcli volume create -e statefile1 -dumpfile fulldump1 -name volume -n

Create an incremental dump:

CLI

maprcli volume dump -s statefile1 -e statefile2 -name volume -dumpfile incrdump1