Manual Pages for UNIX Operating System command usage for man device_remap

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:




SunOS 5.11          Last change: 24 Dec 2008                    1






System Administration Commands                   device_remap(1M)



                # /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  attri-
     butes:



     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Availability                | system/library/platform     |
    |_____________________________|_____________________________|
    | Interface Stability         | Uncommitted                 |
    |_____________________________|_____________________________|


SEE ALSO
     boot(1M), attributes(5)




SunOS 5.11          Last change: 24 Dec 2008                    2