Index for Section 8

Alphabetical listing for V

Bottom of page

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:

  -s  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 operations 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.

  -b  Performs recovery operations in the background. With this option,
      volrecover will put itself in the background 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.

  -n  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.

  -p  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:

      kdetach
	  One of the mirrors was detached by an I/O failure

      stale
	  One of the mirrors needs recovery, but the recovery is related to
	  an administrative operation, not an I/O failure

      stopped
	  Neither kdetach nor stale is appropriate for the volume.

  -v  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.

  -V  Displays commands that volrecover would execute without actually
      executing them.

  -g diskgroup
      Limits 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.

  -o options
      Passes the given option arguments to the -o options for the volplex att
      and volume start operations generated by volrecover. An option argument
      of the form prefix:options can be specified to restrict the set of
      commands that the -o option should be applied to.

      Defined prefixes are:

      vol     Applies to all invocations of the volume utility (volume
	      starts, mirror resynchronizations, RAID5 partity rebuilds, and
	      RAID5 subdisk recoveries)

      plex    Applies to all invocations of the volplex utility (currently
	      used only for attaching plexes)

      attach  Applies specifically to plex attach operations

      start   applies specifically to volume start operations

      recover Applies to subdisk recoveries

      resync  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)

Index for Section 8

Alphabetical listing for V

Top of page