Installation Manual

Installing the CIM Extension for Microsoft Windows282
• The management server supports communication with HBAs that are compliant with the HBA
API. For more information about the HBA API, see the following Web page at the SNIA
website:
http://www.snia.org/tech_activities/hba_api/
• The appiq_hbaapi.dll file is installed as part of the CIM extension to provide access to the
SNIA HBA API and it can be found in
<Installation_Directory>\CimExtensions\lib\.
• The SNIA compliant HBA API provided by the HBA Vendor can be verified by checking the
Windows registry for the following:
• For 32-bit operating systems - \\HKEY_LOCAL_MACHINE\Software\SNIA\HBA
• For 64-bit operating systems -
\\HKEY_LOCAL_MACHINE\Software\WoW6432Node\SNIA\HBA
To use the SNIA HBAAPI (appiq_hbaapi.dll):
1. Set the following registry setting:
HKEY_LOCAL_MACHINE\SOFTWARE\AppIQ
2. Create a String Value named HbaApiPath with Value Data <Installation
Directory>\CimExtensions\lib\appiq_hbaapi.dll.
3. In the <Installation_Directory>\CimExtensions\tools directory on the host, the
program hbatest.exe is available for testing if the HBA configuration is able to provide
information.
Verifying SNIA HBA API Support
The management server can only talk to host bus adapters (HBAs) that support the SNIA HBA API.
The hbatest program, which is accessible from the
<Installation_Directory>\CimExtensions\tools, lists the name and number for all
HBAs that support the SNIA HBA API. In some instances hbatest may report it cannot find an HBA
driver even though an HBA driver is installed. Try installing a different version of the HBA driver
that is SNIA compliant.
To run hbatest:
1. Open a command window and change the directory to
<Installation_Directory>\CimExtensions\tools.
2. Enter the following at the command prompt:
hbatest.exe
The hbaapi.dll must be upgraded or the SNIA HBA API must be used if the following
configuration is used:
• You are using Emulex HBA's.
• The host has a version of hbaapi.dll that is earlier than version 5.2.3790.2753.
• The host is running HP MPIO multipathing.
When using Emulex HBA's and the SNIA library, remember that previous versions of HBAnyware
provide the SNIA library; however, several later versions of HBAnyware do not ship with the SNIA
library and rely upon the Microsoft SNIA library. Your configuration may require you to run the