CommandCentral Storage (CCS) version 5.0 does not offer support for Hewlett Packard (HP) Secure path on windows resulting in only a single path being visible in the web interface (GUI). Support for HP secure-path version 4.0C with service pack 2-9 on Windows 2003 SP2 server and version 4.0C without service pack on Windows 2000 server was added.

Article:TECH55802  |  Created: 2007-01-28  |  Updated: 2007-01-21  |  Article URL http://www.symantec.com/docs/TECH55802
Article Type
Technical Solution

Product(s)

Environment

Issue



CommandCentral Storage (CCS) version 5.0 does not offer support for Hewlett Packard (HP) Secure path on windows resulting in only a single path being visible in the web interface (GUI). Support for HP secure-path version 4.0C with service pack 2-9 on Windows 2003 SP2 server and version 4.0C without service pack on Windows 2000 server was added.

Solution



CCS5.0 did not offer support HP secure-path. Support for HP secure-path version 4.0C with service pack 2-9 on Windows 2003 SP2 server and version 4.0C without service pack on Windows 2000 server was added. Symantec has only tested these versions. The feature requires a new StorageExplorer library HbaExp.dll and hbaapp.exe, which are included in the file below.

Deployment into the environment requires a step by step process.
You can confirm the error by testing.
Test by going to CCS-GUI "settings | Managed Hosts" and select a multipathed host to check the StorageExplorer (select the explorer by the same name), check if the "Configured Device" has an error or not. If there is an error you will need to clean up the StorageExplorer.cfg file for this host and restart again in order to read the configuration and register properly.
1). Traverse to CCS  HAL configuration file directory in a DOS windows  (by default C:\Program Files\VERITAS\CommandCentral Storage Data\Conf\HAL)
open the file "StorageExplorer.cfg" in a text editor and remove all content of items with [devices\hba-x:x]
See the following example to remove all lines contained under [Devices\hba-0:0], [Devices\hba-1:0], [Devices\hba-2:0] and usually before [Control]  in the file and then save it.
[Devices\hba-0:0]
"AutoDiscovered"="1"
"Enable"="1"
"DeviceState"="ERROR"
"wwnn"="200000E08xxxxx7"
"AdapterName"="QLogic-ql2300-1"
"instanceNo"="0"
"OsHandle"="\\.\Scsi2:"
"ErrorStateStartTime"="11907482935150000"
"DeviceErrorTime"="11927407250150000"
"DeviceErrorUMI"="137440329731"
[Devices\hba-1:0]
"DeviceErrorUMI"="137440329731"
"DeviceErrorTime"="11927407250620000"
"ErrorStateStartTime"="11907482937340000"
"AutoDiscovered"="1"
"Enable"="1"
"DeviceState"="ERROR"
"wwnn"="200000E08xxxxx4"
"AdapterName"="QLogic-ql2300-2"
"instanceNo"="1"
"OsHandle"="\\.\Scsi3:"
[Devices\hba-2:0]
"AutoDiscovered"="1"
"Enable"="1"
"DeviceState"="ERROR"
"wwnn"="200000E08xxxxx3"
"AdapterName"="Emulex-LP9002-1"
"instanceNo"="2"
"OsHandle"="\\.\Scsi6:"
"ErrorStateStartTime"="11907482940620000"
"DeviceErrorTime"="11927407250930000"
"DeviceErrorUMI"="137440329731"

2). If the Administrator has the intention of using Microsoft hbaapi.dll :
If the host is a CCS Management Server (MS) or Management Host (MH)  with collections for switch or array running on the host, the Administrator needs to clean up the files 'GsSwitchExplorer.cfg" and "StorageExplorer.cfg", all predefined devices should be clean up, see following lines for examples of what to remove.
[Devices\hba-2:0]
"AdapterName"="com.emulex-LP9002-2"
"HbaPortWWN"="10000000Cxxx173"
"DeviceState"="INACTIVE"
"Enable"="0"
"AutoDiscovered"="1"
"DeviceManager"="1"
[Devices\hba-1:0]
"AdapterName"="com.qlogic-QLA2342-1"
"HbaPortWWN"="210100E08xxxxxx7"
"DeviceState"="INACTIVE"
"Enable"="0"
"AutoDiscovered"="1"
"DeviceManager"="1"
[Devices\hba-0:0]
"AdapterName"="com.qlogic-QLA2342-0"
"HbaPortWWN"="210000E08xxxxxA7"
"DeviceState"="INACTIVE"
"Enable"="0"
"AutoDiscovered"="1"
"DeviceManager"="1"

Synopsis to use Microsoft HBAAPI.dll :
Default within the code is to load vendor SNIA hbaapi library to make the CCS StorageExplorer function on the Windows platform.
In order to use Microsoft hbaapi.dll, the Administrator needs to do the following:
Note: System requirement: the host should be Windows 2003 with Service Pack (SP) 2, because SP1 hbaapi.dll has memory leak issue and it can cause a system hang.
See following link for details. <http://support.microsoft.com/kb/916531/en-us>
If the host is Windows 2000 then Service Pack 4 and up is required.
Customers with the CCS5.0 GA version, need to perform the following steps in order to enable to use Microsoft hbaapi.dll:
- On CCS Management Server host:
A). Traverse to CCS  HAL (Hardware Abstraction Layer)  binaries installation directory in a DOS windows  (by default C:\Program Files\VERITAS\CommandCentral Storage\HAL\bin)
execute "halagentcfg stop-all"
B). Rename "vxhbaapi.dll" to "vxhbaapi.dll.bak"
C). Traverse to CCS  HAL configuration file directory in a DOS windows  (by default  C:\Program Files\VERITAS\CommandCentral Storage Data\Conf\HAL)
open the file "StorageExplorer.cfg" in a test editor
remove all content of items with [devices\hba-x:x]
Note: See the following example to remove all red lines and save it.
(1) / (2) See above
D). execute "halagentcfg start-all" to restart all explorers;
- On CCS  Managed Host:
A).Traverse to CCS  HAL binaries installation directory in a DOS windows  (by default C:\Program Files\VERITAS\CommandCentral Storage\HAL\bin)
execute "halagentcfg stop-process -p HostExplorers"
B). Rename "vxhbaapi.dll" to "vxhbaapi.dll.bak";
C). Open "StorageExplorer.cfg" to remove all registered devices. see above in detail.
D). execute "halagentcfg start-process -p HostExplorers" to restart Host Explorers;
3). Altering other hosts which do not have an installed vendor SNIA library:
A).Traverse to CCS  HAL binaries installation directory in a DOS windows  (by default C:\Program Files\VERITAS\CommandCentral Storage\HAL\bin)
execute "halagentcfg stop-process -p HostExplorers"
B).Rename vxhbaapi.dll, hbaapp.exe and HbaExp.dll into vxhbaapi.dll.bak, hbaapp.exe.bak and HbaExp.dll.bak
C).Copy vxhbaapi.dll, hbaapp.exe and HbaExp.dll  into place from the downloaded file below
D).execute "halagentcfg start-process -p HostExplorers" to restart Host Explorers;




Supplemental Materials

SourceETrack
Value1118316
DescriptionHP Secure Path discrepancies

Legacy ID



294498


Article URL http://www.symantec.com/docs/TECH55802


Terms of use for this information are found in Legal Notices