device_remap man page on SunOS

Man page or keyword search:  
man Server   20652 pages
apropos Keyword Search (all sections)
Output format
SunOS logo
[printable version]

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  mes‐
       sage  "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  fol‐
       lowing 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.10			  24 Dec 2008		      device_remap(1M)
[top]

List of man pages available for SunOS

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net