title: Volume Commands menu: main: parent: OzoneShell weight: 1

Volume commands generally need administrator privileges. The ozone shell supports the following volume commands.

Create

The volume create command allows an administrator to create a volume and assign it to a user.

Params:

ArgumentsComment
-q, --quotaOptional, This argument that specifies the maximum size this volume can use in the Ozone cluster.
-u, --userRequired, The name of the user who owns this volume. This user can create, buckets and keys on this volume.
UriThe name of the volume.

{{< highlight bash >}} ozone sh volume create --quota=1TB --user=bilbo /hive {{< /highlight >}}

The above command will create a volume called hive on the ozone cluster. This volume has a quota of 1TB, and the owner is bilbo.

Delete

The volume delete command allows an administrator to delete a volume. If the volume is not empty then this command will fail.

Params:

ArgumentsComment
UriThe name of the volume.

{{< highlight bash >}} ozone sh volume delete /hive {{< /highlight >}}

The above command will delete the volume hive, if the volume has no buckets inside it.

Info

The volume info commands returns the information about the volume including quota and owner information. Params:

ArgumentsComment
UriThe name of the volume.

{{< highlight bash >}} ozone sh volume info /hive {{< /highlight >}}

The above command will print out the information about hive volume.

List

The volume list command will list the volumes owned by a user.

{{< highlight bash >}} ozone sh volume list --user hadoop {{< /highlight >}}

The above command will print out all the volumes owned by the user hadoop.

Update

The volume update command allows changing of owner and quota on a given volume.

Params:

ArgumentsComment
-q, --quotaOptional, This argument that specifies the maximum size this volume can use in the Ozone cluster.
-u, --userOptional, The name of the user who owns this volume. This user can create, buckets and keys on this volume.
UriThe name of the volume.

{{< highlight bash >}} ozone sh volume update --quota=10TB /hive {{< /highlight >}}

The above command updates the volume quota to 10TB.

You can try out these commands from the docker instance of the Alpha Cluster.