HBA API Test (LOGO)
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
Associated requirements |
Device.Storage.Controller.Fc.Interface Device.Storage.Controller.Fcoe.Interface |
Platforms |
Windows 7 (x64) Windows 7 (x86) Windows 8 (x64) Windows 8 (x86) Windows Server 2012 (x64) Windows Server 2008 R2 (x64) Windows Server 2008 x64 Windows Server 2008 x86Windows 8.1 x64Windows 8.1 x86Windows Server 2012 R2 |
Expected run time |
~5 minutes |
Categories |
Certification Functional |
Type |
Automated |
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 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.
Parameters
| Parameter | Description |
|---|---|
WDKDeviceID |
The device instance ID. |
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\ |