vol_name

Name of a volume.

access

Manages access control records for the volume.

clone

Clones the volume, creating a new volume.

delete-failback new_volume_name

Makes an inbound replica set promotion permanent. (Used only with a recovery volume, which is created by promoting an inbound replica set.)

The resulting volume will no longer be flagged as a recovery volume and cannot be demoted to the original inbound replica set.

replication

Manages volume replication and promotion.

schedule

Manages snapshot and replication schedules for the volume.

show

Displays details about the volume or iSCSI connections to the volume.

shrink [no-snap]
[no-adjust-snap-resv]
size[GB]

Decreases the volume to the specified size. The size is assumed to be in megabytes unless you specify otherwise. You can specify size with any of the following suffixes: m, mb, MB, g, gb, or GB.

See volume select shrink for more information.

size [no-snap] size[GB]

Increases the (reported) volume size. The size is assumed to be in megabytes unless you specify otherwise. You can specify size with any of the following suffixes: m, mb, MB, g, gb, or GB.

The new size will not be recognized by hosts currently connected to the volume unless they support file system expansion. Before increasing the volume size, understand how it affects the operating system, file system, or application using the volume, and set the volume offline first if necessary for your environment.

Note: Some operating systems cannot support volumes larger than 2TB. A warning message is displayed when you attempt to grow a volume beyond 2TB. Make sure your operating system will recognize the new, larger size.

See volume select size for more information.

snapshot

Manages volume snapshots or restores the volume from a snapshot.

bind member_name

Binds the volume to the specified member. Volume data will be restricted to this member.

Binding a volume to a member will override any RAID preference for the volume.

cancel-operation op_id

Cancels an in-progress operation for the volume. For example, you can cancel an in-progress replication, bind, or pool move operation.

Use the volume select show command to obtain the operation’s ID number.

description text

Description for the volume, up to 128 alphanumeric characters. If the text variable contains spaces, surround it with quotation marks.

iscsi-alias alias_name

iSCSI target alias for the volume, up to 64 alphanumeric characters. Some iSCSI initiators can see the alias.

lost-blocks action

Action to take when lost cached blocks occur on the volume, either:

• return-error – Sets the volume online but retains the lost cached block state. If an application attempts to read a lost block, an error will occur. If the block is rewritten, no error will occur, the block will no longer be considered lost, and the volume status will be online-lost-cached-blocks.

• mark-valid – Sets the volume online and marks the lost cached blocks as valid. This action may present a security risk, and the blocks may contain old data.

Note that lost cached blocks can occur if a power failure lasts longer than 72 hours.

offline|online

Sets a volume offline or online.

pool pool_name

Pool in which the volume data will be located.

Moving a volume across pools can be a lengthy operation because all the volume data must be moved from the members in the current pool to the members in the new pool. The data movement will compete with user I/O for computational and network bandwidth.

pref-raid-policy raid-policy

RAID policy preference for the volume data. If you specify raid5, raid50, or raid10, the group will attempt to place the volume data on a pool member with that RAID policy.

The default RAID policy is none, which allows the group to determine the optimal RAID policy for the volume data.

Volume clones do not inherit the RAID preference policy of the parent volume; they are set to none, by default.

read-only|read-write

Sets the volume permission to read-only or read-write (the default). (To make an online volume read-only, you must first set it offline.)

snap-depletion action

Action to take when the reserved snapshot space has been exceeded, either delete-oldest (the default; delete the oldest snapshots until enough space is recovered) or volume-offline (set the volume and its snapshots offline).

snap-reserve n%

Space reserved for snapshots as a percentage of volume size. You must include the percent sign (for example, 150%).

snap-warn n%

Threshold at which an alarm is generated because the amount of free space reserved for snapshots has fallen below the specified value, as a percentage of the total reserved snapshot space. You must include the percent sign (for example, 20%).

thin-provision
disable | enable
[tp-options]

Disables or enables thin provisioning on an existing volume.

When you disable thin provisioning on a volume, the volume reserve increases to the volume’s reported size.

For example, consider a thin-provisioned volume with a reported size of 500GB and a volume reserve that currently equals 300GB. If you disable thin provisioning, the amount of volume reserve will increase to 500GB.

When enabling thin provisioning, the thin-min-reserve, thin-growth-warn, and thin-growth-max parameters are optional. If not specified, the volume will use the group-wide defaults.

See the Group Administration guide for information about space reserve considerations when enabling and disabling thin provisioning on an existing volume.

thin-min-reserve n%

Minimum volume reserve (default is 10% of the total volume size) for a thin-provisioned volume. This is the amount of guaranteed space (volume reserve) for the volume.

thin-growth-warn n%

When the amount of in-use space reaches this value, as a percentage of the volume size, a warning alarm and event message is generated. Applies only to thin-provisioned volumes.

Additional warnings are generated as the amount of in-use space grows beyond this value, as follows:

• For volumes less than 200GB, a warning is generated with every additional 5% increase in the in-use space.

• For volumes larger than 200GB, a warning is generated with every additional 10GB of in-use space.

The default is the group-wide limit, as described in grpparams def-thin-growth-warn.

thin-growth-max n%

When in-use space reaches this limit, as a percentage of the volume size, the volume will be set offline. Applies only to thin-provisioned volumes.

The default is the group-wide limit, as described in grpparams def-thin-growth-max.

unbind

Removes any member binding for the volume.