cfgadm_sysctrl(1M)
NAME
cfgadm_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/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.
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 func-
tion 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
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 processors. 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
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 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 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 disconnected.
If the occupant state is configure, the discon-
nect 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 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 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 com-
mand 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 con-
nect 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 systems have a slot1 the given form is
recommended.
-x set-condition-test=#
Perform a test.
Allows the 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 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 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 number.
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 attri-
butes:
____________________________________________________________
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
|_____________________________|_____________________________|
| Availability | SUNWkvm.u |
|_____________________________|_____________________________|
SEE ALSO
cfgadm(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
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 EXX00 system
CPU/Memory boards.
Man(1) output converted with
man2html