vxmirror(1M)                     VxVM 3.5                      vxmirror(1M)
                                 1 Jun 2002



 NAME    [Toc]    [Back]
      vxmirror - mirror volumes on a disk or control default mirroring

 SYNOPSIS    [Toc]    [Back]
      /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    [Toc]    [Back]
      The vxmirror command provides a mechanism to mirror 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),
      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    [Toc]    [Back]
      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:




                                    - 1 -       Formatted:  January 24, 2005






 vxmirror(1M)                     VxVM 3.5                      vxmirror(1M)
                                 1 Jun 2002



      -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    [Toc]    [Back]
      -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 no disk group is supplied, then rootdg is
                assumed.

      -t tasktag
                Specifies using a tasktag as the tag for any tasks created
                to perform the mirror operations.

 EXAMPLES    [Toc]    [Back]
      The following command mirrors the disk disk01 to any available space
      on any 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




                                    - 2 -       Formatted:  January 24, 2005






 vxmirror(1M)                     VxVM 3.5                      vxmirror(1M)
                                 1 Jun 2002



      This command mirrors any volumes on disk02 to disk03.

           /etc/vx/bin/vxmirror disk02 disk03


 FILES    [Toc]    [Back]
      /etc/default/vxassist         The defaults file for vxassist
                                    parameters.

 SEE ALSO    [Toc]    [Back]
      vxassist(1M), vxdiskadm(1M), vxintro(1M), vxtask(1M)


                                    - 3 -       Formatted:  January 24, 2005