Commands for managing volumes

Depending on whether you are an administrator or an individual user, the Ozone shell commands enable you to create, delete, view, list, and update volumes.

Creating a volume

Only an administrator can create a volume and assign it to a user.
Command Syntax
ozone sh volume create --quota=<volumecapacity> --user=<username> /<volumename>
Purpose Creates a volume and assigns it to a user.
Arguments
  • -q, quota: Specifies the maximum size the volume can occupy in the cluster. This is an optional parameter.
  • -u, user: The name of the user who can use the volume. The designated user can create buckets and keys inside the particular volume. This is a mandatory parameter.
  • The name of the volume to create.
Example
ozone sh volume create --quota=2TB --user=usr1 /vol1
This command creates a 2-TB volume named vol1 for user usr1.

Deleting a volume

Command Syntax
ozone sh volume delete /<volumename>
Purpose Deletes the specified volume, which must be empty.
Arguments The name of the volume to delete.
Example
ozone sh volume delete /vol2
This command deletes the empty volume vol2.

Viewing volume information

Command Syntax
ozone sh volume info /<volumename>
Purpose Provides information about the specified volume.
Arguments The name of the volume whose details you want to view.
Example
ozone sh volume info /vol3
This command provides information about the volume vol3.

Listing volumes

Command Syntax
ozone sh volume list --user <username>
Purpose Lists all the volumes owned by the specified user.
Arguments -u, user: The name of the user whose volumes you want to list.
Example
ozone sh volume list --user usr2
This command lists the volumes owned by user usr2.

Updating a volume

Command Syntax
ozone sh volume update --quota=<volumecapacity> --user=<username> /<volumename>
Purpose Updates the quota or changes the user associated with a specific volume.
Arguments
  • -q, quota: Specifies the maximum size the volume can occupy in the cluster. This is an optional parameter.
  • -u, user: The name of the user who can use the volume. The designated user can create buckets and keys inside the particular volume. This is an optional parameter.
  • The name of the volume to update.
Example
ozone sh volume update --quota=10TB /vol4
This command updates the quota of volume vol4 to 10TB.