Zurück zur Inhaltsseite

Diagnose: Benutzerhandbuch für Intel® PRO Netzwerkadapter – WMI und CDM Provider

Diagnose-Klassen
Registrierungseinträge
Protokollieren
Assoziative Klassen
Tests


Diagnose-Klassen

IANet_DiagTest

Zweck
IANet_DiagTest gehört einer Unterklasse von CIM_DiagnosticTest an. Die Klasse bietet eine generelle Plattform für das Ausführen und Steuern von Diagnosetests für einen von Intel® PROSet unterstützten Ethernet-Adapter. Die Überklasse CIM_DiagnosticTest ist so gestaltet, dass sie das Testen beliebiger Computerhardware auf einem CIM-aktivierten System unterstützt. Die Eigenschaften der Klasse sind von deskriptiver Art und der Testmechanismus wird von den exponierten Methoden bereitgestellt.

Instanzen
Der Schlüssel ist der Name, und bei diesem Provider handelt es sich um die Konkatenation des numerischen Testindex an der GUID für den Referenzadapter (z. B. 1@{12345678-9ABC-DEF0-1234-123456789012}). Dieser Schlüsselwert stellt in gewissem Sinn eine redundante Information dar, da alle Informationen für das Referenzieren eines Adapters und Tests als Objektparameter an RunTest und andere Methoden übertragen werden. Die Instanz muss jedoch mit den Parametern konsistent sein, da der Provider den Befehl andernfalls ablehnt. In der Untertitel-Eigenschaft wird der Name des Tests angegeben, der von dieser Instanz ausgeführt wird. Andere Eigenschaftsfelder enthalten weitere Beschreibungen und Runtime-Informationen.

Erstellen von Instanzen
Sie können keine Instanzen von IANet_DiagTest erstellen.

Löschen von Instanzen
Sie können keine Instanzen von IANet_DiagTest löschen.

Ändern von Eigenschaften
Für diese Klasse sind keine durch den Benutzer veränderbaren Eigenschaften vorhanden.

Assoziationen

Nicht unterstützte Eigenschaften
Install Date, OtherCharacteristicDescription

Methoden
Diese Klasse unterstützt die folgenden Methoden:

Klassenhierarchie

Für CimV2. Unbenutzte Eigenschaften und Methoden werden nicht aufgeführt.

Ausführen von RunTest und andere Methoden in WbemTest

Die RunTest-Methode aus der MOF-Datei sieht folgendermaßen aus:

uint32
RunTest([IN] CIM_ManagedSystemElement ref SystemElement,
[IN] CIM_DiagnosticSetting ref Setting,
[OUT] CIM_DiagnosticResult ref Result);

Die ersten beiden Parameter kennzeichnen In-Parameter. Sie müssen den Objektpfad für beide referenzierten Objekte ermitteln. Außerdem benötigen Sie den Objektpfad für das IANet_DiagTest-Objekt, das das RunTest-Objekt exportiert.

  1. Klicken Sie im Hauptdialogfeld für den WBEM-Test auf Connect (Verbinden).
  2. Geben Sie den zutreffenden Server\Namespace ein. Die Namespaces IntelNCS und CimV2 werden unterstützt.
  3. Klicken Sie auf die Schaltfläche Enum Instances (Instanzen aufzählen) des WBEM-Tests, und geben Sie IANet_DiagTest ein.
  4. Doppelklicken Sie auf die Instanz von IANet_DiagTest. Der Name hat die Form X@[AdapterGUID}. X steht dabei für den Testnamen, und AdapterGUID kennzeichnet den Adapternamen, der dem Namensschlüssel von IANet_EthernetAdapter entspricht.
  5. Das folgende Beispiel zeigt einen abgerufenen Objektpfad:
    \\MYCOMPUTER\root\Cimv2:IANet_DiagTest.Name="1@{4A0CDABE-F6C3-45D0-B60D-F6E7BAFA2C2C}"
  6. Speichern Sie den Objektpfad.
  7. Klicken Sie auf die Schaltfläche Enum Instances (Instanzen aufzählen) des WBEM-Tests, und geben Sie IANet_EthernetAdapter ein.
  8. Doppelklicken Sie auf den zu testenden Adapter.
  9. Das folgende Beispiel zeigt einen abgerufenen Objektpfad:
    \\MYCOMPUTER\root\cimv2:IANet_EthernetAdapter.DeviceID="{4A0CDABE-F6C3-45D0-B60D-F6E7BAFA2C2C}"
  10. Speichern Sie den Objektpfad.
  11. Klicken Sie auf die Schaltfläche Enum Instances (Instanzen aufzählen) des WBEM-Tests, und geben Sie IANet_DiagSetting ein.
  12. Doppelklicken Sie auf die Einstellung, die der Adapter/Test-Kombination entspricht.
  13. Das folgende Beispiel zeigt einen abgerufenen Objektpfad:
    \\MYCOMPUTER\root\cimv2:IANet_DiagSetting.SettingID="1@{4A0CDABE-F6C3-45D0-B60D-F6E7BAFA2C2C}"
  14. Speichern Sie den Objektpfad.
  15. Klicken Sie im Hauptdialogfeld für den WBEM-Test auf Execute Method (Methode ausführen).
  16. Fügen Sie den IANet_DiagTest-Objektpfad in das Dialogfeld ein. Klicken Sie auf OK.
  17. Wählen Sie den Test im Dropdown-Listenfeld für die Methode aus.
  18. Klicken Sie auf die Schaltfläche Edit In Parameters (In-Parameter bearbeiten).
  19. Für RunTest sind Setting (Einstellung) und SystemElement die In-Parameter. Fügen Sie die zuvor gespeicherten Objektpfade für die Einstellung und den Adapter, und schließen Sie das Fenster.
  20. Klicken Sie auf die Schaltfläche Execute (Ausführen).
  21. Listen Sie die IANet_DiagResult-Klasse auf ähnliche Weise wie zuvor die In-Parameter auf.
  22. Überprüfen Sie gegebenenfalls das ausgewählte Ergebnisobjekt.

IANet_DiagSetting

Zweck
Instanzen von IANet_DiagSetting stellen spezifische Anweisungen für Runtime-Diagnosetests bereit. Die verwendeten Anweisungen gelten für alle Tests und sind an die Überklasse CIM_DiagnosticSetting gebunden. Dazu gehören Eigenschaften wie beispielsweise ReportSoftErrors und HaltOnError. Der Unterklasse IANet_DiagSetting werden keine zusätzlichen Eigenschaften hinzugefügt.

Erstellen von Instanzen
Sie können keine Instanzen dieser Klasse erstellen.

Löschen von Instanzen
Sie können keine Instanzen dieser Klasse löschen.

Ändern von Eigenschaften
UpdateInstanceAsync wird implementiert und kann zum Einstellen von folgenden Testparametern verwendet werden: "Halt On Error" (Bei Fehler anhalten), "Report Soft Errors" (Soft-Fehler melden), "Report Status Messages" (Status-Nachrichten melden), "Quick Mode" (Schnellmodus), "Test Warning Level" (Testwarnstufe) und "Percent Of Test Coverage" (Testabdeckung in Prozent).

Assoziationen
Eine Instanz von IANetDiagSettingForTest assoziiert einen IANet_DiagTest mit einer IANet_DiagSetting-Instanz.

Nicht unterstützte Eigenschaften
Die folgenden Eigenschaften werden von NCS nicht unterstützt:

Methoden
Keine

Klassenhierarchie

Für CimV2. Unbenutzte Eigenschaften und Methoden werden nicht aufgeführt.

IANet_DiagResult

Zweck
Instanzen von IANet_DiagResult zeigen die Ergebnisdaten für einen bestimmten Testlauf auf einem bestimmten Adapter an. Instanzen dieser Klasse entsprechen auf identische Weise den Instanzen von IANet_DiagTest und IANet_DiagSetting.

Instanzen
Instanzen von IANet_DiagResult entsprechen den Ergebnissen für einen bestimmten Testlauf auf einem spezifischen Adapter. Für diesen Schlüssel wird dasselbe Format verwendet wie für IANet_DiagTest und IANet_DiagSetting. Die Instanz kann beliebige Testergebnisse speichern, und Daten, die nicht den definierten Eigenschaften entsprechen, können in der TestResults-Array-Eigenschaft untergebracht werden. Jedes Mal, wenn ein neuer Test für einen Adapter ausgeführt wird, überschreibt die neue Instanz die vorhandene Instanz der Testergebnisse für den Adapter und die Testkombination.

Erstellen von Instanzen
Sie können keine Instanzen dieser Klasse erstellen.

Löschen von Instanzen
Sie können keine Instanzen dieser Klasse löschen.

Ändern von Eigenschaften
Sie können keine Instanzen dieser Klasse ändern.

Assoziationen
Eine Instanz von IANet_DiagResultForTest assoziiert einen IANet_DiagTest mit einer IANet_DiagnosticResult-Instanz.

Nicht unterstützte Eigenschaften
Die folgenden Eigenschaften werden von NCS nicht unterstützt:

Methoden
Keine

Klassenhierarchie

Für CimV2. Unbenutzte Eigenschaften und Methoden werden nicht aufgeführt.

Zurück zum Seitenanfang


Registrierungseinträge

Die folgenden Einträge werden während der Installation unter HKLM\Software\Intel\NETWORK_SERVICES\NCS\NcsDiag in die Registrierung aufgenommen. Diese weiter unten definierten Schlüssel und Werte steuern, wie die Diagnosetests ausgeführt werden.

Die folgende Tabelle zeigt die im Schlüssel angegebenen Werte, ihren Typ und eine kurze Erklärung bezüglich ihrer Verwendung:

 
Wert Typ Standard Verwendung
Check Time REG_DWORD 2 Sekunden Zeitdauer zwischen den Überprüfungen auf Abschluss des Sender- oder Responder-Tests.
Enable REG_DWORD 0 Aktiviert (1) oder deaktiviert (0) die Verwendung einer Ergebnis-Protokolldatei.
FileAppend REG_DWORD 1 Ermöglicht das Anhängen (1) der Protokollergebnisdatei an die vorhandene Protokollergebnisdatei. Bei der Einstellung 0 wird die vorhandene Datei gelöscht.
LogFileName REG_SZ NcsDiag.log Der Name der Protokollergebnisdatei.
MaxFileSize REG_DWORD 0x10000 Die maximale Größe der Protokollergebnisdatei.
MaxPktsRcvd REG_DWORD 200 Im Schnellmodus (Quick Mode in IANet_DiagSetting) wird das Senden/Empfangen eines Tests beendet, wenn die Anzahl der empfangenen Pakete den hier angegebenen Wert überschreitet.
TimeoutSndRsp REG_DWORD 100 Der Test wird beendet, wenn die Testdauer (in Sekunden) diesen Wert überschreitet.

Zurück zum Seitenanfang


Protokollieren

Ergebnisprotokoll

Das Ergebnisprotokoll enthält hauptsächlich Informationen, die auch aus IANet_DiagResult-Objekten ermittelt werden könnten. Der Unterschied besteht darin, dass die Informationen, die von einem CIM-Browser ermittelt werden, nur die unmittelbar letzten Ergebnisse bestimmter Tests für einen bestimmten Adapter enthalten. Nachfolgende Tests überschreiben frühere Testergebnisse. Das Ergebnisprotokoll bietet eine bequeme Lösung zum Einrichten und Anzeigen mehrfacher Durchläufe eines solchen Tests.

Aktivieren des Ergebnisprotokolls

So wird das Ergebnisprotokoll aktiviert:

  1. Stellen Sie den Wert für die Aktivierung im Registrierungsschlüssel HKLM\Software\Intel\NETWORK_SERVICES\NCS\NCSDiag auf 1 ein.
  2. Geben Sie den gewünschten Protokolldateinamen unter LogFileName ein, oder behalten Sie den Standardnamen NcsDiag.log bei.
  3. Die Protokolldatei wird im Verzeichnis gespeichert, das im Wert InstalledDir angegeben ist.

Zurück zum Seitenanfang


Assoziative Klassen

Assoziative Klasse Referenz-Eigenschaft/Wert Referenz-Eigenschaft/Wert
IANet_DiagTestForMSE Antecedent = IANet_DiagTest Dependent = IANet_EthernetAdapter
IANet_DiagResultForTest DiagnosticResult = IANet_DiagResult DiagnosticTest = IANet_DiagTest
IANet_DiagSettingForTest Element = IANet_DiagTest Setting = IANet_DiagSetting
IANet_DiagResultForTest DiagnosticResult = IANetDiagResult DiagnosticTest = IANet_DiagTest

Zurück zum Seitenanfang


Tests

Die implementierten Tests können auf einem einzelnen Gerät oder auf zwei Geräten ausgeführt werden. Eine detaillierte Beschreibung der Tests ist im Rahmen dieses Dokuments nicht möglich. Der CDM Provider ist als generelle Testplattform gedacht, die unabhängig von den genauen Details der Tests verwendet werden kann. Eine gewisse Abhängigkeit ist jedoch in den Code integriert. Diese Abhängigkeit wird in diesem Abschnitt erläutert.

Tests für Einzeladapter

Die folgenden Tests werden auf einem Einzeladapter ausgeführt und erfordern keine Interaktion mit einem anderen Adapter:

Alle Fehlermeldungen dieser Tests resultieren aus HRESULT-Fehlercodes, die von Aufrufen an niedrigere Stapelschichten zurückgegeben werden. Die Fehlercodes werden intern als Fehlercodes gespeichert und werden erst dann in Fehlermeldungen übersetzt, wenn der Bezug auf IANet_DiagResult-Objekte durch Auflistung aufgehoben wird oder wenn Objektaufrufe von einer Verwaltungsanwendung empfangen werden.

Tests für zwei Adapter

Die Sender- und Responder-Tests setzen eine gegenseitige Abhängigkeit voraus. Ein Adapter (der Sender) sendet dabei Pakete an einen anderen Adapter (den Responder), der wiederum Pakete an den Sender zurücksendet und dadurch die Schleife vervollständigt. Es handelt sich dabei um dieselben Tests, die auch über Intel ® PROSet ausgeführt werden können. Intel PROSet verwendet jedoch CDM nicht und lässt das gleichzeitige Ausführen von zwei Tests auf demselben Gerät nicht zu. Mit CDM sind gleichzeitige Tests unterschiedlicher Art auf demselben Gerät möglich.

Sender/Responder-Tests

Für Sender/Responder-Tests sind zwei Intel Adapter erforderlich, wobei einer als Sender und der andere als Responder fungiert. Es handelt sich dabei um den einzigen Test, bei dem das Ausführen eines Tests auf einem zweiten Thread basiert, der so lange weiterläuft, bis der Test aufgrund bestimmter Abschlusskriterien beendet oder durch den primären Thread angehalten wird. Die Abschlusskriterien bewirken das Abschalten, sobald eine bestimmte Testzeit überschritten wird oder eine bestimmte Anzahl Pakete empfangen wurde. Beide Werte werden aus der Registrierung übernommen. Der Test kann nur dann aufgrund der Anzahl der empfangenen Pakete beendet werden, wenn Quick Mode (Schnellmodus) aktiviert wurde. Quick Mode ist eine Eigenschaft der IANet_DiagSetting-Klasse und kann darum für jeden Adapter separat eingestellt werden. CDM-Responder antworten auf PROSet-Responder und umgekehrt.

Bei Sender/Responder-Tests werden zwei Arten von Fehlerwerten zurückgegeben. Erstens kann ein Fehlercode (HRESULT) von den unteren Schichten zurückgegeben werden. Während der Test ausgeführt wird und solange der Test nicht vorzeitig durch einen zurückgegebenen Fehlercode beendet wird, gibt der Test-Thread zweitens vorläufige und endgültige Teststatistiken der folgenden Art zurück:


Lesen Sie bitte alle Einschränkungen und Haftungsausschlüsse.


Zurück zur Inhaltsseite     Zurück zum Seitenanfang