6.2.12.3 chvolume

Change attributes of a volume.

Purpose

The chvolume command allows you to modify the attributes of an Exascale volume.

Syntax

chvolume volume-ID [ --attributes attribute=value[,attribute=value]... ]

Command Options

The options for the chvolume command are:

  • volume-ID: Identifies the volume being changed. You can use the lsvolume command to find the identifier for each volume.

  • --attributes: Optionally specifies attributes to change.

    Use the describe chvolume command to see details about the volume attributes you can change. See also Describing Resources and Attributes.

Usage Notes

  • The chvolume command only proceeds if the specified volume is not attached.

  • A volume can have up to two owners. To modify volume ownership, you can add or remove one volume owner at a time.

    To add a volume owner, specify owners=+user-ID as an attribute setting. To remove a volume owner, use owners=-user-ID.

    For example, see Example 6-153.

Examples

Example 6-152 Change the Volume Size

This example shows changing the size of the volume with the volume ID vol0002_50e52177583f4be4bad68ac20b65001e. 

@> chvolume vol0002_50e52177583f4be4bad68ac20b65001e --attributes size=200m

Example 6-153 Change the Volume Owners

The following examples show different ways to change the volume owners.

  • The following command adds peter as an owner of the specified volume: 

    @> chvolume vol0002_50e52177583f4be4bad68ac20b65001e --attributes owners=+peter

  • The following command removes dave as an owner of the specified volume: 

    @> chvolume vol0002_50e52177583f4be4bad68ac20b65001e --attributes owners=-dave

Parent topic: Block Store Management