device_remap(1M) System Administration Commands device_remap(1M)
NAME
device_remap - administer the Solaris I/O remapping feature
SYNOPSIS
/usr/platform/sun4v/sbin/device_remap [-v | -R dir]
DESCRIPTION
Certain multi-node sun4v platforms, such as T5440 and T5240 servers, have an integrated PCI topology that cause the I/O device paths to
change in a CPU node failover condition. The device remapping script, device_remap, remaps the device paths in /etc/path_to_inst file and
the symlinks under /dev to match the hardware.
OPTIONS
The following options are supported:
-v
Displays the /etc/path_to_inst and /dev symlink changes.
-R dir
Perform remapping on the /etc/path_to_inst and /etc/path_to_inst files in the root image at dir.
USAGE
The primary function of device_remap is to remap the device paths in the /etc/path_to_inst file and the symlinks under /dev in a CPU node
failover condition to match the hardware.
After adding CPU node(s) or removing CPU node(s), boot the system to the OBP prompt and use the following procedure:
1. Boot either the failsafe miniroot using: boot -F failsafe , or an install miniroot using boot net -s or similar command.
2. Mount the root disk as /mnt.
3. Change directory to the mounted root disk:
# cd /mnt
4. Run device_remap script:
# /mnt/usr/platform/sun4v/sbin/device_remap
5. Boot the system from disk.
All the error messages are self-explanatory, except for the error message "missing ioaliases node" which means the firmware on the system
does not support device remapping.
EXAMPLES
Example 1 Displaying Changes Following Failover
The following command displays the path_to_inst and /dev changes following a CPU node failover.
# device_remap -v
Example 2 Changing Directory Prior to Any Changes
The following command changes the directory on which the boot image is mounted prior to making any changes.
# device_remap -R /newroot
ATTRIBUTES
See attributes(5) for descriptions of the following attributes:
+-----------------------------+-----------------------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+-----------------------------+-----------------------------+
|Availability |SUNWkvm.v |
+-----------------------------+-----------------------------+
|Interface Stability |Unstable |
+-----------------------------+-----------------------------+
SEE ALSO
boot(1M), attributes(5)
SunOS 5.11 24 Dec 2008 device_remap(1M)