Voltar à página do índice

Diagnósticos: Guia do usuário de provedores WMI e CDM dos adaptadores de rede Intel® PRO

Classes de diagnósticos
Entradas de registro
Registro
Classes associativas
Testes


Classes de diagnóstico

IANet_DiagTest

Objetivo
IANet_DiagTest é uma subclasse de CIM_DiagnosticTest. Essa classe proporciona um veículo genérico para executar e controlar testes de diagnóstico para um adaptador Ethernet com suporte para Intel® PROSet. A superclasse, CIM_DiagnosticTest, é projetada para suportar genericamente o teste de qualquer tipo de hardware em um sistema habilitado para CIM. As propriedades da classe são de natureza descritiva e a mecânica do teste é fornecida pelos métodos expostos.

Instâncias
A chave é Name (Nome) e, nesse provedor, é a concatenação de um índice numérico do teste no GUID do adaptador referenciado (exemplo: 1@{12345678-9ABC-DEF0-1234-123456789012}). Esse valor de chave é, de certa forma, uma informação redundante, já que todas as informações para referenciar um adaptador e testar são passadas como parâmetros de objeto para RunTest e outros métodos. Mesmo assim, a instância deve ser consistente com os parâmetros do método; caso contrário, o provedor não aceita o comando. A propriedade de legenda (caption) dá o nome do teste que a instância irá executar. Outras propriedades fornecem outras descrições e informações de tempo de execução.

Criação de instâncias
Não é possível criar instâncias de IANet_DiagTest.

Exclusão de instâncias
Não é possível excluir instâncias de IANet_DiagTest.

Modificação de propriedades
Não há propriedades modificáveis pelo usuário para essa classe.

Associaçõe

Propriedades sem suporte
Install Date, OtherCharacteristicDescription

Métodos
Essa classe suporta os seguintes métodos:

Hierarquia de classe

Para CimV2. Propriedades que não foram usadas e métodos não exibidos.

Execução de RunTest e outros métodos em WbemTest

O método RunTest do arquivo MOF é o seguinte:

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

Os primeiros dois parâmetros são parâmetros In. É necessário obter o caminho de objeto de ambos os objetos referenciados. Também é necessário obter o caminho de objeto de IANet_DiagTest, que está exportando o objeto RunTest.

  1. Na caixa de diálogo principal de teste do WBEM, clique em Connect.
  2. Insira o Server (Servidor)/Namespace (Espaço de Nomes) correspondentes. Há suporte para os espaços de nome IntelNCS e CimV2.
  3. Clique no botão Enum Instances do teste do WBEM e digite IANet_DiagTest.
  4. Clique duas vezes na instância do IANet_DiagTest. O nome terá a forma X@[AdapterGUID}, onde X é o nome do teste e AdapterGUID será o nome do adaptador, igual ao da chave Name (Nome) do IANet_EthernetAdapter.
  5. Veja a seguir um exe4mplo do caminho do objeto recuperado:
    \\MYCOMPUTER\root\Cimv2:IANet_DiagTest.Name="1@{4A0CDABE-F6C3-45D0-B60D-F6E7BAFA2C2C}"
  6. Salve o caminho do objeto.
  7. Clique no botão Enum Instances do teste do WBEM e digite IANet_EthernetAdapter.
  8. Clique duas vezes no adaptador a ser testado.
  9. Veja a seguir um exe4mplo do caminho do objeto recuperado:
    \\MYCOMPUTER\root\cimv2:IANet_EthernetAdapter.DeviceID="{4A0CDABE-F6C3-45D0-B60D-F6E7BAFA2C2C}"
  10. Salve o caminho do objeto.
  11. Clique no botão Enum Instances do teste do WBEM e digite IANet_DiagSetting.
  12. Clique duas vezes na configuração que representa a combinação adaptador/teste.
  13. Veja a seguir um exe4mplo do caminho do objeto recuperado:
    \\MYCOMPUTER\root\cimv2:IANet_DiagSetting.SettingID="1@{4A0CDABE-F6C3-45D0-B60D-F6E7BAFA2C2C}"
  14. Salve o caminho do objeto.
  15. Na caixa de diálogo principal de teste do WBEM, clique em Execute Method.
  16. Cole o caminho do objeto IANet_DiagTest na caixa de diálogo. Clique em OK.
  17. Selecione o teste na caixa suspensa que está sob o método.
  18. Clique no botão Edit In Parameters.
  19. Para RunTest, os parâmetros In são Setting e SystemElement. Cole os caminhos de objeto de Setting (Configuração) e Adapter (Adaptador), que você salvou anteriormente e feche.
  20. Clique no botão Execute.
  21. Enumere a classe IANet_DiagResult da mesma forma que enumerou os parâmetros In.
  22. Analise o objeto de resultado selecionado conforme o necessário.

IANet_DiagSetting

Objetivo
Instâncias de IANet_DiagSetting fornecem diretivas específicas de teste de diagnóstico em tempo de execução. Todos os testes usam as mesmas diretivas, e elas estão vinculadas à superclasse CIM_DiagnosticSetting. Envolvem propriedades, como ReportSoftErrors e HaltOnError. Não há propriedades adicionais acrescentadas á subclasse IANet_DiagSetting.

Criação de instâncias
Não é possível criar instâncias dessa classe.

Exclusão de instâncias
Não é possível excluir instâncias dessa classe.

Modificação de propriedades
UpdateInstanceAsync é implementado e pode ser usado para configurar os parâmetros de teste como "Halt On Error", "Report Soft Errors", "Report Status Messages", "Quick Mode", "Test Warning Level" e "Percent Of Test Coverage".

Associações
Uma instância de IANetDiagSettingForTest associa uma IANet_DiagTest com um IANet_DiagSetting.

Propriedades sem suporte
O NCS não presta suporte às seguintes propriedades:

Métodos
Nenhum

Hierarquia de classe

Para CimV2. Propriedades que não foram usadas e métodos não exibidos.

IANet_DiagResult

Objetivo
Instâncias de IANet_DiagResult exibem os dados de resultado de um determinado teste, executado em um adaptador determinado. As instâncias dessa classe são idênticas às instâncias de IANet_DiagTest e IANet_DiagSetting.

Instâncias
Instâncias de IANet_DiagResult correspondem aos resultados de um determinado teste, executado em um adaptador específico. O formato da chave é o mesmo de IANet_DiagTest e IANet_DiagSetting. A instância pode armazenar qualquer resultado de teste arbitrário como qualquer tipo de dados. Os que não se enquadram nas propriedades definidas, podem ser colocados na propriedade TestResults Array. A qualquer momento que um novo teste é executado no adaptador, a nova instância sobrescreve a instância de resultados de teste já existente que corresponde à combinação de adaptador e teste.

Criação de instâncias
Não é possível criar instâncias dessa classe.

Exclusão de instâncias
Não é possível excluir instâncias dessa classe.

Modificação de propriedades
Não é possível modificar instâncias dessa classe.

Associações
Uma instância de IANet_DiagResultForTest associa uma IANet_DiagTest com uma instância de IANet_DiagnosticResult.

Propriedades sem suporte
O NCS não presta suporte às seguintes propriedades:

Métodos
Nenhum

Hierarquia de classe

Para CimV2. Propriedades que não foram usadas e métodos não exibidos.

Voltar ao início


Entradas de registro

As entradas a seguir são inseridas do registro (registry) durante a instalação, em: HKLM\Software\Intel\NETWORK_SERVICES\NCS\NcsDiag. Essas chaves e valores controlam a execução dos testes de diagnóstico e são definidos abaixo.

A tabela a seguir contém os valores da chave, o tipo e uma breve explicação sobre o uso:

 
Valor Tipo Padrão Uso
Check Time REG_DWORD 2 seconds Duração do período entre as verificações, para fazer o teste do emissor ou respondedor.
Enable REG_DWORD 0 Habilita (1) ou Desabilita (0) o uso de um arquivo de registro de resultados.
FileAppend REG_DWORD 1 Anexa (1) o arquivo de registro de resultados arquivo de registro de resultados já existente. Se 0, exclui o arquivo existente.
LogFileName REG_SZ NcsDiag.log O nome do arquivo de registro de resultados.
MaxFileSize REG_DWORD 0x10000 O tamanho máximo do arquivo de registro de resultados.
MaxPktsRcvd REG_DWORD 200 No Quick Mode (de IANet_DiagSetting), o teste de emissão/recepção termina quando o número de pacotes recebidos é maior que esse valor.
TimeoutSndRsp REG_DWORD 100 O teste termina quando a duração dele (em segundos) exceder esse valor.

Voltar ao início


Registro

Registro de resultados

O Registro de Resultados mostra principalmente as informações, que também podem ser obtidas de objetos IANet_DiagResult. A diferença é que as informações obtidas de um navegador CIM só mostram os últimos resultados imediatos de determinados testes em um determinado adaptador. Os testes seguintes sobrescrevem os resultados de testes anteriores. O Log de resultados é mais conveniente para configurar e visualizar várias execuções desse teste.

Habilitação do log de resultados

Para habilitar o log de resultados:

  1. Na chave de registro HKLM\Software\Intel\NETWORK_SERVICES\NCS\NCSDiag, configure o valor Enable como 1.
  2. Configure o valor LogFileName como o nome de arquivo preferencial para o registro ou use o padrão NcsDiag.log.
  3. O arquivo de registro ficará no diretório indicado pelo valor InstalledDir.

Voltar ao início


Classes associativas

Classe associativa Propriedade de referência/valor Propriedade de referência/valor
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

Voltar ao início


Testes

Os testes implementados podem ser executados em uma ou em duas máquinas. Este documento não se destina a dar explicações detalhadas sobre os testes, já que o CDM Provider se destina a ser um veículo genérico de teste, independente das particularidades dos testes. Entretanto, o código gera uma certa dependência e isso será explicado nesta seção.

Testes em adaptadores únicos

Os testes a seguir são executados em um único adaptador e não precisam interagir com nenhum outro adaptador:

Todas as mensagens de erro desses testes são resultado de códigos de erro HRESULT retornados de chamadas a camadas mais baixas da pilha. Os códigos de erro são armazenados internamente como códigos de erro e não traduzidos em mensagens de erro até que os objetos IANet_DiagResult sejam "desreferenciados" por enumeração ou sejam recebidas chamadas de objetos de uma aplicação de gerenciamento.

Testes que requerem dois adaptadores

Os testes de emissor e respondedor são dependentes entre si. Um adaptador (o emissor) envia pacotes a outro adaptador (o respondedor) e este envia pacotes ao emissor, fechando o circuito. Esses testes são os mesmos que podem ser executados no Intel ® PROSet. Porém, o Intel PROSet não usa CDM e não permite executar dois testes na mesma máquina ao mesmo tempo. O CDM permite que testes diferentes sejam executados simultaneamente na mesma máquina.

Testes de emissor/respondedor

Emissor/respondedor exige dois adaptadores Intel: uma para ser o emissor e um para ser o respondedor. Esse teste é o único a ser executado baseando-se em um segundo thread qye continua executando até que o teste termine de acordo com os critérios de término ou seja interrompido pelo thread primário. Os critérios de término são tempos de espera baseados no período de duração do teste ou no número de pacotes recebidos. Esses dois valores são obtidos no registro. O teste só poderá ser terminado com base no número de pacotes recebidos se o modo Quick for ativado. Quick Mode é uma propriedade da classe IANet_DiagSetting e, portanto, pode ser configurado adaptador por adaptador. Os respondedores CDM responderão a dispositivos PROSet e vice-versa.

Os testes de emissor/respondedor retornam dois tipos de valores de erro. Primeiramente, as camadas inferiores podem retornar um código de erro (HRESULT). Em segundo lugar, enquanto o teste está sendo executado (e se não for terminado prematuramente pelo retorno de um código de erro), o thread do teste retornará as estatísticas parciais e, em seguida, finais do teste, que conterão o seguinte:


Leia todas as restrições e isenções de responsabilidade.


Voltar à página do Índice   Voltar ao início