iSCSI HBA WMI Test (LOGO)

  • Article

This test verifies that an iSCSI host-bus adapter (HBA) driver implements the required Microsoft® Windows™ Management Instrumentation (WMI) interfaces. To qualify for the Windows Hardware Certification, iSCSI HBA drivers must support the WMI classes that are documented in the iSCSI Driver Development Kit (DDK) version 1.0.

Test details

   
Specifications
  • Device.Storage.Controller.Iscsi.Interface
Platforms
  • Windows 10, client editions (x86)
  • Windows 10, client editions (x64)
  • Windows Server 2016 (x64)
Supported Releases
  • Windows 10
  • Windows 10, version 1511
  • Windows 10, version 1607
  • Windows 10, version 1703
  • Windows 10, version 1709
  • Windows 10, version 1803
  • Windows 10, version 1809
  • Windows 10, version 1903
  • Next update to Windows 10
Expected run time (in minutes) 5
Category Development
Timeout (in minutes) 300
Requires reboot false
Requires special configuration true
Type automatic

 

Additional documentation

Tests in this feature area might have additional documentation, including prerequisites, setup, and troubleshooting information, that can be found in the following topic(s):

Running the test

Before you run the test, complete the test setup as described in the test requirements: iSCSI HBA Testing Prerequisites.

If this is the first time you are running an iSCSI HBA test, iSCSI Target test, or MPIO test over iSCSI bus type on the HLK client, or if there is no iscsihctconfig.ini under [HLK Path]\JobsWorkingDir\ on the HLK client, you will receive a pop-up dialog box to input iSCSI configuration information and/or HBA information. For more information about this dialog box, see "Running the test" in iSCSI HBA Boot Test (LOGO).

Troubleshooting

For generic troubleshooting of HLK test failures, see Troubleshooting Windows HLK Test Failures.

For troubleshooting information, see Troubleshooting Device.Storage Testing.

In addition:

  1. Look at the job results log file for test failures.

  2. Enter the required data in the configuration dialog box that appears when this job is scheduled. For more information, go to iSCSI HBA Boot Test (LOGO).

This test always return Pass or Fail. To review test details, review the test log from the Windows HLK Manager.

More information

The test enumerates all WMI classes that the HBA driver that you are testing exposes. The test verifies that there is an instance of each required class and logs a failure if a class is missing. In addition, for each class that is implemented, the test verifies the data items in the class contain valid values.

The required iSCSI initiator WMI classes include the following:

  • MSiSCSI_HBAInformation

  • MSiSCSI_InitiatorSessionInfo

  • MSiSCSI_PersistentLogins

  • MSiSCSI_TargetMappings

  • MSiSCSI_LUNMappingInformation

  • MSiSCSI_HBASessionConfig

  • MSiSCSI_PortalInfoClass

  • MSiSCSI_TCPIPConfig

  • MSiSCSI_NICConfig

  • MSiSCSI_BootConfiguration

  • MSiSCSI_SecurityCapabilities

  • MSiSCSI_DiscoveryConfig

  • MSiSCSI_RADIUSConfig

  • MSiSCSI_ConnectionStatistics

  • MSiSCSI_SessionStatistics

  • MSiSCSI_InitiatorLoginStatistics

  • MSiSCSI_InitiatorInstanceStatistics

  • MSiSCSI_MMIPSECStats

  • MSiSCSI_QMIPSECStats

  • MSiSCSI_NICPerformance

To run this test:

  1. Run the test as a Driver Test Manager (DTM) job.

  2. Enter the required data in the configuration dialog box that appears when this job is scheduled.

Command syntax

Command option Description

iscsiwmi.cmd

Runs the test.

 

File list

File Location

iscsiwmi.cmd

<[testbinroot]>\nttest\driverstest\storage\wdk\iscsi\

 

Parameters

Parameter name Parameter description
LLU_NetAccessOnly User account for accessing test fileshare.
LLU_LclAdminUsr User account for running the test.
WDKDriverName Driver Name
WDKDeviceID Device ID of iSCSI HBA