HP 3PAR StoreServ Cluster Extension Software Administrator Guide (5697-2894, December 2013)

When HP 3PAR StoreServ Cluster Extension is integrated into the cluster software, an error message
string and integer value are displayed. For the CLI, a return code is displayed. For more information,
see “CLI commands” (page 62).
Log files
Log files assist you in locating and identifying problems. Timestamps, component IDs, and message
IDs are included.
• HP 3PAR StoreServ Cluster Extension-related messages are logged by MSFC to the file
cluster.log in the location %windir%\Cluster\Reports.
• For each system, HP 3PAR StoreServ Cluster Extension keeps its own log file in its default log
location.
Log locationLog file
%HPCLX_3PAR_PATH%\logclxmscs.log
%HPCLX_3PAR_PATH%\logVMClxMscs.log (For VM Management on
Windows Server 2012 only)
%HPCLX_3PAR_PATH%\logCLXCmdlet.log
• HP 3PAR StoreServ Cluster Extension messages can also be found in the following:
◦ MSFC log file [%windir\cluster\reports\cluster.log]
Always disable automatic service or application failover when merging or resynchronizing
Remote Copy volume groups. A failure of the resynchronization source while resynchronizing
can lead to noncurrent data on the resynchronization target.
Start errors
• Generic startup or initialization logic errors can occur when the path to the HP 3PAR StoreServ
Cluster Extension binaries has not been set in the PATH environment variable and the processes
(for example the cluster service) have not recognized the %HPCLX_3PAR_PATH% variable.
To fix this problem, restart the cluster service.
• If the required components of HP 3PAR StoreServ Cluster Extension are not available, a file
(clxlog.log ) is generated that can be used for troubleshooting. The file is usually in the
working directory of the operating system (%SYSTEMROOT%).
• HP 3PAR StoreServ Cluster Extension returns a local error if any of the following occurs:
HP 3PAR StoreServ Cluster Extension does not find the user configuration file for
clx3PARrun in the correct directory location.
◦
◦ An error occurs after initialization.
Failover error handling
Windows Cluster automatically fails over resource groups if the system where resource group is
running on becomes unavailable. This is part of the cluster functionality. Also, this means that if a
problem occurs with the HP 3PAR StoreServ Storage, a resource group online process will be
stopped. The behavior of HP 3PAR StoreServ Cluster Extension is highly configurable. Depending
upon the customer setting, Cluster Extension is used to prevent resource groups from going online
automatically under the wrong conditions.
Cluster Extension will return local, data center-wide or even cluster-wide errors to prevent accidental
access to the resource group’s virtual volumes. HP does not recommend restarting a failed resource
group without investigating the problem. A failed Cluster Extension resource indicates the need to
Log files 79