Regreso a la pantalla de contenido

Diagnósticos: Guía del usuario de proveedores WMI y CDM para adaptadores de red Intel® PRO

Clases de diagnóstico
Entradas del registro
Registro
Clases asociativas
Pruebas


Clases de diagnóstico

IANet_DiagTest

Propósito
IANet_DiagTest está incluida en una subclase de CIM_DiagnosticTest. La clase proporciona un vehículo genérico para ejecutar y controlar las pruebas de diagnóstico para un adaptador Ethernet compatible con Intel® PROSet. La superclase, CIM_DiagnosticTest, se ha concebido para aceptar, de manera genérica, el conjunto de pruebas de cualquier hardware de PC en un sistema CIM activado. Los propiedades de la clase son de naturaleza descriptiva y el mecanismo de la prueba lo proporcionan los métodos expuestos.

Instancias
La clave es un nombre y en este proveedor es la concatenación de un índice numérico de la prueba en el GUID del adaptador de referencia (por ejemplo, 1@{12345678-9ABC-DEF0-1234-123456789012}). Este valor de la clave es información redundante en un sentido, ya que toda la información para referirse a un adaptador y una prueba es pasada como parámetros de objeto del método RunTest y otros. A pesar de eso, la instancia debe ser consistente con los parámetros para el método o, de lo contrario, el proveedor podría rechazar el comando. La propiedad "caption" (título) proporciona el nombre de la prueba que se ejecutará en esta instancia. Otras propiedades proporcionan información de descripción y de tiempo de ejecución.

Creación de instancias
No se pueden crear instancias de IANet_DiagTest.

Eliminación de instancias
No se pueden eliminar instancias de IANet_DiagTest.

Modificación de propiedades
No hay propiedades que el usuario pueda modificar en esta clase.

Asociaciones

Propiedades no compatibles
InstallDate, OtherCharacteristicDescription

Métodos
Esta clase acepta los siguientes métodos:

Jerarquía de clases

Para CimV2. No se muestran las propiedades y métodos que no se utilizan.

La ejecución de RunTest y otros métodos en WbemTest

El método RunTest del archivo MOF es como sigue:

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

Los dos primeros parámetros son parámetros de entrada. Debe obtener la ruta de objeto de ambos objetos referenciados. También debe obtener la ruta al objeto IANet_DiagTest, que está exportando el objeto RunTest.

  1. En el cuadro de diálogo principal de la prueba WBEM, haga clic en Connect (Conectar).
  2. Escriba el servidor o el espacio de nombre apropiado. Se aceptan los espacios de nombre IntelNCS y CimV2.
  3. Haga clic en el botón Enum Instances (Enumerar instancias) de la prueba WBEM y escriba IANet_DiagTest.
  4. Haga doble clic en la instancia IANet_DiagTest. El nombre aparecerá en la forma de X@[GUID_del_adaptador}, donde X es el nombre de la prueba y GUID_del_adaptador es el nombre del adaptador, igual que la clave Name de IANet_EthernetAdapter.
  5. A continuación aparece un ejemplo de la ruta de objeto recuperada:
    \\MYCOMPUTER\root\Cimv2:IANet_DiagTest.Name="1@{4A0CDABE-F6C3-45D0-B60D-F6E7BAFA2C2C}"
  6. Guarde la ruta del objeto.
  7. Haga clic en el botón Enum Instances de la prueba WBEM y escriba IANet_EthernetAdapter.
  8. Haga doble clic en el adaptador que se va a probar.
  9. A continuación aparece un ejemplo de la ruta de objeto recuperada:
    \\MYCOMPUTER\root\cimv2:IANet_EthernetAdapter.DeviceID="{4A0CDABE-F6C3-45D0-B60D-F6E7BAFA2C2C}"
  10. Guarde la ruta del objeto.
  11. Haga clic en el botón Enum Instances de la prueba WBEM y escriba IANet_DiagSetting.
  12. Haga doble clic en el valor que representa la combinación de adaptador y prueba.
  13. A continuación aparece un ejemplo de la ruta de objeto recuperada:
    \\MYCOMPUTER\root\cimv2:IANet_DiagSetting.SettingID="1@{4A0CDABE-F6C3-45D0-B60D-F6E7BAFA2C2C}"
  14. Guarde la ruta del objeto.
  15. En el cuadro de diálogo principal de la prueba WBEM, haga clic en Execute Method (Ejecutar método).
  16. Pegue la ruta del objeto IANet_DiagTest en el cuadro de diálogo. Haga clic en Aceptar.
  17. Debajo de method en el cuadro de lista desplegable, seleccione la prueba.
  18. Haga clic en el botón Edit In Parameters (Editar los parámetros de entrada).
  19. Para RunTest, los parámetros de entrada son Setting y SystemElement Pegue las rutas de los objetos Settings y Adapter guardadas previamente y cierre.
  20. Haga clic en el botón Execute (Ejecutar).
  21. Enumere la clase IANet_DiagResult, de la misma forma que los parámetros de entrada.
  22. Examine el objeto resultante seleccionado según sea necesario.

IANet_DiagSetting

Propósito
Las instancias de IANet_DiagSetting proporcionan directrices de pruebas de diagnóstico en tiempo de ejecución específicas. Las directrices utilizadas son comunes para todas las pruebas y están ligadas a la superclase CIM_DiagnosticSetting. Incluyen propiedades, como serían ReportSoftErrors y HaltOnError. No hay propiedades adicionales agregadas a la subclase IANet_DiagSetting.

Creación de instancias
No se pueden crear instancias de esta clase.

Eliminación de instancias
No se pueden eliminar instancias de esta clase.

Modificación de propiedades
Se implementa UpdateInstanceAsync y puede usarse para fijar parámetros de prueba de "Halt On Error", "Report Soft Errors", "Report Status Messages", "Quick Mode", "Test Warning Level" y "Percent Of Test Coverage".

Asociaciones
Una instancia de IANetDiagSettingForTest asocia una IANet_DiagTest con una IANet_DiagSetting..

Propiedades no compatibles
Las propiedades siguientes no son aceptadas por NCS:

Métodos
Ninguno

Jerarquía de clases

Para CimV2. No se muestran las propiedades y los métodos que no se utilizan.

IANet_DiagResult

Propósito
Las instancias de IANet_DiagResult muestran los datos resultantes de una prueba en particular que se ejecutó en un adaptador específico. Las instancias de esta clase son idénticas a las instancias de IANet_DiagTest y IANet_DiagSetting.

Instancias
Las instancias de IANet_DiagResult corresponden a los resultados de una prueba en particular que se ejecutó en un adaptador específico. El formato para la clave es el mismo que IANet_DiagTest y IANet_DiagSetting. La instancia puede guardar resultados arbitrarios de pruebas como cualquier tipo de datos, que no se ajusta a las propiedades definidas, puede ubicarse en la propiedad TestResults Array. En cualquier momento que se ejecuta una prueba de un adaptador, la instancia nueva sobrescribe la instancia de resultados de prueba existentes correspondientes a la combinación de ese adaptador y esa prueba.

Creación de instancias
No se pueden crear instancias de esta clase.

Eliminación de instancias
No se pueden eliminar instancias de esta clase.

Modificación de propiedades
No se pueden modificar instancias de esta clase.

Asociaciones
Una instancia de IANet_DiagResultForTest asocia un IANet_DiagTest con una instancia de IANet_DiagnosticResult.

Propiedades no compatibles
Las propiedades siguientes no son aceptadas por NCS:

Métodos
Ninguno

Jerarquía de clases

Para CimV2. No se muestran las propiedades y los métodos que no se utilizan.

Principio


Entradas del registro

Las entradas siguientes se escriben en el registro durante la instalación bajo HKLM\Software\Intel\NETWORK_SERVICES\NCS\NcsDiag. Estas claves y valores controlan la ejecución de las pruebas de diagnóstico y se definen a continuación.

La tabla siguiente incluye los valores de la clave, su tipo y una explicación breve de su uso.

 
Valor Tipo Valor predeterminado Uso
Check Time REG_DWORD 2 segundos La duración del lapso de tiempo entre las verificaciones para la conclusión de la prueba del remitente o destinatario
Habilitar REG_DWORD 0 Habilitar (1) o Inhabilitar (0) uso de un archivo de registro de resultados.
FileAppend REG_DWORD 1 Agregar (1) el archivo de registro de resultados al archivo de registro de resultados existente. Si es 0, elimina el archivo existente.
LogFileName REG_SZ NcsDiag.log El nombre del archivo de registro de resultados.
MaxFileSize REG_DWORD 0x10000 El tamaño máximo del archivo de registro de resultados.
MaxPktsRcvd REG_DWORD 200 En Quick Mode (Modo rápido) (de IANet_DiagSetting), la prueba enviar / recibir será terminada en cuanto el número de paquetes recibidos es mayor que este valor.
TimeoutSndRsp REG_DWORD 100 La prueba se termina en cuanto la duración de la prueba (en segundos) sobrepasa este valor.

Principio


Registro

Registro de resultados

El registro de resultados muestra, principalmente, información que podía haberse obtenido de objetos IANet_DiagResult. La diferencia consiste en que esta información que se obtuvo de un navegador CIM, mostrará solamente los últimos resultados inmediatamente anteriores de pruebas particulares en un adaptador en particular. Las pruebas subsecuentes sobrescriben los resultados de pruebas anteriores. El registro de resultados es más conveniente para configurar y examinar varias ejecuciones de tal prueba.

Habilitación del registro de resultados

Para habilitar el registro de resultados:

  1. En la clave del registro HKLM\Software\Intel\NETWORK_SERVICES\NCS\NCSDiag, fije el valor de habilitación en 1.
  2. Establezca el valor LogFileName en el nombre preferido del archivo de registro, o deje el predeterminado NcsDiag.log.
  3. El archivo de registro puede encontrarse en el directorio indicado por el valor de InstalledDir.

Principio


Clases asociativas

Clases asociativas Propiedad o valor de referencia Propiedad o valor de referencia
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

Principio


Pruebas

Las pruebas implementadas pueden ejecutarse en una sola máquina o en dos. La descripción detallada de las pruebas van más allá del ámbito de este documento, ya que el proveedor CDM se ha concebido como un vehículo de pruebas genérico, que no depende de los detalles de las pruebas. Sin embargo, existe cierta dependencia construida en el código y que se explica en esta sección.

Pruebas de un solo adaptador

Las pruebas siguientes se ejecutan en un solo adaptador y no requieren de interacción con otros adaptadores.

Todos los mensajes de error de estas pruebas dan como resultado códigos de error HRESULT devueltos de llamadas a las capas inferiores de la pila. Los códigos de error se guardan internamente como códigos de error y se traducen como mensajes de error hasta que se elimina la referencia de los objetos IANet_DiagResult por enumeración o por llamadas de objeto recibidas de una aplicación de gestión.

Pruebas que requieren de dos adaptadores

Las pruebas de remitente y destinatario son pruebas codependientes en las cuales uno de los adaptadores (el remitente) envía paquetes a otro adaptador (el destinatario), el cual envía paquetes de regreso al remitente, completando así el bucle. Estas son las mismas pruebas que pueden ejecutarse desde Intel ® PROSet. Sin embargo, Intel PROSet no utiliza CDM y no le permite ejecutar dos pruebas en la misma máquina a la vez. CDM permitirá que se ejecuten pruebas concurrentemente en la misma máquina.

Prueba de remitente y destinatario

La prueba de remitente y destinatario requiere de dos adaptadores Intel, uno para el remitente y el otro para el destinatario. Esta prueba es la única en la cual la prueba se ejecuta basada en un segundo subproceso que continúa en ejecución hasta que se termina la prueba de acuerdo con los criterios de terminación o es detenida por un subproceso primario. Los criterios de terminación son tiempos de espera que están basados en la duración del tiempo de la prueba o el número de paquetes recibidos. Ambos valores se pueden obtener del registro. La prueba podrá terminar solamente sobre la base del número de paquetes recibidos si es que se habilitó el Quick Mode. Quick Mode es una propiedad de la clase IANet_DiagSetting y, en consecuencia, podría establecerse sobre la base de cada adaptador. Los destinatarios CDM le contestan a los destinatarios PROSet y viceversa.

Se devuelven dos tipos de valores de error de la prueba de remitente y destinatario. Primero, puede devolverse un código de error (HRESULT) de las capas inferiores. En segundo lugar, mientras se ejecuta la prueba y, salvo que la prueba se termine prematuramente por un código de error devuelto, el subproceso de prueba devolverá estadísticas de la prueba intermedias y después las finales, las cuales incluyen lo siguiente:


Sírvase leer todas las restricciones y renuncias de responsabilidad.


Regreso a la pantalla de contenido   Principio