unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (OSF1-V5.1-alpha)
Page:
Section:
Apropos / Subsearch:
optional field



volmirror(8)							 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 sup-
      plied 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	allo-
  cate 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 sup-
  plied.

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 volas-
       sist will cause created volumes to be mirrored by default.
	    volmirror -d yes disk01

   2.  The following command displays the current status of default mirror-
       ing. 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)