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

简明调用示例

首先,必须通过源端口标识 1 使用目标 ISCSI 控制器 的 IPv4 IP 地址来指定目标发现。无需任何 tgt_user_nametarget_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_nametarget_chap 值。 此系统中仅有两个 I/O 组:03

要查看输出,请指定以下命令:

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