vxreattach(1M)                   VxVM 3.5                    vxreattach(1M)
                                 1 Jun 2002



 NAME    [Toc]    [Back]
      vxreattach - reattach disk drives that have once again become
      accessible

 SYNOPSIS    [Toc]    [Back]
      /etc/vx/bin/vxreattach [-br ] [accessname...]

      /etc/vx/bin/vxreattach -c accessname

 DESCRIPTION    [Toc]    [Back]
      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    [Toc]    [Back]
      -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    [Toc]    [Back]
      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    [Toc]    [Back]
      Check if reattachment of disk c1t2d0 is possible:

           /etc/vx/bin/vxreattach -c c1t2d0





                                    - 1 -       Formatted:  January 24, 2005






 vxreattach(1M)                   VxVM 3.5                    vxreattach(1M)
                                 1 Jun 2002



      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 c1t2d0


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

 SEE ALSO    [Toc]    [Back]
      vxdiskadm(1M), vxintro(1M), vxrecover(1M)


                                    - 2 -       Formatted:  January 24, 2005