HBA API Test (LOGO)

  • Article

This test verifies the Microsoft Windows Management Instrumentation (WMI) interfaces that are implemented by a host bus adapter (HBA) driver for support of the Storage Networking Industry Association's Common HBA API.

Note

   To qualify under the Windows Certification program, Fibre Channel and SAS Storport miniport drivers and SCSI miniport drivers must support the HBA API.

 

Test details

   
Specifications
  • Device.Storage.Controller.Fc.Interface
  • Device.Storage.Controller.Fcoe.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 Compatibility
Timeout (in minutes) 300
Requires reboot false
Requires special configuration false
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: Fibre Channel Adapter Testing Prerequisites

Troubleshooting

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

For troubleshooting information, see Troubleshooting Device.Storage Testing.

More information

The HBA API test requires a Fibre Channel switch between the HBA and the storage devices that you are testing. The Fibre Channel switch must support the GIEL and GANXT specifications. Most switches that have been made in the past 10 years support these specifications.

The topology can any kind of fabric configuration, as long as a switch is present. For example, the simplest configuration is the following: [TestMachine]<-->[FibreChannelSwitch]<-->[FibreChannelStorageArray]

Note

   The test uses a Microsoft Visual Basic script to query the HBAs WMI interfaces. For specific test cases, see the Assertions section. You can view the source of the test by opening the script file with a text editor.

 

The test first installs the schema for the HBA API on the computer and then starts the script.

Command syntax

Command Description

mofcomp -N:root\wmi hbaapi.bmf

Installs the hbaapi.bmf file.

cscript hbatst.vbs "[WDKDeviceID]"

Specifies the device to be tested.

 

File list

File Location

hbatst.vbs

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

hbaapi.bmf

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

 

Parameters

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