1cfgadm_sysctrl(1M) System Administration Commands cfgadm_sysctrl(1M)
2
6 cfgadm_sysctrl - EXX00 system board administration
7
9 /usr/sbin/cfgadm -c function [-f]
10 [-o disable-at-boot | enable-at-boot] [-n | -y] sysctrl0:slot# ...
11 /usr/sbin/cfgadm -x quiesce-test sysctrl0:slot#
14 /usr/sbin/cfgadm -x insert-test | remove-test sysctrl0:slot# ...
17 /usr/sbin/cfgadm -x set-condition-test=# sysctrl0:slot# ...
20 /usr/sbin/cfgadm [-l]
23 -o disable-at-boot | enable-at-boot sysctrl0:slot# ...
24
27 The sysctrl hardware specific library /usr/plat‐
28 form/sun4u/lib/cfgadm/sysctrl.so.1 provides dynamic reconfiguration
29 functionality for configuring and disconnecting system boards on E6X00,
30 E5X00, E4X00, and E3X00 systems. You can insert both I/O and CPU boards
31 into a slot on a running system that is configured for Solaris without
32 rebooting. You can also disconnect and remove both types of boards from
33 a running system without rebooting.
34 System slots appear as attachment points in the device tree, one
37 attachment point for each actual slot in the system chassis. If a board
38 is not in a slot, the receptacle state is empty. If a board is powered-
39 off and ready to remove, the receptacle state is disconnected. If a
40 board is powered-on and is connected to the system bus, the receptacle
41 state is connected.
42 The occupant state is unconfigured when the receptacle state is empty
45 or disconnected. The occupant state is either unconfigured or config‐
46 ured when the receptacle state is connected.
47 In the configured state the devices on a board are available for use by
50 Solaris. In the unconfigured state, the devices on the board are not.
51 Inserting a board changes the receptacle state from empty to discon‐
54 nected. Removing a board changes the receptacle state from disconnected
55 to empty. Removing a board that is in the connected state crashes the
56 operating system and can result in permanent damage to the system.
57
59 Refer to cfgadm(1M) for a more complete description options.
60 The following options are supported:
63 -c function
65 Perform the state change function. Specify function as connect,
67 disconnect, configure or unconfigure.
68 configure Change the occupant state to configure.
70 If the receptacle state is disconnected, the config‐
72 ure function first attempts to connect the recepta‐
73 cle. The configure function walks the OBP device
74 tree created as part of the connect function and
75 creates the Solaris device tree nodes, attaching
76 devices as required. For CPU/Memory boards, config‐
77 ure adds CPUs to the CPU list in the powered-off
78 state. These are visible to the psrinfo(1M) and
79 psradm(1M) commands. Two memory attachment points
80 are published for CPU/memory boards. Use mount(1M)
81 andifconfig(1M) to use I/O devices on the new board.
82 To use CPUs, use psradm -n to on-line the new pro‐
83 cessors. Use cfgadm_ac(1M) to test and configure the
84 memory banks.
85 connect Change the receptacle state to connected.
88 Changing the receptacle state requires that the sys‐
90 tem bus be frozen while the bus signals are con‐
91 nected and the board tested. The bus is frozen by
92 running a quiesce operation which stops all process
93 activity and suspends all drivers. Because the qui‐
94 esce operation and the subsequent resume can be time
95 consuming, and are not supported by all drivers, the
96 -x quiesce-test is provided. While the system bus is
97 frozen, the board being connected is tested by
98 firmware. This operation takes a short time for I/O
99 boards and a significant time for CPU/Memory boards
100 due to CPU external cache testing. This does not
101 provide memory testing. The user is prompted for
102 confirmation before proceeding with the quiesce. Use
103 the -y or -n option to override the prompt. The con‐
104 nect operation is refused if the board is marked as
105 disabled-at-boot, unless either the force flag, -f,
106 or the enable at boot flag, -o enable-at-boot, is
107 given. See -l.
108 disconnect Change the receptacle state to disconnected.
111 If the occupant state is configure, the disconnect
113 function first attempts to unconfigure the occupant.
114 The disconnect operation does not require a quiesce
115 operation and operates quickly. The board is pow‐
116 ered-off ready for removal.
117 unconfigure Change the occupant state to unconfigureed.
120 Devices on the board are made invisible to Solaris
122 during this process. The I/O devices on an I/O board
123 are removed from the Solaris device tree. Any device
124 that is still in use stops the unconfigure process
125 and be reported as in use. The unconfigure operation
126 must be retried after the device is made non-busy.
127 For CPU/Memory boards, the memory must have been
128 changed to the unconfigured state prior to issuing
129 the board unconfigure operation. The CPUs on the
130 board are off-lined, powered off and removed from
131 the Solaris CPU list. CPUs that have processes bound
132 to them cannot be off-lined. See psradm(1M),
133 psrinfo(1M), pbind(1M), andp_online(2) for more
134 information on off-lining CPUs.
135 -f
139 Force a block on connecting a board marked as disabled-at-boot in
141 the non-volatile disabled-board-list variable. See Platform
142 Notes:Sun Enterprise 6x00/5x00/4x00/3x00 Systems
143 -l
146 List options. Supported as described in cfgadm(1M)cfgadm(1M).
148 The type field can be one of cpu/mem, mem, dual-sbus, sbus-upa,
150 dual-pci, soc+sbus, soc+upa, disk or unknown.
151 The hardware-specific info field is set as follows: [disabled at
153 boot] [non-detachable] [100 MHz capable]
154 For sbus-upa and soc+upa type boards, the following additional
156 information appears first: [single buffered ffb|double buffered
157 ffb|no ffb installed] For disk type boards, the following addi‐
158 tional information appears first: {target: # | no disk} {target: #
159 | no disk}
160 -o disable-at-boot | enable-at-boot
163 Modify the state of the non—volatile disabled-board-list variable.
165 Use this the -o option in conjunction with the -c function or -l
166 option.
167 Use -o enable-at-boot with the -c connect to override a block on
169 connecting a disabled-at-boot board.
170 -x insert-test | remove-test
173 Perform a test.
175 Specify remove-test to change the driver state for the specified
177 slot from disconnected to empty without the need for physically
178 removing the board during automated test sequences.
179 Specify insert-test to change the driver state of a slot made to
181 appear empty using the remove-test command to the disconnected
182 state as if it had been inserted.
183 -x quiesce-test sysctrl0:slot1
186 Perform a test.
188 Allows the quiesce operation required for board connect operations
190 to be exercised. The execution of this test confirms that, with the
191 current software and hardware configuration, it is possible to qui‐
192 esce the system. If a device or process cannot be quiesced, its
193 name is printed in an error message. Any valid board attachment
194 point can be used with this command, but since all systems have a
195 slot1 the given form is recommended.
196 -x set-condition-test=#
199 Perform a test.
201 Allows the condition of a system board attachment point to be set
203 for testing the policy logic for state change commands. The new
204 setting is given as a number indicating one of the following condi‐
205 tion values:
206 0 unknown
208 1 ok
209 2 failing
210 3 failed
211 4 unusable
212
217 The following operand is supported:
218 sysctrl0:slot# The attachment points for boards on EXX00
220 systems are published by instance 0 of the
221 sysctrl driver (sysctrl0). The names of the
222 attachment points are numbered from slot0
223 through slot15. Specify # as a number
224 between 0 and 15, indicating the slot num‐
225 ber. This form conforms to the logical
226 ap_id specification given in cfgadm(1M).
227 The corresponding physical ap_ids are
228 listed in the FILES section.
229
232 /usr/platform/sun4u/lib/cfgadm/sysctrl.so.1
233 Hardware specific library
235 /devices/central@1f,0/fhc@0,f8800000/clock-board@0,900000:slot*
238 Attachment Points
240
243 See attributes(5) for descriptions of the following attributes:
244 ┌─────────────────────────────┬─────────────────────────────┐
249 │ ATTRIBUTE TYPE │ ATTRIBUTE VALUE │
250 ├─────────────────────────────┼─────────────────────────────┤
251 │Availability │SUNWkvm.u │
252 └─────────────────────────────┴─────────────────────────────┘
253
255 cfgadm(1M), cfgadm_ac(1M), ifconfig(1M), mount(1M), pbind(1M),
256 psradm(1M), , psrinfo(1M), config_admin(3CFGADM), attributes(5)
257 Sun Enterprise 6x00, 5x00, 4x00 and 3x00 Systems Dynamic Reconfigura‐
260 tion User's Guide
261 Platform Notes:Sun Enterprise 6x00/5x00/4x00/3x00 Systems
264
266 Refer to the Sun Enterprise 6x00, 5x00, 4x00 and 3x00 Systems Dynamic
267 Reconfiguration User's Guide for additional details regarding dynamic
268 reconfiguration of EXX00 system CPU/Memory boards.
269SunOS 5.11 10 Mar 1999 cfgadm_sysctrl(1M)