NAME

volrecover − Performs volume recovery operations

SYNOPSIS

/sbin/volrecover [−g diskgroup] [−sb] [−npVv] [−o options] [volume | medianame...]

OPTIONS

−g diskgroup
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. 

−sStarts disabled volumes selected by the operation. LSM starts the selected volumes 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 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 normally delayed. 

−bPerforms recovery operations in the background. With this option, volrecover will run in the background to attach stale plexes and subdisks 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. 

−nPerforms 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. 

−pPrints 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:

kdetach
One of the mirrors was detached by an I/O failure.

stale
One of the mirrors needs recovery, but the recovery is related to an administrative operation, not an I/O failure.

stopped
Neither kdetach nor stale is appropriate for the volume. 

−VPerforms a “mock run” of the command. Displays the commands that volrecover would execute if the operation actually executed. 

−vRuns 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. 

−o options
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:

volApplies to all invocations of the volume utility (volume starts, mirror resynchronizations, RAID 5 parity rebuilds, and RAID 5 subdisk recoveries)

plexApplies to all invocations of the volplex utility (used only for attaching plexes)

attachApplies specifically to plex attach operations

startApplies specifically to volume start operations

delayrecover
Applies to volume resynchronizations. Starts the volume in degraded mode; defers resynchronization until you initiate it manually.

recoverApplies to subdisk recoveries

resyncApplies to mirror resynchronization and RAID 5 parity recovery

OPERANDS

volumeSpecifies the volume to recover. Limits recovery to the specified volume. 

medianame
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 specified 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 concurrent operations from involving the same disk. Operations that involve unrelated disks will run in parallel. 

EXAMPLES

     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

SEE ALSO

Commands: volplex(8), volume(8)

Other: volintro(8)