vxmirror(1M)															      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 comple-
       tion 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  recom-
		 mended 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  cre-
		 ated 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 oper-
		 ands 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.

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  mir-
       roring 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.

SEE ALSO

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

VxVM 5.0.31.1							    24 Mar 2008 						      vxmirror(1M)