This is documentation for MapR Version 5.0. You can also refer to MapR documentation for the latest release.

Skip to end of metadata
Go to start of metadata


The volume dump create command creates a volume dump file containing data from a volume for distribution or restoration. Permissions required: dump or fc on the volume.


You can use volume dump create to create two types of files:

  • full dump files containing all data in a volume
  • incremental dump files that contain changes to a volume between two points in time

A full dump file is useful for restoring a volume from scratch. An incremental dump file contains the changes necessary to take an existing (or restored) volume from one point in time to another. Along with the dump file, a full or incremental dump operation can produce a state file (specified by the ?-e parameter) that contains a table of the version number of every container in the volume at the time the dump file was created. This represents the end point of the dump file, which is used as the start point of the next incremental dump. The main difference between creating a full dump and creating an incremental dump is whether the -s parameter is specified; if -s is not specified, the volume create command includes all volume data and creates a full dump file. If you create a full dump followed by a series of incremental dumps, the result is a sequence of dump files and their accompanying state files:

dumpfile1 statefile1

dumpfile2 statefile2

dumpfile3 statefile3

...

To maintain an up-to-date dump of a volume:

  1. Create a full dump file. Example:

  2. Periodically, add an incremental dump file. Examples:

    ...and so on.

You can restore the volume from scratch, using the volume dump restore command with the full dump file, followed by each dump file in sequence.

Syntax

CLI

maprcli volume dump create
    [ -cluster <cluster> ]
    [ -s <start state file> ]
    [ -e <end state file> ]
    [ -o ]
    [ -dumpfile <dump file> ]
    -name volumename
{anchor:cli-syntax-end}

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.

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


  • No labels