System Administration Commands cfgadmac(1M)
NAME
cfgadmac - EX00 memory system administration
SYNOPSIS
/usr/sbin/cfgadm [-c configure] [-f]
[-o disable-at-boot enable-at-boot ] ac#:bank# ...
/usr/sbin/cfgadm [-c unconfigure]
[-o disable-at-bootp enable-at-boot ] ac#:bank# ...
/usr/sbin/cfgadm [-v]
[-o quick normal extended, [maxerrors=#] ] -t ac#:bank#...
/usr/sbin/cfgadm -x relocate-test ac#:bank# ...
/usr/sbin/cfgadm [-l] -o disable-at-boot enable-at-boot ac#:bank# ...
DESCRIPTION
The ac hardware specific library
/usr/platform/sun4u/lib/cfgadm/cfgadmac.so.1 provides the
functionality for configuring and unconfiguring memory banks
on E6X00, E5X00, E4X00 and E3X00 systems as part of the
Dynamic Reconfiguration of CPU/Memory boards using
cfgadmsysctrl(1M).
Memory banks appear as attachment points in the device tree.
For each CPU/Memory board, two attachment points are pub-
lished, one for each bank on the board: bank0 and bank1. If
the bank is unpopulated, the receptacle state is empty. If
the bank is populated, the receptacle state is connected.
The receptacle state of a memory bank can never be discon-
nected. The occupant state of a connected memory bank can be
configured or unconfigured. If the occupant state is config-
ured, the memory is in use by Solaris, if unconfigured it is
not.
OPTIONS
Refer to cfgadm(1M) for complete descriptions of the command
options.
The following options are supported:
-c configure unconfigure
Change the occupant state. The configure argument
SunOS 5.11 Last change: 29 Sep 1999 1
System Administration Commands cfgadmac(1M)
ensures that the memory is initialized and adds the
memory to the Solaris memory pool. The unconfigure argu-
ment removes the memory from use by Solaris. When a
CPU/Memory board is to be removed from a system, both
banks of memory must be unconfigured.
cfgadm refuses the configure operation if the memory on
the board is marked disabled-at-boot (see info field),
unless either the -f (force) option or the enable at
boot flag, (-o enable-at-boot), is given. The configure
operation takes a short time proportional to the size of
memory that must be initialized.
cfgadm refuses the unconfigure operation if there is
not enough uncommitted memory in the system (VM viabil-
ity error) or if the bank to be unconfigured has memory
that can't be removed (non-relocatable pages error). The
presence of non-relocatable pages is indicated by the
word permanent in the info listing field. Removing
memory from use by Solaris may take a significant time
due to factors such as system load and how much paging
to secondary storage is required. The unconfigure opera-
tion can be cancelled at any time and the memory
returned to the fully configured state by interrupting
the command invocation with a signal. The unconfigure
operation self-cancels if no memory can be removed
within a timeout period. The default timeout period of
60 seconds can be changed using the -o timeout=# option,
with a value of 0 disabling the timeout.
-f
Force option. Use this option to override the block on
configuring a memory bank marked as disabled at boot in
the non-volatile disabled-memory-list variable. See
Platform Notes:Sun Enterprise 6x00/5x00/4x00/3x00 Sys-
tems
-l
List option. This option is supported as described in
cfgadm(1M).
The type field is always memory.
The info field has the following information for empty
banks:
slot# empty
SunOS 5.11 Last change: 29 Sep 1999 2
System Administration Commands cfgadmac(1M)
The slot# indicates the system slot into which the
CPU/Memory board is inserted. For example, if this were
slot11 the attachment point for use with cfgadm to mani-
pulate the associated board would be sysctrl0:slot11.
The info field has the following information for con-
nected banks:
slot# sizeMbsizeGb [(sizeMbsizeGb used)] base 0x###
[interleaved #-way] [disabled at boot] [permanent]
The size of the bank is given in Mb or Gb as appropri-
ate. If the memory is less than completely used, the
used size is reported. The physical base address is
given in hexadecimal. If the memory bank is interleaved
with some other bank, the interleave factor is reported.
If the memory on the board is disabled at boot using the
non-volatile disabled-memory-list variable, this is
reported. If the bank has memory that cannot be removed
this is reported as permanent.
-o disable-at-boot enable-at-boot
These options allow the state of the non-volatile
disabled-memory-list variable to be modified. These
options can be used in conjunction with the issuing of a
-c option or with the explicit or implied listing com-
mand, -l, if no command is required. Use of -o enable-
at-boot with the configure command to override the block
on configuring memory on a board in the disabled memory
list.
-o extended normal quick
Use with the -t option to specify test level.
The normal test level ensures that each memory cell
stores both a 0 and a 1, and checks that all cells are
separately addressable. The quick test level only does
the 0s and 1s test, and typically misses address line
problems. The extended test uses patterns to test for
adjacent cell interference problems. The default test
level is normal. See -t option.
-o maxerrors=#
Use with the -t option to specify the maximum number of
allowed errors. If not specified, a default of 32 is
assumed.
SunOS 5.11 Last change: 29 Sep 1999 3
System Administration Commands cfgadmac(1M)
-o timeout=#
Use with the unconfigure command to set the self-
cancelling timeout. The default value is 60 and the unit
is seconds. A value of 0 means no timeout.
-t
Test an unconfigured bank of memory. Specify the test
level using the -o quick normal extended option.
cfgadm exits with a 0 (success) if the test was able to
run on the memory bank. The result of the test is avail-
able in the condition for the attachment point.
-v
Verbose option. Use this option in combination with
the -t option to display detailed progress and results
of tests.
-x relocate-test
For all pages of memory in use on the specified memory
bank, a relocation operation as used in the unconfigure
command is attempted. The success of this operation does
not guarantee that the bank can be unconfigured. Failure
indicates that it probably cannot be unconfigured. This
option is for test purposes only.
OPERANDS
The following operand is supported:
ac#:bank# The attachment points for memory banks are pub-
lished by instances of the address controller
(ac) driver (ac#). One instance of the ac
driver is created for each system board, but
only those instances associated with CPU/Memory
boards publish the two bank attachment points,
bank0 and bank1.
This form conforms to the logical apid
specification given in cfgadm(1M). The
corresponding physical apids are listed in the
FILES section.
The ac driver instance numbering has no rela-
tion to the slot number for the corresponding
SunOS 5.11 Last change: 29 Sep 1999 4
System Administration Commands cfgadmac(1M)
board. The full physical attachment point iden-
tifier has the slot number incorporated into it
as twice the slot number in hexadecimal
directly following the fhc@ part.
FILES
/devices/fhc@*,f8800000/ac@0,1000000:bank?
attachment points
/usr/platform/sun4u/lib/cfgadm/cfgadmac.so.1
hardware specific library file
ATRIBUTES
See attributes(5) for descriptions of the following attri-
butes:
ATRIBUTE TYPE ATRIBUTE VALUE
Availability SUNWkvm.u
SEE ALSO
cfgadm(1M), cfgadmsysctrl(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: 29 Sep 1999 5
|
