다중 경로 I-O 테스트(LOGO)

아티클
06/20/2023

이 테스트는 Microsoft® 드라이버 솔루션과 공급업체 스토리지 솔루션의 호환성을 위한 다중 경로 I/O 테스트를 제공합니다.

참고

이 테스트는 x64 프로세서 아키텍처에서 실행되도록 특별히 설계되었습니다.

테스트 세부 정보


사양	Device.Storage.Hd.Mpio.BasicFunction
플랫폼	Windows Server 2016(x64)
지원되는 릴리스	Windows 10 Windows 10 버전 1511 Windows 10 버전 1607 Windows 10, 버전 1703 Windows 10, 버전 1709 Windows 10, 버전 1803 Windows 10, 버전 1809 Windows 10, 버전 1903 Windows 10에 대한 다음 업데이트
예상 실행 시간(분)	180
범주	개발
시간 제한(분)	10800
다시 부팅 필요	false
특별한 구성 필요	false
형식	automatic

추가 설명서

이 기능 영역의 테스트에는 다음 항목에서 찾을 수 있는 필수 조건, 설정, 문제 해결 정보를 포함한 추가 설명서가 있을 수 있습니다.

Device.Storage 추가 설명서

테스트 실행

테스트를 실행하기 전에 테스트 중인 Raid Storage 배열 유형에 대한 테스트 설정을 완료합니다. 자세한 내용은 하드웨어 기반 RAID(스토리지 배열) 테스트 개요를 참조하세요.

또한 이 테스트에는 다음 소프트웨어 및 하드웨어가 필요합니다.

Microsoft MPIO 코어 아키텍처에 인터페이스하는 Microsoft DSM(장치별 모듈) 또는 타사 DSM을 사용하는 하드웨어 스토리지 RAID 배열
테스트 중인 DSM 또는 하드웨어 스토리지 RAID 배열에 포함된 소프트웨어 구성 요소입니다.
다중 경로 I/O 설정

문제 해결

HLK 테스트 실패에 대한 일반적인 문제 해결은 Windows HLK 테스트 실패 문제 해결을 참조하세요.

일반적인 스토리지 문제 해결 정보는 Device.Storage 테스트 문제 해결을 참조하세요.

또한 이 테스트에는 다음과 같은 알려진 문제가 있습니다.

문제점	세부 정보
비 iSCSI 시나리오에 대한 MPIO 테스트 환경이 올바르게 구성되지 않을 수도 있습니다.	비 iSCSI MPIO 테스트 환경에서 테스트하려면 포트가 두 개 이상 있는 HBA(호스트 버스 어댑터)(또는 HBA에 포트가 하나만 있는 경우 둘 이상의 HBA)를 동일한 iSCSI 대상에 연결해야 합니다. 다음 수동 단계에서 테스트 환경이 제대로 설정되었는지 확인할 수 있습니다. 테스트 컴퓨터에서 디바이스 관리자를 열고 숨겨진 장치 표시를 클릭합니다. 일부 디스크가 표시되고 숨겨진 각 디스크가 한 경로에 대해 표시됩니다. 각 HBA 포트 장치 노드: 각 HBA 포트를 마우스 오른쪽 단추로 클릭한 다음 사용 안 함을 클릭하여 사용하지 않도록 설정합니다. 해당 포트 인스턴스를 사용하지 않도록 설정하면 숨겨진 디스크가 제거되는지 확인합니다. 숨겨진 디스크가 남아 있으면 HBA 포트가 iSCSI 대상에 연결되지 않습니다.
테스트가 필터 설치 시 HBA 장치 인스턴스를 가져오는 데 실패합니다.	레지스트리 키(INF 파일)의 DSM 이름이 DSM 자체에 지정된 이름과 동일한지 확인합니다.
테스트가 파이버 채널에 대해 실행 중일 때 파이버 채널 및 iSCSI를 통해 테스트 저장 장치에 연결된 경우 테스트가 iSCSI WMI 정보를 얻지 못합니다.	동일한 테스트 환경에서는 둘 이상의 버스 유형에 대해 동일한 DSM에서 클레임하는 MPIO LUN을 구성하지 않는 것이 좋습니다.
테스트가 링크 수신 거부 및 동시 수신 거부 테스트 사례를 실행한 후 경로가 제거되면 테스트가 실패합니다.	HBA가 최신 드라이버(Windows 로고 인증을 통과한 드라이버)를 실행하고 있는지 확인합니다. 비 iSCSI 테스트 환경에서 테스트 시 다중 경로 I/O 테스트를 수행하려면 HBA 드라이버가 플러그 앤 플레이 드라이버 테스트를 성공적으로 통과해야 합니다. HBA가 해당 테스트를 통과할 수 없는 경우 HBA의 다른 인증된 HBA 모델로 변경하고 다시 테스트하세요. MPIO 경로를 복구하는 데 시간이 오래 걸리기 때문에 이 문제가 발생할 수 있습니다.
MPIO 부팅 환경에서 실행 시 테스트가 실패합니다.	MPIO 부팅 테스트 환경에서 테스트를 실행하지 마세요.
테스트가 iSCSI 대상에서 iSCSI 세션을 복원하지 못합니다.	MPIO 테스트 환경 내에서 하나의 iSCSI 대상과 관련된 여러 포트(IP 주소)가 있는 경우 테스트하는 동안 IP 주소를 통해 연결된 iSCSI 세션이 두 개 이상 있는지 확인해야 합니다. 다중 경로 I/O 테스트를 사용하면 사용자가 iSCSI 대상에 대한 여러 포트 연결을 구성할 수 있지만, 동시에 모든 iSCSI 관련 테스트에 대해 사용자는 테스트하는 동안 하나의 IP 주소만 연결할 수 있습니다.
테스트에 iSCSI UI가 표시되지 않음	먼저 선택한 LUN 버스 유형이 iSCSI인지 확인합니다. 그렇지 않은 경우 다중 경로 I/O 테스트는 iSCSI UI를 표시하지 않습니다. 둘째, iscsihctconfig.ini 파일이 다음 [WLKClient]\JobsWorkingDir\ 경로에 있는지 여부를 확인하세요. 이 파일이 있는 경우 iSCSI UI를 사용하여 iSCSI 구성 정보를 수동으로 입력하려면 해당 파일을 삭제합니다.
테스트가 실패했거나 충돌했습니다.	다중 경로 I/O 테스트를 실행하지 못한 경우 테스트를 다시 실행하기 전에 테스트 환경이 정리되어 있는지 확인하세요. 이 문제는 컨트롤러가 처음에 Windows 로고 키트 1.5를 포함했으며 Windows 로고 키트 1.6를 설치 및 사용하여 스토리지 테스트를 완료하기 전에 Windows를 다시 설치하지 않은 경우에 발생할 수도 있습니다. 이 경우 Windows를 다시 설치하고 테스트를 다시 시작합니다.
IO 작업 오류로 테스트 실패	다중 경로 I/O 테스트가 실패했고 로그 파일에 IO 작업 오류가 포함되어 있는 경우 테스트를 실행하기 전에 사용자의 LUN이 온라인 상태이고 원시 상태로 초기화되었는지 확인하세요. LUN이 온라인이고 초기화된 경우 일부 경로가 장애 조치(failover)된 LUN에서 파일을 복사하거나 읽으세요.

지원 인시던트 열기를 원하는 경우 다음 단계에 따라 고객 지원 서비스에 유용한 정보를 가져옵니다.

전송 .cpk 패키지를 제공하세요. 이 .cpk 패키지는 다중 경로 I/O 테스트 t 로그를 포함할 뿐만 아니라 SCSI 준수 테스트 및 ALUA MPIO 테스트에 대한 로그를 포함해야 합니다.
테스트 환경의 스크린샷을 캡처하세요. 운영 체제가 Windows 2008 R2 이상인 경우 제어판에서 MPIO 구성 스냅샷 화면을 캡처하세요. 이를 보려면 > 제어판 > MPIO > 구성 스냅샷 시작을 클릭합니다.
충돌이 발생한 경우 덤프 파일을 만드세요. 또한 단계에서 다음 테스트를 다시 실행합니다.
1. 테스트 이진 파일 및 파일을 mpiotest.exe, mpioinstallfiltr.exe, iscsiui.exe, devcon.exe, pnpfiltr.sys, pnpdtest.exe 및 mpiotest_script_fvt.txt 파일을 포함하는 Windows HLK 테스트 컴퓨터에 복사합니다.
2. 관리자 권한으로 명령 프롬프트 창을 엽니다.
3. 다음 명령 중 하나를 실행합니다.
  - 버스 유형이 iSCSI인 경우 iscsui.exe 도구 및 입력 정보를 실행하여 iscsihctconfig.ini 파일을 만듭니다.
  - 버스 유형이 비 iSCSI인 경우 mpioinstallfiltr -d <DSM 장치 인스턴스 경로>(예: ROOT\MPIO\0001) -i 명령을 실행한 다음 테스트 컴퓨터를 다시 시작합니다. 이 명령이 중단되는 경우 Windows 메모장을 사용하여 명령 콘솔에서 모든 로그 파일을 복사합니다.
4. 테스트하려면 다음 명령을 실행하십시오. 테스트가 중단된 경우에도 여전히 명령 콘솔에서 Windows 메모장에 모든 로그를 복사할 수 있습니다.
  - Mpiotest.exe -d <DSM 장치 인스턴스 경로 >(예: ROOT\MPIO\0001) -s [ScriptName] -logo -isiSCSI [T/F]입니다.
5. 버스 유형이 비 iSCSI인 경우 명령 프롬프트에서 다음 명령을 실행하여 필터 드라이버 mpioinstallfiltr -d <DSM 장치 인스턴스 경로>(예: ROOT\MPIO\0001) -c를 제거하고 시스템 부팅 머신을 다시 시작합니다.

추가 정보

이 테스트는 Microsoft DSM이든 또는 타사 DSM이든 DSM(장치별 모듈)에만 적용됩니다.

테스트에는 다음과 같은 기본 테스트 어설션이 포함되어 있으며, 이 어설션은 4개의 테스트 사례로 결합됩니다.

장애 조치(failover): 일부 경로가 손상되었지만 전부는 아닐 때 데이터 전송이 중단되지 않습니다.
장애 복구(failback): 일부 경로가 장애 조치(failover)에서 복원될 때 데이터 전송이 정상적으로 작동합니다.
링크 반송: MPIO 환경의 경우 한 경로를 제외한 모든 경로가 손상됩니다. 해당 경로가 끊어지고 15초 이내에 복구되는 경우 데이터 전송을 오류 없이 계속할 수 있습니다.
동시 장애 조치(failover) 및 장애 복구(failback) 또는 "동시 수신 거부": 일부 경로가 장애 조치(failover)하고 다른 경로가 동시에 장애 복구(failback)될 때 데이터 전송이 중단되지 않습니다.
부하 분산 정책: 다른 정책을 설정할 수 있으며 이 정책을 통해 데이터 전송이 올바르게 작동할 수 있습니다. 라운드 로빈 부하 정책 및 하위 집합이 있는 라운드 로빈 부하 정책의 경우 테스트는 효율성이 저하되었는지 여부를 확인합니다.

테스트 구성 요소에는 독립 실행형 테스트 응용프로그램, 오류 주입 필터 드라이버, 테스트 사례 구성 파일, iSCSI 구성 파일(iSCSI 세션을 통해 경로가 생성된 경우) 및 DTM(장치 테스트 관리자)이 포함됩니다.

기업형 스토리지 솔루션의 고객은 해당 구성 요소의 고가용성에 많이 의존합니다. 스토리지에서 고가용성은 종종 중복도에 의해 구현됩니다. MPIO(다중 경로 I/O)는 기업형 스토리지 솔루션의 패브릭 계층에 대한 이러한 구현 중 하나입니다. Microsoft는 Windows Vista 기간에 Windows 고급 서버 운영 체제와 함께 제공되는 다중 경로 드라이버(mpio.sys) 및 장치별 모듈(msdsm.sys)을 사용하여 다중 경로 I/O를 지원합니다.

이 테스트는 공급업체의 스토리지 솔루션과 Microsoft 드라이버 솔루션의 호환성을 위한 다중 경로 I/O 테스트를 제공합니다. 다음 영역에 중점을 둡니다.

경로 장애 조치(failover) 및 복구는 데이터 전송 품질에 영향을 미치지 않아야 합니다. MPIO 환경을 설정하는 한 가지 목적은 데이터 전송의 안정성을 높이는 것입니다. 이 테스트는 경로를 중단하기 위해 실제 환경에서 발생하는 몇 가지 간단한 시나리오를 시뮬레이션한 다음, 환경에서 데이터를 정상적으로 전송할 수 있는지 여부를 확인합니다.
MPIO 환경에서 데이터 전송 효율성이 개선되거나 적어도 성능이 저하되지 않아야 합니다.
스토리지 장치는 지원하기로 선언한 모든 정책에서 정상적으로 작동해야 합니다.

참고

공급업체 정책(정책 값은 7)을 지원하는 DSM(장치별 모듈)의 경우 이 테스트를 실행하기 전에 공급업체의 정책을 현재 정책으로 지정하세요.

이 테스트를 실행하려면

Windows HLK(Windows Hardware Lab Kit)가 실행하려는 테스트 사례를 검색하는 독립 실행형 테스트 응용프로그램을 시작합니다.
Windows HLK가 추가 테스트를 위해 MPIO 테스트 환경 정보를 검색합니다.
경로가 iSCSI를 초과하지 않으면 추가 테스트를 위해 테스트가 관련 HBA 인스턴스에 대한 필터 드라이버를 로드합니다.
경로가 iSCSI를 초과하면 다음 방법 중 하나를 사용하여 iSCSI 구성 정보를 제공합니다.
- [WLK PATH]\JobsWorkingDir\Tasks\[WTTJOBNAME]\에서 Iscsihctconfig.ini 파일을 만드는 테스트 클라이언트의 창 팝업에 구성 데이터를 입력합니다. 자세한 내용은 iSCSI HBA 부팅 테스트(LOGO)를 참조하세요.
  
  참고
  
  테스트 환경에 여러 대상이 포함된 경우 IQN, 포털 IP 및 포트 번호를 포함하여 하나의 대상 관련 정보를 입력하도록 선택하세요. IP 주소의 경우 여러 IP 주소가 있다면 해당 대상을 연결하는 데 사용되는 주소를 입력하세요. MPIO 테스트를 위해 HBA PnP ID를 입력할 필요가 없습니다.
  
  참고
  
  iSCSI 환경에서 상호 CHAP를 지원하는 경우 상호 라디오 상자와 상호 CHAP 지원 확인란을 모두 선택하세요.
- 입력 iSCSI 구성 정보는 iscsihctconfig.ini 파일에 저장됩니다. 사용자 시간을 절약하기 위해 테스트 컴퓨터의 [WLKClient]\JobsWorkingDir\ 아래에 이 구성 파일의 복사본을 배치합니다. 그런 다음 사용자는 iSCSI 구성 정보를 다시 입력하지 않고 동일한 iSCSI 스토리지 대상에 대해 동일한 테스트 클라이언트에서 테스트를 다시 실행할 수 있습니다. 또한 테스트하기 전에 사용자는 Iscsihctconfig.ini 파일을 수동으로 만들고 이를 구성 데이터가 포함된 테스트 컴퓨터의 [WLKClient] \JobsWorkingDir\ 아래에 배치하도록 선택할 수 있습니다. 이때 다음 형식을 사용합니다.
```
[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
```
지원을 선언하고, 장애 조치(failover) 및 장애 복구(failback) 시나리오를 시뮬레이션하고, 테스트를 수행하는 부하 분산 정책을 설정합니다. 비 iSCSI 테스트 환경의 경우 링크 바운싱 및 동시 바운싱 시나리오를 시뮬레이션합니다.
비 ALUA 스토리지 및 ALUA 스토리지에 대한 라운드 로빈 정책을 설정하여 성능 검사를 사용하도록 설정합니다.
테스트 도구는 WTTLogger에 로그합니다.

명령 구문

명령	설명
mpiotest.exe -d "[WDKDeviceID]" -s [ScriptName] -logo -isiSCSI [isiSCSI]	테스트를 실행합니다.

참고

이 테스트 이진에 대한 명령줄 도움말을 보려면 /h를 입력합니다.

파일 목록

파일	위치
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]\

매개 변수

매개 변수 이름	매개 변수 설명
LLU_NetAccessOnly	테스트 파일 공유에 액세스하기 위한 사용자 계정입니다.
LLU_LclAdminUsr	테스트를 실행하기 위한 사용자 계정입니다.
스크립트 이름	전체 테스트 스크립트
WDKDeviceID	테스트할 장치의 인스턴스 경로입니다.
isiSCSI	Is 스토리지 버스 유형 iSCSI(T/F)

다음을 통해 공유