Freigeben über

Redfish – Standardtests

  • Artikel

Dieser manuelle Test überprüft die Serverhardware-Out-of-Band-Verwaltungsfunktion mithilfe des Redfish-Standards "Distributed Management Task Force (DMTF) Redfish" und Windows PowerShell.

Testdetails

   
Spezifikationen
  • System.Server.BMC.Redfish.Basic
Plattformen
  • Windows Server 2016 (x64)
Unterstützte Versionen
  • Windows 10, Version 1511
  • Windows 10, Version 1607
  • Windows 10, Version 1703
  • Windows 10, Version 1709
  • Windows 10, Version 1803
  • Windows 10, Version 1809
  • Windows 10, Version 1903
  • Nächstes Update auf Windows 10
Voraussichtliche Laufzeit (in Minuten) 5
Kategorie Szenario
Zeitüberschreitung (in Minuten) 300
Neustart erforderlich false
Erfordert eine spezielle Konfiguration false
Typ automatic

 

Zusätzliche Dokumentation

Tests in diesem Funktionsbereich enthalten möglicherweise zusätzliche Dokumentation, einschließlich Informationen zu Voraussetzungen, Einrichtung und Fehlerbehebung, die in den folgenden Themen zu finden sind:

Ausführen des Tests

Hinweis

  Der Redfish-Zielserver, der den Zertifizierungsprozess durchläuft, muss sich im selben Netzwerk befinden wie der Windows-basierte Computer, auf dem die clientseitigen Tests ausgeführt werden.

 

Die Tests erfordern zwei Computer:

  • Redfish-Client – Ein windowsbasierter Computer, der in HLK Studio ausgewählt ist. Der HLK-Auftrag wird auf diesem Computer ausgeführt, nachdem der Auftrag manuell geplant wurde. Der HLK-Auftrag startet einen Windows PowerShell Prozess, der das Pester-Testframework lädt. Das Testframework führt dann die tatsächliche Testdatei Pester.Redfish.HLK.Tests.ps1 aus.
  • Redfish-Server – Ein Remote-Redfish-kompatibles Gerät, das diese Tests überprüfen. Sie müssen die IP-Adresse und Anmeldeinformationen dieses Geräts als Parameter angeben, wenn Sie einen Test auf dem Redfish-Client planen.

Problembehandlung

Allgemeine Informationen zur Problembehandlung von HLK-Testfehlern finden Sie unter Problembehandlung bei fehlgeschlagenen Windows HLK-Tests.

Fehler: Die Ausführungsaufgabe mit Commandline cmd /c powershell.exe -c ... Fehler bei ExitCode N

Die Aufgabe wurde mit einem anderen Exitcode als dem ExpectedTaskExitCode beendet. Dies kann dazu führen, dass die Aufgabe fehlschlägt, wenn der Fehler beim Beenden des Codes festgelegt ist.

Der Exitcode des Windows PowerShell Prozesses gibt die Anzahl der Testfehler an. Bei einer erfolgreichen Testausführung ist ExpectedTaskExitCode auf 0 festgelegt. Ein Wert ohne Null (z. B. "Fehler mit ExitCode 3") gibt die entsprechende Anzahl fehlgeschlagener Tests an.

Problemumgehung:

  1. Identifizieren Sie, welche Tests fehlgeschlagen sind, indem Sie eine der folgenden Methoden verwenden:

    • Überprüfen Sie die Protokolldatei RedfishTestRunLog.xml.
    • Führen Sie die Tests erneut in einer Windows PowerShell Konsole auf dem Redfish-Clientcomputer aus.

  2. Debuggen Sie die fehlgeschlagenen Tests mithilfe von Windows PowerShell ISE auf dem Redfish-Clientcomputer.

Weitere Informationen

Hinweis

   Bei der Planung dieser Tests müssen Sie immer Werte für die Parameter RedfishUri, RedfishUserName und RedfishPassword angeben. Die Tests schlagen fehl, wenn die Standardwerte nicht ersetzt werden.

Die Parameter "TestDestFolder", "RedfishMetadataUri" und "AdditionalData" müssen nicht geändert werden, damit die Tests erfolgreich ausgeführt werden können.

 

Manuelles Ausführen der Tests in einer Windows PowerShell Konsole

Beachten Sie, dass sich die Testdateien auf dem Redfish-Clientcomputer in einem Ordner befinden, der vom Parameter [TestDestFolder] angegeben wird. Standardmäßig ist dies [SYSTEMDRIVE]\RedfishLogo.

  1. Stellen Sie sicher, dass die Datei "Redfish.Device.Config.json" (im durch den Parameter [TestDestFolder] angegebenen Ordner) über die richtigen Informationen zum Redfish-Server verfügt. Wenn diese Datei fehlt, führen Sie den folgenden Windows PowerShell Befehl aus, um die Datei zu generieren. Ersetzen Sie im Befehl die Parameterwerte durch die vom Redfish-Server verwendeten Werte.

    PS C:\Users\Administrator> C:\RedfishLogo\CreateRedfishDeviceConfig.ps1 -RedfishUri 'https://10.20.30.40' -RedfishUserName 'root' -RedfishPassword 'testpass'

  2. Laden Sie das Pester Windows PowerShell Modul. Dies ist ein Windows PowerShell-basierter Testbaum.

    Import-Module Pester -Force

  3. Führen Sie die Tests aus.

    PS C:\Users\Administrator> C:\RedfishLogo\Pester.Redfish.HLK.Tests.ps1

    Die fehlgeschlagenen Tests werden rot hervorgehoben.

Debuggen der fehlgeschlagenen Tests in Windows PowerShell ISE

Beachten Sie, dass sich die Testdateien auf dem Redfish-Clientcomputer in einem Ordner befinden, der vom Parameter [TestDestFolder] angegeben wird. Standardmäßig ist dies [SYSTEMDRIVE]\RedfishLogo.

  1. Starten Sie Windows PowerShell ISE im Startmenü.

  2. Stellen Sie sicher, dass die Datei "Redfish.Device.Config.json" die richtigen Informationen zum Redfish-Server enthält. Wenn diese Datei fehlt, führen Sie den folgenden Windows PowerShell Befehl aus, um die Datei zu generieren. Ersetzen Sie im Befehl die Parameterwerte durch die vom Redfish-Server verwendeten Werte.

    PS C:\Users\Administrator> C:\RedfishLogo\CreateRedfishDeviceConfig.ps1 -RedfishUri 'https://10.20.30.40' -RedfishUserName 'root' -RedfishPassword 'testpass'

  3. Laden Sie das Pester Windows PowerShell Modul im Windows PowerShell ISE-Befehlsfenster. Dies ist ein Windows PowerShell-basierter Testbaum.

    Import-Module Pester -Force

  4. Öffnen Sie in Windows PowerShell ISE die Testdatei (drücken Sie STRG+O) [TestDestFolder]\Pester.Redfish.HLK.Tests.ps1.

  5. Suchen Sie den Code für den fehlerhaften Test. Einzelne Tests werden durch das Schlüsselwort "It“ gekennzeichnet (z. B. "Überprüfen, ob der Dienst die Anforderungen der Redfish-Authentifizierung für unterschiedliche Ressourcen erfüllt.")

  6. Legen Sie einen Haltepunkt im fehlerhaften Test fest. Um dies zu tun, platzieren Sie den Cursor in der ersten Zeile des Tests, und drücken Sie dann F9 (Umschaltpunkt).

  7. Drücken Sie F5 (Skript ausführen), um die Tests auszuführen. Die Testausführung sollte auf dem Haltepunkt beendet werden, den Sie im vorherigen Schritt festgelegt haben.

  8. Verwenden Sie Befehle aus dem Menü "Debuggen“, um den Code zu durchlaufen und Fehler zu untersuchen. Finden Sie unter Debuggen von Skripts in Windows PowerShell ISE.

Parameter

Parametername Parameterbeschreibung
TestDestFolder Ordner, in dem Testinhalte auf dem Clientcomputer bereitgestellt werden.
RedfishUri Uri von Redfish-Service
RedfishMetadataUri Uri der Redfish-Dienstmetadaten
RedfishUserName Benutzer, der Zugriff auf den Redfish-Dienst hat
RedfishPassword Passwort des Benutzers, der Zugriff auf den Redfish-Dienst hat
AdditionaData Alle zusätzlichen Daten, die an Tests übergeben werden müssen