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

过于简略
不易阅读或难以理解
重要信息缺失
错误的内容
需要翻译的版本
--选择-- 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_fp

- 驱动程序专用 cfgadm 命令

用法概要

/usr/sbin/cfgadm [-f] [-n | -y] [-v] [-o hardware_options]
     -c function ap_id [ap_id]

/usr/sbin/cfgadm [-v] [-a] [-s listing_options] 
     [-o hardware_options] [-l [ap_id]]

/usr/sbin/cfgadm [-v] [-o hardware_options] -h [ap_id]

描述

fp 端口驱动程序插件 /usr/lib/cfgadm/fp.so.1 提供通过 cfgadm(1M) 管理光纤通道光纤网络设备节点的功能。cfgadm 在连接点上运行。连接点是可动态重新配置硬件资源的系统位置。有关连接点的其他详细信息，请参见 cfgadm(1M)。

对于光纤通道光纤设备节点管理，每个 fp 端口节点采用设备树中的一个连接点表示。此外，每个光纤通道设备还采用一个动态连接点表示。连接点通过 ap_id 命名。定义下列两种类型的 ap_id：逻辑和物理。物理 ap_id 基于物理路径名。逻辑 ap_id 是更短、更加用户友好的名称。对于 fp 端口节点，逻辑 ap_id 为对应的磁盘控制器号。例如，c0 是一个典型的逻辑 ap_id。

光纤通道设备使用端口全球名称 (World Wide Name, WWN) 命名。如果一个磁盘设备连接到控制器 c0，其 ap_id 可以是：

c0::50020f2300006077

其中 50020f2300006077 用于标识特定光纤通道设备的端口 WWN。

缺省情况下，对光纤通道专用环路端口、光纤网络端口或公共环路端口上的每个设备进行探测，并使其可供 Solaris 使用。通过启动应用程序或最终用户操作，可使连接到光纤通道光纤网络端口或公共环路端口的设备不可供 Solaris 使用。此操作类似于通过管理用户接口的方法热拔除设备。应用程序或用户可以使用 /usr/lib/cfgadm/fp.so.1 库来启用 libcfgadm 提供接口以完成此任务。

当前连接的光纤设备列表以连接点的形式生成。

此系统中的连接点简单列表包括 fp 端口节点（非光纤通道设备）中的连接点。以下示例使用列表选项 (-l) 的 -a 标志来列出光纤通道设备：

# cfgadm -l
     Ap_Id                Type         Receptacle   Occupant     Condition
     c0                   fc-fabric    connected    configured   unknown
     c1                   fc-private   connected    configured   unknown
     c2                   fc-pt_to_pt  connected    configured   unknown
     c3                   fc           connected    unconfigured unknown
     sysctrl0:slot0       cpu/mem      connected    configured   ok
     sysctrl0:slot1       sbus-upa     connected    configured   ok

以下示例列出了连接到 fp 端口的光纤通道设备。

# cfgadm -al
     Ap_Id                Type         Receptacle   Occupant     Condition
     c0                   fc-fabric    connected    configured   unknown
     c0::50020f2300006077 disk         connected    configured   unknown
     c0::50020f23000063a9 disk         connected    configured   unknown
     c0::50020f2300005f24 disk         connected    configured   unknown
     c0::50020f2300006107 disk         connected    configured   unknown
     c1                   fc-private   connected    configured   unknown
     c1::220000203708b69c disk         connected    configured   unknown
     c1::220000203708ba7d disk         connected    configured   unknown
     c1::220000203708b8d4 disk         connected    configured   unknown
     c1::220000203708b9b2 disk         connected    configured   unknown
     c2                   fc-pt_to_pt  connected    configured   unknown
     c2::500104f000937528 tape         connected    configured   unknown
     c3                   fc           connected    unconfigured unknown
     sysctrl0:slot0       cpu/mem      connected    configured   ok
     sysctrl0:slot1       sbus-upa     connected    configured   ok

在此示例中，fc-fabric 类型的 ap_id c0 指示 fp 端口与光纤网络相连。对于具有光纤网络相关类型（例如 fc-fabric 和 fc-public ）的 fp 端口，缺省情况下在引导时创建设备节点并可通过 cfgadm 配置与取消配置操作进行管理。fc-private 类型的 ap_id c1 指示 fp 端口连接到专用环路且缺省情况下也创建设备节点。fc-pt_to_pt 类型的 ap_id c2 指示 fp 端口直接连接到另一个 N_port 且缺省情况下也创建设备节点。fc 类型的 ap_id c3 指示 fp 端口 c2 未与任何对象相连。光纤通道设备 ap_id 的 "Type"（类型）字段显示了设备中 LUN 0 的 SCSI 设备类型。

在 Solaris 中配置了具有多个 FCP SCSI LUN 的光纤通道设备，其中每一个 FCP SCSI LUN 均可作为一个 Solaris 设备使用。假定 ap_id c0::50020f2300006077 和 c0::50020f23000063a9 表示具有多个 FCP SCSI LUN 的光纤通道设备。

以下示例显示了如何列出具有 FCP SCSI LUN 的 ap_id 的信息：

# cfgadm -al -o show_SCSI_LUN
     Ap_Id                  Type         Receptacle   Occupant     Condition
     c0                     fc-fabric    connected    configured   unknown
     c0::50020f2300006077,0 disk         connected    configured   unknown
     c0::50020f2300006077,1 disk         connected    configured   unknown
     c0::50020f2300006077,2 disk         connected    configured   unknown
     c0::50020f2300006077,3 disk         connected    configured   unknown
     c0::50020f23000063a9,0 disk         connected    configured   unknown
     c0::50020f23000063a9,1 disk         connected    configured   unknown
     c0::50020f23000063a9,2 disk         connected    configured   unknown
     c0::50020f23000063a9,3 disk         connected    configured   unknown
     c0::50020f2300005f24,0 disk         connected    unconfigured unknown
     c0::50020f2300005f24,1 disk         connected    unconfigured unknown
     c0::50020f2300006107,0 disk         connected    unconfigured unknown
     c0::50020f2300006107,1 disk         connected    unconfigured unknown
     c1                     fc-private   connected    configured   unknown
     c1::220000203708b69c,0 disk         connected    configured   unknown
     c1::220000203708ba7d,0 disk         connected    configured   unknown
     c1::220000203708b8d4,0 disk         connected    configured   unknown
     c1::220000203708b9b2,0 disk         connected    configured   unknown
     c2                     fc-pt_to_pt  connected    configured   unknown
     c2::500104f000937528,0 tape         connected    configured   unknown
     c3                     fc           connected    unconfigured unknown

在此示例中，ap_id c0::50020f2300006077,0 标识光纤通道设备的 FCP SCSI LUN 0，采用端口 WWN 50020f2300006077 表示。根据报告，光纤通道设备具有 4 个 FCP SCSI LUN，并且这些 FCP SCSI LUN 均已配置。列出了与端口 WWN 50020f2300006077 相关联的 4 个 FCP SCSI LUN 级别 ap_id。此列表还显示了未配置的光纤通道设备的 FCP SCSI LUN。c0::50020f2300005f24 所代表的光纤通道设备被报告为具有两个 FCP SCSI LUN。配置操作 on c0::50020f2300005f24 将创建两个 Solaris 设备。FCP SCSI LUN 级别 ap_id 的 Type（类型）字段显示每个 LUN 的 SCSI 设备类型。如果光纤通道设备具有不同的设备类型 LUN，Type（类型）字段会反映出来。

fp 端口上的连接点插口和插卡状态具有下列含义：

configured（已配置）

在 fp 端口上配置了一个或多个设备

connected（已连接）

fp 端口处于活动状态

disconnected（断开）

fp 端口停止（IO 活动暂停）

empty（空）

不适用

unconfigured（未配置）

在 fp 端口上未配置任何设备

fp 端口上各光纤通道设备的状态：

configured（已配置）

设备已在 Solaris 中配置并可供使用

connected（已连接）

设备连接的 fp 端口处于活动状态

disconnected（断开）

设备连接的 fp 端口处于停止状态

unconfigured（未配置）

可配置设备

fp 端口上的连接点 condition（状态）字段具有下列含义：

failed（失败）

一个错误状态已阻止 fp 端口检测光纤通道连接的存在情况或类型的功能。

fp 端口上各光纤通道设备的 condition（状态）字段具有下列含义：

failed（失败）

在光纤网络上探测设备时发生错误。

FAILED

在主机上配置了一个设备且其状态在 Solaris 上显示为正常（即，联机），但是该设备目前不存在或在光纤网络上不显示，或者因为用于配置该设备的本地端口上存在错误状态，该设备的存在情况无法验证。

unusable（不可用）

已在主机上配置设备，但其目前处于脱机状态或存在故障。

condition（状态）为 unknown 指示在光纤网络上探测设备已完成且没有错误，并且如果之前配置了该设备，Solaris 主机中的设备状态为正常。无法保证设备的内部状态。

选项

除列出 (-l) 外，cfgadm 还定义了一些类型的操作。这些操作包括调用配置状态更改以及获取配置管理帮助消息 (-h)。

支持以下选项：

-c function

为 fp 传输特定库定义了下列通用命令：

对于 fc-fabric 类型 fp 端口连接点上的光纤通道设备连接点，支持下列配置状态更改操作：

configure

配置连接到主机的光纤通道光纤网络设备。如果在列表操作的输出中将光纤通道设备列为 unknown（未知）类型，可能无法配置该设备。未尝试配置类型为 unknown（未知）的设备。可使用强制选项 (-f) 来强制 fp 端口驱动程序插件尝试配置任意设备。报告进程中的任何错误。缺省情况下，在光纤通道光纤网络设备上发现的每个 FCP SCSI LUN 都进行了配置。但是，在 fp.conf 文件的 "pwwn-lun-blacklist" 属性中指定的 FCP SCSI LUN 仍将处于 unconfigured（未配置）状态。FCP SCSI LUN 级别列表反映了这些 FCP SCSI LUN 的状态。重新引导或在连接的控制器上 Solaris 动态重新配置之后，它们仍会处于 unconfigured（未配置）状态。有关 "pwwn-lun-blacklist" 属性的更多详细信息，请参见 fp(7d)。

unconfigure

在主机上取消配置光纤通道光纤网络设备。在下次重新引导或在连接该设备的控制器上 Solaris 动态重新配置之前，该设备保持处于 unconfigured（未配置）状态，而届时所有光纤网络设备都会自动枚举。通过使用 fp.conf 文件中的 "manual_configuration_only" 属性可以更改缺省的行为。如果设置了该属性，设备会在重新引导后仍处于 unconfigured（未配置）状态。有关 "manual_configuration_only" 属性的更多详细信息，请参见 fp(7d)。

对于光纤通道专用环路设备和 N_Port 点到点设备，configure 命令返回成功，但不会执行任何操作。unconfigure 命令在专用环路设备和 N_Port 点到点设备上不受支持。缺省情况下，专用环路设备和 N_Port 点到点设备由 Solaris 光纤通道驱动程序配置，且不通过最终用户或应用程序启动的操作进行管理。fp.conf 文件中的 pwwn-lun-blacklist 属性以与应用于光纤网络设备相同的方式应用于专用环路设备和 N_Port 点到点设备。

-f

强制实施 configure 更改状态操作，无论 condition（状态）或 type（类型）为何。请参见上述有关 configure 更改状态操作的说明。

-h ap_id

获取 fp 传输特定帮助。指定任意 fp 连接点。

-o hardware_options

支持下列硬件选项。

show_SCSI_LUN

如果使用 list 选项 -al 指定，列出与发现的光纤通道设备的每个 FCP SCSI LUN 相关联的 ap_id。请参见上述 FCP SCSI LUN 级别列表的说明和示例。在 FCP SCSI LUN 级别上不支持设备节点创建。请参见“附注”部分。

缺省情况下，所有光纤通道设备对 Solaris 都可用。通过设置 /kernel/drv/fp.conf 文件中的属性 "manual_configuration_only"，可完成在缺省情况下仅启用对 Solaris 可用的光纤网络设备的子集。设置了 fp.conf 中的 "manual_configuration_only" 时，除非应用程序或最终用户之前已请求在 Solaris 中配置该设备，否则所有光纤网络设备对 Solaris 均不可用。configure 状态更改命令使该设备对 Solaris 可用。在光纤网络设备上成功执行 configure 操作之后，将相关链接添加到 /dev 名称空间。unconfigure 状态更改命令使设备对 Solaris 不可用。

使用 -c configure 操作在主机上成功配置了光纤通道光纤网络设备时，其物理 ap_id 存储在系统信息库中。使用 -c unconfigure 操作取消光纤通道光纤网络设备配置时，从该系统信息库中删除物理 ap_id。缺省情况下，自动枚举所有光纤网络设备，且仅当设置了 fp.conf 中的 "manual_configuration_only" 属性时才使用该系统信息库。有关 "manual_configuration_only" 属性的更多详细信息，请参见 fp(7d)。

可以使用 -c 选项指定下列命令以控制系统信息库的更新行为：

force_update

对于 configure，无条件地将连接点添加到系统信息库；对于 unconfigure，无条件地删除连接点。

no_update

无论实施任何操作，均不更新系统信息库。

对于正常的 configure 和 unconfigure 操作，不应使用这些选项。请参见“警告”部分。

如果为一个光纤通道设备配置了多个 FCP SCSI LUN 且与其 FCP SCSI LUN 相关联的任意 Solaris 处于不可用状态，将整个光纤通道设备报告为不可用。在使用 -c unconfigure 命令的情况下的以下选项仅移除光纤通道设备的处于不可用状态的 Solaris 设备。

unusable_SCSI_LUN

对于 unconfigure 操作，移除目标设备的任何脱机的设备节点。

-s listing_options

有关用法信息，请参见 cfgadm(1M)。

-t ap_id

目前没有可用的测试命令。

-x hardware_function

目前没有可用的硬件专用函数。

所有其他选项的含义与 cfgadm(1M) 手册页中定义的含义相同。

示例

示例 1 取消配置磁盘

以下命令可用于取消配置磁盘：

# cfgadm -c unconfigure c0::210000203708b606

示例 2 取消配置单个连接点下的所有配置的磁盘

以下命令取消配置 c0 连接点下的所有配置的磁盘。

# cfgadm -c unconfigure c0

示例 3 配置磁盘

以下命令配置磁盘：

# cfgadm -c configure c0::210000203708b606

示例 4 配置单个连接点下的所有未配置的磁盘

以下命令配置连接点 c0 下的所有未配置的磁盘。

# cfgadm -c configure c0

示例 5 从系统信息库中移除光纤通道光纤网络设备连接点

以下命令从光纤设备系统信息库中无条件地移除光纤通道光纤设备连接点。

# cfgadm -c unconfigure -o force_update c0::210000203708b606

示例 6 从目标设备中移除脱机的 Solaris 设备节点

以下命令从目标设备中移除脱机的 Solaris 设备节点：

# cfgadm -c unconfigure -o unusable_SCSI_LUN c0::210000203708b606

文件

/usr/lib/cfgadm/fp.so.1

光纤通道光纤网络设备节点管理的硬件专用库。

/etc/cfg/fp/fabric_WWN_map

当前配置的光纤网络设备的物理 ap_id 的系统信息库。仅用于在引导时重新配置这些光纤网络设备。仅当设置了 /kernel/drv/fp.conf 文件中的 "manual_configuration_only" 时才使用该系统信息库。

/etc/rcS.d/fdevattach

重新配置引导时物理 ap_id 在 /etc/cfg/fp/fabric_WWN_map 中列出的光纤网络设备。

属性

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

另请参见

svcs(1)、cfgadm(1M)、svcadm(1M)、config_admin(3CFGADM)、libcfgadm(3LIB)、attributes(5)、smf(5)、fp(7d)

警告

对于正常 configure/unconfigure 操作下的系统信息库更新，请勿使用硬件专用选项。如果当引导时光纤网络设备的节点创建失败且错误状态被认为是永久性的，希望使用硬件专用选项。带 force_update 硬件专用选项的 unconfigure 命令从系统信息库中无条件地移除存在故障的光纤设备连接点。

附注

对于具有未知或无 SCSI 设备类型的设备（例如，光纤通道主机总线适配器），configure 操作可能不适用。

configure 和 unconfigure 命令在由端口 WWN ap_id 表示的光纤通道设备级别上运行。如果为一个光纤通道设备配置了多个 FCP SCSI LUN，关联端口 WWN ap_id 上的 configure 命令用于为每个 FCP SCSI LUN 创建一个 Solaris 设备，除非使用 fp.conf 文件中的 "pwwn-lun-blacklist" 属性进行了指定。unconfigure 命令移除所有与端口 WWN ap_id 相关联的 Solaris 设备。FCP SCSI LUN 级别 ap_id 对于 configure 和 unconfigure 命令无效。

过时的 show_FCP_dev 选项已被新的 show_SCSI_LUN 选项代替，且过时的 unusable_FCP_dev 选项已被新的 unusable_SCSI_LUN 选项代替。

cfgadm_fp 服务由服务管理工具 smf(5) 管理，其服务标识符为：

svc:/system/device/fc-fabric:default

可以使用 svcadm(1M) 来对此服务执行管理操作（如启用、禁用或请求重新启动）。可以使用 svcs(1) 命令来查询服务的状态。

引导时启动此服务后，对于光纤网络设备配置，无需实施此服务的管理操作。