DEVICE_REMAP(1M) Maintenance Commands DEVICE_REMAP(1M)

device_remap - administer the Solaris I/O remapping feature

/usr/platform/sun4v/sbin/device_remap [-v | -R dir]

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.

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.

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.

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

See attributes(5) for descriptions of the following attributes:

ATTRIBUTE TYPE ATTRIBUTE VALUE
Interface Stability Unstable

boot(1M), attributes(5)

December 24, 2008 OmniOS