HP MSA 2040 CLI Reference Guide

create volume 69
create volume
Description Creates a volume in a vdisk. 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-MB boundaries. When a volume is created or expanded, if the
resulting size would be less than 4 MB it will be increased to 4 MB; if the resulting size would be
greater than 4 MB it will be decreased to the nearest 4-MB boundary.
If you intend to use the volume as the secondary volume in a replication set, you can create a
replication-prepared volume. A secondary volume cannot be mapped.
To create multiple volumes at once, use the create volume-set command.
Syntax
create volume
vdisk
vdisk
size size [B|KB|MB|GB|TB|KiB|MiB|GiB|TiB]
[mapping
ports . LUN ]
[access read-write|rw|read-only|ro|no-access]
[lun
LUN ]
[ports
ports ]
[snap-pool
snap-pool ]
[reserve
size [B|KB|MB|GB|TB|KiB|MiB|GiB|TiB]]
[snappable]
[prepare-replication-volume]
name
Parameters vdisk vdisk
The name or serial number of the vdisk in which to create the volume. For vdisk syntax, see
"Command syntax" (page 20).
size
size [B|KB|MB|GB|TB|KiB|MiB|GiB|TiB]
Sets the volume size using the current base, as shown by the show cli-parameters command. The unit
can be specified as follows:
• If base 2 is in use: B (bytes), KiB (kibibytes), MiB (mebibytes), or GiB (gibibytes)
• If base 10 is in use: B (bytes), KB (kilobytes), MB (megabytes), or GB (gigabytes)
If no unit is specified, the unit is 512-byte blocks.
mapping
ports . LUN
Deprecated; use the ports and lun parameters.
access read-write|rw|read-only|ro|no-access
Optional. The access permission for hosts connected to the controller for this volume: read-write (rw),
read-only (ro), or no-access. If no-access is specified, the volume is not mapped. The default is
read-write.
lun
LUN
Optional if the access parameter is set to no-access. Specifies the LUN to assign to the mapping
on all ports.