HiCommand Dynamic Link Manager User's Guide (for Windows(R))

[Contents][Glossary][Index][Back][Next]


8.2.3 List of collected error information

Table 8-1 List of error information collected by the DLMgetras utility for collecting error information lists the types of error information collected by the DLMgetras utility for collecting error information in the folder to which error information is output.

Table 8-1 List of error information collected by the DLMgetras utility for collecting error information

Folder that stores collected files#1 Files Explanation
Just under the folder to which collected information is output getrasn.log The log file generated when DLMgetras is executed.
folder-to-which-collected-information-is-output\HDLM-installation-destination-drive-name_\Program Files\HITACHI\DynamicLinkManager#2 hdlmservicepack HDLM SP version number
hdlmversion HDLM version number
folder-to-which-collected-information-is-output\HDLM-installation-destination-drive-name_\Program Files\HITACHI\DynamicLinkManager\log#2 dlmmgrn.log HDLM Manager log (including the driver log)
dlmprsvkey.log PRSV key log
hcmdslicense2.log Log when updating the license
hdlmtrn.log Trace file
hs_err_pidnnnn.log Java execution log (nnnn indicates a process ID)
folder-to-which-collected-information-is-output\folder-to-which-Windows-is-introduced (%SystemRoot%) setupact.log
setupapi.log
setuperr.log
Windows log
folder-to-which-collected-information-is-output\HDLM-installation-destination-drive-name_\Program Files\HITACHI\DynamicLinkManager\log\mmap#2 hdlmtr.mm Trace management file
folder-to-which-collected-information-is-output\HDLM-installation-destination-drive-name_\Program Files\HITACHI\DynamicLinkManager\log#2 dlmgui1.log
dlmgui2.log
HDLM GUI log
dlmgui_launcher1.log
dlmgui_launcher2.log
HDLM GUI log
dlmwebagent[1-N].log#3 HDLM remote access interface log
installhdlm.log Unattended installation log
folder-to-which-collected-information-is-output\HDLM-installation-destination-drive-name_\Program Files_\HITACHI\DynamicLinkManager\config#2 dlmgui_version HDLM GUI version and build numbers
dlmmgr.xml HDLM configuration file
dlmwebagent.properties Configuration file for HDLM remote access interface
folder-to-which-collected-information-is-output\Windows-installation-destination-drive-name\Windows\Cluster cluster.log MSCS log
folder-to-which-collected-information-is-output\VxVM-installation-destination-drive-name_Program Files\VERITAS\Volume Manager M.N\logs#4 All files under logs VxVM log
folder-to-which-collected-information-is-output\VCS-installation-destination-drive-name_Program Files\VERITAS\Cluster Server\log All files under log VCS log
Integrated-trace-file-output-folder-specified-in-the-Hitachi-Network-Objectplaza-Trace-Library-utility
(Default: folder-to-which-collected-information-is-output\installation-destination-drive-name_\Program Files#5\HITACHI\HNTRLib2\spool)
hntrn.log#6 Integrated trace file (HNTRLib2)
Integrated-trace-file-output-folder-specified-in-the-Hitachi-Network-Objectplaza-Trace-Library-utility
(Default: folder-to-which-collected-information-is-output\installation-destination-drive-name_\Program Files\HITACHI\HNTRLib\spool)
hntr[1-16].log Integrated trace file (HNTRLib)
folder-to-which-collected-information-is-output\getrasinfo application-list.txt List of uninstallation information
cluster-sys.txt MSCS information
dirHdlmRoot.txt All the folders and the list of files in the HDLM installation destination folder
dirSystemRoot.txt All the folders and the list of files in the Windows installation destination folder
dlm_iscsims.txt#7 Contents of the iscsicli.exe
dlm-reg.txt Contents of the HDLM registry
dlmmemorytrace.txt HDLM memory trace information
dlmmgr-lic.txt Result of the dlnkmgr view -sys -lic command
dlmmgr-lu.txt Result of the dlnkmgr view -lu -item pn cp type ic ie dnu slpr clpr -exlu command
dlmmgr-lu-all.txt Result of the dlnkmgr view -lu -item all -exlu command
dlmmgr-path.txt Result of the dlnkmgr view -path -exlu command
dlmmgr-path-iem.txt Result of the dlnkmgr view -path -iem command
dlmmgr-sys.txt Result of the dlnkmgr view -sys command
evApplication.evt
evApplication.log
Event log for applications
evSecurity.evt
evSecurity.log
Event log for security
evSystem.evt
evSystem.log
Event log for the system
HBA-reg.txt Registry setting information of HBA
hdlmdsm-status.txt Filter driver information
hntrlib-reg.txt Contents of the HNTRLib registry
iscsi-reg.txt iscsi registry information
mpio-list.txt MPIO information
mpio-reg.txt MPIO registry information
winmsd.txt Windows system information
folder-to-which-collected-information-is-output\hbsainfo All files under hbsainfo#8 Error information of a HiCommand product other than HDLM

#1
The target error information collection folder is created in the folder to which collected information is output. The user specifies the folder to which collected information is output when executing DLMgetras. The default of folder-to-which-collected-information-is-output when the DLMgetras utility is executed from the Windows Start menu is Windows-installation-destination-drive-name\hdlmtemp\hdlmgetras_nn. nn is a number from 00 to 99. You can change the Windows-installation-destination-drive-name\hdlmtemp portion by changing the target in the DLMGetras properties.

#2
The underlined part indicates the folder specified during installation

#3
The value N depends on the setting in the dlmwebagent.properties file. The default value is 2.

#4
M.N indicates the VxVM version. For example, 4.1 indicates VERITAS Volume Manager 4.1. The applicable version is either 2.7, 3.0, 3.1, 4.0, 4.1, 4.2, or 4.3.

#5
In the Windows Server 2003(IPF and x64), replace this part with Program Files (x86).

#6
In the actual file name, a file number is appended to Integrated-trace-file-prefix specified-in-the-Hitachi-Network-Objectplaza-Trace-Library-utility2. For example, the default will be hntr21.log to hntr216.log. Note that the 2 following the integrated trace file prefix does not represent a file number.

#7
You can obtain dlm_iscsims.txt only when the iSCSI software was installed.

#8
You can obtain all files under hbsainfo only when the HiCommand product other than HDLM from which error information is to be collected is being used.

Manually obtainable error information files and how to obtain them

When the DLMgetras utility finishes normally, the KAPL10022-I message is displayed. Error information is not obtained in the following cases:

In the above cases, manually obtain the error information described in the table below, and then save it in a desired location. Table 8-2 Manually obtainable error information files and how to obtain them shows the manually obtainable error information files and how to obtain them.

Table 8-2 Manually obtainable error information files and how to obtain them

Error information File How to obtain the files#1
HDLM log dlmguin.log
dlmgui_launchern.log
dlmmgrn.log
dlmwebagent[1-N].log
hcmdslicense2.log
hdlmtrn.log
hs_err_pidnnnn.log
installhdlm.log
Obtain the HDLM log files that are in the following folder:
HDLM-installation-drive:\Program Files\HITACHI\DynamicLinkManager\log
hdlmtr.mm Obtain the hdlmtr.mm file that is in the following folder:
HDLM-installation-drive:\Program Files\HITACHI\DynamicLinkManager\log\mmap
Configuration file dlmmgr.xml
dlmwebagent.properties
Obtain the configuration files that are in the following folder:
HDLM-installation-drive:\Program Files\HITACHI\DynamicLinkManager\config
MSCS log cluster.log Obtain the files that are in the following folder and are specified in the environment variable ClusterLog:
Windows-installation-folder\Cluster
VxVM log All files under logs Obtain all the files that are in the following folder:
VxVM-installation-folder\logs
VCS log All files under log Obtain all the files that are in the following folder:
VCS-installation-folder\log
Windows log setupact.log
setupapi.log
setuperr.log
Obtain the log files that are in the following folder:
folder-to-which-Windows-is-introduced (%SystemRoot%)
Integrated trace file (HNTRLib2) hntrn.log#2 Obtain the integrated trace files that are in the following folder:
HNTRLib2-installation-drive:\Program Files#3\HITACHI\HNTRLib2\spool
Integrated trace file (HNTRLib) hntr[1-16].log Obtain the integrated trace files that are in the following folder:
HNTRLib-installation-drive:\Program Files\HITACHI\HNTRLib\spool
Registry information application-list.txt
dlm-reg.txt
HBA-reg.txt
Use a registry editor to output the registry information into a file. The following lists the registry keys for each file.
When obtaining the HBA-reg.txt file, the registry keys below might not exist, depending on the environment you use. Only output existing registry keys into a file.
  • For application-list.txt:
    HKEY_LOCAL_MACHINE\SOFTWARE
  • For dlm-reg.txt:
    HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet
  • For HBA-reg.txt:
    HKEY_LOCAL_MACHINE\SYSTEM\SYSTEM\CurrentControlSet\Services\ql2100
    HKEY_LOCAL_MACHINE\SYSTEM\SYSTEM\CurrentControlSet\Services\ql2200
    HKEY_LOCAL_MACHINE\SYSTEM\SYSTEM\CurrentControlSet\Services\ql2300
    HKEY_LOCAL_MACHINE\SYSTEM\SYSTEM\CurrentControlSet\Services\elxsli2
    HKEY_LOCAL_MACHINE\SYSTEM\SYSTEM\CurrentControlSet\Services\lp6nds35
    HKEY_LOCAL_MACHINE\SYSTEM\SYSTEM\CurrentControlSet\Services\lpxnds
    HKEY_LOCAL_MACHINE\SYSTEM\SYSTEM\CurrentControlSet\Services\lpxftr
    HKEY_LOCAL_MACHINE\SYSTEM\SYSTEM\CurrentControlSet\Services\elxstor
MSCS information cluster-sys.txt At the command prompt, execute all of the cluster commands listed below to output the results into the cluster-sys.txt file:
cluster /ver > cluster-sys.txt
cluster /QUORUM >> cluster-sys.txt
cluster /List >> cluster-sys.txt
cluster node >> cluster-sys.txt
cluster node /prop >> cluster-sys.txt
cluster node /priv >> cluster-sys.txt
cluster group >> cluster-sys.txt
cluster group /prop >> cluster-sys.txt
cluster group /priv >> cluster-sys.txt
cluster res >> cluster-sys.txt
cluster res /prop >> cluster-sys.txt
cluster res /priv >> cluster-sys.txt
cluster net >> cluster-sys.txt
cluster net /prop >> cluster-sys.txt
cluster net /priv >> cluster-sys.txt
cluster netint >> cluster-sys.txt
cluster netint /prop >> cluster-sys.txt
cluster netint /priv >> cluster-sys.txt
cluster restype /list >> cluster-sys.txt
iSCSI information dlm_iscsims.txt#4 At the command prompt, execute the following iSCSI utilities to output the results into each file:
  • iscsicli VersionInfo >> dlm_iscsims.txt
  • iscsicli ListPersistentTargets >> dlm_iscsims.txt
  • iscsicli ListTargetPortals >> dlm_iscsims.txt
  • iscsicli ListTargets >> dlm_iscsims.txt
  • iscsicli SessionList >> dlm_iscsims.txt
HDLM information hdlmservicepack
hdlmversion
Obtain the hdlmservicepack file, and the hdlmversion file that is in the following folder:
HDLM-installation-drive:\Program Files\HITACHI\DynamicLinkManager
dlmgui_version Obtain the dlmgui_version file that is in the following folder:
HDLM-installation-drive:\Program Files\HITACHI\DynamicLinkManager\config
dlmmemorytrace.txt
dlmmgr-lic.txt
dlmmgr-lu.txt
dlmmgr-lu-all.txt
dlmmgr-path.txt
dlmmgr-path-iem.txt
dlmmgr-sys.txt
hdlmdsm-status.txt
viewfile.txt
At the command prompt, execute the following commands to output the results into each file:
  • dlmmemorytrace.txt
    HDLM-installation-drive:\Program Files\HITACHI\DynamicLinkManager\DLMTools\hsptpdrv.exe v > dlmmemorytrace.txt
  • dlmmgr-lic.txt
    dlnkmgr view -sys -lic > dlmmgr-lic.txt
  • dlmmgr-lu.txt
    dlnkmgr view -lu -item pn cp type ic ie dnu slpr clpr -exlu > dlmmgr-lu.txt
  • dlmmgr-lu-all.txt
    dlnkmgr view -lu -item all -exlu > dlmmgr-lu-all.txt
  • dlmmgr-path.txt
    dlnkmgr view -path -exlu > dlmmgr-path.txt
  • dlmmgr-path-iem.txt
    dlnkmgr view -path -iem > dlmmgr-path-iem.txt
  • dlmmgr-sys.txt
    dlnkmgr view -sys > dlmmgr-sys.txt
  • hdlmdsm-status.txt
    HDLM-installation-drive:\Program Files\HITACHI\DynamicLinkManager\DLMTools\hsptpdrv.exe aa > hdlmdsm-status.txt
  • viewfile.txt
    HDLM-installation-drive:\Program Files\HITACHI\DynamicLinkManager\DLMTools\viewfile.exe > viewfile.txt
All the folders and the list of files in the HDLM installation destination folder dirHdlmRoot.txt At the command prompt, execute the following commands to output the results into dirHdlmRoot.txt file.
dir /s /a HDLM-installation-drive:\Program Files\HITACHI\DynamicLinkManager > dirHdlmRoot.txt
Event log information evApplication.evt
evApplication.txt
evSecurity.evt
evSecurity.txt
evSystem.evt
evSystem.txt
Open the Event viewer, and then name and save each log file. For each log, save the following two types of files described below for each log file:
  • File A file whose type is event log (*.evt)
  • File A file whose type is text file (tab-delimited) (*.txt)
MPIO information mpio-list.txt At the command prompt, execute the mpiolist command listed below to output the results into the mpio-list.txt file:
  • HDLM-installation-drive:\Program Files\HITACHI\DynamicLinkManager\DLMTools\mpiolist 0 > mpio-list.txt
  • HDLM-installation-drive:\Program Files\HITACHI\DynamicLinkManager\DLMTools\mpiolist 1 >> mpio-list.txt
  • HDLM-installation-drive:\Program Files\HITACHI\DynamicLinkManager\DLMTools\mpiolist 2 >> mpio-list.txt
  • HDLM-installation-drive:\Program Files\HITACHI\DynamicLinkManager\DLMTools\mpiolist 3 >> mpio-list.txt
  • HDLM-installation-drive:\Program Files\HITACHI\DynamicLinkManager\DLMTools\mpiolist 4 >> mpio-list.txt
  • HDLM-installation-drive:\Program Files\HITACHI\DynamicLinkManager\DLMTools\mpiolist 5 >> mpio-list.txt
Windows system information winmsd.txt At the command prompt, execute the winmsd command as follows. The winmsd.txt file is output to the folder where you execute the command:
winmsd /report winmsd.txt
All the folders and the list of files in the Windows installation destination folder dirSystemRoot.txt At the command prompt, execute the following commands to output the results into dirSystemRoot.txt file.
dir /s /a %SystemRoot% > dirSystemRoot.txt

#1
The installation folders used in the How to obtain the files column indicate the default installation folder.

#2
In the actual file name, a file number is appended to Integrated-trace-file-prefix specified-in-the-Hitachi-Network-Objectplaza-Trace-Library-utility2. For example, the default is hntr21.log to hntr216.log. Note that the 2 following the integrated trace file prefix does not represent a file number.

#3
In the Windows Server 2003(IPF and x64), replace this part with Program Files (x86).

#4
You can obtain dlm_iscsims.txt only when the iSCSI software was installed.

[Contents][Back][Next]


[Trademarks]

All Rights Reserved. Copyright (C) 2003, 2007, Hitachi, Ltd.