lshostiplogin
svcinfo lshostiplogin コマンドは、iSCSI 修飾名 (IQN) によって識別され、IP アドレスを使用して構成されたイーサネット・ポートにログインしているホストについて、ログイン・セッション・タイプおよびその他の詳細をリストするために使用します。
構文
パラメーター
- (オプション) ログインの詳細を表示する対象の、構成済みのホスト IQN を示すオブジェクト ID。 この値は、0 から 2047 (構成される iSCSI/iSER IQN の SVC クラスター当たりの最大数 [512 x 4 = 2048]) の範囲の数値でなければなりません。
- (オプション) ログインの詳細を表示する対象の、構成済みのホスト IQN 名を示すオブジェクト名。
- (オプション) 指定した値に一致する 1 つ以上のフィルター属性のリストを指定します。-filtervalue? の説明を参照してください。
- (オプション) 有効なすべてのフィルター属性をレポートに組み込みます。
lshostiplogin コマンドには、以下のフィルター属性が有効です。
- login_protocol
- host_id
- host_name
フィルター属性について詳しくは、-filtervalue パラメーターの属性を参照してください。
説明
このコマンドは、ログイン・セッション・タイプおよびその他の詳細をリストします。
この表は、出力ビュー・データとして表示される可能性のある属性値を示しています。
| 属性 | 説明 |
|---|---|
| id | ログインの詳細を表示する対象の、構成済みのホスト IQN を示すオブジェクト ID。 |
| name | iSCSI ホストまたは iSER ホストの固有の IQN。 この IQN は、構成済みのホスト・オブジェクトに属している必要があります。 |
| host_id | この IQN が属しているホスト・オブジェクト ID。 |
| host_name | host_id に対応するホスト名。 |
| login_count | ホストがクラスター・ポートに対して確立した、すべての入出力グループへのログイン・セッションの総数。 |
| login_protocol | 構成済みのホストが IP アドレスを使用して構成されたイーサネット・ポートとのセッションを確立するために使用する接続プロトコルを指定します。この値には、次のいずれかの値を指定することができます。
|
| login | ホストからクラスター内の任意のノードへの単一セッションを参照する整数。この値は、0 から 31 の範囲の数値です。 |
| node_id | ホスト IQN によって、login フィールドで参照されたログイン・セッションが確立されているノードのノード ID。この値は、1 から 32 の範囲の整数です。 |
| node_name | ホスト IQN によって、login フィールドで参照されたログイン・セッションが確立されているノードのノード名。この値は、最大 16 文字のストリングです。 |
| port_id | ログインが確立されているイーサネット・ポートを示す、lsportip ビューで表示されるポート ID。この値は、1 から 12 の範囲の数値です。 |
| host_port_grp_id | 示されているログインについて、ポートが属しているターゲット・ポート・グループの ID。この値は、1 から 64 の範囲の数値です。 |
| protocol | 構成済みの IP ホスト IQN が、login フィールドで参照されたログイン・セッションを確立するために使用している接続プロトコルを示します。この値には、次のいずれかの値を指定することができます。
|
| ip_version | IP アドレス・バージョンを示します。表示される値は IPv4 または IPv6 です。 |
| failover | セッションがローカル IP アドレスを参照するか、フェイルオーバー IP アドレスを参照するかを識別します。表示される値は yes または no です。 |
例 1
* IQN "iqn.1996-04.de.suse:01:d4aba8f69a95" は、IPv4 バージョンを使用して iSCSI 接続によってノード 1 (node_id 1) のポート 2 と 3、およびノード 2 (node_id 2) のポート 2 と 3 にログオンしました。
lshostiplogin を実行すると、以下のようにログイン・セッションが表示されます。
ホスト情報:
# 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
簡略ビュー
# 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" }]
詳細ビュー
# 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. ログイン要求がホスト IQN に出された順序によって、表示されるログインの順序が決まります。
数回のログアウトとログインの後に表示される詳細ビューの別例
詳細ビュー
# 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
* この例は、例 1 のフェイルオーバー・シナリオ (ノード 2 がダウンし、すべてのログインがノード 1 のポート 2 と 3 で確立されている場合) をカバーしています。
簡略ビュー
# 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" }]
詳細ビュー
# 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. 両方の接続が iSCSI 経由で行われています。
2. IQN "iqn.1996-04.de.suse:03:d3bse3e25l70" は、IPv4 バージョンを使用してノード 3 (node_id: 3 IOgrp: 1) のポート 5、およびノード 4 (node_id: 4
IOgrp: 1) のポート 5 にログオンしています。両方の接続が 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
簡略ビュー
# 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" } ] }