목차 페이지로 돌아가기

진단: Intel(R) PRO Network Adapters WMI and CDM Providers 사용 설명서

진단 클래스
레지스트리 항목
로깅
연관 클래스
테스트


진단 클래스

IANet_DiagTest

용도
IANet_DiagTest는 CIM_DiagnosticTest의 하위 클래스입니다. 이 클래스는 Intel(R) PROSet에서 지원하는 이더넷 어댑터의 진단 테스트를 실행하고 제어하는 일반적인 전달 수단을 제공합니다. CIM_DiagnosticTest 수퍼클래스는 일반적으로 CIM 가능 시스템에 있는 모든 컴퓨터 하드웨어의 테스트를 지원합니다. 클래스 속성은 본래 설명적이며 테스트 메커니즘은 노출된 메서드를 통해 제공됩니다.

인스턴스
키는 이름이며, 이 공급자의 경우에는 참조된 어댑터의 GUID에 있는 테스트의 숫자 인덱스를 연결한 것입니다(예: 1@{12345678-9ABC-DEF0-1234-123456789012}). 이 키 값은 어댑터와 테스트를 참조하는 모든 정보가 RunTest와 다른 메서드에 객체 매개변수로 전달되므로 여분의 정보로 간주될 수도 있습니다. 인스턴스는 메서드에 대한 매개변수와의 일관성을 유지해야 합니다. 그렇지 않으면 공급자가 명령을 거부합니다. 캡션 속성은 이 인스턴스가 실행될 테스트의 이름을 제공합니다. 다른 속성은 기타 설명과 런타임 정보를 제공합니다.

인스턴스 만들기
IANet_DiagTest 인스턴스는 만들 수 없습니다.

인스턴스 삭제
IANet_DiagTest 인스턴스는 삭제할 수 없습니다.

속성 수정
이 클래스에는 사용자가 수정할 수 있는 속성이 없습니다.

연관

지원되지 않는 속성
Install Date, OtherCharacteristicDescription

메서드
이 클래스는 다음 메서드를 지원합니다.

클래스 계층

CimV2의 경우. 사용되지 않는 속성과 메서드는 나와 있지 않습니다.

WbemTest에서 RunTest 및 기타 메서드 실행

MOF 파일에 있는 RunTest 메서드는 다음과 같습니다.

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

처음 두 매개변수는 입력 매개변수입니다. 참조된 두 객체의 객체 경로를 가져와야 합니다. RunTest 객체를 엑스포트 중인 IANet_DiagTest 객체의 객체 경로도 가져와야 합니다.

  1. 기본 WBEM 테스트 대화 상자에서 Connect를 누릅니다.
  2. 해당 '서버\네임스페이스'를 입력합니다. IntelNCS 및 CimV2 네임스페이스가 지원됩니다.
  3. WBEM 테스트의 Enum Instances 단추를 누르고 IANet_DiagTest를 입력합니다.
  4. IANet_DiagTest 인스턴스를 두 번 누릅니다. 이름 형식은 X@[AdapterGUID}입니다. 여기서 X는 테스트 이름이고, AdapterGUID는 IANet_EthernetAdapter의 이름 키와 동일한 어댑터 이름입니다.
  5. 다음은 검색된 객체 경로의 예입니다.
    \\MYCOMPUTER\root\Cimv2:IANet_DiagTest.Name="1@{4A0CDABE-F6C3-45D0-B60D-F6E7BAFA2C2C}"
  6. 객체 경로를 저장합니다.
  7. WBEM 테스트의 Enum Instances 단추를 누르고 IANet_EthernetAdapter를 입력합니다.
  8. 테스트할 어댑터를 두 번 누릅니다.
  9. 다음은 검색된 객체 경로의 예입니다.
    \\MYCOMPUTER\root\cimv2:IANet_EthernetAdapter.DeviceID="{4A0CDABE-F6C3-45D0-B60D-F6E7BAFA2C2C}"
  10. 객체 경로를 저장합니다.
  11. WBEM 테스트의 Enum Instances 단추를 누르고 IANet_DiagSetting을 입력합니다.
  12. 어댑터/테스트 조합을 나타내는 설정을 두 번 누릅니다.
  13. 다음은 검색된 객체 경로의 예입니다.
    \\MYCOMPUTER\root\cimv2:IANet_DiagSetting.SettingID="1@{4A0CDABE-F6C3-45D0-B60D-F6E7BAFA2C2C}"
  14. 객체 경로를 저장합니다.
  15. 기본 WBEM 테스트 대화 상자에서 Execute Method를 누릅니다.
  16. IANet_DiagTest 객체 경로를 대화 상자에 붙여 넣습니다. OK를 클릭합니다.
  17. 메서드 아래의 드롭다운 상자에서 테스트를 선택합니다.
  18. Edit In Parameters 단추를 누릅니다.
  19. RunTest의 경우 Setting 및 SystemElement는 입력 매개변수입니다. 앞서 저장한 Setting 및 Adapter 객체 경로를 붙여 넣고 닫습니다.
  20. Execute 단추를 누릅니다.
  21. 입력 매개변수와 동일한 방식으로 IANet_DiagResult 클래스를 열거합니다.
  22. 필요에 맞게 선택된 결과 객체를 검사합니다.

IANet_DiagSetting

용도
IANet_DiagSetting 인스턴스는 특정 런타임 진단 테스트 지시어를 제공합니다. 사용된 지시어는 모든 테스트에 공통되고 CIM_DiagnosticSetting 수퍼클래스에 바인드됩니다. 여기에는 ReportSoftErrors 및 HaltOnError와 같은 속성이 포함됩니다. IANet_DiagSetting 수퍼클래스에 다른 속성이 추가되지는 않습니다.

인스턴스 만들기
이 클래스의 인스턴스는 만들 수 없습니다.

인스턴스 삭제
이 클래스의 인스턴스는 삭제할 수 없습니다.

속성 수정
UpdateInstanceAsync가 구현되며 테스트 매개변수를 "Halt On Error", "Report Soft Errors", "Report Status Messages", "Quick Mode", "Test Warning Level" 및 "Percent Of Test Coverage"로 설정하는 데 사용될 수 있습니다.

연관
IANetDiagSettingForTest 인스턴스는 IANet_DiagTest를 IANet_DiagSetting과 연관시킵니다.

지원되지 않는 속성
다음 속성은 NCS에서 지원되지 않습니다.

메서드
없음

클래스 계층

CimV2의 경우. 사용되지 않는 속성과 메서드는 나와 있지 않습니다.

IANet_DiagResult

용도
IANet_DiagResult 인스턴스는 특정 어댑터에 대해 실행된 특정 테스트의 결과 데이터를 표시합니다. 이 클래스의 인스턴스는 IANet_DiagTest 및 IANet_DiagSetting 인스턴스와 동일하게 일치합니다.

인스턴스
IANet_DiagResult 인스턴스는 특정 어댑터에 대해 실행된 특정 테스트의 결과와 일치합니다. 키 형식은 IANet_DiagTest 및 IANet_DiagSetting과 동일합니다. 정의된 속성과 맞지 않는 데이터가 TestResults Array 속성에 포함될 수 있으므로 인스턴스가 임의 테스트 결과를 저장할 수 있습니다. 언제든 어댑터에 대해 새 테스트가 실행되면 새 인스턴스가 그 어댑터/테스트 조합에 해당하는 테스트 결과의 기존 인스턴스를 덮어씁니다.

인스턴스 만들기
이 클래스의 인스턴스는 만들 수 없습니다.

인스턴스 삭제
이 클래스의 인스턴스는 삭제할 수 없습니다.

속성 수정
이 클래스의 인스턴스는 수정할 수 없습니다.

연관
IANet_DiagResultForTest 인스턴스는 IANet_DiagTest를 IANet_DiagnosticResult 인스턴스와 연관시킵니다.

지원되지 않는 속성
다음 속성은 NCS에서 지원하지 않습니다.

메서드
없음

클래스 계층

CimV2의 경우. 사용되지 않는 속성과 메서드는 나와 있지 않습니다.

맨 처음으로 돌아가기


레지스트리 항목

다음 항목은 설치하는 동안 HKLM\Software\Intel\NETWORK_SERVICES\NCS\NcsDiag 아래의 레지스트리에 입력됩니다. 진단 테스트 실행을 제어하는 이러한 키와 값이 아래에 정의되어 있습니다.

다음 표에는 키의 값, 유형 및 간략한 사용법 설명이 나와 있습니다.

 
값 유형 기본 사용
Check Time REG_DWORD 2 seconds 송신기 또는 응답기 테스트의 완료 검사 간격
Enable REG_DWORD 0 결과 로그 파일 사용 활성화(1) 또는 결과 로그 파일 사용 비활성화(0)
FileAppend REG_DWORD 1 기존 결과 로그 파일에 결과 로그 파일 첨부(1) 또는 기존 파일 삭제(0)
LogFileName REG_SZ NcsDiag.log 결과 로그 파일 이름
MaxFileSize REG_DWORD 0x10000 최대 결과 로그 파일 크기
MaxPktsRcvd REG_DWORD 200 빠른 모드(IANet_DiagSetting에서)에서는 수신 패킷 수가 이 값보다 클 때 송/수신 테스트가 종료됩니다.
TimeoutSndRsp REG_DWORD 100 테스트 지속 시간(초)이 이 값을 초과할 때 테스트가 종료됩니다.

맨 처음으로 돌아가기


로깅

결과 로그

결과 로그는 기본적으로 IANet_DiagResult 객체에서도 가져올 수 있는 정보를 표시합니다. 차이는 CIM 브라우저에서 가져온 정보는 특정 어댑터에 대한 특정 테스트의 최근 결과만 표시한다는 점입니다. 이후 테스트는 이전 테스트 결과를 덮어씁니다. 결과 로그를 사용하면 나중에 실행할 테스트를 보다 쉽게 설정 및 검토할 수 있습니다.

결과 로그 활성화

결과 로그를 활성화하려면

  1. HKLM\Software\Intel\NETWORK_SERVICES\NCS\NCSDiag 레지스트리 키에서 Enable 값을 1로 설정합니다.
  2. LogFileName 값을 선호하는 로그 파일 이름으로 설정하거나 기본값 NcsDiag.log를 그대로 둡니다.
  3. 로그 파일은 InstalledDir 값이 나타내는 디렉토리에서 찾을 수 있습니다.

맨 처음으로 돌아가기


연관 클래스

연관 클래스 참조 속성/값 참조 속성/값
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

맨 처음으로 돌아가기


테스트

구현된 테스트는 단일 컴퓨터에서 실행되거나 두 대의 컴퓨터에서 실행될 수 있습니다. CDM Provider가 특정 테스트에 종속되지 않는 일반 테스트 전달체(Vehicle)이기 때문에 테스트에 대한 자세한 설명은 이 문서의 범위를 벗어납니다. 하지만 이 절에서 설명한 것처럼 코드는 일부 종속성이 내장되어 있습니다.

단일 어댑터 테스트

다음 테스트는 단일 어댑터에 대해 실행되고 다른 어댑터와의 상호 작용이 필요하지 않습니다.

이러한 테스트에서 발생하는 모든 오류 메시지는 하위 스택 레이어에 대한 호출에서 반환된 HRESULT 오류 코드로 인한 것입니다. 오류 코드는 내부에서 오류 코드로 저장되며 IANet_DiagResult 객체가 열거에 의해 참조 해제되거나 객체 호출이 관리 응용 프로그램에서 수신될 때까지 오류 메시지로 변환되지 않습니다.

두 대의 어댑터가 필요한 테스트

송신기 및 응답기 테스트는 상호 의존적 테스트입니다. 즉, 한 어댑터(송신기)가 다른 어댑터(응답기)에 패킷을 보내면 응답기가 송신기에게 패킷을 돌려보내므로 루프가 형성됩니다. 이는 동일한 테스트로, Intel(R) PROSet에서 실행할 수 있습니다. 하지만 Intel PROSet에서는 CDM을 사용하지 않으며 한 컴퓨터에서 두 테스트를 동시에 실행할 수 없습니다. CDM을 사용하면 한 컴퓨터에서 여러 테스트를 동시에 실행할 수 있습니다.

송신기/응답기 테스트

송신기/응답기 테스트에는 송신기와 응답기 역할을 할 인텔 어댑터가 하나씩 필요합니다. 완료 조건에 따라 테스트가 완료되거나 주 스레드가 테스트를 중지할 때까지 계속 실행되는 보조 스레드에 기반하여 실행되는 테스트는 이 테스트뿐입니다. 완료 조건은 테스트 시간이나 수신 패킷 수에 기반한 시간 초과입니다. 이러한 값은 둘 다 레지스트리에서 가져옵니다. 빠른 모드가 활성화된 경우에는 수신 패킷 수에 기반해서만 테스트가 종료될 수 있습니다. 빠른 모드는 IANet_DiagSetting 클래스의 속성이므로 어댑터마다 설정될 수 있습니다. CDM 응답기는 PROSet 응답기에 응답하고, PROSet 응답기는 CDM 응답기에 응답합니다.

두 유형의 오류 값이 송신기/응답기 테스트에서 반환됩니다. 첫째, 오류 코드(HRESULT)가 하위 레이어에서 반환될 수 있습니다. 둘째, 테스트가 실행되는 동안 반환된 오류 코드로 인해 테스트가 중간에 종료되는 경우가 아니면 테스트 스레드가 중간 테스트 통계를 반환한 후 최종 테스트 통계를 반환합니다. 최종 테스트 통계에는 다음 사항이 포함됩니다.


제한 및 책임 부인을 자세히 읽어보십시오.


목차 페이지로 돌아가기     맨 처음으로 돌아가기