usr/src/man/man1m/device_remap.1m

   1 '\" te
   2 .\" Copyright (c) 2008, Sun Microsystems, Inc. All Rights Reserved
   3 .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License").  You may not use this file except in compliance with the License.
   4 .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing.  See the License for the specific language governing permissions and limitations under the License.
   5 .\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE.  If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
   6 .TH DEVICE_REMAP 1M "Dec 24, 2008"
   7 .SH NAME
   8 device_remap \- administer the Solaris I/O remapping feature
   9 .SH SYNOPSIS
  10 .LP
  11 .nf
  12 \fB/usr/platform/sun4v/sbin/device_remap\fR [\fB-v\fR | \fB-R\fR \fIdir\fR]
  13 .fi
  14
  15 .SH DESCRIPTION
  16 .sp
  17 .LP
  18 Certain multi-node sun4v platforms, such as T5440 and T5240 servers, have an
  19 integrated PCI topology that cause the I/O device paths to change in a CPU node
  20 failover condition. The device remapping script, \fBdevice_remap\fR, remaps the
  21 device paths in \fB/etc/path_to_inst\fR file and the symlinks under \fB/dev\fR
  22 to match the hardware.
  23 .SH OPTIONS
  24 .sp
  25 .LP
  26 The following options are supported:
  27 .sp
  28 .ne 2
  29 .na
  30 \fB\fB-v\fR\fR
  31 .ad
  32 .sp .6
  33 .RS 4n
  34 Displays the \fB/etc/path_to_inst\fR and \fB/dev\fR symlink changes.
  35 .RE
  36
  37 .sp
  38 .ne 2
  39 .na
  40 \fB\fB-R\fR \fIdir\fR\fR
  41 .ad
  42 .sp .6
  43 .RS 4n
  44 Perform remapping on the \fB/etc/path_to_inst\fR and \fB/etc/path_to_inst\fR
  45 files in the root image at \fIdir\fR.
  46 .RE
  47
  48 .SH USAGE
  49 .sp
  50 .LP
  51 The primary function of \fBdevice_remap\fR is to remap the device paths in the
  52 \fB/etc/path_to_inst\fR file and the symlinks under \fB/dev\fR in a CPU node
  53 failover condition to match the hardware.
  54 .sp
  55 .LP
  56 After adding CPU node(s) or removing CPU node(s), boot the system to the OBP
  57 prompt and use the following procedure:
  58 .RS +4
  59 .TP
  60 1.
  61 Boot either the failsafe miniroot using: \fBboot\fR \fB-F\fR \fBfailsafe\fR
  62 , or an install miniroot using \fBboot net\fR \fB-s\fR or similar command.
  63 .RE
  64 .RS +4
  65 .TP
  66 2.
  67 Mount the root disk as \fB/mnt\fR.
  68 .RE
  69 .RS +4
  70 .TP
  71 3.
  72 Change directory to the mounted root disk:
  73 .sp
  74 .in +2
  75 .nf
  76 # \fBcd /mnt\fR
  77 .fi
  78 .in -2
  79 .sp
  80
  81 .RE
  82 .RS +4
  83 .TP
  84 4.
  85 Run \fBdevice_remap\fR script:
  86 .sp
  87 .in +2
  88 .nf
  89 # \fB/mnt/usr/platform/sun4v/sbin/device_remap\fR
  90 .fi
  91 .in -2
  92 .sp
  93
  94 .RE
  95 .RS +4
  96 .TP
  97 5.
  98 Boot the system from disk.
  99 .RE
 100 .sp
 101 .LP
 102 All the error messages are self-explanatory, except for the error message
 103 "missing ioaliases node" which means the firmware on the system does not
 104 support device remapping.
 105 .SH EXAMPLES
 106 .LP
 107 \fBExample 1 \fRDisplaying Changes Following Failover
 108 .sp
 109 .LP
 110 The following command displays the \fBpath_to_inst\fR and \fB/dev\fR changes
 111 following a CPU node failover.
 112
 113 .sp
 114 .in +2
 115 .nf
 116 # \fBdevice_remap -v\fR
 117 .fi
 118 .in -2
 119 .sp
 120
 121 .LP
 122 \fBExample 2 \fRChanging Directory Prior to Any Changes
 123 .sp
 124 .LP
 125 The following command changes the directory on which the boot image is mounted
 126 prior to making any changes.
 127
 128 .sp
 129 .in +2
 130 .nf
 131 # \fBdevice_remap -R /newroot\fR
 132 .fi
 133 .in -2
 134 .sp
 135
 136 .SH ATTRIBUTES
 137 .sp
 138 .LP
 139 See \fBattributes\fR(5) for descriptions of the following attributes:
 140 .sp
 141
 142 .sp
 143 .TS
 144 box;
 145 c | c
 146 l | l .
 147 ATTRIBUTE TYPE  ATTRIBUTE VALUE
 148 _
 149 Interface Stability     Unstable
 150 .TE
 151
 152 .SH SEE ALSO
 153 .sp
 154 .LP
 155 \fBboot\fR(1M), \fBattributes\fR(5)