Solaris cfgadm使用

精选转载

loofeer 2011-09-01 10:56:34 博主文章分类：Solaris

cfgadm 命令包括以下功能：

显示系统组件状态
测试系统组件
更改组件配置
显示配置帮助消息
使用 cfgadm 命令重新配置系统组件的优点是可在系统运行的同时添加、移除或更换组件。另一优点是 cfgadm 命令可引导逐步完成添加、移除或更换系统组件所需执行的步骤。
注 – 并非所有 SCSI 和 PCI 控制器都支持使用 cfgadm 命令进行热插拔。

附加点
cfgadm 命令可以显示有关附加点的信息，附加点是指系统中可以执行动态重新配置操作的位置。
附加点由以下几项组成：

插卡，表示可在系统中配置的硬件组件
插座，是指插入插卡的位置
附加点由逻辑附加点 ID 和物理附加点 ID (Ap_Id) 表示。物理 Ap_Id 是附加点的物理路径名。逻辑 Ap_Id 是物理 Ap_Id 的用户友好替代项。有关 Ap_Id 的更多信息，请参阅 cfgadm(1M)。
SCSI 主机总线适配器 (Host Bus Adapter, HBA) 或 SCSI 控制器的逻辑 Ap_Id 通常由控制器编号表示，如 c0。
如果未向 SCSI HBA 指定控制器编号，则将提供内部生成的唯一标识符。以下是 SCSI 控制器的唯一标识符的示例：
fas1:scsi
SCSI 设备的逻辑 Ap_Id 通常具有以下格式：
HBA-logical-apid::device-identifier
在以下示例中，c0 是 SCSI HBA 的逻辑 Ap_Id：
c0::dsk/c0t3d0
设备标识符通常由 /dev 目录中的设备的逻辑设备名称派生而来。例如，逻辑设备名称为 /dev/rmt/1 的磁带设备具有以下逻辑 Ap_Id：
c0::rmt/1
如果 SCSI 设备的逻辑 Ap_Id 无法从 /dev 目录中的逻辑名称派生而来，则将提供内部生成的唯一标识符。以下是 /dev/rmt/1 磁带设备的标识符的示例：
c0::st4
有关 SCSI Ap_Id 的更多信息，请参阅 cfgadm_scsi(1M)。
cfgadm 命令按照一组通用状态（如已配置和未配置）和操作（如连接、配置、取消配置等）来表示所有资源和动态重新配置操作。有关这些通用状态和操作的更多信息，请参见 cfgadm(1M)。
下表列出了 SCSI HBA 附加点的插座和插卡的状态。

插座状态

说明

插卡状态

说明

empty

N/A（对于 SCSI HBA）

configured

在总线上配置了一个或多个设备

disconnected

总线处于静止状态

unconfigured

未配置任何设备

connected

总线处于活动状态

下表列出了 SCSI 设备附加点的插座和插卡的状态。

插座状态

说明

插卡状态

说明

empty

N/A（对于 SCSI 设备）

configured

设备已配置

disconnected

总线处于静止状态

unconfigured

设备未配置

connected

总线处于活动状态

如果特殊硬件未另行指示其他状态，则 SCSI 附加点的状态是未知的。有关显示 SCSI 组件信息的说明，请参见如何显示有关 SCSI 设备的信息。
如何显示有关 SCSI 设备的信息
以下过程在使用 cfgadm 命令显示设备类型配置信息的示例中使用 SCSI 控制器 c0 和 c1 以及与其连接的设备。

--------------------------------------------------------------------------------

注 –
如果 cfgadm 命令不支持 SCSI 设备，则该设备不会显示在 cfgadm 命令输出中。

--------------------------------------------------------------------------------

成为超级用户。

显示有关系统上的附加点的信息。

# cfgadm -l Ap_Id Type Receptacle Occupant Condition c0 scsi-bus connected configured unknown c1 scsi-bus connected configured unknown

在本示例中，c0 和 c1 表示两个 SCSI 控制器。

显示有关系统的 SCSI 控制器及其连接设备的信息。

--------------------------------------------------------------------------------
注 –
cfgadm -l 命令显示有关 SCSI HBA 而不是 SCSI 设备的信息。使用 cfgadm -al 命令可显示有关 SCSI 设备（如磁盘和磁带）的信息。
如何取消配置 SCSI 控制器
以下过程在取消配置 SCSI 控制器的示例中使用 SCSI 控制器 c1。

成为超级用户。

取消配置 SCSI 控制器。

# cfgadm -c unconfigure c1

验证是否已取消配置 SCSI 控制器。

请注意，c1 的 Occupant 列指定 unconfigured，表明 SCSI 总线没有已配置的插卡。
如果取消配置操作失败，请参见如何解析失败的 SCSI 取消配置操作。

如何配置 SCSI 控制器
以下过程在配置 SCSI 控制器的示例中使用 SCSI 控制器 c1。

成为超级用户。

配置 SCSI 控制器。

# cfgadm -c configure c1

验证 SCSI 控制器是否已配置。

前面的取消配置过程移除了 SCSI 总线上的所有设备。现在，所有设备都已配置回系统中。

如何配置 SCSI 设备
以下过程在配置 SCSI 设备的示例中使用 SCSI 磁盘 c1t4d0。

成为超级用户。

确定要配置的设备。

配置 SCSI 设备。

# cfgadm -c configure c1::dsk/c1t4d0

验证 SCSI 设备是否已配置。

如何断开 SCSI 控制器连接

--------------------------------------------------------------------------------

注意 –
断开 SCSI 设备连接时必须非常谨慎，特别是在处理包含关键文件系统（如根 (/)、usr、var 和 swap 分区）的控制器任务时。动态重新配置软件无法检测到系统挂起可能导致的所有情况。使用此过程时应谨慎。

--------------------------------------------------------------------------------

以下过程在断开 SCSI 设备连接的示例中使用 SCSI 控制器 c1。

成为超级用户。
验证断开设备连接之前是否已连接该设备。

断开 SCSI 控制器的连接。

# cfgadm -c disconnect c1
WARNING: Disconnecting critical partitions may cause system hang.
Continue (yes/no)? y

--------------------------------------------------------------------------------

注意 –
此命令可以暂停 SCSI 总线上的所有 I/O 活动，直到使用 cfgadm -c connect 命令为止。cfgadm 命令可执行一些基本检查，以防止断开关键分区的连接，但不能检测到所有情况。如果此命令使用不当，则可能会导致系统挂起并且可能需要重新引导系统。

--------------------------------------------------------------------------------

验证 SCSI 总线是否已断开连接。

# cfgadm -al
Ap_Id                Type          Receptacle   Occupant     Condition
c0                   scsi-bus      connected    configured   unknown
c0::dsk/c0t0d0       disk          connected    configured   unknown
c0::rmt/0            tape          connected    configured   unknown
c1                   unavailable   disconnected configured   unknown
c1::dsk/c1t3d0       unavailable   disconnected configured   unknown
c1::dsk/c1t4d0       unavailable   disconnected configured   unknown

控制器及其连接的所有设备都将与系统断开连接。SPARC: 如何连接 SCSI 控制器
以下过程在连接 SCSI 控制器的示例中使用 SCSI 控制器 c1。

成为超级用户。

验证连接设备之前该设备是否已断开连接。

# cfgadm -al Ap_Id Type Receptacle Occupant Condition c0 scsi-bus connected configured unknown c0::dsk/c0t0d0 disk connected configured unknown c0::rmt/0 tape connected configured unknown c1 unavailable disconnected configured unknown c1::dsk/c1t3d0 unavailable disconnected configured unknown c1::dsk/c1t4d0 unavailable disconnected configured unknown

连接 SCSI 控制器。

# cfgadm -c connect c1

验证 SCSI 控制器是否已连接。

SPARC: 如何将 SCSI 设备添加到 SCSI 总线中
在如何将 SCSI 设备添加到 SCSI 总线的示例中使用的是 SCSI 控制器 c1。

--------------------------------------------------------------------------------

注 –
添加设备时，应指定与设备连接的 SCSI HBA（控制器）的 Ap_Id，而不是设备本身的 Ap_Id。

--------------------------------------------------------------------------------

成为超级用户。

确定当前的 SCSI 配置。

将 SCSI 设备添加到 SCSI 总线。

键入以下 cfgadm 命令。
例如：

# cfgadm -x insert_device c1 Adding device to SCSI HBA: /devices/sbus@1f,0/SUNW,fas@1,8800000 This operation will suspend activity on SCSI bus: c1

在 Continue (yes/no)? 提示符下键入 y 以继续操作。

Continue (yes/no)? y SCSI bus quiesced successfully. It is now safe to proceed with hotplug operation.

正在执行热插拔操作的同时，SCSI 总线上的 I/O 活动会暂停。

连接设备，然后打开设备电源。

在 Enter y if operation is complete or n to abort (yes/no)? 提示符下键入 y。

Enter y if operation is complete or n to abort (yes/no)? y

验证是否已添加了设备。

新磁盘已添加到控制器 c1 中。

SPARC: 如何更换 SCSI 控制器上的相同设备
以下过程在 SCSI 控制器上更换相同设备的示例中使用 SCSI 磁盘 c1t4d0。

成为超级用户。

确定当前的 SCSI 配置。

将 SCSI 总线上的设备更换为同一类型的其他设备。

键入以下 cfgadm 命令。
例如：

# cfgadm -x replace_device c1::dsk/c1t4d0 Replacing SCSI device: /devices/sbus@1f,0/SUNW,fas@1,8800000/sd@4,0 This operation will suspend activity on SCSI bus: c1

在 Continue (yes/no)? 提示符下键入 y 以继续操作。
正在执行热插拔操作的同时，SCSI 总线上的 I/O 活动会暂停。

Continue (yes/no)? y SCSI bus quiesced successfully. It is now safe to proceed with hotplug operation.

关闭要移除的设备的电源，然后将其移除。

添加替换设备。然后，关闭该设备的电源。
替换设备应该与要移除的设备类型相同并且具有同一地址（目标和 LUN）。

在 Enter y if operation is complete or n to abort (yes/no)? 提示符下键入 y。

Enter y if operation is complete or n to abort (yes/no)? y

验证是否已更换了设备。

SPARC: 如何移除 SCSI 设备
以下过程在移除 SCSI 控制器上的设备示例中使用 SCSI 磁盘 c1t4d0。

成为超级用户。

确定当前的 SCSI 配置。

从系统中移除 SCSI 设备。

键入以下 cfgadm 命令。
例如：

# cfgadm -x remove_device c1::dsk/c1t4d0 Removing SCSI device: /devices/sbus@1f,0/SUNW,fas@1,8800000/sd@4,0 This operation will suspend activity on SCSI bus: c1

在 Continue (yes/no)? 提示符下键入 y 以继续操作。

Continue (yes/no)? y SCSI bus quiesced successfully. It is now safe to proceed with hotplug operation.

正在执行热插拔操作的同时，SCSI 总线上的 I/O 活动会暂停。

关闭要移除的设备的电源，然后将其移除。

在 Enter y if operation is complete or n to abort (yes/no)? 提示符下键入 y。

Enter y if operation is complete or n to abort (yes/no)? y

验证是否已从系统中移除了设备。

对 SCSI 配置问题进行疑难解答
本节提供有关 SCSI 配置问题的错误消息和可能的解决方案。有关对 SCSI 配置问题进行疑难解答的更多信息，请参见 cfgadm(1M)。

错误消息

cfgadm: Component system is busy, try again: failed to offline: device-path Resource Information ------------------ -------------------------- /dev/dsk/c1t0d0s0 mounted filesystem "/file-system"

原因

尝试移除或更换已挂载文件系统的设备。

解决方案

取消挂载错误消息中列出的文件系统，并重试 cfgadm 操作。

错误消息

cfgadm: Component system is busy, try again: failed to offline: device-path Resource Information ------------------ -------------------------- /dev/dsk/device-name swap area

原因

如果使用 cfgadm 命令移除系统资源（如交换设备或专用转储设备），则在系统资源仍然处于活动状态时将显示一条类似的错误消息。

解决方案

取消配置指定设备上的交换区域，并重试 cfgadm 操作。

错误消息

cfgadm: Component system is busy, try again: failed to offline: device-path Resource Information ------------------ -------------------------- /dev/dsk/device-name dump device (swap)

原因

尝试移除或更换在交换区域中配置的转储设备。

解决方案

取消配置在交换区域中配置的转储设备，并重试 cfgadm 操作。

错误消息

cfgadm: Component system is busy, try again: failed to offline: device-path Resource Information ------------------ -------------------------- /dev/dsk/device-name dump device (dedicated)

原因

尝试移除或更换专用转储设备。

解决方案

取消配置该专用转储设备，并重试 cfgadm 操作。如何解析失败的 SCSI 取消配置操作
如果一个或多个目标设备繁忙并且 SCSI 取消配置操作失败，请使用此过程。否则，将来对此控制器和目标设备进行动态重新配置操作会失败，并会显示 dr in progress 消息。

成为超级用户。

重新配置控制器。

# cfgadm -c configure device-name

如何显示 PCI 插槽配置信息
此过程在 Solaris 10 6/06 发行版中已进行了更新，包括 PCIe 配置信息。
cfgadm 命令可显示系统上的 PCI 可热插拔设备和插槽的状态。有关更多信息，请参见 cfgadm(1M)。

成为超级用户。

显示 PCI 配置信息。

显示 PCI 插槽配置信息。
例如：

# cfgadm Ap_Id Type Receptacle Occupant Condition pci1:hpc0_slot0 unknown empty unconfigured unknown pci1:hpc0_slot1 unknown empty unconfigured unknown pci1:hpc0_slot2 unknown empty unconfigured unknown pci1:hpc0_slot3 ethernet/hp connected configured ok pci1:hpc0_slot4 unknown empty unconfigured unknown

显示特定的 PCI 设备信息。
例如：

# cfgadm -s "cols=ap_id:type:info" pci Ap_Id Type Information pci1:hpc0_slot0 unknown Slot 7 pci1:hpc0_slot1 unknown Slot 8 pci1:hpc0_slot2 unknown Slot 9 pci1:hpc0_slot3 ethernet/hp Slot 10 pci1:hpc0_slot4 unknown Slot 11

逻辑 Ap_Id pci1:hpc0_slot0 是可热插拔插槽 Slot 7 的逻辑 Ap_Id。组件 hpc0 表示此插槽的可热插拔适配卡，pci1 表示 PCI 总线实例。Type 字段表示插槽中存在的 PCI 适配卡的类型。
显示 PCIe 插槽配置信息。
例如：

# cfgadm pci Ap_Id Type Receptacle Occupant Condition pcie1 unknown empty unconfigured unknown pcie2 unknown empty unconfigured unknown pcie3 unknown empty unconfigured unknown pcie4 etherne/hp connected configured ok pcie5 pci-pci/hp connected configured ok pcie6 unknown disconnected unconfigured unknown

显示特定的 PCIe 设备信息。
例如：

# cfgadm -s "cols=ap_id:busy:o_state" pci Ap_Id Busy Occupant pcie1 n unconfigured pcie2 n unconfigured pcie3 n unconfigured pcie4 n configured pcie5 n configured pcie6 n configured

--------------------------------------------------------------------------------
注 –
在大多数情况下，逻辑 Ap_Id 都应该与系统机箱上用丝网印花法标记的插槽标签匹配。有关可热插拔插槽的 cfgadm 输出，请参阅平台指南。显示 Busy 字段可确保尝试热插拔操作之前 Ap_Id 未转换为其他状态。

--------------------------------------------------------------------------------

如何移除 PCI 适配卡
在 Solaris 10 6/06 发行版中，以下过程已经更新，可用于移除 PCIe 适配卡。但是，无论使用 PCI 还是 PCIe，移除适配卡的过程都是相同的。

成为超级用户。

确定 PCI 适配卡所在的插槽。
例如：

停止用于打开设备的应用程序。
例如，如果设备是一块以太网卡，请使用 ifconfig 命令停用相应的接口，并取消检测该接口。

按照如下方式使用 cfgadm(1M) 命令手动取消配置设备。或者，如果您有 PCIe 适配卡，也可使用自动配置方法，如按平台指南中定义的方式按插槽的“注意”按钮。

# cfgadm -c unconfigure pcie4

确认是否已取消配置设备。
例如：

# cfgadm pci Ap_Id Type Receptacle Occupant Condition pcie1 unknown empty unconfigured unknown pcie2 unknown empty unconfigured unknown pcie3 unknown empty unconfigured unknown pcie4 unknown connected unconfigured unknown pcie5 pci-pci/hp connected configured ok pcie6 unknown disconnected unconfigured unknown

--------------------------------------------------------------------------------
注 –
如果取消配置设备，则 Type 和 Condition 也将成为 unknown。

--------------------------------------------------------------------------------

手动断开插槽的电源。如果使用自动配置方法，则此步骤是不必要的。有关更多信息，请参阅平台指南。

# cfgadm -c disconnect pcie4

确认是否已断开设备连接。
例如：

# cfgadm pci Ap_Id Type Receptacle Occupant Condition pcie1 unknown empty unconfigured unknown pcie2 unknown empty unconfigured unknown pcie3 unknown empty unconfigured unknown pcie4 unknown disconnected unconfigured unknown pcie5 pci-pci/hp connected configured ok pcie6 unknown disconnected unconfigured unknown

遵照平台指南中的相应说明移除 PCI 适配卡。移除该卡后，插座状态即为空。
例如：

# cfgadm pci Ap_Id Type Receptacle Occupant Condition pcie1 unknown empty unconfigured unknown pcie2 unknown empty unconfigured unknown pcie3 unknown empty unconfigured unknown pcie4 unknown empty unconfigured unknown pcie5 pci-pci/hp connected configured ok pcie6 unknown disconnected unconfigured unknown

--------------------------------------------------------------------------------
注 –
可以在引导时启用或禁用自动配置方法，具体取决于平台的实现。请针对环境设置合适的自动配置方法。

--------------------------------------------------------------------------------

如何添加 PCI 适配卡
在 Solaris 10 6/06 发行版中，以下过程已经更新，可用于添加 PCIe 适配卡。但是，无论使用 PCI 还是 PCIe，添加适配卡的过程都是相同的。

成为超级用户。

标识可热插拔的插槽并打开锁。
例如，pcie3。

# cfgadm pci Ap_Id Type Receptacle Occupant Condition pcie1 unknown empty unconfigured unknown pcie2 unknown empty unconfigured unknown pcie3 unknown empty unconfigured unknown pcie4 unknown empty unconfigured unknown pcie5 pci-pci/hp connected configured ok pcie6 unknown disconnected unconfigured unknown

遵照平台指南中的相应说明将 PCI 适配卡插入插槽。

确定插入 PCI 适配卡后该卡所在的插槽。
例如：

# cfgadm pci Ap_Id Type Receptacle Occupant Condition pcie1 unknown empty unconfigured unknown pcie2 unknown empty unconfigured unknown pcie3 unknown disconnected unconfigured unknown pcie4 unknown empty unconfigured unknown pcie5 pci-pci/hp connected configured ok pcie6 unknown disconnected unconfigured unknown

使用 cfgadm 命令手动连接插槽的电源。或者，如果您有 PCIe 适配卡，也可使用自动配置方法，如按平台指南中定义的方式按插槽的“注意”按钮。
例如：

# cfgadm -c connect pcie3

确认附加点已连接。
例如：

# cfgadm pci Ap_Id Type Receptacle Occupant Condition pcie1 unknown empty unconfigured unknown pcie2 unknown empty unconfigured unknown pcie3 unknown connected unconfigured unknown pcie4 unknown empty unconfigured unknown pcie5 pci-pci/hp connected configured ok pcie6 unknown disconnected unconfigured unknown

按照如下方式使用 cfgadm 命令手动配置 PCI 适配卡。如果使用自动配置方法，此步骤应该是不必要的。有关更多信息，请参阅平台指南。
例如：

# cfgadm -c configure pcie3

验证插槽中的 PCI 适配卡的配置。
例如：

# cfgadm pci Ap_Id Type Receptacle Occupant Condition pcie1 unknown empty unconfigured unknown pcie2 unknown empty unconfigured unknown pcie3 etherne/hp connected configured unknown pcie5 pci-pci/hp connected configured ok pcie6 unknown disconnected unconfigured unknown

如果此设备为新设备，请配置任何支持的软件。
例如，如果此设备是一块以太网卡，请使用 ifconfig 命令来设置接口。

--------------------------------------------------------------------------------

对 PCI 配置问题进行疑难解答

错误消息

cfgadm: Configuration operation invalid: invalid transition

原因

尝试进行无效转换。

解决方案

检查是否正确发出了 cfgadm -c 命令。使用 cfgadm 命令检查当前的插座和插卡状态，并确保 Ap_Id 正确。

错误消息

cfgadm: Attachment point not found

原因