device_remap(1M) System Administration Commands device_remap(1M)NAMEdevice_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 mes‐
sage "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 fol‐
lowing 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 ALSOboot(1M), attributes(5)SunOS 5.10 24 Dec 2008 device_remap(1M)