ストレージ パフォーマンス CS
このテストでは、ストレージ デバイスのパフォーマンスがパフォーマンス要件を満たしているかどうかを検証します。
テストの詳細
| 仕様 |
|
| プラットフォーム |
|
| サポートされているリリース |
|
| 予想される実行時間 (分) | 240 |
| カテゴリ | ベンチマーク |
| タイムアウト (分) | 14400 |
| 再起動が必要です | false |
| 特別な構成が必要です | false |
| Type | automatic |
その他のドキュメント
この機能領域のテストには、前提条件、セットアップ、トラブルシューティング情報など、次のトピックに記載されている追加のドキュメントが含まれている場合があります。
テストの実行
ストレージ デバイスは、適切なコントローラーに接続されている必要があります。 このテストは非破壊で行われるため、テスト中にファイルやパーティションが破壊されることはありません。 ただし、ファイルがドライブに書き込まれます。 ロゴ テスト以外で、ドライブ上で発生するアクティビティの量を最小限に抑えることが重要です。 これはパフォーマンス テストなので、外部アクティビティが結果に影響を与える可能性があります。
トラブルシューティング
HLK テスト エラーの一般的なトラブルシューティングについては、「Windows HLK テストのエラーのトラブルシューティング」を参照してください。
WTT トレースの確認:
RunJob - ストレージ パフォーマンス ライブラリの子ジョブの結果にアクセスします。
Run StorPerf のタスク ログを表示します。
ログ ファイル StorPerf.wtl を開きます。
問題を解決する可能性のあるメッセージがないか確認します。
スパン サイズのエラー:
エラー メッセージ: "要求されたスパン サイズ、10737418240 バイトは、事前設定ファイル 7195066368 バイトを超えています。 ロゴ テストは無効です。"
要求されたスパン サイズが事前設定ファイルよりも大きい場合、エラーが記録されますが、テストは継続して実行されます。 作成された testzone.tmp ファイルが小さすぎて、テストで要求された範囲を十分にテストすることができません。
このファイルを作成するには、より多くの領域が必要です。または、ファイルが小さすぎて、テストを開始する前に適切に削除されませんでした。
現在、必要とされる事前設定ファイルの最小サイズは 10Gb です。 また、ドライブには 20% の空き領域が必要です。 事前設定フェーズでは、ドライブ上の総空き領域の 20% を残して、すべての空き領域を埋めるファイルが書き込まれます。
ディスクの合計サイズ * 20% + 10GB < 空き領域
個々のテスト結果の確認:
ストレージ パフォーマンス CS / ストレージ パフォーマンス USB3 のジョブ ログを参照します。
テスト内部で実行される各テスト ケースのファイルには、トリアージのためにコントローラーにコピー バックされるものが数種類あります。 これらのファイルには、WTT ログで得られる情報よりも多くの情報が含まれています。
.result ファイルは、このテストから起動された各プロセスのコンソール出力です。
.xml ファイルが、このテストが起動するワークロードによって生成され、 メトリックを取得するために解析されます。
.csv ファイルは、すべてのテスト ケースについて解析されたすべてのデータの集計です。
.xls ファイルは、同じ名前の .csv ファイルと同じ集計ですが、求められるメトリック バーの値と共に、合格/不合格が色分けされている点が異なります。
.result ファイルと .xml ファイルの名前付けで、テストケースの実行が一意に識別されます。
Scen = シナリオ。
長い 16 進数の文字列は、ワークロードに渡されたすべてのパラメーターを識別します。
3 桁の 16 進数の文字列は、スレッド ID です。
最後の数字は、同じワークロードでのまったく同じテスト ケースの実行回数です。
ログにエラーが発生した場合、最初に確認する場所は、エラーが発生したテスト ケースと同名の .result ファイルです。 ワークロードでエラーが発生した場合、コンテンツにアクセスしやすいように、.result ファイルは .wtl ログ ファイルにコピーされます。
ディスクへのハンドルを開くことができない場合、ドライブにパーティションが存在しないか、管理者として実行されていない可能性があります。
メトリックについて不一致がある場合、.xml ファイルにその値が格納されています
分散やテスト ケースの相互作用について不一致がある場合は、.csv/.xls ファイルですべてのテストの結果を表示できます。
開いている ETW のログに関する問題。
テストが実行中に閉じられた場合、ETW ログがアクティブのままになっている可能性があります。
これをリセットする最も簡単な方法は、コンピューターを再起動することです。
ロガーは手動で閉じることもできます。
管理者特権でのコマンド プロンプトを開きます。
logman query -ets を実行します
logman stop -ets "Circular BitLocker Logger" を実行します
トラブルシューティング情報の詳細については、「Device.Storage テストのトラブルシューティング」を参照してください。
詳細
このジョブでは、テスト対象デバイスのデバイス インスタンス ID を受け取り、シナリオに応じてデバイス インスタンス ID を物理ドライブ番号またはドライブ レターに変換します。 シナリオ上必要な場合は、テストに必要な構成にするために、ジョブによりドライブをパーティション分割してフォーマットします。 テストでは、要件の項目にマップされた一連のテスト ケースを実行します。 テスト ケースは自己完結型であり、順番に実行されます。 テスト ケースの一覧を取得するには、適切なデバイスを指定した PrintPolicy コマンド ライン オプションを使用します。 これらのテスト ケースは、さらなるテストやデバッグを行うために PolicyXML コマンドライン オプションでカスタム ポリシー xml ファイルを使い、スタンドアロン モードのテストによりコマンドラインで実行することができます。
ストレージ パフォーマンス テストでは、デバイスの種類ごとに、実行するパフォーマンス テストと適切なメトリックを定義するポリシー テーブルが格納されています。 テーブル内の適切な項目が選ばれると、テストは、指定されたワークロード (ここでは StorageAssessment) のインスタンスを順次生成して、そのデバイスのテーブルで指定された項目をテストします。 StorageAssessment でテストが完了し結果が作成されると、ストレージ パフォーマンス テストはその値を解析し、ロゴ要件で定義されたバーと比較して、合格/不合格のログを出力します。
テストするシナリオは、コマンドラインの DeviceTag フラグによって参照されます。 このフラグは、ポリシー xml 内の TestcaseGroup です。 テストにはいくつかのシナリオが組み込まれていますが、必要に応じてカスタム シナリオも使うことができます。
シナリオは、注文、ワークロード、アクセス、操作、操作値、IO サイズ、スパン サイズ、ランタイム、キューの深さ、事前設定の割合、および事前設定 MB で定義されています。 テーブルで定義されている各シナリオは、一度生成されるワークロードに対応します。 1 つのデバイスに同じシナリオが複数定義されていても、1 つのテストケースのみが呼び出されます。
メトリックは、その型と値によって定義されます。 メトリックの本質は、その単位と、バーが上限であるか下限であるかです。 各シナリオに対して多くのメトリックを指定できます。その場合、そのシナリオで呼び出されるテストケースは 1 つだけになります。
テーブルの各エントリには、そのテスト ケースのテストを停止する前、直近の一連の実行で許容される最大分散を定義する分散条件が指定されています。 多くのエントリでは、最小実行数 5 回、最大実行数 30 回と定義されており、テストを継続するには、過去 5 回の実行の分散が 10% 未満でなければなりません。 テスト ケースは最大 30 回、または分散の要件が満たされるまで再実行されます。 その時点で、最後に実行された一連のメトリックの定義済みプロパティ (最小値、最大値、平均値、代表値など) に基づいて、メトリックが評価されます。
ストレージ パフォーマンス テストは 1 つのワークロードに限定されませんが、ポリシー テーブルで定義されているほとんどのシナリオでは、パフォーマンス ワークロードとメトリックを生成するために StorageAssessment ワークロードが使われます。
コマンドの使用方法
| コマンド | 説明 |
|---|---|
StorPerf.exe /DriveLetter [StorageDriveLetter] /DeviceTag CS_Boot |
指定されたドライブで CS テストを実行します。 DeviceTag は、HS200 対応ドライブの場合、CS_Boot_HS200 とすることもできます。 |
コマンド構文
| コマンド オプション | 説明 |
|---|---|
/DriveNumber <番号> |
テスト対象デバイスの物理ドライブ番号。 例: /DriveNumber 0 |
/DriveLetter <文字> |
テスト対象デバイスのドライブ文字。 例: /DriveLetter C |
/DeviceTag <値> |
構成 xml ファイルから入力として選択する TestcaseGroup または ComparisonGroup を特定します。 このパラメーターでは大文字と小文字が区別され、ポリシー xml ファイルと比較 xml ファイルの両方のインデックス作成に使用されます。 例: /DeviceTag CS_Boot |
/PolicyXML <値> |
ポリシー xml ファイルの名前。 I/O ワークロードを実行するためのすべてのパラメーターを定義します。 オプションを指定しない場合、既定のファイルが生成されます。 例: /PolicyXML CSPolicy.xml |
/Compare <値><値> |
比較する 2 つの xml ファイル。 これらのファイルは、このテストの以前の実行から生成されている必要があります。 各テスト ケースに対して反復回数が同じになる保証はないので、"AllTestCasesAggregated*.xml" ファイルではなく、"FinalTestCasesAggregated*.xml" ファイルを使用する必要があります。 例: /Compare FinalTestCasesAggregated_42f4.xml FinalTestCasesAggregated_a732.xml |
/CompareXML <値> |
比較 xml ファイルの名前。 比較を実行するためのすべてのパラメーターを定義します。 オプションを指定しない場合、既定のファイルが生成されます。 例: /CompareXML CSCompare.xml |
/PrintPolicy |
ポリシー テーブルを出力します。 |
Note
このテスト バイナリのコマンド ライン ヘルプを表示するには、「/h」と入力します。
ファイル一覧
| ファイル | 場所 |
|---|---|
StorPerf.exe |
<[testbinroot]>\NTTest\driverstest\storage\wdk\ |
StorageAssessment.exe |
<[testbinroot]>\NTTest\driverstest\storage\wdk\StorageAssessment\ |
ssdtest.dat |
<[testbinroot]>\NTTest\driverstest\storage\wdk\StorageAssessment\ |
パラメーター
| パラメーター名 | パラメーターの説明 |
|---|---|
| LLU_NetAccessOnly | テスト ファイル共有にアクセスするためのユーザー アカウントです。 |
| LLU_LclAdminUsr | テストを実行するためのユーザー アカウント。 |
| WDKDeviceID | テストするデバイスのインスタンス パス。 |
| DeviceID | DriveLetter または DriveNumber のいずれか |
| DeviceTag | |
| DiskDeviceObjLink | Create Storage Parameters によって割り当てられます。 |
| Destructive | (0、1) 0 = パッシブ、1 = 破壊的 |
| QueryHS200 | HS200 モードをサポートするデバイスがあるかどうかを問い合わせます |