lshost
lshost コマンドを使用して、システムから認識できるすべてのホストに関する簡略な情報、および単一のホストに関する詳細な情報のリストを生成します。
構文
パラメーター
- -filtervalue attribute=value
- (オプション) 1 つ以上のフィルターのリストを指定します。フィルター属性値に一致する値をもつオブジェクトのみが戻されます。 容量を指定する場合、単位も入力する必要があります。
- -nohdr
- (オプション) デフォルトでは、見出しは、簡略形式のビューではデータの列ごとに、詳細形式のビューではデータの項目ごとに表示されます。-nohdr パラメーターは、これらの見出しの表示を抑止します。注: 表示するデータが存在しない場合、見出しは表示されません。
- -delim delimiter
- (オプション) デフォルトでは、簡略形式のビューのデータのすべての列がスペースで区切られます。
各列の幅は、データの各項目の最大幅に設定されています。詳細ビューでは、データの各項目は別の行に表示され、見出しが表示される場合、データと見出しの間には、スペースが 1 つ入ります。
-delim パラメーターは、この動作を指定変更します。-delim パラメーターでは、1 バイトの文字を入力できます。コマンド・ラインに
-delim :と入力すると、簡略ビューのすべてのデータ項目がコロン (:) で区切られます。例えば、列の間に空白は入りません。詳細ビューでは、データと見出しは指定の区切り文字で区切られます。 - object_id | object_name
- (オプション) オブジェクトの名前または ID を指定します。 このパラメーターを指定すると、特定のオブジェクトの詳細ビューが戻され、-filtervalue パラメーターで指定された値はすべて無視されます。 object_id | object_name パラメーターを指定しない場合、-filtervalue パラメーターで指定したフィルター要件に一致するすべてのオブジェクトの簡略ビューが表示されます。
- -filtervalue?
- (オプション) 有効なフィルター属性のいずれかまたはすべてのリストをレポートに表示することを指定します。
lshost コマンドの有効なフィルター属性は、次のとおりです。
- host_cluster_id
- host_cluster_name
- host_name
- host_id
- id
- iogrp_count
- name
- port_count
- site_id
- site_name
- status
- type
- protocol
フィルター属性について詳しくは、-filtervalue パラメーターの属性を参照してください。
説明
このコマンドは、システムが認識できるホストの簡略リストまたは詳細ビューを返します。
ファイバー・チャネル (FC) ポートの場合、node_logged_in_count フィールドには、ホスト・ポートにログインされているノードの数が示されます。Internet Small Computer System Interface (iSCSI) ポートの場合、node_logged_in_count フィールドには、ホスト iSCSI 修飾名 (IQN) からの iSCSI セッションの数が示されます。
複数の入出力グループを介してアクセスできるボリュームに、iSCSI ホストをマップすることができます。
iSCSI ホストは、複数の入出力グループ (および単一の入出力グループ) を介してアクセスできるボリュームにアクセスすることができます。複数の入出力グループを介してアクセスできるボリュームへマップされる iSCSI ホストは、アクセス・セットの各入出力グループとのアクティブな iSCSI セッションが 1 つ以上ある場合、online です。ボリュームが iSCSI ホストへマップされていない場合、そのボリュームは degraded です。
以下のリストは、ファブリック接続 FC ホスト・ポートのさまざまな状態を説明しています。
- active
- ボリューム・マッピングを持つすべてのノードが指定のワールド・ワイド・ポート名 (WWPN) にログインしているが、少なくとも 1 つのノードが過去 5 分以内に WWPN から SCSI コマンドを受け取った場合、ホスト・ポートはアクティブです。
- degraded
- ボリューム・マッピングを持つ 1 つ以上のノードが指定の WWPN にログインしていない場合、ホスト・ポートは劣化しています。
- inactive
- ボリューム・マッピングを持つすべてのノードが指定の WWPN にログインしているが、どのノードも過去 5 分以内に WWPN から SCSI コマンドを受け取っていない場合、ホスト・ポートは非アクティブです。
- offline
- ボリューム・マッピングを持つ 1 つ以上の入出力 (I/O) グループが指定の WWPN にログインしていない場合、ホスト・ポートはオフラインです。
以下のリストは、直接接続 FC ホスト・ポートのさまざまな状態を説明しています。
- active
- ノードが指定の WWPN にログインしており、そのノードが過去 5 分以内に WWPN から SCSI コマンドを受け取った場合、ホスト・ポートはアクティブです。
- inactive
- ボリューム・マッピングを持つすべてのノードが指定の WWPN にログインしているが、どのノードも過去 5 分以内に WWPN から SCSI コマンドを受け取っていない場合、ホスト・ポートは非アクティブです。
- offline
- 指定された WWPN に対するログインが存在しない場合、ホスト・ポートはオフラインです。
以下のリストは、ファブリック接続 NVMe/FC ホスト・ポートのさまざまな状態を説明しています。
- active
- ボリューム・マッピングを持つすべてのノードが指定の NVMe 修飾名 (NQN) にログインしており、少なくとも 1 つのノードが過去 5 分以内に NQN から NVMe コマンドを受け取った場合、ホスト・ポートはアクティブです。
- degraded
- ボリューム・マッピングをもつ 1 つ以上のノードが指定の NQN にログインしていない場合、ホスト・ポートは機能低下しています。
- inactive
- ボリューム・マッピングを持つすべてのノードが指定の NQN にログインしているが、どのノードも過去 5 分以内に NQN からの NVMe コマンドを認識していない場合、ホスト・ポートは非アクティブです。
- offline
- ボリューム・マッピングを持つ 1 つ以上の入出力 (I/O) グループが指定の NQN にログインしていない場合、ホスト・ポートはオフラインです。
注: lshost コマンドは、ノードにログインされているホスト HBA ポートのリストを表示します。 ただし、表示された情報には、もうログインしていないか、SAN ファブリックの一部でなくなっているホスト HBA ポートが含まれる場合があります。例えば、あるホスト HBA ポートのプラグがスイッチから抜かれても、lshost では、すべてのノードにログインされている WWPN が表示されます。このアクションが行われた場合、誤った項目は、除去されたホスト HBA ポートを以前に含んでいた同じスイッチ・ポートに別の装置のプラグが差し込まれた時点で除去されます。
以下のリストは、指定された
iSCSI 名 のさまざまな状態を説明しています。- active
- ボリューム・マッピングを持つすべての入出力グループに、指定された
iSCSI 名の iSCSI セッションが少なくとも 1 つ関連付けられている場合、iSCSI 名はアクティブです。 - inactive
- ホストにボリューム・マッピングはないが、指定された
iSCSI 名の iSCSI セッションが少なくとも 1 つ存在する場合、iSCSI 名は非アクティブです。 - offline
- 1 つ以上の入出力グループへのアクセスを使用するボリュームが、関連するすべての入出力グループの iSCSI または iSER セッションに関連付けられていない指定された iscsiname にマッピングされている場合はオフラインです。
以下のリストは、host_status のさまざまな状態を説明しています。
- online
- ホストに完全な接続があります。以下のいずれかのタイプを使用する場合、1 つのスタイルの接続のみを使用するホストはオンラインです。
- ファイバー接続ファイバー・チャネル (FAFC)
- すべてのポートがアクティブまたは非アクティブで、ホストがボリューム・マッピングを持っている各入出力グループ内のすべてのオンライン・ノードにログインしています。
- 直接接続ファイバー・チャネル (DAFC)
- ホストがボリューム・マッピングを持っている入出力グループ内のすべてのノードに対して、ホストがアクティブまたは非アクティブのログインを持っています。
- Internet Small Computer System Interface (iSCSI)
- ホストが、ボリューム・マッピングを持っている各入出力グループとの iSCSI セッションを持っている。
- NVMe over Fibre Channel (FC-NVMe)
- すべてのホスト NQN には、そのホストがボリューム・マッピングを持っている各入出力グループ内のすべてのオンライン・ノードとの NVMe 関連付けがあります。
- offline
- ホストに接続がありません。この理由は、ホストの電源がオフにされ、オンになっていないためである可能性があります。
要確認: iSCSI ホストが、構成されていない入出力グループにのみログインしている場合、関連するホスト・オブジェクトの状況は
offlineです。 - degraded
- ホストは完全には接続されていません。原因として、構成エラーまたはハードウェア障害が考えられます。これにより、計画された保守アクティビティーの間にアクセスが失われる可能性があるため、可能な限りすみやかに修復する必要があります。要確認: マップ済みボリュームのない iSCSI ホストが、所属する入出力グループの一部 (全部ではなく) にログインしている場合は
degradedです。 - mask
- ホストがアクセス可能な (ノード上に存在する) ファイバー・チャネル (FC) 入出力ポート。
この表は、表示される可能性のある出力を示しています。
| 属性 | 説明 |
|---|---|
| id | 固有ホスト ID を示します。この値は英数字値です。 |
| name | 固有のホスト名を示します。この値は英数字ストリングです。 |
| port_count | ポート数を示します。 |
| type | ホスト・タイプを示します。 |
| mask | 64 ビットのバイナリー・ストリングによってマスク値を示します。 |
| iogrp_count | 入出力グループの数を示します。 |
| status | ホストが online または offline のどちらであるかを示します。 |
| protocol | ホストがストレージへのアクセスに scsi または nvme のどちらを使用するかを示します。 |
| WWPN | 16 文字の 16 進数ストリングによってワールド・ワイド・ポート名 (WWPN) を示します。 |
| SAS_WWPN | 16 文字の 16 進数ストリングによってシリアル接続 SCSI (SAS) WWPN を示します。 |
| nqn | NVMe 修飾名を示します。 |
| node_logged_in_count | WWPN または NQN がログインしているノードの数を示します。 |
| state | SAS WWPN ログインの状態を示します。値は次のとおりです。
|
| sas_wwpn_count | 構成されている SAS WWPN の数を示します。 |
| nqn_count | ホストに割り当てられている NVMe NQN ポートの数を示します。 |
| site_id | ホストのサイト ID を識別します。値は 1、2、またはブランクです。 |
| site_name | ホストのサイト名を識別します。値は、英数字ストリングまたはブランクであることが必要です。 |
| host_cluster_id | ホスト・クラスターの固有 ID を示します。 |
| host_cluster_name | ホスト・クラスターの固有の名前を示します。 |
| status_policy | ホスト状況の計算に使用される接続要件を表示します。値は、complete または redundant のいずれかです。status_policy redundant の場合:
|
| status_site | ホスト状況を計算するために使用されるホスト・サイト接続を表示します。結果は、以下のいずれかの値になります。
|
| owner_id | 所有権グループの ID を表示します。 |
| owner_name | 所有権グループの名前を表示します。 |
呼び出し例
lshost
結果出力:
id name port_count iogrp_count status mapping_count host_cluster_id host_cluster_name protocol site_id site_name owner_id owner_name
0 hostone 1 4 offline 0 1 vardyhost1 scsi 2 chelsea2 0 tenantA
1 host0 1 4 degraded 1 2 vardyhost2 nvme 1 chelsea1 0 tenantA
2 host1 1 4 online 2 3 vardyhost3 scsi 2 chelsea2 0 tenantA
詳細な呼び出し例
lshost 0
結果出力:
id 0
name ined
port_count 1
type openvms
mask 0000000000000000000000000000000000000000000000000000000000001101
iogrp_count 4
status online
WWPN 10000000C92BB490
node_logged_in_count 1
state inactive
site_id 2
site_name chelsea2
host_cluster_id 1
host_cluster_name jvardy8
protocol scsi
status_policy complete
status_site all
owner_id 0
owner_name tenantA
呼び出し例
lshost 0
結果出力:
id 0
name host0
port_count 10
type generic
mask 1111111111111111111111111111111111111111111111111111111111111111
iogrp_count 4
status offline
SAS_WWPN 1000000000000009
node_logged_in_count 0
state offline
SAS_WWPN 1000000000000008
node_logged_in_count 0
state offline
site_id 2
site_name chelsea2
host_cluster_id 2
host_cluster_name boat3ng
protocol scsi
status_policy complete
status_site all
owner_id 0
owner_name tenantA
呼び出し例
lshost 1
結果出力:
id 1
name host1
port_count 2
type generic
mask 1111111111111111111111111111111111111111111111111111111111111111
iogrp_count 4
status offline
site_id
site_name
host_cluster_id
host_cluster_name
protocol nvme
nqn nqn.2014-08.com.example:nvme.host.sys.xyz
node_logged_in_count 0
state offline
nqn nqn.2014-08.org.nvmexpress:uuid:f81d4fae-7dec-11d0-a765-00a0c91e6bf6
node_logged_in_count 0
state offline
status_policy complete
status_site all
owner_id 0
owner_name tenantA