test veritas logo



vxreattach - reattach disk drives that have once again become accessible


/etc/vx/bin/vxreattach [-br ] [accessname...]

/etc/vx/bin/vxreattach -c accessname


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. You can also invoke vxreattach directly. In a Cluster Volume Manager (CVM) environment, you can invoke vxreattach on the Primary or the Secondary. In most cases, Veritas recommends running the command from the Primary node.

Note: Master and Slave words are going to be deprecated in upcoming releases. We will refer to them using Primary and Secondary words respectively.


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


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.


Check if reattachment of disk sdg is possible:

/etc/vx/bin/vxreattach -c sdg

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:

/etc/vx/bin/vxreattach -r sdg

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).


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


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

VxVM 7.3.1 vxreattach(1M)