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] [-npVv] [-o options] [volume |
  medianame...]

OPTIONS
  -g diskgroup
      Specifies the disk group for the operation, either by disk group ID or
      by disk group name. By default, the disk group is chosen based on the
      volume or medianame operands. If no volume or medianame operands are
      given, all disks in this disk group will be recovered.

      Without the -g option and operands, all volumes needing recovery in all
      imported disk groups will be recovered.

  -s  Starts disabled volumes selected by the operation. LSM starts the
      selected volumes with the -o delayrecover start option before
      performing any other recovery actions. 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, attachment of stale plexes and subdisks, and
      recovery of stale RAID 5 parity are normally delayed.

  -b  Performs recovery operations in the background. With this option,
      volrecover will run in the background to attach stale plexes and
      subdisks and to resynchronize mirrored volumes and RAID 5 parity. If
      the -b option is used with the -s option, volumes will be started
      before recovery begins.

  -n  Performs no recovery operations.	If used with the -s option, volumes
      are started, but no other actions are taken. If the -n option is used
      with the -p option, volrecover prints a list of startable volumes.

  -p  Prints a list of selected volumes that are startable. The list contains
      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  Performs a "mock run" of the command. Displays the commands that
      volrecover would execute if the operation actually executed.

  -v  Runs in verbose mode; displays information about each task started by
      volrecover. For recovery operations (as opposed to start operations), a
      completion status is displayed when each task completes.

  -o options
      Passes the given option arguments to the -o options for the volplex att
      and volume start operations invoked 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. See volume(8) and
      volplex(8) for the options you can use with prefix.

      Defined prefixes are:

      vol     Applies to all invocations of the volume utility (volume
	      starts, mirror resynchronizations, RAID 5 parity rebuilds, and
	      RAID 5 subdisk recoveries)

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

      attach  Applies specifically to plex attach operations

      start   Applies specifically to volume start operations

      delayrecover
	      Applies to volume resynchronizations. Starts the volume in
	      degraded mode; defers resynchronization until you initiate it
	      manually.

      recover Applies to subdisk recoveries

      resync  Applies to mirror resynchronization and RAID 5 parity recovery

OPERANDS
  volume  Specifies the volume to recover. Limits recovery to the specified
	  volume.

  medianame
	  Specifies the disk to recover. Recovers all LSM objects on the
	  named disk.

DESCRIPTION
  The volrecover utility performs plex attach, RAID 5 subdisk recovery, and
  resynchronization operations for the named volumes or for volumes that use
  the named disks (medianame).

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

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

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

EXAMPLES
   1.  To recover in the background any detached subdisks or plexes that
       resulted from replacement of a specified disk, enter:

	    # volrecover -b medianame

   2.  To monitor the operations, use the command:

	    # volrecover -v medianame

SEE ALSO
  Commands: volplex(8), volume(8)

  Other: volintro(8)

Index for Section 8

Alphabetical listing for V

Top of page