lshostiplogin

使用 svcinfo lshostiplogin 命令可列出主机的登录会话类型和其他详细信息，这些主机由其 iSCSI 限定名 (IQN) 来标识，并已登录到使用 IP 地址配置的以太网端口。

语法

svcinfo lshostiplogin { id | name } [ -filtervalueattribute=value ] [ -filtervalue? ]

参数

id

（可选）用于指示已配置的主机 IQN 的对象标识，将显示该主机的登录详细信息。该值必须为 0 到 2047 之间的数字（每个 SVC 集群的已配置 iSCSI/iSER IQN 的最大数量 [512 x 4 = 2048]）。

name

（可选）用于指示已配置的主机 IQN 名称的对象名称，将显示该主机的登录详细信息。

-filtervalueattribute=value

（可选）指定与指定值匹配的一个或多个过滤器属性的列表；请参阅 -filtervalue? 以了解支持的属性。

Note: 某些过滤器允许您在输入命令时使用通配符。使用 CLI 时，应该遵循以下有关使用通配符的规则：

通配符为星号 (*)。
命令最多可包含一个通配符，并且该通配符必须是字符串中的第一个或最后一个字符。
使用通配符时，必须用双引号 ("") 将过滤器条目括起：lshostiplogin -filtervalue "attribute=value*"

-filtervalue?

（可选）在报告中包含所有有效的过滤器属性。以下过滤器属性对 lshostiplogin 命令有效：

login_protocol
host_id
host_name

将忽略使用 -filtervalue? 参数指定的任何参数。

有关过滤属性的更多信息，请参阅-filtervalue 参数的属性。

描述

此命令用于列出登录会话类型和其他详细信息。

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

Table 1. svcinfo lshostiplogin 输出
属性	描述
id	用于指示已配置的主机 IQN 的对象标识，将显示该主机的登录详细信息。
name	iSCSI 或 iSER 主机的唯一 IQN。此 IQN 必须属于已配置的主机对象。
host_id	此 IQN 所属的主机对象标识。
host_name	对应于 host_id 的主机名。
login_count	主机建立的到所有 I/O 组中的集群端口的登录会话总数。
login_protocol	指定已配置的主机用于与使用 IP 地址配置的以太网端口建立会话的连接协议。该值可以是下列任一值： `iSCSI` `iSER` `mixed`
login	指示从主机到集群中的任何节点的单个会话的整数。该值是 0 - 31 范围内的一个数字。
node_id	主机 IQN 建立登录会话（由 login 字段所指示）的节点的节点标识。该值是 1 - 32 范围内的整数。
node_name	主机 IQN 建立登录会话（由 login 字段所指示）的节点的节点名称。该值是最多为 16 个字符的字符串。
port_id	指示 lsportip 视图所显示的以太网端口（建立登录）的端口标识。该值是 1 - 12 范围内的一个数字。
host_port_grp_id	描述其登录的端口所属的目标端口组标识。该值是 1 - 64 范围内的一个数字。
协议 (protocol)	指示配置的 IP 主机 IQN 为建立 login 字段所指示的登录会话而使用的连接协议。该值可以是下列任一值： `iSCSI` `iSER`
ip_version	指示 IP 寻址版本。显示的值为 IPv4 或 IPv6。
failover	指示会话是指示本地还是故障转移 IP 地址。该值显示为 yes 或 no。

示例 1

 
*  IQN "iqn.1996-04.de.suse:01:d4aba8f69a95" logged onto node1 (node_id 1) port 2 and 3 and node2 (node_id 2) port 2 and 3,
 with IPv4 version over iSCSI connection. lshostiplogin displays login sessions as shown below.

 Host Info:
 # svctask mkhost -iscsiname "iqn.1996-04.de.suse:01:d4aba8f69a95"
 Host, id [0], successfully created

 # lshost
 id  name     port_count iogrp_count status  site_id site_name  host_cluster_id host_cluster_name
 0   host0    1          4           online

 Concise View 
# lshostiplogin
id name                                       host_id  host_name        login_count  login_protocol
0  iqn.1996-04.de.suse:01:d4aba8f69a95        0        host0            4            iscsi

 Json View 
# lshostiplogin -json
[{ "id": "0", "name": "iqn.1996-04.de.suse:01:d4aba8f69a95", "host_id": "0", "host_name": "host0", "login_count": "4",
 "login_protocol": "iscsi" }]

 Detailed View 
# lshostiplogin 0
id 0
name iqn.1996-04.de.suse:01:d4aba8f69a95
host_id 0
host_name host0
login_count 4
login_protocol iscsi

login 0
node_id 1
node_name node1
port_id 2
host_port_grp_id 1
protocol iscsi
ip_version IPv4
failover no

login 1
node_id 1
node_name node1
port_id 3
host_port_grp_id 1
protocol iscsi
ip_version IPv4
failover no
 
login 2
node_id 2
node_name node2
port_id 2
host_port_grp_id 1
protocol iscsi
ip_version IPv4
failover no

login 3
node_id 2
node_name node2
port_id 3
host_port_grp_id 1
protocol iscsi
ip_version IPv4
failover no

 Json View 
# lshostiplogin -json 0
{ "id": "0", "name": "iqn.1996-04.de.suse:01:d4aba8f69a95", "host_id": "0", "host_name": "host0", "login_count": "4",
 "login_protocol": "iscsi", "logins": [{ "login": "0", "node_id": "1", "node_name": "node1", "port_id": "2",
 "host_port_grp_id": "1", "protocol": "iscsi", "ip_version": "IPv4", "failover": "no" }, {"login": "1", "node_id": "1",
 "node_name": "node1", "port_id": "3", "host_port_grp_id": "1", "protocol": "iscsi", "ip_version": "IPv4", "failover":
 "no"}, { "login": "2", "node_id": "2", "node_name": "node2", "port_id": "2", "host_port_grp_id": "1", "protocol":
 "iscsi", "ip_version": "IPv4", "failover": "no" }, {"login": "3", "node_id": "2", "node_name": "node2", "port_id": "3",
 "host_port_grp_id": "1", "protocol": "iscsi", "ip_version": "IPv4", "failover": "no"} ] }

NOTE: This CLI does not display sorted list of logins. Order in which login requests are served to host IQN, will
 dictate order of logins displayed.

Another possible Detailed view after few logouts and logins

 Detailed View 
# lshostiplogin 0
id 0
name iqn.1996-04.de.suse:01:d4aba8f69a95
host_id 0
host_name host0
login_count 4
login_protocol iscsi

login 1
node_id 1
node_name node1
port_id 2
host_port_grp_id 1
protocol iscsi
ip_version IPv4
failover no

login 0
node_id 1
node_name node1
port_id 3
host_port_grp_id 1
protocol iscsi
ip_version IPv4
failover no
 
login 2
node_id 2
node_name node2
port_id 3
host_port_grp_id 1
protocol iscsi
ip_version IPv4
failover no

login 3
node_id 2
node_name node2
port_id 2
host_port_grp_id 1
protocol iscsi
ip_version IPv4
failover no

 Json View 
# lshostiplogin -json 0
{ "id": "0", "name": "iqn.1996-04.de.suse:01:d4aba8f69a95", "host_id": "0", "host_name": "host0", "login_count": "4",
 "login_protocol": "iscsi", "logins": [{ "login": "1", "node_id": "1", "node_name": "node1", "port_id": "2",
 "host_port_grp_id": "1", "protocol": "iscsi", "ip_version": "IPv4", "failover": "no"}, {"login": "0", "node_id": "1",
 "node_name": "node1", "port_id": "3", "host_port_grp_id": "1", "protocol": "iscsi", "ip_version": "IPv4", "failover":
 "no"}, { "login": "2", "node_id": "2", "node_name": "node2", "port_id": "3", "host_port_grp_id": "1", "protocol":
 "iscsi", "ip_version": "IPv4", "failover": "no"}, {"login": "3", "node_id": "2", "node_name": "node2", "port_id": "2",
 "host_port_grp_id": "1", "protocol": "iscsi", "ip_version": "IPv4", "failover": "no"} ] }

示例 2

 
*  This example covers failover scenario for Example 1, when node 2 is down and all logins are established on node1 port 2 and 3:

 Concise View 
# lshostiplogin
id name                                       host_id  host_name        login_count  login_protocol
0  iqn.1996-04.de.suse:01:d4aba8f69a95        0        host0            4            iscsi

  Json View 
# lshostiplogin -json
[{ "id": "0", "name": "iqn.1996-04.de.suse:01:d4aba8f69a95", "host_id": "0", "host_name": "host0", "login_count": "4",
 "login_protocol": "iscsi" }]

 Detailed View 
# lshostiplogin 0
id 0
name iqn.1996-04.de.suse:01:d4aba8f69a95
host_id 0
host_name host0
login_count 4
login_protocol iscsi

login 0
node_id 1
node_name node1
port_id 2
host_port_grp_id 1
protocol iscsi
ip_version IPv4
failover no

login 1
node_id 1
node_name node1
port_id 3
host_port_grp_id 1
protocol iscsi
ip_version IPv4
failover no

login 2
node_id 1
node_name node1
port_id 2
host_port_grp_id 1
protocol iscsi
ip_version IPv4
failover yes

login 3
node_id 1
node_name node1
port_id 3
host_port_grp_id 1
protocol iscsi
ip_version IPv4
failover yes

 Json View 
# lshostiplogin -json 0
{ "id": "0", "name": "iqn.1996-04.de.suse:01:d4aba8f69a95", "host_id": "0", "host_name": "host0", "login_count": "4",
 "login_protocol": "iscsi", "logins": [{ "login": "0", "node_id": "1", "node_name": "node1", "port_id": "2",
 "host_port_grp_id": "1", "protocol": "iscsi", "ip_version": "IPv4", "failover": "no" }, {"login": "1", "node_id": "1",
 "node_name": "node1", "port_id": "3", "host_port_grp_id": "1", "protocol": "iscsi", "ip_version": "IPv4", "failover":
 "no"}, { "login": "2", "node_id": "1", "node_name": "node1", "port_id": "2", "host_port_grp_id": "1", "protocol": "iscsi",
 "ip_version": "IPv4", "failover": "yes" }, {"login": "3", "node_id": "1", "node_name": "node1", "port_id": "3",
 "host_port_grp_id": "1", "protocol": "iscsi", "ip_version": "IPv4", "failover": "yes"} ] }

示例 3

 
*  This example covers following scenario:
1. IQN "iqn.1996-04.de.suse:01:d4aba8f69a95" has logged onto node1 (node_id: 1 IOgrp: 0) port 2 and node2 (node_id: 2
 IOgrp: 0) port 2 with IPv4 version. Both the connections are over iSCSI.
2. IQN "iqn.1996-04.de.suse:03:d3bse3e25l70" has logged onto node3 (node_id: 3 IOgrp: 1) port 5 and node4 (node_id: 4
 IOgrp: 1) port 5 with IPv4 version. Both the connections are over iSER.

# svctask mkhost -iscsiname "iqn.1996-04.de.suse:03:d3bse3e25l70"
Host, id [1], successfully created

# lshost
id  name     port_count iogrp_count status  site_id site_name host_cluster_id host_cluster_name
0   host0    1          4           online
1   host1    1          4           online

 Concise View 
# lshostiplogin
id name                                       host_id  host_name        login_count  login_protocol
0  iqn.1996-04.de.suse:01:d4aba8f69a95        0        host0            2            iscsi
1  iqn.1996-04.de.suse:03:d3bse3e25l70        1        host1            2            iser

 Json View 
# lshostiplogin -json
[{ "id": "0", "name": "iqn.1996-04.de.suse:01:d4aba8f69a95", "host_id": "0", "host_name": "host0", "login_count": "2",
 "login_protocol": "iscsi" }, { "id": "1", "name": "iqn.1996-04.de.suse:03:d3bse3e25l70", "host_id": "1", "host_name":
 "host1", "login_count": "2", "login_protocol": "iser" }]

 Detailed View 0 
# lshostiplogin 0
id 0
name iqn.1996-04.de.suse:01:d4aba8f69a95
host_id 0
host_name host0
login_count 2
login_protocol iscsi

login 0
node_id 1
node_name node1
port_id 2
host_port_grp_id 1
protocol iscsi
ip_version IPv4
failover no

login 1
node_id 2
node_name node2
port_id 2
host_port_grp_id 1
protocol iscsi
ip_version IPv4
failover no

 Json View 
# lshostiplogin -json 0
{ "id": "0", "name": "iqn.1996-04.de.suse:01:d4aba8f69a95", "host_id": "0", "host_name": "host0", "login_count": "2",
 "login_protocol": "iscsi", "logins": [ { "login": "0", "node_id": "1", "node_name": "node1", "port_id": "2",
 "host_port_grp_id": "1", "protocols": "iscsi", "ip_version": "IPv4", "failover": "no"}, { "login": "1", "node_id": "2",
 "node_name": "node2", "port_id": "2", "host_port_grp_id": "1", "protocols": "iscsi", "ip_version": "IPv4", "failover":
 "no" } ] }

 Detailed View 1 
# lshostiplogin 1
id 1
name iqn.1996-04.de.suse:03:d3bse3e25l7
host_id 1
host_name host1
login_count 2
login_protocol iser

login 0
node_id 3
node_name node3
port_id 5
host_port_grp_id 2
protocol iser
ip_version IPv4
failover no

login 1
node_id 4
node_name node4
port_id 5
host_port_grp_id 2
protocol iser
ip_version IPv4
failover no

 Json View 
# lshostiplogin -json 1
{ "id": "1", "name": "iqn.1996-04.de.suse.03:d3bse3e25l7", "host_id": "1", "host_name": "host1", "login_count": "2",
 "login_protocol": "iser", "logins": [ { "login": "0", "node_id": "3", "node_name": "node3", "port_id": "5", "host_port_grp_id":
 "2", "protocols": "iser", "ip_version": "IPv4", "failover": "no"}, { "login": "1", "node_id": "4", "node_name": "node4",
 "port_id": "5", "host_port_grp_id": "2", "protocols": "iser", "ip_version": "IPv4", "failover": "no" } ] }