DEVICE_REMAP(1M) Maintenance 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 |
+--------------------+-----------------+
|Interface Stability | Unstable |
+--------------------+-----------------+

SEE ALSO


boot(1M), attributes(5)


December 24, 2008 DEVICE_REMAP(1M)