io_redirect_dsf.1m (2010 09)

i
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