vxrecover - perform volume recovery operations
vxrecover [ -g diskgroup ] [ -sbnpvV ] [ -o options ] [ volume | medianame ... ]
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.
- 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.
- 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.
- 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.
- 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.
- Display information about each task started by vxrecover. For recovery operations (as opposed to
start operations), print a completion status when each task completes.
- 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.
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
Copyright © 2005 The SCO Group, Inc. All rights reserved.