CLI Guide

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 volume size is 140 TB (128 TiB).
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.
snapshot-retention-priority never-delete|high|medium|low
Optional. For virtual storage, this specifies the retention priority for snapshots of the volume set.
never-delete: Snapshots will never be deleted.
high: Snapshots may be deleted after all eligible medium-priority snapshots have been deleted
medium: Snapshots may be deleted after all eligible low-priority snapshots have been deleted. This is the
default.
low: Snapshots may be deleted.
tier-affinity no-affinity|archive|performance
Optional. For virtual storage, this specifies how to tune the tier-migration algorithm for the volume:
no-affinity: This setting uses the highest available performing tiers first and only uses the Archive
tier when space is exhausted in the other tiers. Volume data will swap into higher performing tiers based
on frequency of access and tier space availability. This is the default.
archive: This setting prioritizes the volume data to the least performing tier available. Volume data can
move to higher performing tiers based on frequency of access and available space in the tiers.
performance: This setting prioritizes volume data to the higher performing tiers. If no space is available,
lower performing tier space is used. Performance affinity volume data will swap into higher tiers based
upon frequency of access or when space is made available
vdisk vdisk
Optional; required for linear volumes. The name or serial number of the linear disk group in which to create
the volumes. A name that includes a space must be enclosed in double quotes.
volume-group volume-group
Optional. The name of a volume group to which to add the volume. A name that includes a space must be
enclosed in double quotes. If the group does not exist, it will be created
Examples
Create two unmapped, 100 GB volumes with base name MyVol- in pool B and add them to volume group
MyVG.
# create volume-set count 2 size 100GB pool b basename MyVol- volume-group
MyVG
Create two unmapped, 100 GB volumes with base name data- in disk group data.
# create volume-set count 2 size 100GB vdisk data basename data-
Create ten 20-GB volumes with the base name vd1_v in disk group vd1, mapped starting with LUN 5 with
read-only access through port A1.
# create volume-set count 10 size 20GB vdisk vd1 basename vd1_v baselun 5
access ro ports a1
Create four 5 MB volumes with the base name BV1_ with snapshot retention priority high.
# create volume-set pool B count 4 size 5MB basename BV1_ snapshot-
retention-priority high volume-group Vol1
See also
create volume
Alphabetical list of commands 65