device_remap(1m)

1device_remap(1M)        System Administration Commands        device_remap(1M)
2
3
4

NAME

6       device_remap - administer the Solaris I/O remapping feature
7

SYNOPSIS

9       /usr/platform/sun4v/sbin/device_remap [-v | -R dir]
10
11

DESCRIPTION

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

OPTIONS

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

USAGE

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

EXAMPLES

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

ATTRIBUTES

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