Renaming a Volume
Describes how to rename a volume using the Control System, CLI or the REST API.
About this task
The rename operation for a volume triggers an unmount and a remount of the volume being renamed. The volume mount path is unavailable for an ongoing IO operation that results in a temporary IO failure.
CAUTION
Data is not written to a volume if you rename the volume in the
midst of an IO operation. Stop all clients that are writing data to a volume and
ensure that no active IO operations are taking place on the volume, before you
rename the volume. Renaming a Volume Using the Control System
Procedure
- Log in to the Control System and go the volume information page.
- Click Rename Volume from the Select Action drop-down menu to display the Rename Volume window.
-
Enter the new name for the volume in the New Volume
Name field and click Save Changes for
the changes to take effect.
NOTEFor tiering-enabled volumes, volume name cannot exceed ninety-eight characters.
Renaming a Volume Using the CLI and REST API
About this task
The basic command to rename a volume is:
maprcli volume rename -name <oldName> -newname <newName>Send a request of type POST. For example:
curl -X POST 'https://<host>:8443/rest/volume/rename?name=<oldName>&newname=<newName>' --user <username>:<password>volume rename
for more information.