vxassist make

Use the vxassist make command to create a volume.

vxassist [-b] [-o notrackalign] -g<DynamicDiskGroupName> make [<VolumeName>] <length>[type={mirror|raid5|stripe}[,log]] [<alloc_attributes...>] [Column=N] [StripeUnit=<width>] [Site=<sitename1>[,<sitename2>,...]] [DriveLetter={A|B|..|Z}|DrivePath=<DrivePath>] [<[!]diskname | p#c#t#l#> ...]

The following attributes apply:

-b

Option to run the command in the background. This option is useful for the operations that take an extended amount of time, such as adding a mirror or extending a volume.

-o notrackalign

Disable track alignment on the disk where the volume resides.

-g<DynamicDiskGroupName>

Name of the dynamic disk group.

<VolumeName>

Name of the volume. This is a Storage Foundation-specific name that is used for internal processing.

The name is limited to 18 ASCII characters. It cannot contain spaces, slash mark (/), backslash (\), exclamation point (!), angle brackets (< >), or equal sign (=). Also, a period cannot be the first character in the name.

<Length>

Size of the volume; megabytes is the default. To indicate KB, add K to the number (500K); similarly, add G for GB and T for TB.

type={mirror|raid5|stripe} [,log]

Type of volume to be created. Default is a spanned volume. The [,log] argument in type adds a RAID-5 log for a RAID-5 volume or a dirty region logging (DRL) log for a mirrored volume during volume creation.

<alloc_attributes>

Allocation attributes for mirroring and striping volumes.

Attributes are:

  • Mirror=n[, {diskclass {[!]diskclass:instance}}]

  • Wantmirror={diskclass {[!]diskclass:instance}}

  • Stripe={diskclass {[!]diskclass:instance}}

  • Wantstripe={diskclass {[!]diskclass:instance}}

Mirror=<n>

or

Mirror=<n>, diskclass

Number of mirrors to be created for mirrored volumes. (Default is 2.)

Optionally specify a diskclass to use in mirroring. For example, Mirror=2,target specifies that volumes are mirrored between SCSI target addresses. Each mirror can contain disks from any number of instances of the diskclass, but different mirrors cannot use disks from the same instance of the diskclass.

Stripe=diskclass

Volumes are striped across instances of a particular diskclass. For example, Stripe=target specifies that volumes are striped between SCSI target addresses. Each column stripe can contain disks from any number of instances of the diskclass, but different columns cannot use disks from the same instance of the diskclass.

Wantmirror=diskclass

Specifies a diskclass to use in mirroring. However this constraint is ignored if the requested allocation cannot be satisfied.

Wantstripe=diskclass

Volumes are striped across instances of a particular disk class. However this constraint is ignored if the requested allocation cannot be satisfied.

diskclass {[!]diskclass:instance}

Diskclass specifies (or excludes) a particular type of disk grouping. For example, port specifies a group of disks on a port.

Instance specifies which grouping. For example, p1 specifies a particular grouping of disks.

Each type of diskclass has a particular format for specifying instances of the class. Multiple diskclass instances can be specified separated by a space.

Diskclass can be one of the following:

- target or t

Specifies the disks that have the same SCSI target address of the same port. The target is specified in the form p#t#

- enclr, e, or enclosure

Specifies the disks belonging to a particular enclosure.

- port or p

Specifies the disks that are connected to a particular port.

- channel or ch

Specifies the disks that are connected to a particular channel.

Column=<n>

Number of columns. Required for RAID-5 and striped volumes.

StripeUnit=<Width>

Stripe width of RAID-5/striped volumes in blocks (512 Kbytes). Allows the user to specify the stripe unit for RAID-5 and striped volumes.

Site

Name of the site on which a site-based volume is to be created or mirrored.

DriveLetter={A|B|...|Z}

The default is no assignment of a drive letter to the volume.

DrivePath=<DrivePath>

Used when you want to mount the new volume at a folder on a local NTFS volume. You can use this attribute as an alternative to the drive letter.

[!]<DiskName>...

Name of a disk or disks to include or exclude, such as Harddisk2. Parameters are used to specify disks for volume creation, mirroring, and extension.

The disk name can also be indicated by the internal disk name or by p#c#t#l#, where the #s correspond to port, channel, target, and LUN of a disk.

If disks are not specified, SFW selects the disks automatically within the specified disk group.

Note:

This attribute is required when working with a Microsoft Disk Management Disk Group.

Note:

The default volume type is a concatenated volume. The created volume is not formatted (no file system is created on the volume). You need to use the operating system format command to format the volume.

Note:

Dynamic disks belonging to a Microsoft Disk Management Disk Group do not support track alignment.

Examples

vxassist -gDG2 make 100 DriveLetter=E Harddisk1

The above command line sequence creates a simple 100-MB volume in dynamic disk group DG2. The volume's drive letter is E. The volume would be created on Harddisk1.

vxassist -gDG2 make 100 type=mirror,log DriveLetter=F

The above command line sequence makes a mirrored 100-MB volume with a DRL log. The volume is assigned the drive letter F.

vxassist -gDG2 make 120 type=raid5 DriveLetter=X Column=3 
Harddisk2 Harddisk3 Harddisk5

The above command line sequence creates a 120-MB RAID-5 volume with the drive letter X. The volume is striped across Harddisk2, Harddisk3, and Harddisk5. All RAID-5 volumes require at least three columns. If you do not indicate a column number for a RAID-5 volume, the command fails.

vxassist -b -gDG2 make 100 type=stripe DriveLetter=X Column=3

The above command line sequence makes a striped volume that is assigned drive letter X. The -b option allows the command to run in the background.

vxassist -gDG2 make DbVolume 100

The resulting path name for the volume is:

\Device\HarddiskDmVolumes\DG2\DbVolume.

vxassist -gDG2 make Vol1 100m mirror=2, port

The above command line sequence makes a two mirrored 100-MB volumes that are connected to the same port.

vxassist -gDG2 make Vol1 100m mirror=2, port port:p2 port:p3

The above command line sequence makes two mirrored 100-MB volumes that are connected to port:p2 and port:p3.

To create a volume for a site that uses the site-aware allocation feature, refer to:

See Creating a volume through CLI.

See Administering volumes for site-based allocation .