Redfish 基本的なテスト

[アーティクル]
06/19/2023

この手動テストでは、Distributed Management Task Force (DMTF) Redfish 標準と Windows PowerShell を使用して、サーバーハードウェアの帯域外管理機能を検証します。

テストの詳細


仕様	System.Server.BMC.Redfish.Basic
プラットフォーム	Windows Server 2016 (x64)
サポートされているリリース	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 への次の更新プログラム
予想される実行時間 (分)	5
カテゴリ	シナリオ
タイムアウト (分)	300
再起動が必要です	false
特別な構成が必要です	false
Type	automatic

その他のドキュメント

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

System.Server のその他のドキュメント

テストの実行

Note

認定プロセスを実行するターゲット Redfish サーバーは、クライアント側テストを実行する Windows ベースのコンピューターと同じネットワーク上にある必要があります。

テストには 2 台のコンピューターが必要です。

Redfish クライアント - HLK Studio で選択した Windows ベースのコンピューター。ジョブを手動でスケジュールした後、このコンピューターで HLK ジョブが実行されます。 HLK ジョブによって、Pester テストフレームワークを読み込む Windows PowerShell プロセスが開始されます。その後、テストフレームワークによって実際のテストファイル Pester.Redfish.HLK.Tests.ps1 が実行されます。
Redfish サーバー - これらのテストを検証するリモート Redfish 互換デバイス。 Redfish クライアントでテストをスケジュールするときに、このデバイスの IP アドレスと資格情報をパラメーターとして指定する必要があります。

トラブルシューティング

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

エラー： コマンドライン cmd /c powershell.exe -c ... での実行タスクが ExitCode N で失敗しました

タスクは ExpectedTaskExitCode 以外の終了コードで終了しました。 Fail On Exit Code (終了コードで失敗する) に設定されている場合、これによりタスクが失敗する可能性があります。

Windows PowerShell プロセスの終了コードは、テストエラーの数を示します。テストの実行が成功した場合、ExpectedTaskExitCode は 0 に設定されます。 0 以外の値 (たとえば、"ExitCode 3 で失敗しました") は、対応する失敗したテストの数を示します。

対処法:

次のいずれかの方法を使用して、失敗したテストを特定します。
- ログファイル RedfishTestRunLog.xml を確認します。
- Redfish クライアントコンピューターの Windows PowerShell コンソールでテストを手動で再度実行します。
Redfish クライアントコンピューターの Windows PowerShell ISE を使用して、失敗したテストをデバッグします。

詳細

Note

これらのテストをスケジュールするときは、RedfishUri、RedfishUserName、RedfishPassword の各パラメーターの値を常に指定する必要があります。既定値を置き換えないと、テストは失敗します。

TestDestFolder、RedfishMetadataUri、AdditionalData の各パラメーターは、テストを成功させるために変更する必要はありません。

Windows PowerShell コンソールでテストを手動で実行する

テストファイルを Redfish クライアントコンピューターの [TestDestFolder] パラメーターで指定されているフォルダーに置くことに注意してください。既定では、[SYSTEMDRIVE]\RedfishLogo です。

Redfish.Device.Config.json ファイル ([TestDestFolder] パラメーターで指定されたフォルダーにあります) に Redfish サーバーに関する正しい情報が含まれることを確認します。このファイルが見つからない場合は、次の Windows PowerShell コマンドを実行してファイルを生成します。コマンドのパラメーターの値を、Redfish サーバーで使用される値に置き換えます。
```
PS C:\Users\Administrator> C:\RedfishLogo\CreateRedfishDeviceConfig.ps1 -RedfishUri 'https://10.20.30.40' -RedfishUserName 'root' -RedfishPassword 'testpass'
```
Pester Windows PowerShell モジュールを読み込みます。これは、Windows PowerShell ベースのテストハーネスです。
```
Import-Module Pester -Force
```
テストを実行します。
```
PS C:\Users\Administrator> C:\RedfishLogo\Pester.Redfish.HLK.Tests.ps1
```
失敗したテストは赤で強調表示されます。

失敗したテストを Windows PowerShell ISE でデバッグする

[スタート] メニューから Windows PowerShell ISE を起動します。
Redfish.Device.Config.json ファイルに Redfish サーバーに関する正しい情報が含まれることを確認します。このファイルが見つからない場合は、次の Windows PowerShell コマンドを実行してファイルを生成します。コマンドのパラメーターの値を、Redfish サーバーで使用される値に置き換えます。
```
PS C:\Users\Administrator> C:\RedfishLogo\CreateRedfishDeviceConfig.ps1 -RedfishUri 'https://10.20.30.40' -RedfishUserName 'root' -RedfishPassword 'testpass'
```
Windows PowerShell ISE のコマンドウィンドウで Pester Windows PowerShell モジュールを読み込みます。これは、Windows PowerShell ベースのテストハーネスです。
```
Import-Module Pester -Force
```
Windows PowerShell ISE で、テストファイル [TestDestFolder]\Pester.Redfish.HLK.Tests.ps1 を開きます (Ctrl + O キーを押します)。
失敗したテストのコードを見つけます。個々のテストは、It キーワードによってマークされています (例: It "サービスがさまざまなリソースの Redfish 認証要件を満たしていることを確認する。")
失敗したテストにブレークポイントを設定します。これを行うには、テストの最初の行にカーソルを置き、F9 キー (ブレークポイントの切り替え) を押します。
F5 キー (スクリプトの実行) を押してテストを実行します。前のステップで設定したブレークポイントで、テストの実行が停止するはずです。
[デバッグ] メニューのコマンドを使用してコードをステップ実行し、エラーを調べます。「Windows PowerShell ISE でスクリプトをデバッグする方法」をご覧ください。

パラメーター

パラメーター名	パラメーターの説明
TestDestFolder	テストの内容が展開されるクライアントコンピューター上のフォルダー。
RedfishUri	Redfish サービスの URI
RedfishMetadataUri	Redfish サービスメタデータの URI
RedfishUserName	Redfish サービスにアクセスできるユーザー
RedfishPassword	Redfish サービスにアクセスできるユーザーのパスワード
AdditionaData	テストに渡す必要があるその他のデータ

次の方法で共有