volume move

Moves the specified volume or mirror to a different topology. Permissions required: m or fc on the volume.

Syntax

CLI
/opt/mapr/bin/maprcli volume move
  -name volumeName
  [ -cluster cluster_name ]
 [ -eclabel new label for ec-store volume ]
 [ -ectopology <topology> ]
 [ -label new label for volume data ]
 [ -nslabel new label for volume name container ]
  [ -topology topology ]
REST
Request Type POST
Request URL
http[s]://<host>:<port>/rest/volume/move?<parameters> 

Parameters

Parameter: cluster
Possible Values: Any valid cluster.
Description: The cluster on which to create the volume.
Parameter: eclabel
Possible Values: Any label.
Description: The label to use for the erasure-coded volume. See Using Storage Labels for more information on labels.
The label should contain only the following characters:
A-Z a-z 0-9 _ - .
Parameter: ectopology
Possible Values: Any topology that exists in your environment.
Description: The new rack path for the erasure-coded volume if you are moving an erasure-coded volume.
Note: This parameter is applicable only for EC volumes, and only when you set the ecenable parameter in volume create, or volume modify to true.
Parameter: label
Possible Values: Any label.
Description: The label to use for the storage pool. See Using Storage Labels for more information on labels.
The label should contain only the following characters:
A-Z a-z 0-9 _ - .
Tip: Use the special label named anywhere to let a volume reside on any storage pool. Not setting a label, causes a volume to reside only on a storage pool without a label.
Parameter: name
Possible Values: Any valid name
Description: The name of the volume to move. For moving:
  • An erasure coded volume, specify the name of the front-end volume.
  • The metadata volume associated with a tier, specify the name of the metadata volume.
The name should contain only the following characters:
A-Z a-z 0-9 _ - .
For tiering-enabled volumes, the volume name cannot exceed ninety-eight characters.
Parameter: nslabel
Possible Values: Any value.
Description: The label to use for the namespace container. See Using Storage Labels for more information on labels.
The label should contain only the following characters:
A-Z a-z 0-9 _ - .
Parameter: topology
Possible Values: Any
Description: The new rack path for the:
  • Regular or tiered standard volume, if you are moving a regular or tiered standard volume.
  • Regular or tiered mirror volume, if you are moving a regular or tiered mirror volume.
  • Metadata volume, if you are moving a metadata volume associated with a tier.
This parameter is not required, if you are moving an erasure-coded volume.

Advisory Note on Storage Labels

When the volume of a label is changed, replicas cannot be migrated within the file server, from one SP with the old label to another SP with the desired label. If there no other SPs, all old copies will not be fully migrated to the new desired label.

Examples

maprcli volume move -name testVolume -topology /newPath
curl -k -X 'https://abc.sj.us:8443/rest/volume/move?name=testVolume&topology=%2FnewPath' --user mapr:mapr