CLI Guide

[volume-group volume-group]
Parameters
access read-write|rw|read-only|ro|no-access
Optional. The access permission to use for the mapping:read-write (rw), read-only (ro), or
no-access. If no-access is specified, the volume is not mapped. The default is read-write.
baselun base-LUN
Optional. The first in a sequence of LUNs to assign to map the volumes through ports specified by
the ports parameter. If the baselun and ports parameters are omitted, the volumes are not
mapped. If a LUN to be assigned to a volume is already in use, an error message is displayed and that
volume and any subsequent volumes are not mapped.
basename base-name
A name to which a number will be appended to generate a different name for each volume. Volume
names must be unique system-wide. Input rules:
● The value is case sensitive.
● The value can have a maximum of 16 bytes.
● The value can include spaces and printable UTF-8 characters except: " , . < \
● A value that includes a space must be enclosed in double quotes.
Resulting volumes are numbered sequentially starting with 0000. If volumes with the specified
basename already exist, names of new volumes start with the first available name in the sequence.
For example: for basename vd1_v, if vd1_v0000 and vd1_v0002 exist, the next volumes created
will be vd1_v0001 and vd1_v0003.
count #
The number of volumes to create, from 1 to 128. Volumes will be created up to the maximum number
supported per disk group.
large-virtual-extents enabled|disabled|on|off
Optional. For a virtual volume, this sets whether the system will try to allocate pages in a sequentially
optimized way to reduce I/O latency and improve performance.
● disabled or off: Optimized page allocation is disabled. This is the default.
● enabled or on: Optimized page allocation is enabled
pool pool
Optional; required for virtual volumes. The name or serial number of the pool in which to create the
volumes.
ports ports
Optional. The controller ports to use for the mapping. All ports must be the same type (FC, for
example). For port syntax, see Command syntax. If not all ports are specified, the unspecified ports
are not mapped. If the ports and baselun parameters are omitted, the volumes are not mapped.
size size[B|KB|MB|GB|TB|KiB|MiB|GiB|TiB]
Sets the volume size. 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.
A value less than 4.2 MB (4 MiB) will be increased to 4.2 MB. A value greater than 4.2 MB will be
decreased to the nearest 4.2 MB boundary. The maximum size of a virtual volume is 140 TB (128 TiB).
The maximum size of a linear volume is equal to the maximum size limit of the disk group.
If overcommit is enabled, the volume size can exceed the physical capacity of the storage pool. To
see whether overcommit is enabled, use the show pools command. If overcommit is disabled and
the combined size of the volumes will exceed the capacity of the storage pool, an error message is
displayed and no volumes are created.
● 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
66
Alphabetical list of commands