vxassist mirror

Use the vxassist mirror command to add a mirror to an existing volume.

vxassist [-b] [-o notrackalign] [-g<DynamicDiskGroupName>] mirror <VolumeName|DriveLetter|VmName|DrivePath> [type=<typename>] [<alloc_attributes ...>] [Column=N] [StripeUnit=<width>] [Site=<sitename1>[,<sitename2>,...]] [<[!]diskname | p#c#t#l#> ...]

The following attributes apply:

-b

Runs the command in the background.

-o notrackalign

Disable track alignment on the disk where the volume resides.

-g<DynamicDiskGroupName>

Required only if the internal volume name or internal disk name is used.

<VolumeName>

the path name of the volume, such as \Device\HarddiskDmVolumes\DG1\Volume1.

<DriveLetter>

The drive letter of the volume.

<VmName>

Internal name of the volume; requires the use of the -g option (for example, -gDG1 Volume1).

<DrivePath>

A volume that is mounted on an NTFS folder; it is indicated by a path to that folder.

Type=<Type>

Type of volume layout.

Types are:

- Stripe

- Concatenate

<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

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

[!]<DiskName>...

The name of the disk or disks (such as Harddisk2) on which the mirror or mirrors are to be created.

The disk name can also be indicated by the internal disk name, which requires the -g option (for example, -gDG1 Disk2).

[!]<p#c#t#l#>

Another way to indicate a disk; the #s correspond to port, channel, target, and LUN of a disk.

Warning:

Adding mirrors to a volume involves a certain amount of time for mirror resynchronization. Take care not to perform actions on the volume until the command is complete. Also, if you inadvertently shut down the server or deport the disk group containing the volume before mirror resynchronization completes, any mirrors that were being added to the volume are deleted when the disk group with the volume comes online again.

The SmartMove feature can help reduce mirror resynchronization time.

Note:

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

Example

vxassist mirror -b Z: Mirror=2 Harddisk4 Harddisk5

The above command line sequence adds two mirrors to volume Z. Harddisk4 and Harddisk5 are used to create the mirrors. The process of adding the two mirrors runs in the background. Instead of using the drive letter Z, you can provide a path name, such as:

\Device\HarddiskDmVolumes\DynDskGrp1\Volume1

To create a mirror for a site-based volume using the site-aware allocation feature, refer to:

See Adding a mirror to a site-based volume through CLI.

See Administering mirrored plexes for site-based allocation.

More Information

SmartMove