HP MSA 1040 HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 70

create volume-set Description Creates a specified number of volumes in a vdisk. You must specify a base name and a size for the volumes. You can create the volumes unmapped or set their 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 mappings by using the map volume and unmap volume commands. By default, this command will not map the created volumes. 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. Syntax create volume-set vdisk vdisk basename base-name count # size size[B|KB|MB|GB|TB|KiB|MiB|GiB|TiB] [baselun base-LUN] [access read-write|rw|read-only|ro|no-access] [ports ports] Parameters vdisk vdisk The name or serial number of the vdisk in which to create the volumes. For vdisk syntax, see "Command syntax" (page 20). basename base-name A name to which a number will be appended to generate a different name for each volume. A name is case sensitive; can include spaces and printable UTF-8 characters except a left angle bracket, backslash, comma, or double quote; and can have a maximum of 16 bytes. A name 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 vdisk. size size[B|KB|MB|GB|TB|KiB|MiB|GiB|TiB] Sets the size for each volume 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. If the combined size of the volumes exceeds the capacity of the vdisk, an error message is displayed and no volumes are created. 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. 70 Alphabetical list of commands