test veritas logo


vxmirror(1M)

NAME

vxmirror - mirror volumes on a disk or control default mirroring

SYNOPSIS

/etc/vx/bin/vxmirror [-g diskgroup ] [-d yes|no ] [-t tasktag ] medianame [new_medianame...]

/etc/vx/bin/vxmirror [-g diskgroup ] [-d yes|no ] [-t tasktag ] -a [new_medianame...]

/etc/vx/bin/vxmirror [-g diskgroup ] [-d yes|no]

/etc/vx/bin/vxmirror [-g diskgroup] -D

DESCRIPTION

The vxmirror command provides a mechanism to mirror all non-mirrored volumes that are located on a specified disk, to mirror all currently non-mirrored volumes in the specified disk group, or to change or display the current defaults for mirroring. All volumes that have only a single plex (mirror copy), are mirrored by adding an additional plex.

Volumes containing subdisks that reside on more than one disk are not mirrored by vxmirror.

vxmirror is generally called from the vxdiskadm menus. It is not an interactive command, and after it is called, continues until completion of the operation or until a failure is detected.

Note: Generating mirror copies of volumes can take a considerable time to complete.

In the first listed form of this command, the disk media name is supplied on the command line to vxmirror. That name is assumed to be the only disk from which volumes are mirrored. In the case of mirroring volumes from a specified disk, only simple single-subdisk volumes are mirrored.

In the first and second listed forms of the command, new_medianame... identifies a new disk media name (or set of names). The mirroring operation uses these names as targets on which to allocate the mirrors. An error results if the same disk is specified for both the source and target disk and if no other viable targets are supplied.

Hardware-Specifc Note

Some environments provide guidelines to optimize the VxVM’s interaction with intelligent storage systems. If these guidelines are present, VxVM follows the guidelines when creating volumes or allocating space for volumes. By default, vxmirror only creates mirror volumes that conform with these guidelines. The following options change the behavior of vxmirror:
-o override Creates a mirror of the specified volume and ignores any storage-specific guidelines. Overriding the guidelines is not recommended as it can result in incompatible objects, or objects that cannot be administered by VxVM.
-o verify Verifies that the specified mirror can be created without violating any storage-specific guidelines, but does not create the plex. If any guidelines are violated, vxmirror exits with an error message.
Note: These options need a specific license. Without the license, vxmirror ignores the specified option.

OPTIONS

-a Mirrors all existing volumes for the specified disk group.
-d yes | no Changes the default for subsequent volume creation, depending on the option argument. If yes, then all subsequent volumes created automatically become mirrored volumes. If no, then mirroring is turned off for future volumes created.
-D Displays current default status for mirroring.
-g diskgroup Limits operation of the command to the given disk group, as specified by disk group ID or disk group name. The medianame operands are evaluated relative to the given disk group. If this option is not specified, the default disk group is determined using the rules given in the vxdg(1M) manual page.
-t tasktag Specifies using a tasktag as the tag for any tasks created to perform the mirror operations.
-f Modifies the mirror disk geometry forcefully. This option is recommended when there is a mismatch between geometry of the source and mirror disk. When you use -f option,vxmirror tries to align mirror disk geometry with the source disk. This may result in slight size truncation on mirror disk due to the way in which the geometry is aligned.

EXAMPLES

The following command mirrors all non-mirrored volumes on disk disk01 to the available space on any other available disk. Subsequent calls to vxassist mirror created volumes by default.

/etc/vx/bin/vxmirror -d yes disk01

This command displays the current status of default mirroring. It outputs the string yes if mirroring is currently enabled, or no if mirroring is not enabled.


/etc/vx/bin/vxmirror -D

This command mirrors any volumes on disk02 to disk03.


/etc/vx/bin/vxmirror disk02 disk03

FILES

/etc/default/vxassist The defaults file for vxassist parameters.

NOTES

Volumes on the root disk cannot be mirrored to an EFI disk.

SEE ALSO

vxassist(1M), vxdiskadm(1M), vxintro(1M), vxtask(1M)


VxVM 7.3.1 vxmirror(1M)