HiCommand Dynamic Link Manager User's Guide (for Windows(R))
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.logWindows 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.logHDLM GUI log dlmgui_launcher1.log
dlmgui_launcher2.logHDLM 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.logEvent log for applications evSecurity.evt
evSecurity.logEvent log for security evSystem.evt
evSystem.logEvent 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:
- When the KAPL10048-E message is displayed after execution of the DLMgetras utility finishes
- When the KAPL10022-I and KAPL10048-E messages are not displayed after execution of the DLMgetras utility finishes.
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.logObtain the HDLM log files that are in the following folder:
HDLM-installation-drive:\Program Files\HITACHI\DynamicLinkManager\loghdlmtr.mm Obtain the hdlmtr.mm file that is in the following folder:
HDLM-installation-drive:\Program Files\HITACHI\DynamicLinkManager\log\mmapConfiguration file dlmmgr.xml
dlmwebagent.propertiesObtain the configuration files that are in the following folder:
HDLM-installation-drive:\Program Files\HITACHI\DynamicLinkManager\configMSCS log cluster.log Obtain the files that are in the following folder and are specified in the environment variable ClusterLog:
Windows-installation-folder\ClusterVxVM log All files under logs Obtain all the files that are in the following folder:
VxVM-installation-folder\logsVCS log All files under log Obtain all the files that are in the following folder:
VCS-installation-folder\logWindows log setupact.log
setupapi.log
setuperr.logObtain 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\spoolIntegrated 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\spoolRegistry information application-list.txt
dlm-reg.txt
HBA-reg.txtUse 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.txtiSCSI 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
hdlmversionObtain the hdlmservicepack file, and the hdlmversion file that is in the following folder:
HDLM-installation-drive:\Program Files\HITACHI\DynamicLinkManagerdlmgui_version Obtain the dlmgui_version file that is in the following folder:
HDLM-installation-drive:\Program Files\HITACHI\DynamicLinkManager\configdlmmemorytrace.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.txtAt 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.txtEvent log information evApplication.evt
evApplication.txt
evSecurity.evt
evSecurity.txt
evSystem.evt
evSystem.txtOpen 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.txtAll 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.
All Rights Reserved. Copyright (C) 2003, 2007, Hitachi, Ltd.