unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (HP-UX-11.11)
Page:
Section:
Apropos / Subsearch:
optional field



 vxrecover(1M)			  VxVM 3.5		       vxrecover(1M)
				 1 Jun 2002



 NAME
      vxrecover - perform volume recovery operations

 SYNOPSIS
      vxrecover [-bcEmnpsvV] [-g diskgroup ] [-o options ] [-t tasktag ] [
      volume | medianame...]

 DESCRIPTION
      The vxrecover utility performs plex attach, RAID-5 subdisk recovery,
      and resynchronize operations for the named volumes, or for volumes
      residing on the specified disks medianame.  If no medianame or volume
      is specified, the operation applies to all volumes, or to all volumes
      in the specified disk group.  If -s is specified, disabled volumes are
      started.	With -s and -n, volumes are started, but no other recovery
      takes place.

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

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

      -c	Operates on cluster-shareable disk groups.  This option is
		used by the cluster reconfiguration utility to effect
		recovery on volumes in shared disk groups after the failure
		of a node in the cluster.  Do not use -c as a command-line
		option.	 Available only if the VERITAS Volume Manager (VxVM)
		cluster feature is enabled and a license is installed.

      -E	Starts disabled volumes or plexes even when they are in the
		EMPTY state.  This is useful for starting up volumes
		restored by the vxmake utility when specified along with the
		-s option.

      -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 is specified, all disks in this disk group are
		recovered, otherwise, the volume and medianame are evaluated
		relative to the given disk group.

		Without the -g option, if no volume and medianame is
		specified, all volumes in all imported disk groups are
		recovered; otherwise, the disk group for each medianame
		specified is determined based on name uniqueness within all
		disk groups.



				    - 1 -	  Formatted:  August 2, 2006






 vxrecover(1M)			  VxVM 3.5		       vxrecover(1M)
				 1 Jun 2002



      -m	Recognizes and enables volumes that were moved as a result
		of a disk group move, split or join operation.

      -n	Does not perform any recovery operations.  If used with -s,
		volumes are started, but no other actions are taken.  If
		used with -p, vxrecover only prints a list of startable
		volumes.

      -o options
		Passes the given option arguments to the -o options for the
		vxplex att and vxvol start operations generated by
		vxrecover.  You can specify an option argument in the form

		     prefix:options

		to restrict the set of commands that the -o option is
		applied to.  Defined prefixes are:

		+  vol applies to all invocations of the vxvol utility
		   (volume starts, mirror resynchronizations, RAID-5 partity
		   rebuilds, and RAID-5 subdisk recoveries)

		+  plex, applies to all invocations of the vxplex utility
		   (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 RAID-5
		   parity recovery.

      -p	Prints the list of selected volumes that are startable.	 For
		each startable volume, a line is printed containing 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 include:

		+  kdetach indicates that one of the mirrors was detached by
		   an I/O failure

		+  stale means that one of the mirrors needs recovery, but
		   that the recovery is related to an administrative
		   operation, not an I/O failure

		+  stopped prints if neither kdetach nor stale is
		   appropriate for the volume.





				    - 2 -	  Formatted:  August 2, 2006






 vxrecover(1M)			  VxVM 3.5		       vxrecover(1M)
				 1 Jun 2002



      -s	Starts disabled volumes that are selected by the operation.
		Volumes are started before any other recovery actions are
		taken.	Volumes are started with the -o delayrecover start
		option.	 This requests that any operations that can be
		delayed in starting a volume are delayed.  That is, only
		those operations necessary to make a volume available for
		use occur.  Other operations, such as mirror
		resynchronization, attaching of stale plexes and subdisks,
		and recovery of stale RAID-5 parity, are typically delayed.

      -t tasktag
		If any tasks are registered to track the progress of the
		operation, marks them with the tag tasktag.  This option is
		also passed to any utilities called to perform recoveries,
		so all tasks registered by any utility to perform the
		recoveries are also tagged with tasktag.

      -v	Displays information about each task started by vxrecover.
		For recovery operations (as opposed to start operations),
		prints a completion status when each task completes.

      -V	Displays each command executed by vxrecover.  The ouput
		generated is more verbose than the job descriptions printed
		with the -v option.

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

	   vxrecover -b medianame


      To monitor the operations, use the command:

	   vxrecover -v medianame


 SEE ALSO
      vxintro(1M), vxmake(1M), vxplex(1M), vxvol(1M)















				    - 3 -	  Formatted:  August 2, 2006