手册页部分 1M: 系统管理命令

退出打印视图

更新时间: 2014 年 7 月
 
 

cfgadm_sysctrl(1M)

名称

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 提供动态重新配置功能,用于在 E6X00E5X00E4X00 以及 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

执行状态更改函数。将函数指定为 connectdisconnectconfigureunconfigure

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/memmemdual-sbussbus-upadual-pcisoc+sbussoc+upadiskunknown 之一。

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

对于 sbus-upasoc+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) 发布。连接点名称编号为 slot0slot15。将 # 指定为 015 之间的数字,表示槽号。此格式符合 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)

属性类型
属性值
可用性
system/library/platform

另请参见

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》