1device_remap(1M) System Administration Commands device_remap(1M)
2
3
4
6 device_remap - administer the Solaris I/O remapping feature
7
9 /usr/platform/sun4v/sbin/device_remap [-v | -R dir]
10
11
13 Certain multi-node sun4v platforms, such as T5440 and T5240 servers,
14 have an integrated PCI topology that cause the I/O device paths to
15 change in a CPU node failover condition. The device remapping script,
16 device_remap, remaps the device paths in /etc/path_to_inst file and the
17 symlinks under /dev to match the hardware.
18
20 The following options are supported:
21
22 -v
23
24 Displays the /etc/path_to_inst and /dev symlink changes.
25
26
27 -R dir
28
29 Perform remapping on the /etc/path_to_inst and /etc/path_to_inst
30 files in the root image at dir.
31
32
34 The primary function of device_remap is to remap the device paths in
35 the /etc/path_to_inst file and the symlinks under /dev in a CPU node
36 failover condition to match the hardware.
37
38
39 After adding CPU node(s) or removing CPU node(s), boot the system to
40 the OBP prompt and use the following procedure:
41
42 1. Boot either the failsafe miniroot using: boot -F failsafe ,
43 or an install miniroot using boot net -s or similar command.
44
45 2. Mount the root disk as /mnt.
46
47 3. Change directory to the mounted root disk:
48
49 # cd /mnt
50
51
52
53 4. Run device_remap script:
54
55 # /mnt/usr/platform/sun4v/sbin/device_remap
56
57
58
59 5. Boot the system from disk.
60
61
62 All the error messages are self-explanatory, except for the error mes‐
63 sage "missing ioaliases node" which means the firmware on the system
64 does not support device remapping.
65
67 Example 1 Displaying Changes Following Failover
68
69
70 The following command displays the path_to_inst and /dev changes fol‐
71 lowing a CPU node failover.
72
73
74 # device_remap -v
75
76
77
78 Example 2 Changing Directory Prior to Any Changes
79
80
81 The following command changes the directory on which the boot image is
82 mounted prior to making any changes.
83
84
85 # device_remap -R /newroot
86
87
88
90 See attributes(5) for descriptions of the following attributes:
91
92
93
94
95 ┌─────────────────────────────┬─────────────────────────────┐
96 │ ATTRIBUTE TYPE │ ATTRIBUTE VALUE │
97 ├─────────────────────────────┼─────────────────────────────┤
98 │Availability │SUNWkvm.v │
99 ├─────────────────────────────┼─────────────────────────────┤
100 │Interface Stability │Unstable │
101 └─────────────────────────────┴─────────────────────────────┘
102
104 boot(1M), attributes(5)
105
106
107
108SunOS 5.11 24 Dec 2008 device_remap(1M)