Index Index for
Section 8
Index Alphabetical
listing for V
Bottom of page Bottom of
page		 

volmirror(8)


NAME

  volmirror - Mirrors volumes on a disk or control default mirroring


SYNOPSIS

  /usr/sbin/volmirror [-g diskgroup] [-d yes|no] medianame [new_medianame...]

  /usr/sbin/volmirror [-g diskgroup] [-d yes|no] -a  [new_medianame...]

  /usr/sbin/volmirror [-g diskgroup] [-d yes|no]

  /usr/sbin/volmirror [-g diskgroup] -D


OPTIONS

  The volmirror command supports the following options:

  -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 will be
      evaluated relative to the given disk group.  If no disk group is
      supplied to the volmirror command, rootdg is presumed.

  -d  Changes the default for subsequent volume creation, depending on the
      option argument. If the option argument is yes, all subsequent volumes
      created using the volassist command will automatically be created as
      mirrored volumes. If the option argument supplied is no, mirroring will
      be turned off for future volumes by default.

  -D  Displays current default status for mirroring.

  -a  Mirrors all existing volumes for the specified disk group.


DESCRIPTION

  The volmirror command provides a mechanism to mirror all the contents of a
  specified disk, to mirror all currently unmirrored 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 volmirror.

  The volmirror command is generally called from the voldiskadm 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.

  In the first listed form of the command, the disk media name is supplied on
  the command line to volmirror. 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, the new_medianame ...
  parameter 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.


EXAMPLES

  The following are examples of the use of the volmirror command.

   1.  The following command mirrors the contents of the disk named disk01 to
       any available space on any available disk. Subsequent calls to
       volassist will cause created volumes to be mirrored by default.
	    volmirror -d yes disk01

   2.  The following command displays the current status of default
       mirroring. It prints the string yes if mirroring is currently enabled
       or no, if not.
	    volmirror -D

   3.  The following command mirrors any volumes on disk02 onto disk03.
	    volmirror disk02 disk03


FILES

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


SEE ALSO

  volintro(8), volassist(8), volrootmir(8)

Index Index for
Section 8
Index Alphabetical
listing for V
Top of page Top of
page