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.
NOTE
In a secure cluster, you must use the
HPE Ezmeral Data Fabric user ID. Using
root
or any other user ID results in the system hanging.Syntax
- CLI
-
/opt/mapr/bin/maprcli volume dump create [ -cluster cluster_name [-s startvolumepointname] [-e endvolumepointname] [-o (for dumpfile on stdout)] [-dumpfile dumpfilename (ignored if -o is used)] -name volumename
- REST
-
Request Type POST Request URL http[s]://<host>:<port>/rest/volume/dump/create?<parameters>
Parameters
Parameter | Description |
---|---|
cluster |
The cluster on which to run the command. |
dumpfile |
The name of the dump file (ignored if -o is used). NOTE Provide the absolute path for the dump file. When the absolute path
is not provided, the dumpfile is stored in the
/opt/mapr/apiserver/bin folder. |
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
The data is not encrypted in the dump file created for a volume
enabled for data at rest encryption.Examples
Create a full dump:
/opt/mapr/bin/maprcli volume dump create -e statefile1 -dumpfile /tmp/fulldump1 -name volumeone
curl -X POST 'https://server.sj.us:8443/rest/volume/dump/create?e=statefile1&dumpfile=/tmp/fulldump1&name=volumeone' --user <username>:<password>
Create an incremental dump:
/opt/mapr/bin/maprcli volume dump create -s statefile1 -e statefile2 -name volumetwo -dumpfile /tmp/incrdump1
curl -X POST 'https://server.sj.us:8443/rest/volume/dump/create?s=statefile1&e=statefile2&name=volumetwo&dumpfile=/tmp/incrdump1' --user <username>:<password>