CLI Guide

Table Of Contents

expand volume

Description Expands a standard or base volume.

Volume sizes are aligned to 4.2 MB (4 MiB) boundaries. When a volume is created or expanded, if the

resulting size would be less than 4.2 MB it will be increased to 4 MB; if the resulting size would be

greater than 4.2 MB it will be decreased to the nearest 4.2 MB boundary.

For virtual storage, if overcommit is disabled, expansion is restricted to the space available in the pool

that contains the volume. If overcommit is enabled, the volume size can exceed the physical capacity

of the pool. To see whether overcommit is enabled, use the show pools command. The maximum size

of a virtual volume is 140 TB (128 TiB).

● When the overcommit feature is disabled, the host does not lose read or write access to the pool

volumes when the pool reaches or exceeds the high threshold value.

● When the overcommit feature is enabled, the storage system sends the data protect sense key

Add, Sense: Space allocation failed write protect to the host when the pool

reaches or exceeds the high threshold value. If the host is rebooted after the pool reaches or

exceeds the high threshold value, the host loses read and write access to the pool volumes. The

only way to regain read and write access to the pool volumes is to add more storage to the pool.

For linear storage, if insufficient space is available for expansion in the disk group, first expand the

disk group by using expand vdisk. The maximum size of a linear volume is equal to the maximum size

limit of the disk group.

You cannot expand the secondary volume of a replication set. However, you can expand the primary

volume of a replication set, which automatically expands its secondary volume—even if replication is

in progress.

Minimum role manage

Syntax

expand volume

size size[B|KB|MB|GB|TB|KiB|MiB|GiB|TiB] | max

volume

Parameters

size size[B|KB|MB|GB|TB|KiB|MiB|GiB|TiB] | max

Specifies either:

● The amount of space to add to the volume. The unit is optional (B represents bytes). If base 2 is

in use, whether you specify a base-2 or base-10 unit, the resulting size will be in base 2. If no unit

is specified, the default is 512-byte blocks.

● max: For linear storage, expand the volume to fill the available space in the disk group.

volume

The name or serial number of the volume to expand. A name that includes a space must be enclosed

in double quotes.

Examples

Expand volume V1 by 100 GB.

# expand volume size 100GB V1