System Administration Commands cfgadmsysctrl(1M)
NAME
cfgadmsysctrl - EX00 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/platform/sun4u/lib/cfgadm/sysctrl.so.1 provides dynamic
reconfiguration functionality for configuring and discon-
necting system boards on E6X00, E5X00, E4X00, and E3X00 sys-
tems. 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 configured when the receptacle state is con-
nected.
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.
SunOS 5.11 Last change: 10 Mar 1999 1
System Administration Commands cfgadmsysctrl(1M)
Inserting a board changes the receptacle state from empty to
disconnected. 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 configure function first attempts to
connect the receptacle. 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, configure adds CPUs to
the CPU list in the powered-off state.
These are visible to the psrinfo(1M) and
psradm(1M) commands. Two memory attach-
ment 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
processors. Use cfgadmac(1M) to test and
configure the memory banks.
connect Change the receptacle state to connected.
Changing the receptacle state requires
that the system bus be frozen while the
bus signals are connected and the board
tested. The bus is frozen by running a
quiesce operation which stops all process
activity and suspends all drivers.
Because the quiesce 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
SunOS 5.11 Last change: 10 Mar 1999 2
System Administration Commands cfgadmsysctrl(1M)
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 over-
ride the prompt. The connect 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 discon-
nected.
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 powered-off ready for removal.
unconfigure Change the occupant state to unconfi-
gureed.
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), andponline(2) for more infor-
mation on off-lining CPUs.
-f
Force a block on connecting a board marked as
SunOS 5.11 Last change: 10 Mar 1999 3
System Administration Commands cfgadmsysctrl(1M)
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
ffbdouble buffered ffbno ffb installed] For disk type
boards, the following additional 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
SunOS 5.11 Last change: 10 Mar 1999 4
System Administration Commands cfgadmsysctrl(1M)
operations to be exercised. The execution of this test
confirms that, with the current software and hardware
configuration, it is possible to quiesce 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 sys-
tems 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 indicat-
ing one of the following condition 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 EX00 systems are published
by instance 0 of the sysctrl
driver (sysctrl0). The names of
the attachment points are num-
bered from slot0 through slot15.
Specify # as a number between 0
and 15, indicating the slot
number. This form conforms to
the logical apid specification
given in cfgadm(1M). The
corresponding physical apids
are listed in the FILES section.
FILES
/usr/platform/sun4u/lib/cfgadm/sysctrl.so.1
Hardware specific library
SunOS 5.11 Last change: 10 Mar 1999 5
System Administration Commands cfgadmsysctrl(1M)
/devices/central@1f,0/fhc@0,f8800000/clock-
board@0,900000:slot*
Attachment Points
ATRIBUTES
See attributes(5) for descriptions of the following attri-
butes:
ATRIBUTE TYPE ATRIBUTE VALUE
Availability SUNWkvm.u
SEE ALSO
cfgadm(1M), cfgadmac(1M), ifconfig(1M), mount(1M),
pbind(1M), psradm(1M), , psrinfo(1M), configadmin(3CFGADM),
attributes(5)
Sun Enterprise 6x00, 5x00, 4x00 and 3x00 Systems Dynamic
Reconfiguration User's Guide
Platform Notes:Sun Enterprise 6x00/5x00/4x00/3x00 Systems
NOTES
Refer to the Sun Enterprise 6x00, 5x00, 4x00 and 3x00 Sys-
tems Dynamic Reconfiguration User's Guide for additional
details regarding dynamic reconfiguration of EX00 system
CPU/Memory boards.
SunOS 5.11 Last change: 10 Mar 1999 6
|
