unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

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



volrecover(8)							volrecover(8)



NAME

  volrecover - Performs	volume recovery	operations

SYNOPSIS

  /sbin/volrecover [-g diskgroup] [-sb]	[-npVv]	[-o options] [volume | medi-
  aname...]

OPTIONS

  -s  Starts disabled volumes selected by the operation. LSM starts the
      selected volumes with the	-o delayrecover	start option before perform-
      ing 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 sub-
      disks 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  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.

  -V  Performs a "mock run" of the command. Displays the commands that volre-
      cover would execute if the operation actually executed.

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

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

  -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 com-
      mands that the -o	option should be applied to. See volume(8) and vol-
      plex(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 residing 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 residing
  on 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)