illumos: manual page: device

DEVICE_REMAP(8) Maintenance Procedures DEVICE_REMAP(8)

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