man pages section 1M: System Administration Commands

Exit Print View

Updated: July 2014
 
 

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
system/library/platform
Interface Stability
Uncommitted

See also

boot(1M), attributes(5)