lscontroller

使用 lscontroller 命令可显示系统可见的控制器的简明列表或详细视图。

语法

lscontroller [ -filtervalueattribute=value ] [ -nohdr ] [ -delim delimiter ] [ -filtervalue? ] [ { controller_id | controller_name } ]

参数

-filtervalueattribute=value

（可选）指定一个或多个过滤器的列表。仅返回值与过滤器属性值匹配的对象。如果指定了容量，那么还必须包含单位。

Note: 某些过滤器允许您在输入命令时使用通配符。以下规则适用于将通配符用于 CLI 的情况：

通配符为星号 (*)。
命令最多可包含一个通配符，并且该通配符必须是字符串中的第一个或最后一个字符。

-filtervalue?

（可选）显示有效的过滤器属性。 lscontroller 命令的以下过滤器属性有效：

controller_name
id

-nohdr

（可选）缺省情况下，将在简明样式视图中显示每个数据列的标题，在详细样式视图中显示每个数据项的标题。 -nohdr 参数用于禁止显示这些标题。

Note: 如果没有要显示的数据，那么不会显示标题。

-delimdelimiter

（可选）缺省情况下，简明视图中的所有数据列都以空格分隔。每列的宽度设置为每个数据项的最大宽度。在详细视图中，每个数据项各占一行，如果显示标题，将用空格来分隔数据与标题。 -delim 参数会覆盖此行为。 -delim 参数的有效输入为一个单字节字符。如果在命令行中输入 -delim :，那么在简明视图中将用冒号字符 (:) 分隔所有数据项；例如，不会出现列间距。在详细视图中，数据与标题间以指定的定界符分隔。

controller_id | controller_name

（可选）指定控制器的名称或标识。使用此参数时，将返回特定控制器的详细视图，而忽略 -filtervalue 参数指定的任何值。如果未指定 controller_id | controller_name 参数，那么简明视图将显示与 -filtervalue 参数指定的过滤需求相匹配的所有控制器。

描述

此命令返回对系统可见的控制器的简明列表或详细视图。

以下值适用于输出视图中的数据：

degraded no, yes

要区分存储控制器的名称与系统上显示的名称，请通过发出 lscontroller 命令来列出存储控制器。记录您希望确定的控制器的名称或标识。对于当前讨论的控制器，请发出 lscontrollercontroller name | id 命令，其中 controller name | id 是控制器名称或标识。记录该控制器的全球节点名 (WWNN)。可使用 WWNN 确定实际存储控制器，方法是启动本机控制器用户界面或使用它提供的命令行工具来验证具有该 WWNN 的实际控制器。

备注:

mdisk_link_count 值是当前与该存储控制器关联的 MDisk 的数量。
max_mdisk_link_count 值是 mdisk_link_count 自上次重置为 mdisk_link_count 值之后所达到的最高值。
Remember: 该值由特定的维护过程重置或在清除事件日志时重置。
从节点或节点容器端口到单个 MDisk 的控制器端口的 SAN 连接是一条路径。控制器端口 path_count 值是当前用于向此控制器端口提交输入/输出 (I/O) 数据的路径数。
存储控制器 max_path_count 值是存储控制器 path_count 自上次重置为 path_count 值之后所达到的最高值。该值由特定的维护过程重置或在清除系统错误日志时重置。
Important: max_path_count 值是 path_count 自上次重置为 path_count 值之后所达到的最高值。

Remember: 该值由特定的维护过程重置或在清除事件日志时重置。
allow_quorum 值指示是否启用了控制器来支持定额磁盘。定额支持处于启用还是禁用状态取决于控制器硬件类型。
ctrl_s/n 值是控制器序列号。
Important: 此数据来自供应商控制的源，并且可能不可用。

lscontroller 输出提供了可显示为输出视图数据的属性值。

下表提供可显示为输出视图数据的属性值。

Table 1. lscontroller 输出
属性	可能的值
id	指示控制器标识。
name	指示控制器名称。
WWNN	指示全球节点名 (WWNN)。对于 iSCSI 控制器，该字段为空白。
mdisk_link_count	指示 MDisk 链接计数。
max_mdisk_link_count	指示最大 MDisk 链接计数。
degraded	指示控制器是否具有已降级的 MDisk。
vendor_id	指示供应商标识名称或编号。
product_id_low	指示产品标识。
product_id_high	指示产品标识。
product_revision	指示产品修订版。
ctrl_s/n	指示控制器序列号。
allow_quorum	指示控制器可以支持定额磁盘。
WWPN	指示全球端口名 (WWPN)。对于 iSCSI 控制器，该字段为空白。
path_count	指示当前用于向控制器端口提交输入/输出 (I/O) 数据的路径数。
max_path_count	指示当前用于向控制器端口提交输入/输出 (I/O) 数据的最大路径数。
site_id	指示控制器的站点值。此数字值为 `1`、`2`、`3` 或空白。
site_name	指示控制器的站点名称。该值是字母数字值或为空白。
fabric_type	指示光纤通道 (FC) 或 SAS 控制器。 `fc` 指示 FC 控制器 `sas_direct` 指示 SAS 直接连接控制器 `multiple` 指示多个控制器（FC 和/或 SAS） `iscsi` 表示 iSCSI 控制器
iscsi_port_id	指示 I/O 端口标识，与 FC 域中的 WWPN 值相同。对于 iSCSI 控制器，此值表示 iSCSI 端口标识；对于其他控制器，此值为空。此值必须是数字值。此标识引用 lsiscsistorageport 命令输出中的行号。 lsiscsistorageport 可以用于查找控制器 IQN。
ip	指示与 `iscsi_port_id` 关联的 IP 地址。该值显示 iSCSI 控制器的 IP 值，对于其他控制器而言为空。该值必须为 IPv4 或 IPv6 地址。
physical_capacity	指示控制器的物理容量。对于不报告物理容量信息的控制器，该值始终为空。

iSCSI 控制器的简明调用示例

lscontroller -delim :

生成的简明输出：

id:controller_name:ctrl_s/n:vendor_id:product_id_low:product_id_high:WWNN:degraded:fabric_type:site_id:site_name
0:controller0::IBM:1726-4xx:FAStT::no:iscsi:1:snpp1
1:controller1::IBM:1726-4xx:FAStT::no:iscsi:2:snpp2
7:controller7:3EK0J5Y8:SEAGATE :ST373405:FC:200600A0B851061E:yes:fc:1:snpp1
8:controller8:3EK0J6CR:SEAGATE :ST373405:FC:200600A0B851061D:no:fc:2:snpp2
9:controller9:3EK0J4YN:SEAGATE :ST373405:FC:200600A0B851061C:no:fc:3:snpp3
10:controller10:3EK0GKGH:SEAGATE :ST373405:FC:200600A0B851061B:no:fc:1:snpp4
11:controller11:3EK0J85C:SEAGATE :ST373405:FC:200600A0B851061A:no:fc:2:snpp5
12:controller12:3EK0JBR2:SEAGATE :ST373405:FC:200600A0B851062A:no:fc:3:snpp6
13:controller13:3EKYNJF8:SEAGATE :ST373405:FC:200600A0B851062B:no:fc:1:snpp7
14:controller14:3EK0HVTM:SEAGATE :ST373405:FC:200600A0B851062C:no:fc:2:snpp8

光纤通道控制器的详细调用示例

lscontroller -delim = 7

生成的详细输出：

id=7
controller_name=controller7
WWNN=20000004CF2412AC
mdisk_link_count=1
max_mdisk_link_count=1
degraded=no
vendor_id=SEAGATE 
product_id_low=ST373405
product_id_high=FC      
product_revision=0003
ctrl_s/n=3EK0J5Y8
allow_quorum=no

WWPN=22000004CF2412AC
path_count=1
max_path_count=1
WWPN=21000004CF2412AC
path_count=0
max_path_count=0
fabric_type=sas_direct
iscsi_port_id=
ip=physical_capacity=20.0GB

iSCSI 控制器的详细调用示例

lscontroller 0

生成的详细输出：

id 0
controller_name controller0
WWNN 
mdisk_link_count 4
max_mdisk_link_count 4
degraded no
vendor_id IBM
product_id_low 1726-4xx
product_id_high   FAStT
product_revision 0617
ctrl_s/n
allow_quorum no
fabric_type iscsi
site_id
site_name
WWPN
path_count 4
max_path_count 4
iscsi_port_id 1
ip 10.10.10.1
WWPN
path_count 4
max_path_count 4
iscsi_port_id 2
ip 10.10.10.2
physical_capacity 40.0GB