vxreattach

NAME

vxreattach - reattach disk drives that have once again become accessible

SYNOPSIS

DESCRIPTION

The vxreattach utility reattaches disks to the disk group they were in and retains the same media name.

This operation may be necessary if a disk has a transient failure, or if VERITAS Volume Manager (VxVM) starts with some disk drivers unloaded and unloadable. Disks then enter the failed state. If the problem is fixed, vxreattach may be able to reattach the disks without plexes being flagged as stale, as long as the reattach happens before any volumes on the disk are started.

vxreattach tries to find a disk in the same disk group with the same disk ID for the disk(s) to be reattached. The reattach operation may fail even after finding the disk with the matching disk ID if the original cause (or some other cause) for the disk failure still exists.

vxreattach is usually invoked by vxdiskadm when performing disk recovery. It is not intended to be run directly by an administrator.

OPTIONS

-b

Performs the reattach operation in the background.

-c

Checks if a reattach is possible. No operation is performed, but the name of the disk group and disk media name at which the disk can be reattached is displayed.

-r

Tries to recover stale plexes of any volumes on the failed disk. It does this by calling vxrecover.

EXIT CODES

A zero exit status is returned if the reattach is performed; non-zero is returned otherwise.

See vxintro(1M) for a list of standard exit codes.

EXAMPLES

Check if reattachment of disk c1t2d0 is possible:

If reattachment is possible, vxreattach returns with an exit status of 0 and displays the disk group name and disk media name. If reattachment is not possible, vxreattach returns an exit status of 2 and displays an error.

Attempt to reattach the disk in the foreground and try to recover stale plexes of any volumes on the disk:

If the reattachment is successful, vxreattach returns an exit status of 0. Otherwise, if an error occurs, vxreattach returns a non-zero exit code as defined on vxintro(1M).

FILES

/etc/default/vxplex

Standard defaults file that can be used to determine whether FastResync is used when attaching plexes. See vxplex(1M) for details.

SEE ALSO

vxdiskadm (1M), vxintro (1M), vxplex (1M), vxrecover (1M)