lsiscsistorageportcandidate

使用 lsiscsistorageportcandidate 命令来显示有关以下信息的简明或详细列表：通过来自指定发起程序源端口的目标 IP 指定的候选因特网小型计算机系统接口 (iSCSI) 目标控制器 iSCSI 限定名 (IQN)。

语法

lsiscsistorageportcandidate [ -nohdr ] [ -delim delimiter ] [ { -node { node_id | node_name } } ] [ lsiscsistorageportcandidate-rowid ]

参数

-nohdr: （可选）缺省情况下，将在简明样式视图中显示每个数据列的标题，在详细样式视图中显示每个数据项的标题。 -nohdr 参数用于禁止显示这些标题。
Note: 如果没有可供显示的数据，那么不会显示标题。
-nodenode_name | node_id: （可选）
指定系统中节点的标识或名称。该值必须是字母数字字符串。
-delim delimiter: （可选）缺省情况下，简明视图中的所有数据列都以空格分隔。每列的宽度设置为每个数据项的最大宽度。在详细视图中，每个数据项各占一行，如果显示标题，将用空格来分隔数据与标题。 -delim 参数会覆盖此行为。 -delim 参数的有效输入为一个单字节字符。如果在命令行中输入 -delim :，那么在简明视图中将用冒号字符 (:) 分隔所有数据项；例如，不会出现列间距。在详细视图中，数据与标题间以指定的定界符分隔。
lsiscsistorageportcandidate-rowid: （可选）指定简明视图中显示的行标识，以提供有关所发现的门户网站 IP 的详细信息视图。

描述

此命令列出有关最后一次调用 detectiscsistorageportcandidate 命令的信息。此命令还可显示两种类型的列表：

简明信息列表，其中包含有关指定发起程序端口的指定目标 IP 上显示的候选 iSCSI 目标控制器 IQN 的信息，并指出哪些发起程序端口能够看到所发现的每一个 iSCSI 目标 IQN。
有关最后一次调用 detectiscsistorageportcandidate 命令期间发现的所有目标控制器门户网站 IP 的详细信息。

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

Table 1. lsiscsistorageportcandidate 输出
属性	描述
id	指示发现输出的行标识。在使用 lsiscsistorageportcandidate 命令前输入 detectiscsistorageportcandidate 命令。首先显示简明视图，每个 IQN 显示一行。使用来自简明视图的行标识以指定 lsiscsistorageportcandidate`lsiscsistorageportcandidate-rowid` 命令的详细视图。详细视图针对 IQN 显示所发现目标 IP 地址的列表。
src_port_id	指示源端口标识。该值必须是 1 到 8 之间的数字。
target_ipv4	指示目标 IPv4 地址。
target_ipv6	指示目标 IPv6 地址。
target_iscsiname	指示使用目标控制器的（已发现）IQN。该值是长度为 256 个字符的字母数字字符串。
iogroup_list	指示发现结果代码的冒号分隔列表：该值必须是长度最多为 32 个字符的字母数字字符串。此字段不能为空白。值为 `0` 和 `1`： `0` 指示 I/O 组在系统中可用，但未通过 I/O 组触发发现，或通过 I/O 组执行发现失败。 `1` 指示 I/O 组存在，并通过 I/O 组成功执行发现。 Note: 值 `-`（短划线）指示 I/O 组无效或者不存在于系统中。
status	指示发现是否成功。状态为以下值之一： `full` `partial` `none`
configured	指示已发现的目标 IQN 是否与源端口或目标端口建立了任何会话。值为 `yes` 和 `no`（缺省值）。
site_id	指示站点标识（如果正在发现的节点属于站点）。该属性适用于 HyperSwap 系统。
site_name	指示站点名称（如果正在发现的节点属于站点）。该属性适用于 HyperSwap 系统。
SendTargets Portal IPs	提供通过使用 detectiscsistorageportcandidate 命令发现的所有目标门户网站 IP（最多 32 个）的列表。

简明调用示例

首先，必须通过源端口标识 1 使用目标 ISCSI 控制器的 IPv4 IP 地址来指定目标发现。无需任何 tgt_user_name 或 target_chap 值。

detectiscsistorageportcandidate –srcportid 1 -targetip 10.10.10.1

要查看输出，请指定以下命令：

lsiscsistorageportcandidate

将显示以下生成的简明输出：

id  src_port_id target_ipv4 target_ipv6 target_iscsiname  iogroup_list configured status site_id site_name
0   1           10.10.10.1              IQN1              1:1:1:1        no       Full

简明调用示例

此示例通过 I/O 组 0 和源端口标识 0 使用目标 ISCSI 控制器的 IPv4 IP 地址来显示目标发现：

detectiscsistorageportcandidate -iogrp 0 –srcportid 1 -targetip IP2  –username superuser –chapsecret password2

使用 tgt_user_name 和 target_chap 值。此系统中仅有两个 I/O 组：0 和 3。

要查看输出，请指定以下命令：

lsiscsistorageportcandidate

将显示以下生成的简明输出：

id  src_port_id target_ipv4 target_ipv6 target_iscsiname  iogroup_list configured status site_id site_name
0   1       IP2                  IQN1       1:-:-:0        no       Full
1   1       IP2                  IQN2       1:-:-:0        no       Full
2   1       IP2                  IQN3       1:-:-:0        no       Full

详细调用示例

首先，必须通过源端口标识 1 和目标 IP 地址使用目标 ISCSI 控制器的 IPv4 IP 地址来指定目标发现。

detectiscsistorageportcandidate –srcportid 1 -targetip 10.10.10.1

简明视图中每个 IQN 一行，如第一个简明视图示例中所示。简明视图中的每个行标识都确定了一个 iSCSI 限定名 (IQN)。要查看 IQN 的详细信息，请指定行标识 (id)：

lsiscsistorageportcandidate 0

生成的输出针对 IQN 列出了所发现门户网站 IP 地址的详细信息：

SendTargets Portal IPs
10.10.10.1
10.10.10.2
fe:65::00:01
fe:65::00:02