volrecover - Performs volume recovery operations
/sbin/volrecover [-g diskgroup] [-sb] [-npVv] [-o options] [volume | medi-
-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
-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
-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:
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.
-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.
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.
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
Applies to volume resynchronizations. Starts the volume in
degraded mode; defers resynchronization until you initiate it
recover Applies to subdisk recoveries
resync Applies to mirror resynchronization and RAID 5 parity recovery
volume Specifies the volume to recover. Limits recovery to the specified
Specifies the disk to recover. Recovers all LSM objects residing on
the named disk.
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
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.
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
Commands: volplex(8), volume(8)