CLI Guide

virtual-volume expand
Non-disruptively increases the capacity of an existing virtual volume.
Contexts
All contexts.
In clusters/cluster/virtual-volumes/ context and below, command is expand.
Syntax
virtual-volume expand
[-v|--virtual-volume] context-path
[-e|--extent] extent
[-f|--force]
Arguments
Required
arguments
[-v|--
virtual-
volume]
context-path
* The virtual volume to expand.
● For both storage volume and concatenation methods of expansion, the virtual volume must be
expandable, and have a geometry of RAID 1, RAID C, or RAID 0.
● For storage-volume expansions, the virtual volume must be expandable, and have a geometry of RAID 1,
RAID C, RAID 0, or DR1.
Optional
arguments
[-e|--
extent] extent
* The target local device or extent to add to the virtual volume using the concatenation method of
expansion. The local device or extent must not have a virtual volume on top of it.
[-f|--force]
The meaning of this argument varies, depending on whether the --extent argument is used (expansion
method = concatenation) or not used (expansion-method = storage-volume)
● For storage-volume expansion, the --force argument skips the confirmation message.
● For concatenation expansion, the --force argument expands a virtual volume built on a RAID 1 device
using a target that is not a RAID 1 or that is not as redundant as the device supporting the virtual
volume.
* - argument is positional.
Description
This command expands the specified virtual volume using one of two methods; storage-volume or concatenation.
The ll command output shows whether the volume is expandable, the expandable capacity (if any), and the expansion method
available for the volume. For example:
VPlexcli:> ll /clusters/cluster-1/virtual-volumes/ Test_volume
Name Value
------------------- --------------
.
.
.
capacity 0.5G
consistency-group -
expandable true
332
Commands