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

NAME

6       cfgadm_sysctrl - EXX00 system board administration
7

SYNOPSIS

9       /usr/sbin/cfgadm -c function [-f]
10            [-o disable-at-boot | enable-at-boot] [-n | -y] sysctrl0:slot# ...
11
12
13       /usr/sbin/cfgadm -x quiesce-test sysctrl0:slot#
14
15
16       /usr/sbin/cfgadm -x insert-test | remove-test sysctrl0:slot# ...
17
18
19       /usr/sbin/cfgadm -x set-condition-test=# sysctrl0:slot# ...
20
21
22       /usr/sbin/cfgadm [-l]
23            -o disable-at-boot | enable-at-boot sysctrl0:slot# ...
24
25

DESCRIPTION

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
35
36       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
43
44        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
48
49       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
52
53       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

OPTIONS

59       Refer to cfgadm(1M) for a more complete description options.
60
61
62       The following options are supported:
63
64       -c function
65
66           Perform the state change function.  Specify  function  as  connect,
67           disconnect, configure or unconfigure.
68
69           configure      Change the occupant state to configure.
70
71                          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
86
87           connect        Change the receptacle state to connected.
88
89                          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
109
110           disconnect      Change the receptacle state to disconnected.
111
112                          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
118
119           unconfigure    Change the occupant state to unconfigureed.
120
121                          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
136
137
138       -f
139
140            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
144
145       -l
146
147           List options. Supported as described in cfgadm(1M)cfgadm(1M).
148
149           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
152           The hardware-specific info field is set as  follows:  [disabled  at
153           boot] [non-detachable] [100 MHz capable]
154
155           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
161
162       -o disable-at-boot | enable-at-boot
163
164           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
168           Use  -o  enable-at-boot  with the -c connect to override a block on
169           connecting a disabled-at-boot board.
170
171
172       -x insert-test | remove-test
173
174           Perform a test.
175
176            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
180           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
184
185       -x quiesce-test sysctrl0:slot1
186
187           Perform a test.
188
189           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
197
198       -x set-condition-test=#
199
200           Perform a test.
201
202           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
207             0      unknown
208             1      ok
209             2      failing
210             3      failed
211             4      unusable
212
213
214
215

OPERANDS

217       The following operand is supported:
218
219       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
230

FILES

232       /usr/platform/sun4u/lib/cfgadm/sysctrl.so.1
233
234           Hardware specific library
235
236
237       /devices/central@1f,0/fhc@0,f8800000/clock-board@0,900000:slot*
238
239           Attachment Points
240
241

ATTRIBUTES

243       See attributes(5) for descriptions of the following attributes:
244
245
246
247
248       ┌─────────────────────────────┬─────────────────────────────┐
249       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
250       ├─────────────────────────────┼─────────────────────────────┤
251       │Availability                 │SUNWkvm.u                    │
252       └─────────────────────────────┴─────────────────────────────┘
253

SEE ALSO

255       cfgadm(1M),   cfgadm_ac(1M),   ifconfig(1M),   mount(1M),    pbind(1M),
256       psradm(1M), , psrinfo(1M), config_admin(3CFGADM), attributes(5)
257
258
259       Sun  Enterprise  6x00, 5x00, 4x00 and 3x00 Systems Dynamic Reconfigura‐
260       tion User's Guide
261
262
263       Platform Notes:Sun Enterprise 6x00/5x00/4x00/3x00 Systems
264

NOTES

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.
269
270
271
272SunOS 5.11                        10 Mar 1999               cfgadm_sysctrl(1M)
Impressum