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 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.
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
|