请告诉我们如何提高我们的文档：

过于简略
不易阅读或难以理解
重要信息缺失
错误的内容
需要翻译的版本
--选择-- Deutch (German) Español (Spanish) Français (French) Italiano (Italian) Português Brasil (Portuguese) 日本語 (Japanese) 한국어 (Korean) 简体中文 (Simplified Chinese) 繁體中文 (Traditional Chinese) 其他语言 其他

Your rating has been updated

感谢您的反馈！

您的反馈将非常有助于我们提供更好的文档。 您是否愿意参与我们的内容改进并提供进一步的意见？

前往问卷调查不。谢谢。

cfgadm_sysctrl

- EXX00 系统板管理

用法概要

/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# ...

描述

sysctrl 硬件特定库 /usr/platform/sun4u/lib/cfgadm/sysctrl.so.1 提供动态重新配置功能，用于在 E6X00、E5X00、E4X00 以及 E3X00 系统中配置和断开系统板。可将 I/O 板和 CPU 板插入针对 Solaris 配置的运行中系统上的插槽，而无需重新引导。也可以从正在运行的系统断开和移除这两种类型的板，而无需重新引导。

系统插槽在设备树中显示为连接点，系统机箱中的每个实际插槽对应一个连接点。如果插槽中没有插入板，则插口状态为 empty（空）。如果板已断电并可随时移除，则插口状态为 disconnected（断开）。如果板已通电并连接到系统总线，则插口状态为 connected（已连接）。

插口状态为 empty（空）或 disconnected（断开）时，插卡状态为 unconfigured（未配置）。插口状态为 connected（已连接）时，插卡状态为 unconfigured（未配置）或 configured（已配置）。

处于 configured（已配置）状态时，板上的设备可供 Solaris 使用。处于 unconfigured（未配置）状态时，板上的设备不可用。

插入板会使插口状态从 empty（空）更改为 disconnected（断开）。移除板会使插口状态从 disconnected（断开）更改为 empty（空）。移除处于 connected（已连接）状态的板会导致操作系统崩溃，并可能导致系统的永久性损坏。

选项

有关选项的更完整的描述，请参见 cfgadm(1M)。

支持以下选项：

-c function

执行状态更改函数。将函数指定为 connect、disconnect、configure 或 unconfigure。

configure（配置）

将插卡状态更改为 configured（已配置）。

如果插口状态为 disconnected（断开），configure 函数会首先尝试连接该插口。configure 函数可遍历 connect 函数创建的 OBP 设备树，并创建 Solaris 设备树节点，从而根据需要连接设备。对于 CPU/内存板，configure 会将 CPU 添加到处于 powered-off（已断电）状态的 CPU 列表中。这些操作对于 psrinfo(1M) 和 psradm(1M) 命令是可见的。为 CPU/内存板发布了两个内存连接点。通过 mount(1M) 和 ifconfig(1M) 可使用新板上的 I/O 设备。要使用 CPU，请使用 psradm -n 使新处理器联机。使用 cfgadm_ac(1M) 可测试和配置内存区。

connect

将插口状态更改为 connected（已连接）。

当总线信号已连接并且板已测试时，要更改插口状态必须冻结系统总线。可通过执行 quiesce 操作冻结总线，该操作会停止所有进程活动并暂停所有驱动程序。由于 quiesce 操作以及随后的恢复操作比较耗时，而且并非所有驱动程序都支持这些操作，因此提供了 -x quiesce-test。当系统总线冻结时，固件会对正在连接的板进行测试。对于 I/O 板，该操作可在很短的时间内完成，而对于 CPU/内存板，由于需要进行 CPU 外部高速缓存测试，因此比较耗时。该操作过程中不进行内存测试。系统在 quiesce 操作开始前会提示用户进行确认。使用 -y 或 -n 选项应答该提示。如果板标记为 disabled-at-boot，则 connect 操作被拒绝，除非指定了强制标志 -f 或引导时启用标志 -o enable-at-boot。请参见 -l。

disconnect

将插口状态更改为 disconnected（断开）。

如果插卡状态为 configured（已配置），disconnect 函数会首先尝试取消对该插卡的配置。disconnect 操作不要求执行 quiesce 操作，因此耗时较短。板会断电，可随时移除。

unconfigure（取消配置）

将插卡状态更改为 unconfigured（未配置）。

在此过程中，会使板上的设备对 Solaris 不可见。I/O 板上的 I/O 设备将从 Solaris 设备树中删除。对于任何正在使用中的设备，会停止取消配置过程并报告设备正在使用。必须在使设备处于不忙状态后重试取消配置操作。对于 CPU/内存板，发出板取消配置操作前，必须已将内存更改为未配置状态。板上的 CPU 会脱机、断电并从 Solaris CPU 列表中删除。不能使与进程绑定的 CPU 脱机。有关使 CPU 脱机的更多信息，请参见psradm(1M)、psrinfo(1M)、pbind(1M) 和 p_online(2)。

-f

强制将块连接到 disabled-board-list 非易失性变量中标记为 disabled-at-boot 的板。请参见《Platform Notes: Sun Enterprise 6x00/5x00/4x00/3x00 Systems》。

-l

列出选项。按 cfgadm(1M)cfgadm(1M) 中的描述支持该选项。

type 字段可以是 cpu/mem、mem、dual-sbus、sbus-upa、dual-pci、soc+sbus、soc+upa、disk 或 unknown 之一。

硬件特定的 info 字段的设置如下：[disabled at boot] [non-detachable] [100 MHz capable]

对于 sbus-upa 和 soc+upa 类型的板，首先显示以下附加信息：[single buffered ffb|double buffered ffb|no ffb installed] 对于磁盘类型的板，首先显示以下附加信息：{target: # | no disk} {target: # | no disk}

-o disable-at-boot | enable-at-boot

修改 disabled-board-list 非易失性变量的状态。将 -o 选项与 -c function 或 -l 选项结合使用。

将 -o enable-at-boot 与 -c connect 结合使用可在连接 disabled-at-boot 板时覆盖块。

-x insert-test | remove-test

执行测试。

指定 remove-test 将指定插槽的驱动程序状态从 disconnected（断开）更改为 empty（空），而无需在自动测试过程中物理移除板。

指定 insert-test 将通过 remove-test 命令显示为 empty（空）的插槽的驱动程序状态更改为 disconnected（断开），就好像之前插入过板一样。

-x quiesce-test sysctrl0:slot1

执行测试。

允许执行板的连接操作所需的 quiesce 操作。执行该测试可确认在当前软件和硬件配置下，可以停止系统。不能停止的设备或进程的名称将显示在错误消息中。该命令适用于任何有效的板连接点，但由于所有系统都有插槽 1，因此推荐采用给定的形式。

-x set-condition-test=#

执行测试。

允许设置系统板连接点的状态，以便测试状态更改命令的策略逻辑。新的设置为指示如下状态值之一的数字：

0      unknown
1      ok 
2      failing
3      failed
4      unusable

操作数

支持下列操作数：

sysctrl0:slot#

EXX00 系统板连接点由 sysctrl 驱动程序的实例 0 (sysctrl0) 发布。连接点名称编号为 slot0 到 slot15。将 # 指定为 0 到 15 之间的数字，表示槽号。此格式符合 cfgadm(1M) 中提供的逻辑 ap_id 规范。对应的物理 ap_id 已在“文件”部分中列出。

文件

/usr/platform/sun4u/lib/cfgadm/sysctrl.so.1

硬件特定库

/devices/central@1f,0/fhc@0,f8800000/clock-board@0,900000:slot*

连接点

属性

有关下列属性的说明，请参见 attributes(5)：

另请参见

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》

附注

有关 EXX00 系统 CPU/内存板动态重新配置的更多详细信息，请参见《Sun Enterprise 6x00, 5x00, 4x00 and 3x00 Systems Dynamic Reconfiguration User's Guide》。