opensolaris man page for device_remap

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)