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

  1. Log in to the Control System and go the volume information page.
  2. Click Rename Volume from the Select Action drop-down menu to display the Rename Volume window.
  3. Enter the new name for the volume in the New Volume Name field and click Save Changes for the changes to take effect.
    NOTE
    For 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>
See volume rename for more information.