volrecover(8)volrecover(8)NAMEvolrecover - Performs volume recovery operations
SYNOPSIS
/sbin/volrecover [-g diskgroup] [-sb] [-npVv] [-o options] [volume |
medianame...]
OPTIONS
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. Starts disabled
volumes selected by the operation. LSM starts the selected vol‐
umes 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 avail‐
able for use will occur. Other operations, such as mirror resyn‐
chronization, attachment of stale plexes and subdisks, and
recovery of stale RAID 5 parity are normally delayed. Performs
recovery operations in the background. With this option, volre‐
cover 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. Performs no recovery opera‐
tions. 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. 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: One of the mirrors was
detached by an I/O failure. One of the mirrors needs recovery,
but the recovery is related to an administrative operation, not
an I/O failure. Neither kdetach nor stale is appropriate for
the volume. Performs a “mock run” of the command. Displays the
commands that volrecover would execute if the operation actually
executed. 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. 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: Applies to all invocations of the volume
utility (volume starts, mirror resynchronizations, RAID 5 parity
rebuilds, and RAID 5 subdisk recoveries) Applies to all invoca‐
tions of the volplex utility (used only for attaching plexes)
Applies specifically to plex attach operations Applies specifi‐
cally to volume start operations Applies to volume resynchro‐
nizations. Starts the volume in degraded mode; defers resynchro‐
nization until you initiate it manually. Applies to subdisk
recoveries Applies to mirror resynchronization and RAID 5 parity
recovery
OPERANDS
Specifies the volume to recover. Limits recovery to the specified vol‐
ume. 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 speci‐
fied 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 concur‐
rent operations from involving the same disk. Operations that involve
unrelated disks will run in parallel.
EXAMPLES
To recover in the background any detached subdisks or plexes that
resulted from replacement of a specified disk, enter:
# volrecover-b medianame To monitor the operations, use the
command:
# volrecover-v medianame
SEE ALSO
Commands: volplex(8), volume(8)
Other: volintro(8)volrecover(8)
