lshostiplogin
使用 svcinfo lshostiplogin 命令可列出主机的登录会话类型和其他详细信息，这些主机由其 iSCSI 限定名 (IQN) 来标识，并已登录到使用 IP 地址配置的以太网端口。
语法
参数
- （可选）用于指示已配置的主机 IQN 的对象标识，将显示该主机的登录详细信息。该值必须为 0 到 2047 之间的数字（每个 SVC 集群的已配置 iSCSI/iSER IQN 的最大数量 [512 x 4 = 2048]）。
- （可选）用于指示已配置的主机 IQN 名称的对象名称，将显示该主机的登录详细信息。
- （可选）指定与指定值匹配的一个或多个过滤器属性的列表；请参阅 -filtervalue? 以了解受支持的属性。
- （可选）在报告中包含所有有效的过滤器属性。以下过滤器属性对 lshostiplogin 命令有效：
- login_protocol
- host_id
- host_name
有关过滤属性的更多信息，请参阅-filtervalue 参数的属性。
描述
此命令用于列出登录会话类型和其他详细信息。
下表提供可显示为输出视图数据的属性值。
| 属性 | 描述 |
|---|---|
| id | 用于指示已配置的主机 IQN 的对象标识，将显示该主机的登录详细信息。 |
| name | iSCSI 或 iSER 主机的唯一 IQN。此 IQN 必须属于已配置的主机对象。 |
| host_id | 此 IQN 所属的主机对象标识。 |
| host_name | 对应于 host_id 的主机名。 |
| login_count | 主机建立的到所有 I/O 组中的集群端口的登录会话总数。 |
| login_protocol | 指定已配置的主机用于与使用 IP 地址配置的以太网端口建立会话的连接协议。该值可以是下列任一值：
|
| 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 字段所指示的登录会话而使用的连接协议。该值可以是下列任一值：
|
| 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" } ] }