vxmirror(ADM)

vxmirror - mirror volumes on a disk or control default mirroring

Synopsis

/etc/vx/bin/vxmirror [ -g diskgroup ] [ -d yes|no ] medianame [ new_medianame ... ]
/etc/vx/bin/vxmirror [ -g diskgroup ] [ -d yes|no ] -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 the contents of a specified disk, to mirror all currently un-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), will be mirrored by adding an additional plex.

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

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

NOTE: Due to the nature of generating mirror copies of volumes, this command may take a considerable time to complete.

Mirroring volumes from the boot disk produces a disk that can be used as an alternate boot disk. This is done by calling the vxrootmir command. This will mirror root and swap volumes. If usr and var are also volumes, they too will be mirrored.

In the first listed form of the command, the disk media name is supplied on the command line to vxmirror. That name is taken to be the only disk from which volumes should be 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 being performed will use these names as targets on which to allocate the mirrors. An error will result if the same disk is specified for both the source and target disk and if no other viable targets are supplied.

Options

-g diskgroup: Limit operation of the command to the given disk group, as specified by disk group ID or disk group name. The medianame operands will be evaluated relative to the given disk group. If no disk group is supplied to the vxmirror command, then rootdg is presumed.
-d: Change the default for subsequent volume creation, depending on the option argument. If the option argument is yes, then all subsequent volumes created using the vxassist command will automatically be created as mirrored volumes. If the option argument supplied is no, then mirroring will be turned off for future volumes by default.
-D: Display current default status for mirroring.
-a: Mirror all existing volumes for the specified disk group.

Examples

The following are examples of the use of the vxmirror command:

	vxmirror -d yes disk01

This invocation will cause the disk named disk01 to have its contents mirrored to any available space on any available disk. Subsequent calls to vxassist will cause created volumes to be mirrored by default.

	vxmirror -D

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

	vxmirror disk02 disk03

This command will cause any volumes on disk02 to be mirrored to disk03.

Files

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

References

vxassist(ADM), vxdiskadm(ADM), vxintro(ADM), vxrootmir(ADM)