io_redirect_dsf(1M)

A iA io_redirect_dsf(1M) io_redirect_dsf(1M) NAME io_redirect_dsf - redirect the persistent device special files from one device to a different device within the same class SYNOPSIS /usr/sbin/io_redirect_dsf -H old_hw_path -N new_hw_path /usr/sbin/io_redirect_dsf -d old_dsf -n new_dsf DESCRIPTION The io_redirect_dsf command reassigns persistent device special files (DSF) from the current dev- ice (associated with old_hw_path or old_dsf ) to a new device (associated with new_hw_path or new_dsf ), with both devices required to belong to the same class (see intro (7)). This command is typically intended for replacing a bad device by retaining the device special files associated with it (a bad device is specified with either old_hw_path or old_dsf ). In the first form, the command accepts as input the LUN hardware paths of the current device and of the new device (see intro (7)). In the second form, the command accepts as input the persistent DSFs of the current device and of the new device. Both devices must have persistent DSFs configured prior to executing the command. Persistent DSFs may be configured using either insf or mksf (see insf (1M) or mksf(1M)). The user should ensure that the new device is accessible before running the command (for example, by checking that ioscan reports the new device state as CLAIMED and its health state as online). The redirection can happen only if the number of persistent DSFs of the current device and new device are equal. There is an exception in the case of stale nodes. The stale nodes are the nodes which have an entry in the system I/O configuration files but the corresponding device is not found (see ioconfig(4)) and ioscan (1M)). Warnings • Both devices will be inaccessible while the redirection is taking place. • After successful completion of the operation, the DSFs of the new device will be deleted since the new device will now use the DSFs formerly mapped to the current device. Options io_redirect_dsf recognizes the following options: -H old_hw_path Specify the hardware path of the current device. io_redirect_dsf returns an error if old_hw_path is not a LUN hardware path. -N new_hw_path Specify the hardware path of the new device. io_redirect_dsf returns an error if new_hw_path is not a LUN hardware path. -d old_dsf Specify the device special file of the current device. io_redirect_dsf returns an error if old_dsf is not a persistent DSF. -n new_dsf Specify the device special file of the new device. io_redirect_dsf returns an error if new_dsf is not a persistent DSF. RETURN VALUE Exit values are: 0 Successful completion. >0 An error condition occurred. EXAMPLES Redirect the DSF /dev/disk/disk15 with the hardware path at 64000/0xfa00/0x2 to point to the hardware path at 64000/0xfa00/0x3. Both disks belong to the disk class. io_redirect_dsf -H 64000/0xfa00/0x2 -N 64000/0xfa00/0x3 Redirect the DSF /dev/disk/disk23 to point to the device with DSF /dev/disk/dsk26. Both DSFs represent devices that belong to the disk class . HP-UX 11i Version 3: September 2010 − 1 − Hewlett-Packard Company 1 A iA io_redirect_dsf(1M) io_redirect_dsf(1M) io_redirect_dsf -d /dev/disk/disk23 -n /dev/disk/disk26 WARNINGS You must be superuser to execute the io_redirect_dsf command. SEE ALSO insf(1M), mksf(1M), ioscan(1M), intro(7). 2 Hewlett-Packard Company − 2 − HP-UX 11i Version 3: September 2010