System Administration Commands                   deviceremap(1M)



NAME
     deviceremap - administer the Solaris I/O remapping feature

SYNOPSIS
     /usr/platform/sun4v/sbin/deviceremap [-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,  deviceremap,  remaps the device
     paths in /etc/pathtoinst file and the symlinks under  /dev
     to match the hardware.

OPTIONS
     The following options are supported:

     -v

         Displays the /etc/pathtoinst and /dev symlink changes.


     -R dir

         Perform   remapping   on   the   /etc/pathtoinst   and
         /etc/pathtoinst files in the root image at dir.


USAGE
     The primary function of deviceremap is to remap the  device
     paths  in  the /etc/pathtoinst 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 deviceremap script:




SunOS 5.11          Last change: 24 Dec 2008                    1






System Administration Commands                   deviceremap(1M)



                # /mnt/usr/platform/sun4v/sbin/deviceremap



         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  pathtoinst  and  /dev
     changes following a CPU node failover.


       # deviceremap -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.


       # deviceremap -R /newroot



ATRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     Availability                 SUNWkvm.v                   
    
     Interface Stability          Unstable                    
    


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




SunOS 5.11          Last change: 24 Dec 2008                    2