vxrecover(ADM)

vxrecover - perform volume recovery operations

Synopsis

vxrecover [ -g diskgroup ] [ -sbnpvV ] [ -o options ] [ volume | medianame ... ]

Description

The vxrecover program performs plex attach, RAID-5 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, then the operation applies to all volumes (or to all volumes in the specified disk group). If -s is specified, then 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.

Options

-s: Start 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 RAID-5 parity will normally be delayed.
-b: Perform recovery operations in the background. With this option, vxrecover will put itself in the background to attach stale plexes and subdisks, and to resynchronize mirrored volumes and RAID-5 parity. If this is used with -s, then volumes will be started before recovery begins in the background.
-n: Do not perform any recovery operations. If used with -s, then volumes will be started, but no other actions will be taken. If used with -p, then the only action of vxrecover will be to print a list of startable volumes.
-p: Print 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 include the following: 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 is printed if neither kdetach nor stale is appropriate for the volume.
-v: Display information about each task started by vxrecover. For recovery operations (as opposed to start operations), print a completion status when each task completes.
-V: Display each command executed by vxrecover. The ouput generated is more verbose than the job descriptions printed with the -v option.
-g diskgroup: Limit 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, then 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, then 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: Pass the given option arguments to the -o options for the vxplex att and vxvol start operations generated by vxrecover. 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 vxvol utility (volume starts, mirror resynchronizations, RAID-5 partity rebuilds, and RAID-5 subdisk recoveries); plex, applies to all invocations of the vxplex 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; and resync applies to mirror resynchronization and RAID-5 parity recovery.

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

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

	vxrecover -v medianame

References

vxintro(ADM), vxplex(ADM), vxvol(ADM)