次の方法で共有

マルチパス I-O テスト (ロゴ)

  • [アーティクル]

このテストでは、ベンダーのストレージ ソリューションと Microsoft® ドライバー ソリューションとの互換性のためのマルチパス I/O テストが提供されます。

Note

   このテストは、特に x64 プロセッサアーキテクチャで実行するように設計されています。

 

テストの詳細

   
仕様
  • Device.Storage.Hd.Mpio.BasicFunction
プラットフォーム
  • Windows Server 2016 (x64)
サポートされているリリース
  • Windows 10
  • Windows 10 バージョン 1511
  • Windows 10 Version 1607
  • Windows 10 Version 1703
  • Windows 10 バージョン 1709
  • Windows 10 バージョン 1803
  • Windows 10 Version 1809
  • Windows 10 バージョン 1903
  • Windows 10 への次の更新プログラム
予想される実行時間 (分) 180
カテゴリ 開発
タイムアウト (分) 10800
再起動が必要です false
特別な構成が必要です false
Type automatic

 

その他のドキュメント

この機能領域のテストには、前提条件、セットアップ、トラブルシューティング情報など、次のトピックに記載されている追加のドキュメントが含まれている場合があります。

テストの実行

テストを実行する前に、テストする Raid Storage アレイのタイプに対応したテストの設定を完了します。 詳細については、[ハードウェアベースのRAID（ストレージアレイ）テストの概要] を参照してください。

さらに、このテストには次のソフトウェアとハードウェアが必要です。

  • Microsoft デバイス固有モジュール (DSM) または Microsoft MPIO コアアーキテクチャにインターフェースするサードパーティ製 DSM を使用するハードウェアストレージ RAID 配列

  • テスト対象の DSM またはハードウェアストレージ RAID 配列に含まれるソフトウェアコンポーネント。

  • 複数パスの I/O セットアップ

トラブルシューティング

HLK テストのエラーの一般的なトラブルシューティングについては、「Windows HLK テストのエラーのトラブルシューティング」を参照してください。

ストレージのトラブルシューティング情報については、「Device.Storage テストのトラブルシューティング」を参照してください。

さらに、このテストには次の既知の問題があります。

問題点

詳細

iSCSI 以外のシナリオの MPIO テスト環境が正しく構成されていない可能性があります。

iSCSI MPIO 以外のテスト環境でテストする場合、テストでは、少なくとも 2 つのポート (HBA に 1 つのポートがある場合は少なくとも 2 つの HBA) を持つホスト バス アダプター (HBA) が同じ iSCSI ターゲットに接続されている必要があります。 次の手動手順では、テスト環境が正しく設定されていることを確認できます。

  1. テスト用コンピューターで、デバイスマネージャーを開き、[非表示のデバイスの表示] をクリックします。 一部のディスクが表示され、非表示の各ディスクは 1 つのパス用です。

  2. 各 HBA ポート デバイス ノードについて:

    1. 各HBAポートを右クリックし、[無効化] をクリックして無効化します。

    2. そのポート インスタンスを無効にした後、非表示のディスクが削除されるのを確認します。 隠しディスクが残っている場合、HBA ポートは iSCSI ターゲットに接続されません。

フィルターをインストールするときに、テストで HBA デバイス インスタンスを取得できません。

レジストリ キー (INF ファイル) の DSM 名が、DSM 自体で指定された名前と同じであることを確認します。

テストが ファイバー チャネル に対して実行されているときに、テストが ファイバー チャネル と iSCSI の両方を介してテスト 記憶域デバイスに接続されている場合、テストは iSCSI WMI 情報の取得に失敗します。

同じテスト環境内の複数のバスの種類に対して、同じ DSM によって要求される MPIO LUN を構成することをお勧めします。

リンクの弾み付きと同時に弾むテスト ケースがテストによって実行された後にパスが削除されると、テストは失敗します。

HBA で最新のドライバー (ロゴ認定に合格したドライバー) が実行Windows確認してください。 iSCSI 以外のテスト環境でテストする場合、マルチパス I/O テストでは、HBA ドライバーが プラグ アンド プレイ Driver テストに合格する必要があります。 HBA がテストに合格できない場合は、HBA の別の認定済み HBA モデルに変更し、MPIO パスの復旧に長い時間が必要なので、この問題が発生する可能性があります。

MPIO ブート環境で実行すると、テストは失敗します。

MPIO ブート テスト環境ではテストを実行しません。

テストでは、iSCSI ターゲット上の iSCSI セッションの復元に失敗します。

MPIO テスト環境内で、1 つの iSCSI ターゲットに関連する複数のポート (IP アドレス) がある場合は、テスト中に少なくとも 2 つの iSCSI セッションが IP アドレスを介して接続されていることを確認する必要があります。 マルチパス I/O テストでは、ユーザーは iSCSI ターゲットへの複数のポート接続を構成することができますが、すべての iSCSI 関連テストに対して同時に、ユーザーはテスト中に 1 つの IP アドレスのみを関連付けることができます。

テストで iSCSI UI が表示されない

最初に、選択した LUN バスの種類が iSCSI を確認します。 そうしない場合、マルチパス I/O テストでは iSCSI UI は表示されません。 次に、[WLKClient]\JobsWorkingDir\ のパスにiscsihctconfig.iniファイルが存在する場合は確認してください。 このファイルが存在する場合は、iSCSI UI を使用して iSCSI 構成情報を手動で入力する場合は削除します。

テストが失敗またはクラッシュしました。

マルチパス I/O テストの実行に失敗した場合は、テストを再実行する前に、テスト環境がクリーンである必要があります。 この問題は、コントローラーに最初に Windows ロゴ キット 1.5 が含まれている場合に、Windows Logokit 1.6 をインストールして使用してストレージ テストを完了する前に Windows を再インストールしなかった場合に発生する可能性があります。この問題が発生した場合は、Windows してテストを再開します。

IO 操作エラーでテストが失敗する

マルチパス I/O テストに失敗した場合は、ログ ファイルに IO 操作エラーが含まれている場合は、テストを実行する前に、LUN がオンラインであり、未加工の状態で初期化されていないことを確認してください。 LUN がオンラインで初期化されている場合は、一部のパスがフェールオーバーされた LUN からファイルをコピーまたは読み取ってみください。

 

サポート インシデントを開く場合は、次の手順に従って、カスタマー サポート サービスに役立つ情報を取得します。

  1. 提出された .cpk パッケージをご提示ください。 この .cpk パッケージには、マルチパス I/O テスト t ログだけでなく、SCSI コンプライアンス テストと ALUA MPIO テストのログを含める必要があります。

  2. テスト環境のスクリーンショットをキャプチャしてください。 OS が Windows 2008 R2 以降の場合、コントロールパネルから MPIOの設定スナップショット画面をキャプチャしてください。 これを表示するには、[スタート] > [コントロールパネル]> の >[MPIOの設定スナップショット] をクリックします。

  3. クラッシュが発生した場合は、ダンプ ファイルを作成してください。 また、手順で次のテストを再実行します。

    1. テスト バイナリバイナリとファイルを Windows HLK テスト コンピューターにコピーします。mpiotest.exe、mpioinstallfiltr.exe、iscsiui.exe、iscsiui.exe、devcon.exe、pnpfiltr.sys、pnpdtest.exe、mpiotest_script_fvt.txt ファイルが含まれます。

    2. 管理者特権を使用して、コマンド プロンプト ウィンドウを開きます。

    3. 次のいずれかのコマンドを実行します。

      • バスの種類が iSCSI の場合は、iscsui.exe ツールと入力情報を実行して、新しいファイル iscsihctconfig.ini します。

      • バスタイプが非iSCSIの場合は、mpioinstallfiltr -d <DSM デバイスのインスタンスパス> (例えば ROOTMPIO0001) -i を実行し、テスト用コンピュータを再起動します。 このコマンドがクラッシュした場合、メモ帳を使ってコマンドコンソールからすべてのログファイルをコピーしてください。

    4. 次のコマンドを実行します: テストがクラッシュした場合でも、コマンド コンソールからメモ帳にすべてのログをコピーできます。

      • Mpiotest.exe -d <DSM デバイスのインスタンスパス> (例えば ROOT\MPIO\0001) -s [ScriptName] -logo -isiSCSI [T/F].

    5. バスタイプが非iSCSIの場合、コマンドプロンプトから以下のコマンドを実行し、 フィルタドライバをアンインストールします： mpioinstallfiltr -d DSM デバイスのインスタンス パス、 (例えば, ROOTMPIO0001) -c そして、システムブートマシンを再起動します。

詳細情報

このテストは、Microsoft DSM またはサード パーティの DSM のデバイス固有モジュール (DSM) にのみ適用されます。

テストには、次の基本的なテスト アサーションが含まれています。これは 4 つのテスト ケースに結合されます。

  • フェールオーバー: 一部のパスが壊れているが、すべてではない場合、データ転送は破損しません。

  • フェールバック: データ転送は、一部のパスがフェールオーバーから復元された場合に正常に機能します。

  • リンク の折り返し: MPIO 環境では、1 つのパスを除くすべてのパスが壊れています。 そのパスが破損し、15 分以内に回復した場合、データ転送はエラーなしで続行できます。

  • 同時フェールオーバーとフェールバック、または "同時に回復" する: 一部のパスがフェールオーバーされ、他のパスが同時にフェールバックされる場合、データ転送は破損しません。

  • 負荷分散ポリシー: 異なるポリシーを設定し、データ転送が正しく機能する可能性があります。 ラウンド ロビン読み込みポリシーとサブセットを含むラウンド ロビン読み込みポリシーの場合、テストでは効率が低下するかどうかを確認します。

テスト コンポーネントには、スタンドアロンのテスト アプリケーション、フォールト インジェクション フィルター ドライバー、テスト ケース構成ファイル、iSCSI 構成ファイル (パスが iSCSI セッションで作成されている場合)、Device Test Manager (DTM) が含まれます。

エンタープライズ ストレージ ソリューションのお客様は、そのコンポーネントの高可用性に大きく依存しています。 ストレージでは、高可用性は多くの場合、冗長性によって実装されます。 マルチパス I/O (MPIO) は、エンタープライズ ストレージ ソリューションのファブリック 層に対するこのような実装の 1 つです。 Microsoft では、Windows Vista の期間に Windows Advanced Server オペレーティング システムに出荷されるマルチパス ドライバー (mpio.sys) とデバイス固有モジュール (msdsm.sys) を使用したマルチパス I/O をサポートしています。

このテストでは、ベンダーのストレージ ソリューションと Microsoft ドライバー ソリューションとの互換性のためのマルチパス I/O テストが提供されます。 次の領域に焦点を当ています:

  1. パスのフェールオーバーと回復は、データ転送の品質に影響しません。 MPIO 環境を設定する目的の 1 つは、データ転送の信頼性を高めすることです。 このテストでは、現実世界でパスを壊すいくつかの単純なシナリオをシミュレートし、環境がデータを正常に転送できるかどうかを確認します。

  2. MPIO 環境では、データ転送の効率を向上させるか、少なくとも低下させない必要があります。

  3. ストレージは、サポートを宣言しているすべてのポリシーで正常に動作する必要があります。

Note

   ベンダー ポリシー (ポリシー値は 7) をサポートするデバイス固有モジュール (DSM) の場合は、このテストを実行する前に、ベンダーのポリシーを現在のポリシーにしてください。

 

このテストを実行するには次のようにします。

  1. Windows Hardware Lab Kit (Windows HLK) は、実行するテスト ケースを取得するスタンドアロン テスト アプリケーションを開始します。

  2. HLK Windows、さらにテストするために MPIO テスト環境の情報を取得します。

  3. パスが iSCSI を超えない場合、テストでは、さらにテストのために関連する HBA インスタンスのフィルター ドライバーが読み込まれます。

  4. パスが iSCSI を超える場合は、次のいずれかの方法を使用して iSCSI 構成情報を指定します。

    • テスト クライアントのウィンドウ ポップアップに構成データを入力します。この場合、[WLK PATH]\JobsWorkingDir\Tasks\[WTTJOBNAME]\ の下に Iscsihctconfig.ini ファイルが作成されます。 詳細については、「iSCSI HBA ブートテスト (ロゴ)」を参照してください。

      Note

         テスト環境に複数のターゲットが含まれる場合は、IQN、ポータル IP、ポート番号など、1 つのターゲット関連情報を入力してください。 IP アドレスについては、複数の IP アドレスがある場合は、そのターゲットの接続に使用する IP アドレスを入力してください。 MPIO テストの場合は、HBA PnP ID を入力する必要があります。

      Note

         iSCSI 環境で相互の chap がサポートされている場合は、[相互] ラジオ ボックスと [相互の Chap をサポートする] チェック ボックスの両方をオンにしてください。

       

    • 入力された iSCS I設定情報は、iscihctconfig.ini のファイルに保存されます。 ユーザーの時間を節約するために、この構成ファイルのコピーをテスト マシンの [WLKClient]\JobsWorkingDir\ の下に置いています。 その後、ユーザーは、iSCSI 構成情報を再入力することなく、同じ iSCSI ストレージ ターゲットに対して同じテスト クライアントでテストを再実行できます。 また、テストの前に、ユーザーは Iscsihctconfig.ini ファイルを手動で作成し、構成データを含むテスト マシンの [WLKClient] \JobsWorkingDir\ の下に置く方法を選択できます。 次の形式を使用します。

      [Targets] DiskTarget=Target [Target] TargetName=iqn.2001-05.com.equallogic:0-8a0906-7e2dd0401-fd1d03f67f74b96b-10-2411a0920-0 PortalPort=3260 PortalIPAddress=10.10.20.80 CHAPType=None

  5. サポートを宣言し、フェールオーバーとフェールバックのシナリオをシミュレートし、テストを実行する負荷分散ポリシーを設定します。 iSCSI 以外のテスト環境の場合は、リンクの弾むシナリオと同時に弾むシナリオをシミュレートします。

  6. 非 ALUA ストレージおよび ALUA ストレージのラウンドロビンポリシーを設定して、パフォーマンスチェックを有効にします。

  7. テストツールは WTTLogger にログを記録します。

コマンド構文

コマンド 説明

mpiotest.exe -d "[WDKDeviceID]" -s [ScriptName] -logo -isiSCSI [isiSCSI]

テストを実行します。

Note

   このテスト バイナリのコマンド ライン ヘルプを表示するには、「/h」と入力します。

 

ファイル一覧

ファイル 場所

Devcon.exe

<[testbinroot]>\idw\

EDT_Disable_Support.vbs

<[testbinroot]>\nttest\DriversTest\storage\wdk\mpiotest\

EDT_Enable_Support.vbs

<[testbinroot]>nttest\DriversTest\storage\wdk\mpiotest\

Iscsiui.exe

<[testbinroot]>\nttest\DriversTest\storage\wdk\mpiotest\

Mpioinstallfiltr.exe

<[testbinroot]>\nttest\DriversTest\storage\wdk\mpiotest\

Mpiotest.exe

<[testbinroot]>\nttest\nttest\DriversTest\storage\wdk\

Mpiotest_script_fvt.txt

<[testbinroot]>\nttest\DriversTest\storage\wdk\mpiotest\

DevFund_PnPDTest_WLK.dll

<[testbinroot]>\

Utility_Enable_Disable_DriverVerifier.dll

<[testbinroot]>\

Utility_DeviceStatusCheck.wsc

<[testbinroot]>\

Utility_DisableEDTSupport.wsc

<[testbinroot]>\

Utility_EmptyTest.wsc

<[testbinroot]>\

Utility_WdfRelatedVerification.wsc

<[testbinroot]>\

 

パラメーター

パラメーター名 パラメーターの説明
LLU_NetAccessOnly テスト ファイル共有にアクセスするためのユーザー アカウントです。
LLU_LclAdminUsr テストを実行するためのユーザー アカウントです。
ScriptName 完全なテストスクリプト
WDKDeviceID テストするデバイスのインスタンス パス
isiSCSI ストレージバスのタイプは iSCSI (T/F)