Multipfad-E/A – Test (LOGO)
Dieser Test bietet Multipfad-E/A-Tests für die Kompatibilität der Speicherlösung eines Anbieters mit Microsoft®-Treiberlösungen.
Hinweis
Der Test ist speziell auf die Ausführung auf x64-Prozessorarchitekturen ausgelegt.
Testdetails
| Spezifikationen |
|
| Plattformen |
|
| Unterstützte Versionen |
|
| Voraussichtliche Laufzeit (in Minuten) | 180 |
| Kategorie | Entwicklung |
| Timeout (in Minuten) | 10800 |
| 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
Vervollständigen Sie vor der Testausführung die Testeinrichtung für den Typ des RAID-Speicherarrays, den Sie testen. Weitere Informationen finden Sie unter Testen von Hardware-basiertem RAID (Speicherarray) – Übersicht.
Darüber hinaus erfordert dieser Test die folgende Software und Hardware:
Hardwarespeicher-RAID-Array, das entweder das Microsoft Device Specific Module (DSM) oder ein Drittanbieter-DSM verwendet, das eine Schnittstelle zur Microsoft MPIO-Kernarchitektur hat
Softwarekomponenten, die im getesteten DSM- oder Hardwarespeicher-RAID-Array enthalten sind.
Multipfad-E/A-Setup
Problembehandlung
Informationen zur allgemeinen Problembehandlung von HLK-Testfehlern finden Sie unter Problembehandlung von Windows HLK-Testfehlern.
Allgemeine Informationen zur Problembehandlung finden Sie unter Problembehandlung bei Device.Storage-Tests.
Außerdem weist dieser Test die folgenden bekannten Probleme auf:
Problem |
Details |
Die MPIO-Testumgebung für ein Szenario ohne iSCSI ist möglicherweise nicht richtig konfiguriert. |
Beim Testen in einer MPIO-Testumgebung ohne iSCSI erfordert der Test, dass der Hostbusadapter (HBA) mit mindestens zwei Ports (oder mindestens zwei HBAs, wenn der HBA nur einen Port hat) mit demselben iSCSI-Ziel verbunden sein muss. Mit den folgenden manuellen Schritten kann überprüft werden, ob die Testumgebung richtig eingerichtet ist:
|
Der Test ruft beim Installieren des Filters keine HBA-Geräteinstanz ab. |
Stellen Sie sicher, dass der DSM-Name im Registrierungsschlüssel (INF-Datei) mit dem im DSM selbst angegebenen Namen übereinstimmt. |
Der Test kann die iSCSI-WMI-Informationen nicht abrufen, wenn das Testspeichergerät sowohl über Fibre Channel als auch über iSCSI verbunden ist, wenn der Test gegen Fibre Channel ausgeführt wird. |
Es wird empfohlen, MPIO-LUNs, die von demselben DSM beansprucht werden, nicht über mehr als einen Bustyp in derselben Testumgebung zu konfigurieren. |
Der Test schlägt fehl, wenn Pfade entfernt werden, nachdem der Test die Testfälle „Link Bouncing“ und „Simultaneous Bouncing“ ausgeführt hat. |
Stellen Sie sicher, dass der HBA den neuesten Treiber ausführt (einen, der die Windows-Logozertifizierung bestanden hat). Beim Testen in einer Testumgebung ohne iSCSI erfordert der Multipfad-E/A-Test, dass der HBA-Treiber den Plug & Play-Treibertest erfolgreich besteht. Wenn der HBA diesen Test nicht bestehen kann, wechseln Sie bitte zu einem anderen zertifizierten HBA-Modell des HBA und wiederholen Sie den Test. Dieses Problem kann auftreten, weil die Wiederherstellung von MPIO-Pfaden lange dauert. |
Der Test schlägt fehl, wenn er unter einer MPIO-Startumgebung ausgeführt wird. |
Führen Sie den Test nicht in einer MPIO-Starttestumgebung aus. |
Der Test kann iSCSI-Sitzungen im iSCSI-Ziel nicht wiederherstellen. |
Wenn in der MPIO-Testumgebung mehrere Ports (IP-Adressen) mit einem iSCSI-Ziel verbunden sind, müssen Sie sicherstellen, dass während des Tests mindestens zwei iSCSI-Sitzungen über die IP-Adresse verbunden sind. Obwohl der Multipfad-E/A-Test Benutzern ermöglicht, mehrere Port-Verbindungen zu einem iSCSI-Ziel zu konfigurieren, kann der Benutzer gleichzeitig für alle iSCSI-bezogenen Tests nur eine IP-Adresse während des Tests zuordnen. |
Der Test hat die iSCSI-Benutzeroberfläche nicht angezeigt |
Stellen Sie zunächst sicher, dass der ausgewählte LUN-Bustyp iSCSI ist. Wenn nicht, zeigt der Multipfad-E/A-Test die iSCSI-Benutzeroberfläche nicht an. Zweitens, überprüfen Sie bitte, ob die iscsihctconfig.ini-Datei unter folgendem Pfad vorhanden ist: [WLKClient]\JobsWorkingDir\. Wenn diese Datei vorhanden ist, löschen Sie sie, wenn Sie die iSCSI-Benutzeroberfläche zur manuellen Eingabe der iSCSI-Konfigurationsinformationen verwenden möchten. |
Der Test ist fehlgeschlagen oder abgestürzt. |
Wenn der Multipfad-E/A-Test nicht ausgeführt werden konnte, vergewissern Sie sich bitte, dass die Testumgebung sauber ist, bevor Sie den Test erneut ausführen. Dieses Problem kann auftreten, wenn Ihr Controller ursprünglich Windows Logo Kit 1.5 enthielt und Sie Windows nicht neu installiert haben, bevor Sie Windows Logokit 1.6 installiert und verwendet haben, um Ihre Speichertests abzuschließen. Installieren Sie in diesem Fall Windows neu und starten Sie den Test erneut. |
Der Test schlägt mit E/A-Vorgangsfehlern fehl |
Wenn der Multipfad-E/A-Test fehlgeschlagen ist und die Protokolldatei E/A-Vorgangsfehler enthält, stellen Sie bitte sicher, dass Ihre LUNs online und im Rohzustand initialisiert sind, bevor Sie den Test ausführen. Wenn die LUNs online und initialisiert sind, versuchen Sie bitte, eine Datei von einer LUN mit einigen Pfaden zu kopieren oder zu lesen, für die ein Failover durchgeführt wurde. |
Wenn Sie beabsichtigen, einen Supportincident zu eröffnen, befolgen Sie diese Schritte, um Informationen zu erhalten, die für den Kundendienst nützlich sind:
Bitte stellen Sie Ihr .cpk-Paket für die Übermittlung bereit. Dieses .cpk-Paket sollte nicht nur das Multipfad-E/A-Testprotokoll enthalten, sondern auch Protokolle für den SCSI-Konformitätstest und den ALUA-MPIO-Test.
Machen Sie bitte Screenshots Ihrer Testumgebung. Wenn das Betriebssystem Windows 2008 R2 oder höher ist, erfassen Sie bitte den Bildschirm der MPIO-Konfigurationsmomentaufnahme über die Systemsteuerung. Um dies anzuzeigen, klicken Sie auf Start>Systemsteuerung>MPIO>-Konfigurationsmomentaufnahme.
Falls es zu einem Absturz gekommen ist, erstellen Sie bitte eine Dump-Datei. Führen Sie außerdem den folgenden Test schrittweise erneut aus:
Kopieren Sie die Testbinärdateien, Binärdateien und Dateien auf den Windows HLK-Testcomputer, darunter: mpiotest.exe, mpioinstallfiltr.exe, iscsiui.exe, devcon.exe, pnpfiltr.sys, pnpdtest.exe und die Datei mpiotest_script_fvt.txt.
Öffnen Sie die Eingabeaufforderungsfenster mit Administratorrechten.
Führen Sie einen der folgenden Befehle aus:
Wenn der Bustyp iSCSI ist, führen Sie das Tool iscsui.exe aus und geben Sie Informationen ein, um eine iscsihctconfig.ini-Datei zu erstellen.
Wenn der Bustyp kein iSCSI ist, führen Sie den folgenden Befehl aus: „mpioinstallfiltr -d <DSM-Geräteinstanzpfad> (z. B. ROOT\MPIO\0001) -i“, und starten Sie den Testcomputer neu. Wenn dieser Befehl abstürzt, kopieren Sie alle Protokolldateien aus der Befehlskonsole mit dem Editor.
Führen Sie den folgenden Befehl zum Testen aus. Selbst wenn der Test abstürzt, können Sie immer noch alle Protokolle von der Befehlskonsole in den Editor kopieren.
- Mpiotest.exe -d <DSM-Geräteinstanzpfad> (z. B. ROOT\MPIO\0001) -s [ScriptName] -logo -isiSCSI [T/F].
Wenn der Bustyp kein iSCSI ist, führen Sie an einer Eingabeaufforderung den folgenden Befehl aus, um den Filtertreiber zu deinstallieren: „mpioinstallfiltr -d <DSM-Geräteinstanzpfad> (z. B ROOT\MPIO\0001) -c“, und starten Sie den Systemstartcomputer neu.
Weitere Informationen
Dieser Test wird nur für gerätespezifische Module (DSM) angewendet, entweder Microsoft DSM oder ein Drittanbieter-DSM.
Der Test umfasst die folgenden grundlegenden Testaussagen, die in vier Testfällen zusammengefasst sind:
Failover: Die Datenübertragung wird nicht unterbrochen, wenn einige Pfade, aber nicht alle, unterbrochen werden.
Failback: Die Datenübertragung funktioniert normal, wenn einige Pfade nach einem Failover wiederhergestellt werden.
Link Bounce: Bei einer MPIO-Umgebung sind alle Pfade außer einem Pfad unterbrochen. Wenn dieser Pfad unterbrochen und innerhalb von 15 Sekunden wiederhergestellt wird, kann die Datenübertragung fehlerfrei fortgesetzt werden.
Gleichzeitiges Failover und Failback oder „Simultaneous Bouncing“: Die Datenübertragung wird nicht unterbrochen, wenn einige Pfade ausfallen und andere Pfade gleichzeitig ausfallen.
Lastenausgleichsrichtlinie: Es können verschiedene Richtlinien festgelegt werden, und die Datenübertragung kann damit ordnungsgemäß funktionieren. Für die Round-Robin-Laderichtlinie und die Round-Robin-Laderichtlinie mit Teilmenge prüft der Test, ob die Effizienz beeinträchtigt wird.
Zu den Testkomponenten gehören eine eigenständige Testanwendung, ein Fehlereinführungsfiltertreiber, eine Testfallkonfigurationsdatei, eine iSCSI-Konfigurationsdatei (wenn der Pfad über eine iSCSI-Sitzung erstellt wird) und der Device Test Manager (DTM).
Kunden einer Unternehmensspeicherlösung verlassen sich stark auf die Hochverfügbarkeit ihrer Komponenten. Im Speicher wird Hochverfügbarkeit häufig durch Redundanz realisiert. Multipfad-E/A (MPIO) ist eine solche Implementierung für die Fabric-Ebene einer Unternehmensspeicherlösung. Microsoft unterstützt Multipfad-E/A mit einem Multipfad-Treiber (mpio.sys) und einem gerätespezifischen Modul (msdsm.sys), die mit dem Windows Advanced Server-Betriebssystem im Windows Vista-Zeitrahmen geliefert werden.
Der Test bietet Multipfad-E/A-Tests für die Kompatibilität der Speicherlösung eines Anbieters mit Microsoft-Treiberlösungen. Sein Fokus liegt auf den folgenden Bereichen:
Pfad-Failover und Wiederherstellung sollten sich nicht auf die Datenübertragungsqualität auswirken. Ein Zweck der Einrichtung einer MPIO-Umgebung besteht darin, die Zuverlässigkeit der Datenübertragung zu erhöhen. Dieser Test simuliert mehrere einfache Szenarien, die in der Praxis passieren würden, um einen Pfad zu unterbrechen, und prüft dann, ob die Umgebung Daten normal übertragen kann.
Die Effizienz der Datenübertragung sollte in einer MPIO-Umgebung verbessert oder zumindest nicht beeinträchtigt werden.
Speichergeräte sollten unter allen Richtlinien, die sie deklarieren zu unterstützen, normal funktionieren.
Hinweis
Für ein gerätespezifisches Modul (DSM), das die Anbieterrichtlinie unterstützt (Richtlinienwert ist 7), machen Sie bitte die Richtlinie des Anbieters zur aktuellen Richtlinie, bevor Sie diesen Test ausführen.
So führen Sie diesen Test aus
Das Windows Hardware Lab Kit (Windows HLK) startet die eigenständige Testanwendung, die die auszuführenden Testfälle abruft.
Die Windows HLK ruft die MPIO-Testumgebungsinformationen für weitere Tests ab.
Wenn ein Pfad nicht über iSCSI liegt, lädt der Test den Filtertreiber für eine verwandte HBA-Instanz für weitere Tests.
Wenn der Pfad über iSCSI liegt, geben Sie die iSCSI-Konfigurationsinformationen mithilfe einer der folgenden Methoden an:
Geben Sie die Konfigurationsdaten in das Popup-Fenster auf dem Testclient ein, wodurch die Datei „Iscsihctconfig.ini“ unter [WLK PATH]\JobsWorkingDir\Tasks\[WTTJOBNAME]\ erstellt wird. Weitere Informationen finden Sie unter iSCSI HBA – Starttest (LOGO).
Hinweis
Wenn Ihre Testumgebung mehrere Ziele umfasst, geben Sie bitte eine zielbezogene Information ein, einschließlich IQN, Portal-IP und Portnummer. Wenn Sie über mehrere IP-Adressen verfügen, geben Sie für die IP-Adresse bitte diejenige ein, die zum Verbinden dieses Ziels verwendet wird. Für den MPIO-Test müssen Sie keine HBA-PnP-ID eingeben.
Hinweis
Wenn Ihre iSCSI-Umgebung wechselseitiges CHAP unterstützt, aktivieren Sie bitte sowohl das Optionsfeld „Wechselseitig“ als auch das Kontrollkästchen „Unterstützt wechselseitiges CHAP“.
Die eingegebenen iSCSI-Konfigurationsinformationen werden in der iscsihctconfig.ini-Datei gespeichert. Damit Benutzer Zeit sparen können, haben wir eine Kopie dieser Konfigurationsdatei unter [WLKClient]\JobsWorkingDir\ auf dem Testcomputer eingefügt. Anschließend können Benutzer den Test auf demselben Testclient für dasselbe iSCSI-Speicherziel erneut ausführen, ohne die iSCSI-Konfigurationsinformationen erneut einzugeben. Außerdem können Benutzer vor dem Testen die Datei „Iscsihctconfig.ini“ manuell erstellen und sie unter [WLKClient] \JobsWorkingDir\ auf dem Testcomputer einfügen, der die Konfigurationsdaten enthält. Verwenden Sie das folgende Format:
[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
Legen Sie die Lastenausgleichsrichtlinie fest, die Unterstützung deklariert, Failover- und Failback-Szenarien simuliert und Tests durchführt. Simulieren Sie für eine Testumgebung ohne iSCSI die Szenarios für „Link Bouncing“ und „Simultaneous Bouncing“.
Legen Sie die Round-Robin-Richtlinie für Nicht-ALUA-Speicher und ALUA-Speicher fest, um die Leistungsüberprüfung zu ermöglichen.
Das Testtool meldet sich bei WTTLogger an.
Befehlssyntax
| Befehl | Beschreibung |
|---|---|
mpiotest.exe -d "[WDKDeviceID]" -s [ScriptName] -logo -isiSCSI [isiSCSI] |
Führt den Test aus. |
Hinweis
Geben Sie /h ein, um die Befehlszeilenhilfe für diese Testbinärdatei anzuzeigen.
Dateiliste
| Datei | Standort |
|---|---|
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]>\ |
Parameter
| Parametername | Parameterbeschreibung |
|---|---|
| LLU_NetAccessOnly | Benutzerkonto für den Zugriff auf die Testdateifreigabe. |
| LLU_LclAdminUsr | Benutzerkonto für die Ausführung des Tests. |
| ScriptName | Vollständiges Testskript |
| WDKDeviceID | Instanzpfad des zu testenden Geräts |
| isiSCSI | Ist Speicherbustyp iSCSI (T/F) |