vxreattach(1m) [hpux man page]
vxreattach(1M) vxreattach(1M) NAME
vxreattach - reattach disk drives that have once again become accessible SYNOPSIS
/etc/vx/bin/vxreattach [-br ] [accessname...] /etc/vx/bin/vxreattach -c accessname 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: /etc/vx/bin/vxreattach -c c1t2d0 If reattachment is possible, vxreattach returns with an exit status of 0 and displays the disk group name and disk media name. If reat- tachment 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). 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) VxVM 5.0.31.1 24 Mar 2008 vxreattach(1M)
Check Out this Related Man Page
vxrecover(1M) vxrecover(1M) NAME
vxrecover - perform volume recovery operations SYNOPSIS
vxrecover [-bcEmnpsvV] [-d defaults_file] [-g diskgroup] [-o options] [-t tasktag] [volume | volume_set | medianame...] DESCRIPTION
The vxrecover utility performs plex attach, RAID-5 subdisk recovery, and resynchronize operations for the specified volumes, for all vol- umes under the specified volume sets, or for volumes residing on the disks specified by medianame. If no medianame, volume or volume_set is specified, the operation applies to all volumes, or to all volumes in the specified disk group. If -s is specified, disabled volumes are started. With -s and -n, volumes are started, but no other recovery takes place. Recovery operations are started in an order that prevents two concurrent operations on the same disk. Operations that involve unrelated disks run in parallel. OPTIONS
-b Performs recovery operations in the background. With this option, vxrecover runs in the background to attach stale plexes and subdisks, and to resynchronize mirrored volumes and RAID-5 parity. If this is used with -s, volumes are started before recovery begins in the background. -c Operates on cluster-sharable disk groups. This option is used by the cluster reconfiguration utility to effect recovery on vol- umes in shared disk groups after the failure of a node in the cluster. Do not use -c as a command-line option. Available only if the Veritas Volume Manager (VxVM) cluster feature is enabled and a license is installed. -d defaults_file Specifies the absolute pathname of a defaults file to use instead of /etc/default/vxrecover. The defaults file can be used to define new values for the I/O region size and delay time when reattaching plexes. The following attributes may be defined in this file: iosize=size Specifies the size (in standard length units as defined in vxintro(1M)) of the regions that are used to perform recovery operations. Specifying a larger size typically causes the operation to complete sooner, but with greater impact on other processes using the volume. The default I/O size is 2048 sectors (1 megabyte). slow=iodelay Allows the impact on system performance of copy operations to be reduced. Plex recovery operations usually consist of a number of short operations on small regions of the volume. This attribute inserts a delay between the recovery of each such region. A specific delay is specified as a number of milliseconds. The default value is 250 milliseconds. The following settings are suggested for a clustered environment with a large number of mirrored volumes: iosize=4m slow=1000 corresponding to an I/O size of 4 megabytes, and an I/O delay of 1000 milliseconds. -E Starts disabled volumes or plexes even when they are in the EMPTY state. This is useful for starting up volumes restored by the vxmake utility when specified along with the -s option. -g diskgroup Limits operation of the command to the given disk group, as specified by disk group ID or disk group name. If no volume or medi- aname is specified, all disks in this disk group are recovered, otherwise, the volume and medianame are evaluated relative to the given disk group. Without the -g option, if no volume and medianame is specified, all volumes in all imported disk groups are recovered; otherwise, the disk group for each medianame specified is determined based on name uniqueness within all disk groups. -m Recognizes and enables volumes that were moved as a result of a disk group move, split or join operation. -n Does not perform any recovery operations. If used with -s, volumes are started, but no other actions are taken. If used with -p, vxrecover only prints a list of startable volumes. -o options Passes the given option arguments to the -o options for the vxplex att and vxvol start operations generated by vxrecover. You can specify an option argument in the form prefix:options to restrict the set of commands that the -o option is applied to. Defined prefixes are: o vol applies to all invocations of the vxvol utility (volume starts, mirror resynchronizations, RAID-5 partity rebuilds, and RAID-5 subdisk recoveries) o plex, applies to all invocations of the vxplex utility (used only for attaching plexes) o attach applies specifically to plex attach operations o start applies specifically to volume start operations o recover applies to subdisk recoveries o resync applies to mirror resynchronization and RAID-5 parity recovery. -p Prints the list of selected volumes that are startable. For each startable volume, a line is printed containing 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 include: o kdetach indicates that one of the mirrors was detached by an I/O failure o stale means that one of the mirrors needs recovery, but that the recovery is related to an administrative operation, not an I/O failure o stopped prints if neither kdetach nor stale is appropriate for the volume. -s Starts disabled volumes that are selected by the operation. Volumes are started before any other recovery actions are taken. Volumes are started with the -o delayrecover start option. This requests that any operations that can be delayed in starting a volume are delayed. That is, only those operations necessary to make a volume available for use occur. Other operations, such as mirror resynchronization, attaching of stale plexes and subdisks, and recovery of stale RAID-5 parity, are typically delayed. -t tasktag If any tasks are registered to track the progress of the operation, marks them with the tag tasktag. This option is also passed to any utilities called to perform recoveries, so all tasks registered by any utility to perform the recoveries are also tagged with tasktag. -v Displays information about each task started by vxrecover. For recovery operations (as opposed to start operations), prints a completion status when each task completes. -V Displays each command executed by vxrecover. The ouput generated is more verbose than the job descriptions printed with the -v option. EXAMPLES
To recover, in the background, any detached subdisks or plexes that resulted from replacement of a specified disk, use the command: vxrecover -b medianame To monitor the operations, use the command: vxrecover -v medianame FILES
/etc/default/vxplex Standard defaults file for vxplex that determines whether FastResync is used when attaching plexes. See vxplex(1M) for details. /etc/default/vxrecover Standard defaults file for vxrecover that is used to set the I/O size and I/O delay values for recovery operations. SEE ALSO
vxintro(1M), vxmake(1M), vxplex(1M), vxvol(1M), vxvset(1M) VxVM 5.0.31.1 24 Mar 2008 vxrecover(1M)