CLI Guide

Table Of Contents
set vdisk on page 161
show disks on page 184
show vdisks on page 259
create volume
Description Creates a volume in a linear disk group or virtual pool.
You must specify a size for the volume. You can create the volume unmapped or set its default
mapping. Default mapping settings apply to all hosts, unless overridden by an explicit mapping
between a host and the volume. You can later change the mapping by using the map volume and
unmap volume commands. By default, this command will not map the created volume.
CAUTION: Using a default mapping for a volume will allow multiple hosts to access the
volume. To avoid multiple hosts mounting the volume and causing corruption, the hosts
must be cooperatively managed, such as by using cluster software.
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.2 MB; if the resulting size would be
greater than 4.2 MB it will be decreased to the nearest 4.2 MB boundary.
To create multiple volumes at once, use the create volume-set command.
NOTE: For virtual storage, you cannot add a volume to a volume group that is in a replication set.
For virtual storage, you can set the retention priority for snapshots of the volume. If automatic
deletion of snapshots is enabled, the system uses the retention priority of snapshots to determine
which, if any, snapshots to delete. Snapshots are considered to be eligible for deletion if they have
any retention priority other than never-delete. Eligible snapshots are considered for deletion by priority
and age. The oldest, lowest priority snapshots are deleted first. Snapshots that are mapped or are not
leaves of a volumes snapshot tree are not eligible for automatic deletion.
Minimum role manage
Syntax
create volume
[access read-write|rw|read-only|ro|no-access]
[large-virtual-extents enabled|disabled|on|off]
[lun LUN]
[pool pool]
[ports ports]
[reserve size[B|KB|MB|GB|TB|KiB|MiB|GiB|TiB]]
size size[B|KB|MB|GB|TB|KiB|MiB|GiB|TiB]
[snapshot-retention-priority never-delete|high|medium|low]
[tier-affinity no-affinity|archive|performance]
vdisk vdisk
[volume-group volume-group]
name
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
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 in SSD applications and improve performance.
disabled or off: Optimized page allocation is disabled. This is the defaullarge-virtual-
extents enabled|disabled|on|offt.
62 Alphabetical list of commands