cfgadm_sysctrl(1M) System Administration Commands cfgadm_sysctrl(1M)NAMEcfgadm_sysctrl - EXX00 system board administration
SYNOPSIS
/usr/sbin/cfgadm -c function [-f]
[-o disable-at-boot | enable-at-boot] [-n | -y] sysctrl0:slot# ...
/usr/sbin/cfgadm -x quiesce-test sysctrl0:slot#
/usr/sbin/cfgadm -x insert-test | remove-test sysctrl0:slot# ...
/usr/sbin/cfgadm -x set-condition-test=# sysctrl0:slot# ...
/usr/sbin/cfgadm [-l]
-o disable-at-boot | enable-at-boot sysctrl0:slot# ...
DESCRIPTION
The sysctrl hardware specific library /usr/plat‐
form/sun4u/lib/cfgadm/sysctrl.so.1 provides dynamic reconfiguration
functionality for configuring and disconnecting system boards on E6X00,
E5X00, E4X00, and E3X00 systems. You can insert both I/O and CPU boards
into a slot on a running system that is configured for Solaris without
rebooting. You can also disconnect and remove both types of boards from
a running system without rebooting.
System slots appear as attachment points in the device tree, one
attachment point for each actual slot in the system chassis. If a board
is not in a slot, the receptacle state is empty. If a board is powered-
off and ready to remove, the receptacle state is disconnected. If a
board is powered-on and is connected to the system bus, the receptacle
state is connected.
The occupant state is unconfigured when the receptacle state is empty
or disconnected. The occupant state is either unconfigured or config‐
ured when the receptacle state is connected.
In the configured state the devices on a board are available for use by
Solaris. In the unconfigured state, the devices on the board are not.
Inserting a board changes the receptacle state from empty to discon‐
nected. Removing a board changes the receptacle state from disconnected
to empty. Removing a board that is in the connected state crashes the
operating system and can result in permanent damage to the system.
OPTIONS
Refer to cfgadm(1M) for a more complete description options.
The following options are supported:
-c function
Perform the state change function. Specify function as connect,
disconnect, configure or unconfigure.
configure Change the occupant state to configure.
If the receptacle state is disconnected, the config‐
ure function first attempts to connect the recepta‐
cle. The configure function walks the OBP device
tree created as part of the connect function and
creates the Solaris device tree nodes, attaching
devices as required. For CPU/Memory boards, config‐
ure adds CPUs to the CPU list in the powered-off
state. These are visible to the psrinfo(1M) and
psradm(1M) commands. Two memory attachment points
are published for CPU/memory boards. Use mount(1M)andifconfig(1M) to use I/O devices on the new board.
To use CPUs, use psradm -n to on-line the new pro‐
cessors. Use cfgadm_ac(1M) to test and configure the
memory banks.
connect Change the receptacle state to connected.
Changing the receptacle state requires that the sys‐
tem bus be frozen while the bus signals are con‐
nected and the board tested. The bus is frozen by
running a quiesce operation which stops all process
activity and suspends all drivers. Because the qui‐
esce operation and the subsequent resume can be time
consuming, and are not supported by all drivers, the
-x quiesce-test is provided. While the system bus is
frozen, the board being connected is tested by
firmware. This operation takes a short time for I/O
boards and a significant time for CPU/Memory boards
due to CPU external cache testing. This does not
provide memory testing. The user is prompted for
confirmation before proceeding with the quiesce. Use
the -y or -n option to override the prompt. The con‐
nect operation is refused if the board is marked as
disabled-at-boot, unless either the force flag, -f,
or the enable at boot flag, -o enable-at-boot, is
given. See -l.
disconnect Change the receptacle state to disconnected.
If the occupant state is configure, the disconnect
function first attempts to unconfigure the occupant.
The disconnect operation does not require a quiesce
operation and operates quickly. The board is pow‐
ered-off ready for removal.
unconfigure Change the occupant state to unconfigureed.
Devices on the board are made invisible to Solaris
during this process. The I/O devices on an I/O board
are removed from the Solaris device tree. Any device
that is still in use stops the unconfigure process
and be reported as in use. The unconfigure operation
must be retried after the device is made non-busy.
For CPU/Memory boards, the memory must have been
changed to the unconfigured state prior to issuing
the board unconfigure operation. The CPUs on the
board are off-lined, powered off and removed from
the Solaris CPU list. CPUs that have processes bound
to them cannot be off-lined. See psradm(1M),
psrinfo(1M), pbind(1M), andp_online(2) for more
information on off-lining CPUs.
-f
Force a block on connecting a board marked as disabled-at-boot in
the non-volatile disabled-board-list variable. See Platform
Notes:Sun Enterprise 6x00/5x00/4x00/3x00 Systems
-l
List options. Supported as described in cfgadm(1M)cfgadm(1M).
The type field can be one of cpu/mem, mem, dual-sbus, sbus-upa,
dual-pci, soc+sbus, soc+upa, disk or unknown.
The hardware-specific info field is set as follows: [disabled at
boot] [non-detachable] [100 MHz capable]
For sbus-upa and soc+upa type boards, the following additional
information appears first: [single buffered ffb|double buffered
ffb|no ffb installed] For disk type boards, the following addi‐
tional information appears first: {target: # | no disk} {target: #
| no disk}
-o disable-at-boot | enable-at-boot
Modify the state of the non—volatile disabled-board-list variable.
Use this the -o option in conjunction with the -c function or -l
option.
Use -o enable-at-boot with the -c connect to override a block on
connecting a disabled-at-boot board.
-x insert-test | remove-test
Perform a test.
Specify remove-test to change the driver state for the specified
slot from disconnected to empty without the need for physically
removing the board during automated test sequences.
Specify insert-test to change the driver state of a slot made to
appear empty using the remove-test command to the disconnected
state as if it had been inserted.
-x quiesce-test sysctrl0:slot1
Perform a test.
Allows the quiesce operation required for board connect operations
to be exercised. The execution of this test confirms that, with the
current software and hardware configuration, it is possible to qui‐
esce the system. If a device or process cannot be quiesced, its
name is printed in an error message. Any valid board attachment
point can be used with this command, but since all systems have a
slot1 the given form is recommended.
-x set-condition-test=#
Perform a test.
Allows the condition of a system board attachment point to be set
for testing the policy logic for state change commands. The new
setting is given as a number indicating one of the following condi‐
tion values:
0 unknown
1 ok
2 failing
3 failed
4 unusable
OPERANDS
The following operand is supported:
sysctrl0:slot# The attachment points for boards on EXX00
systems are published by instance 0 of the
sysctrl driver (sysctrl0). The names of the
attachment points are numbered from slot0
through slot15. Specify # as a number
between 0 and 15, indicating the slot num‐
ber. This form conforms to the logical
ap_id specification given in cfgadm(1M).
The corresponding physical ap_ids are
listed in the FILES section.
FILES
/usr/platform/sun4u/lib/cfgadm/sysctrl.so.1
Hardware specific library
/devices/central@1f,0/fhc@0,f8800000/clock-board@0,900000:slot*
Attachment Points
ATTRIBUTES
See attributes(5) for descriptions of the following attributes:
┌─────────────────────────────┬─────────────────────────────┐
│ ATTRIBUTE TYPE │ ATTRIBUTE VALUE │
├─────────────────────────────┼─────────────────────────────┤
│Availability │system/library/platform │
└─────────────────────────────┴─────────────────────────────┘
SEE ALSOcfgadm(1M), cfgadm_ac(1M), ifconfig(1M), mount(1M), pbind(1M),
psradm(1M), , psrinfo(1M), config_admin(3CFGADM), attributes(5)
Sun Enterprise 6x00, 5x00, 4x00 and 3x00 Systems Dynamic Reconfigura‐
tion User's Guide
Platform Notes:Sun Enterprise 6x00/5x00/4x00/3x00 Systems
NOTES
Refer to the Sun Enterprise 6x00, 5x00, 4x00 and 3x00 Systems Dynamic
Reconfiguration User's Guide for additional details regarding dynamic
reconfiguration of EXX00 system CPU/Memory boards.
SunOS 5.11 10 Mar 1999 cfgadm_sysctrl(1M)