volrecover(8)						      System Manager's Manual						     volrecover(8)

NAME

       volrecover - Performs volume recovery operations

SYNOPSIS

       /sbin/volrecover [-g diskgroup] [-sb] [-o options] [volume | medianame...]

OPTIONS

       Options	that  can  be  specified  to  volrecover are: Starts disabled volumes that are selected by the operation.  Volumes will be started
       before any other recovery actions are taken. Volumes will be started with the -o delayrecover start option.  This requests that any  opera-
       tions  that can be delayed in starting a volume will be delayed. In other words, only those operations necessary to make a volume available
       for use will occur. Other operations, such as mirror resynchronization, attaching of stale plexes and subdisks, and recovery of stale RAID5
       parity will normally be delayed.  Performs recovery operations in the background. With this option, volrecover will put itself in the back-
       ground to attach stale plexes and subdisks, and to resynchronize mirrored volumes and RAID5 parity. If this is used with -s,  volumes  will
       be  started  before  recovery  begins in the background.  Performs no recovery operations. If used with -s, volumes will be started, but no
       other actions will be taken. If used with -p, the only action of volrecover will be to print a list of startable volumes.  Prints the  list
       of selected volumes that are startable. For each startable volume, a line is printed containing the following information: the volume name,
       the disk group ID of the volume, the volume's usage type, and a list of state flags pertaining to mirrors of the volume.

	      State flags and their meanings are: One of the mirrors was detached by an I/O failure One of the mirrors	needs  recovery,  but  the
	      recovery	is  related  to  an  administrative operation, not an I/O failure Neither kdetach nor stale is appropriate for the volume.
	      Displays information about each task started by volrecover. For recovery operations (as opposed to start operations),  a	completion
	      status  is printed when each task completes.  Displays commands that volrecover would execute without actually executing them.  Lim-
	      its operation of the command to the given disk group, as specified by disk group ID or disk group name. If no  volume  or  medianame
	      operands	are  given, all disks in this disk group will be recovered; otherwise, the volume and medianame operands will be evaluated
	      relative to the given disk group.

	      Without the -g option, if no operands are given, all volumes in all imported disk groups will  be  recovered;  otherwise,  the  disk
	      group  for each medianame operand will be determined based on name uniqueness within all disk groups.  Passes the given option argu-
	      ments to the -o options for the volplex att and volume start operations generated by volrecover. An option argument of the form pre-
	      fix:options can be specified to restrict the set of commands that the -o option should be applied to.

	      Defined  prefixes  are:  Applies	to  all invocations of the volume utility (volume starts, mirror resynchronizations, RAID5 partity
	      rebuilds, and RAID5 subdisk recoveries) Applies to all invocations of the volplex utility (currently used only for attaching plexes)
	      Applies specifically to plex attach operations applies specifically to volume start operations Applies to subdisk recoveries Applies
	      to mirror resynchronization and RAID5 parity recovery

DESCRIPTION

       The volrecover program performs plex attach, RAID5 subdisk recovery, and resynchronize operations for the named	volumes,  or  for  volumes
       residing on the named disks (medianame).

       If no medianame or volume operands are specified, the operation applies to all volumes (or to all volumes in the specified disk group).

       If -s is specified, disabled volumes will be started.  With -s and -n, volumes are started, but no other recovery takes place.

       Recovery  operations  will  be  started	in  an order that prevents two concurrent operations from involving the same disk. Operations that
       involve unrelated disks will run in parallel.

EXAMPLES

       To recover, in the background, any detached subdisks or plexes that resulted from replacement of a specified disk, use the command:

       # volrecover -b medianame

       If you want to monitor the operations, use the command:

       # volrecover -v medianame

SEE ALSO

       volintro(8), volplex(8), volume(8)

																     volrecover(8)