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:

See Also

boot(1M), attributes(5)