vxreattach

vxreattach - reattach disk drives that have once again become accessible

Synopsis

/etc/vx/bin/vxreattach [ -rb ] [ accessname ... ]
/etc/vx/bin/vxreattach -c accessname

Description

The vxreattach utility will, if possible, reattach disks to the disk group they were previously in and retain the same media name that they had.

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

The vxreattach command is called as part of disk recovery from the vxdiskadm menus.

vxreattach tries to find a disk in the same disk group with the same disk ID for the disk(s) to be reattached. Note that 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.

The vxreattach utility has the following options:

-r: This option causes the vxreattach utility to attempt to recover stale plexes of any volumes on the failed disk. It does this by calling vxrecover.
-b: This option causes the reattach operation to be performed in the background.
-c: This option checks whether 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 will be displayed.

Exit codes

A zero exit status will be returned if it is possible to perform a reattach; non-zero will be returned otherwise.

References

vxdiskadm(ADM), vxintro(ADM), vxrecover(ADM)