一般的な iSCSI 構成に関する問題のトラブルシューティングする際に次のツールを使用できます。
snoop – このツールは更新され、iSCSI パケットをサポートするようになりました。
wireshark – このネットワークモニタリングは http://www.wireshark.org/ から利用できます。
どちらのツールも、ポート 3260 上の iSCSI パケットをフィルタできます。
このセクションでは、iSCSI のさまざまな問題およびエラーメッセージをトラブルシューティングする方法について説明します。
接続の問題の考えられる原因を特定するには、管理者として iSCSI ターゲット情報を一覧表示します。
例:
initiator# iscsiadm list target
Target: iqn.2001-05.com.abcstorage:6-8a0900-37ad70401-bcfff02df8a421df-zzr1200-01
TPGT: default
ISID: 4000002a0000
Connections: 0
出力に接続が表示されていない場合は、接続が失敗したことについて、/var/adm/messages ファイル内で考えられる理由を調査します。
ping コマンドを使用して、接続がアクセス可能かどうかを確認できます。telnet コマンドを使用してストレージデバイスの iSCSI ポートに接続し、iSCSI サービスが利用可能かどうかを確認することもできます。デフォルトのポートは 3260 です。
さらに、ストレージデバイスのログファイルでエラーを確認します。
出力にターゲットが表示されていない場合は、/var/adm/messages ファイル内でその考えられる原因を調査します。
SendTargets を発見方式として使用している場合は、–v オプションを使って discovery-address の一覧表示を試みると、ホストが目的のターゲットを認識しているかどうかがわかります。例:
initiator# iscsiadm list discovery-address -v 10.0.0.1 Discovery Address: 10.0.0.1:3260 Target name: eui.210000203787dfc0 Target address: 10.0.0.1:11824 Target name: eui.210000203787e07b Target address: 10.0.0.1:11824
発見方式として iSNS を使用している場合は、iSNS 発見方式を有効にし、v オプションを使用して –isns-server を一覧表示することで、期待されるターゲットがホストに認識されることを確認します。例:
initiator# iscsiadm list isns-server -v
iSNS Server IP Address: 10.20.56.56:3205
Target name: iqn.1992-08.com.xyz:sn.1234566
Target address: 10.20.57.161:3260, 1
Target name: iqn.2003-10.com.abc:group-0:154:abc-65-01
Target address: 10.20.56.206:3260, 1
Target name: iqn.2003-10.com.abc:group-0:154:abc-65-02
Target address: 10.20.56.206:3260, 1
.
.
.
iSCSI デバイスまたはディスクを利用できない場合にトラブルシューティングを行うには、列挙中にこのターゲット上で発見された LUN を特定します。
例:
# iscsiadm list target -S
Target: iqn.2001-05.com.abcstorage:6-8a0900-37ad70401-bcfff02df8a421df-zzr1200-01
TPGT: default
ISID: 4000002a0000
Connections: 1
LUN: 0
Vendor: ABCSTOR
Product: 0010
OS Device Name: /dev/rdsk/c3t34d0s2
–S オプションを指定すると、列挙中にこのターゲット上で発見された LUN が表示されます。
/var/adm/messages ファイルを確認して、エラーが報告されたかどうかを調べます。LUN が一覧表示されるべきなのにそうなっていない場合は、/var/adm/messages ログファイルを確認してください。
ストレージデバイスのログファイルにエラーが記録されていないか確認します。
ストレージデバイスのすべての LUN マスクが正しく構成されていることを確認します。
特定のイニシエータに対するストレージの認証を制御する手段として iSNS 発見ドメインを使用しないでください。代わりに LUN マスクを使用して、承認されたイニシエータだけが LUN にアクセスできることを確認します。
ターゲットが使用中のときに発見ドメインからターゲットを削除しようとした場合、iSCSI イニシエータはこのターゲットからログアウトしません。このイニシエータがこのターゲット(および関連付けられた LUN) にアクセスしないようにする場合は、LUN マスクを使用する必要があります。ターゲットを発見ドメインから削除するだけでは不十分です。
LUN マスクの詳細は、ベンダー固有のストレージドキュメントを参照してください。
このセクションでは、/var/adm/messages ファイルに見つかる可能性のある iSCSI メッセージと、考えられる解決方法について説明します。
メッセージの形式は次のとおりです。
iscsi TYPE (OID) STRING (STATUS-CLASS#/STATUS-DETAIL#)
接続またはセッションのいずれか。
接続またはセッションのオブジェクト ID。この ID は、OS インスタンスに一意です。
状態の説明。
これらの値は、RFC 3720 で定義されている iSCSI ログイン応答として返されます。
iscsi connection(OID) login failed - Miscellaneous iSCSI initiator errors.
Cause: 何らかのイニシエータエラーにより、デバイスログインが失敗しました。
iscsi connection(OID) login failed - Initiator could not be successfully authenticated.
Cause: デバイスによるイニシエータの認証が成功しませんでした。
解決策: 該当する場合には、CHAP 名、CHAP パスワード、または RADIUS サーバーの設定が正しいことを確認します。
iscsi connection(OID) login failed - Initiator is not allowed access to the given target.
Cause: イニシエータが iSCSI ターゲットデバイスにアクセスすることを、デバイスが許可できません。
解決策: イニシエータ名を確認するとともに、その名前がストレージデバイスによって正しくマスクまたはプロビジョニングされていることを確認します。
iscsi connection(OID) login failed - Requested ITN does not exist at this address.
Cause: ユーザーが要求する iSCSI ターゲット名 (ITN) へのアクセスを、デバイスが提供しません。
解決策: イニシエータの発見情報が正しく指定されており、ストレージデバイスが正しく構成されていることを確認します。
iscsi connection(OID) login failed - Requested ITN has been removed and no forwarding address is provided.
Cause: ユーザーが要求する iSCSI ターゲット名 (ITN) へのアクセスを、デバイスが提供しなくなりました。
解決策: イニシエータ発見情報が正しく指定されており、ストレージデバイスが正しく構成されていることを確認します。
iscsi connection(OID) login failed - Requested iSCSI version range is not supported by the target.
Cause: イニシエータの iSCSI バージョンがストレージデバイスによってサポートされていません。
iscsi connection(OID) login failed - No more connections can be accepted on this Session ID (SSID).
Cause: ストレージデバイスは、このイニシエータノードから iSCSI ターゲットデバイスへの接続をこれ以上受け入れることができません。
iscsi connection(OID) login failed - Missing parameters (e.g., iSCSI initiator and/or target name).
Cause: ストレージデバイスが、イニシエータ名またはターゲット名が正しく指定されていないと報告しています。
解決策: iSCSI イニシエータまたはターゲット名を指定します。
iscsi connection(OID) login failed - Target hardware or software error.
Cause: ストレージデバイスでハードウェアエラーまたはソフトウェアエラーが発生しました。
解決策: ストレージドキュメントを参照するか、ストレージベンダーに連絡して必要なサポートを受けます。
iscsi connection(OID) login failed - iSCSI service or target is not currently operational.
Cause: ストレージデバイスが現在動作していません。
解決策: ストレージドキュメントを参照するか、ストレージベンダーに連絡して必要なサポートを受けます。
iscsi connection(OID) login failed - Target has insufficient session, connection or other resources.
Cause: ストレージデバイスのリソースが不足しています。
解決策: ストレージドキュメントを参照するか、ストレージベンダーに連絡して必要なサポートを受けます。
iscsi connection(OID) login failed - unable to initialize authentication
iscsi connection(OID) login failed - unable to set authentication
iscsi connection(OID) login failed - unable to set username
iscsi connection(OID) login failed - unable to set password
iscsi connection(OID) login failed - unable to set ipsec
iscsi connection(OID) login failed - unable to set remote authentication
Cause: イニシエータが認証の初期化または設定を正しく行えませんでした。
解決策: イニシエータの認証が正しく構成されていることを確認します。
iscsi connection(OID) login failed - unable to make login pdu
Cause: イニシエータが、イニシエータまたはストレージデバイスの設定に基づいてログインのペイロードデータユニット (PDU) を作成できませんでした。
解決策: 任意のターゲットログインパラメータやその他のデフォルト以外の設定値のリセットを試みます。
iscsi connection(OID) login failed - failed to transfer login
iscsi connection(OID) login failed - failed to receive login response
Cause: イニシエータが、PDU をネットワーク接続経由で転送または受信できませんでした。
解決策: ネットワーク接続が到達可能であることを確認します。
iscsi connection(OID) login failed - received invalid login response (OP CODE)
Cause: ストレージデバイスがログインに対して予想外の応答を返しました。
iscsi connection(OID) login failed - login failed to authenticate with target
Cause: イニシエータがストレージデバイスを認証できませんでした。
解決策: イニシエータの認証が正しく構成されていることを確認します。
iscsi connection(OID) login failed - initiator name is required
Cause: どのアクションを実行する場合も、イニシエータ名が構成されている必要があります。
解決策: イニシエータ名が構成されていることを確認します。
iscsi connection(OID) login failed - authentication receive failed
iscsi connection(OID) login failed - authentication transmit failed
Cause: イニシエータが認証情報を転送または受信できませんでした。
解決策: 状況に応じて、ストレージデバイスまたは RADIUS サーバーとのネットワーク接続を確認します。
iscsi connection(OID) login failed - login redirection invalid
Cause: ストレージデバイスが、イニシエータを無効な宛先にリダイレクトしようとしました。
解決策: ストレージドキュメントを参照するか、ストレージベンダーに連絡して必要なサポートを受けます。
iscsi connection(OID) login failed - target protocol group tag mismatch, expected <TPGT>, received <TPGT>
Cause: イニシエータとターゲットの TPGT (ターゲットポータルグループタグ、Target Portal Group Tag) が一致しません。
解決策: イニシエータ上またはストレージデバイス上の TPGT 発見設定を確認します。
iscsi connection(OID) login failed - can't accept PARAMETER in security stage
Cause: ログインのセキュリティーフェーズで、デバイスがサポートされていないログインパラメータで応答しました。
解決策: パラメータ名が参考のため記載されています。ストレージドキュメントを参照するか、ストレージベンダーに連絡して必要なサポートを受けます。
iscsi connection(OID) login failed - HeaderDigest=CRC32 is required, can't accept VALUE
iscsi connection(OID) login failed - DataDigest=CRC32 is required, can't accept VALUE
Cause: このターゲットに対して、CRC32 に設定された HeaderDigest または DataDigest のみを受け入れるようにイニシエータが構成されています。デバイスは値 VALUE を返しました。
解決策: イニシエータとデバイスのダイジェスト設定に互換性があることを確認します。
iscsi connection(OID) login failed - HeaderDigest=None is required, can't accept VALUE
iscsi connection(OID) login failed - DataDigest=None is required, can't accept VALUE
Cause: このターゲットに対して、NONE に設定された HeaderDigest または DataDigest のみを受け入れるようにイニシエータが構成されています。デバイスは値 VALUE を返しました。
解決策: イニシエータとデバイスのダイジェスト設定に互換性があることを確認します。
iscsi connection(OID) login failed - can't accept PARAMETER
Cause: イニシエータはこのパラメータをサポートしません。
iscsi connection(OID) login failed - can't accept MaxOutstandingR2T VALUE
Cause: イニシエータは、記載された値の MaxOutstandingR2T を受け入れません。
iscsi connection(OID) login failed - can't accept MaxConnections VALUE
Cause: イニシエータは、記載された値の最大接続数を受け入れません。
iscsi connection(OID) login failed - can't accept ErrorRecoveryLevel VALUE
Cause: イニシエータは、記載された値のエラー回復レベルを受け入れません。
iscsi session(OID) NAME offline
Cause: このターゲット名のすべての接続が、削除されたか、または失敗しました。
iscsi connection(OID) failure - unable to schedule enumeration
Cause: イニシエータがこのターゲットの LUN を列挙できませんでした。
解決策: LUN の列挙を強制実行するには、devfsadm -i iscsi コマンドを実行します。詳細は、devfsadm(1M) のマニュアルページを参照してください。
iscsi connection(OID) unable to connect to target NAME (errno:ERRNO)
Cause: イニシエータによるネットワーク接続の確立が失敗しました。
解決策: 接続エラーに関する特定エラー数については、/usr/include/sys/errno.h ファイルを参照してください。