10.3.1 Data to be collected (in Windows)

This subsection describes the data to be collected in Windows when an error has occurred.

The data collection tool (jegn_log.bat command) classifies the target folders and files for data collection into primary data and secondary data categories and then stores the collected data directly under the specified data storage folder.

The following tables show the organization of folders for the data that is stored directly under the data storage folder and their contents.

Table 10‒6: Organization and contents of data folders (physical host)
Folder name	Type	Data that is stored
`data-storage-folder\jp1_default\eg4nnmi_1st\oslog`	Primary data	OS log information
`data-storage-folder\jp1_default\eg4nnmi_1st\spool`		Integrated trace log
`data-storage-folder\jp1_default\eg4nnmi_1st\eg4nnmi`		Information about JP1/IM - EG for NNMi
`data-storage-folder\jp1_default\eg4nnmi_1st\base`		Information about JP1/Base
`data-storage-folder\jp1_default\eg4nnmi_1st\ucpsb`		Information about Web server
`data-storage-folder\jp1_default\eg4nnmi_2nd\oslog`	Secondary data	OS log information
`data-storage-folder\jp1_default\eg4nnmi_2nd\base`	Secondary data	Information about JP1/Base

Table 10‒7: Organization and contents of data folders (logical host)
Folder name	Type	Data that is stored
`data-storage-folder\logical-host-name\eg4nnmi_1st\oslog`	Primary data	OS log information
`data-storage-folder\logical-host-name\eg4nnmi_1st\eg4nnmi`		Information about JP1/IM - EG for NNMi
`data-storage-folder\logical-host-name\eg4nnmi_1st\base`		Information about JP1/Base
`data-storage-folder\logical-host-name\eg4nnmi_1st\ucpsb`		Information about Web server
`data-storage-folder\logical-host-name\eg4nnmi_2nd\oslog`	Secondary data	OS log information
`data-storage-folder\logical-host-name\eg4nnmi_2nd\base`	Secondary data	Information about JP1/Base

For details about the jegn_log.bat command, see jegn_log.bat (Windows only) in 7. Commands.

Cautions to be taken when using the data collection tool

If you execute the data collection tool, the system information on the machine may not have been collected when execution of the data collection tool is completed. This is because the process that internally collects the OS information has not been completed, even though execution of the data collection tool has been completed.After ensuring that execution of msinfo32.exe has been completed from the Processes tab or the Details tab, by starting the Task Manager,perform operations such as compressing the collected data by using a compression tool, or moving or deleting the collected data.
If there is a Windows event in the Windows event log in which the message format provided by the event log-issuing product and the number of padded characters do not match, an application error might occur during execution of the data collection tool. This is not a problem because the data is collected even in such cases.

When this problem occurs, a dialog box is displayed, and execution of the data collection tool might stop (the tool restarts when you respond to the dialog box). If you want to disable the display of the dialog box, execute the following procedure:
1. Click the Start menu and enter gpedit.msc in Search for Program and File or Run.
2. Local group policy data editor appears. Select Local computer policy, Computer composition, Management template, Windows component, and then Windows error report in the tree on the left-hand side.
3. In Settings on the right-hand side, select Effective in Do not display the user interface in which a severe error occurred, and click the OK button.

Organization of this subsection

(1) OS log information
(2) Integrated trace log
(3) Information about JP1/IM - EG for NNMi
(4) Information about JP1/Base
(5) Information about the operation

(1) OS log information

This subsection describes the OS log information that needs to be collected when an error has occurred. You can use the data collection tool (jegn_log.bat command) to collect the OS log information. The tables below list and describe the OS log information that can be collected by the data collection tool.

In the tables, the File name column shows the name of the file at the storage location after data has been collected by the data collection tool.

Table 10‒8: OS log information (primary data for the physical host)
Type of information	Data that is collected	File name
Data collection date and time	Execution result of `date /t` Execution result of `time /t`	`date.log`
Log files for Hitachi Integrated Installer	Files under `Windows-installation-folder\Temp\HCDINST\`	Copies of the files at the left
Host name settings set in the computer	`system-root-folder\system32\drivers\etc\hosts`	`hosts`
Service port settings set in the computer	`system-root-folder\system32\drivers\etc\services`	`services`
NIC installation status	Execution result of `ipconfig /all`	`ipconfig.log`
List of started services	Execution result of `net start`	`netstart.log`
Network statistical information	Execution result of `netstat -nao`	`netstat.log`
Environment variables for the computer	Execution result of `set`	`set.log`
System information for the computer	Execution result of `msinfo32 /report` `file-name`	`msinfo32.log`
Registry information	Result of collection by the `reg` command of the contents of the `HKEY_LOCAL_MACHINE\SOFTWARE\HITACHI` or `HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\HITACHI` registry	`hitachi_reg.txt`
ON/OFF information for the media sense function	Result of collection by the `reg` command of the contents of the `HKEY_LOCAL_MACHINE\System\CurrentControlSet\Services\Tcpip\Parameters\DisableDHCPMediaSense` registry	`DisableDHCPMediaSense_reg.txt`
JP1/Base access permission information (installation folder)	Execution result of `cacls` `Base-path`	`cacls_jp1base.log`
JP1/Base access permission information (log folder)	Execution result of `cacls` `Base-path\log`	`cacls_jp1base_log.log`
JP1/Base access permission information (command execution log folder)	Execution result of `cacls` `Base-path\log\COMMAND`	`cacls_jp1base_log_COMMAND.log`
JP1/Base access permission information (event database folder)	Execution result of `cacls` `Base-path\sys`	`cacls_jp1base_sys.log`
	Execution result of `cacls` `Base-path\sys\event`	`cacls_jp1base_sys_event.log`
	Execution result of `cacls` `Base-path\sys\event\servers`	`cacls_jp1base_sys_event_servers.log`
	Execution result of `cacls` `Base-path\sys\event\servers\default`	`cacls_jp1base_sys_event_servers_default.log`
JP1/IM - EG for NNMi access permission information (installation folder)	Execution result of `cacls` `EG-for-NNMi-path`	`cacls_jp1eg4nnmi.log`
JP1/IM - EG for NNMi access permission information (log folder)	Execution result of `cacls` `EG-for-NNMi-path\log`	`cacls_jp1eg4nnmi_log.log`
List of JP1/Base files	Execution result of `dir` `Base-path` `/s`	`dir_jp1base.log`
List of JP1/IM - EG for NNMi files	Execution result of `dir` `EG-for-NNMi-path` `/s`	`dir_jp1eg4nnmi.log`
Host name for resolving the network address	Execution result of `jbsgethostbyname`	`jbsgethostbyname.log` (standard output) `jbsgethostbyname_err.log` (standard error)
Health check	Execution result of `jbshcstatus -debug -a`	`jbshcstatus.log` (standard output) `jbshcstatus_err.log` (standard error)
Event service's process activity status	Execution result of `jevstat`	`jevstat.log` (standard output) `jevstat_err.log` (standard error)
Process activity status (JP1/Base)	Execution result of `jbs_spmd_status`	`jbs_spmd_status.log` (standard output) `jbs_spmd_status_err.log` (standard error)
Process activity status (JP1/IM - EG for NNMi)	Execution result of `jegn_spmd_status`	`jegn_spmd_status.log` (standard output) `jegn_spmd_status_err.log` (standard error)
jp1hosts2 information registered on the host	Execution result of `jbshosts2export`	`jbshosts2export.log` (standard output) `jbshosts2export_err.log` (standard error)
Execution result of the data collection command	Execution result of the `jegn_log.bat` command	`jegn_log_result.log`
Library information for product information acquisition and logs	Files under `<%SystemDrive%>\Program Files(x86)\Hitachi\jp1common\jp1imegn\`	Copies of the files at the left
JP1/Base access permission information (ALLUSERSPROFILE folder)	Execution result of `cacls <%ALLUSERSPROFILE%>\Hitachi\jp1\jp1_default\JP1Base\log`	`cacls_programdata_jp1base_log.log`
List of JP1/Base files (ALLUSERSPROFILE folder)	Execution result of `dir <%ALLUSERSPROFILE%>\Hitachi\jp1\jp1_default\JP1Base /s`	`dir_programdata_jp1base.log`

Table 10‒9: OS log information (secondary data for the physical host)
Type of information	Data that is collected	File name
Data collection date and time	Execution result of `date /t` Execution result of `time /t`	`date.log`
Windows event log	Application: `system-root-folder\system32\config\AppEvent.Evt` System: `system-root-folder\system32\config\SysEvent.Evt`	`AppEvent(Backup).evt` `AppEvent(Backup).txt` `SysEvent(Backup).evt` `SysEvent(Backup).txt`
Crash dump^#	`user-specified-folder\user.dmp`	`user.dmp`
Dr. Watson log^#	`user-specified-folder\drwtsn32.log`	`drwtsn32.log`

#: Output of a crash dump must be set in advance. For details about how to specify the output settings, see 2.4.4(1) Preparations for collecting data in the event of an error (Windows only).

Table 10‒10: OS log information (primary data for the logical host)
Type of information	Data that is collected	File name
Data collection date and time	Execution result of `date /t` Execution result of `time /t`	`date.log`
JP1/Base access permission information (shared folder)	Execution result of `cacls` `shared-folder\JP1Base`	`cacls_jp1base.log`
JP1/Base access permission information (log folder)	Execution result of `cacls` `shared-folder\JP1Base\log`	`cacls_jp1base_log.log`
JP1/Base access permission information (command execution log folder)	Execution result of `cacls` `shared-folder\JP1Base\log\COMMAND`	`cacls_jp1base_log_COMMAND.log`
JP1/Base access permission information (event database folder)	Execution result of `cacls` `shared-folder\JP1Base\event`	`cacls_jp1base_event.log`
JP1/IM - EG for NNMi access permission information (shared folder)	Execution result of `cacls` `shared-folder\JP1EG4NNMI`	`cacls_jp1eg4nnmi.log`
JP1/IM - EG for NNMi access permission information (log folder)	Execution result of `cacls` `shared-folder\JP1EG4NNMI\log`	`cacls_jp1eg4nnmi_log.log`
List of JP1/Base files	Execution result of `dir` `shared-folder\JP1Base /s`	`dir_logical-host-name_jp1base.log`
List of JP1/IM - EG for NNMi files	Execution result of `dir` `shared-folder\JP1EG4NNMI /s`	`dir_logical-host-name_jp1eg4nnmi.log`
Host name for resolving the network address	Execution result of `jbsgethostbyname` `logical-host-name`	`jbsgethostbyname.log` (standard output) `jbsgethostbyname_err.log` (standard error)
Event service's process activity status	Execution result of `jevstat` `logical-host-name`	`jevstat.log` (standard output) `jevstat_err.log` (standard error)
Health check	Execution result of `jbshcstatus -debug -a -h` `logical-host-name`	`jbshcstatus.log` (standard output) `jbshcstatus_err.log` (standard error)
Process activity status (JP1/Base)	Execution result of `jbs_spmd_status -h` `logical-host-name`	`jbs_spmd_status.log` (standard output) `jbs_spmd_status_err.log` (standard error)
Process activity status (JP1/IM - EG for NNMi)	Execution result of `jegn_spmd_status -h` `logical-host-name`	`jegn_spmd_status.log` (standard output) `jegn_spmd_status_err.log` (standard error)
jp1hosts2 information registered on the host	Execution result of `jbshosts2export -h` `logical-host-name`	`jbshosts2export.log` (standard output) `jbshosts2export_err.log` (standard error)
JP1/Base access permission information (ALLUSERSPROFILE folder)	Execution result of `cacls <%ALLUSERSPROFILE%>\Hitachi\jp1\logical-host-name\JP1Base\log`	`cacls_programdata_jp1base_log.log`
List of JP1/Base files (ALLUSERSPROFILE folder)	Execution result of `dir <%ALLUSERSPROFILE%>\Hitachi\jp1\logical-host-name\JP1Base /s`	`dir_programdata_jp1base.log`

Table 10‒11: OS log information (secondary data for the logical host)
Type of information	Data that is collected	File name
Data collection date and time	Execution result of `date /t` Execution result of `time /t`	`date.log`

To Page Top

(2) Integrated trace log

You can use the data collection tool (jegn_log.bat command) to collect the integrated trace log. The table below shows the integrated trace log that can be collected by the data collection tool.

In the table, the File name column shows the name of the file at the storage location after data has been collected by the data collection tool.

Table 10‒12: Integrated trace log (primary data for the physical host)
Type of information	Data that is collected	File name
Integrated trace log	`system-drive:ProgramFiles(x86)\Hitachi\HNTRLib2\spool`	The following file by default: `hntr2[1\|2\|3\|4].log`

To Page Top

(3) Information about JP1/IM - EG for NNMi

This subsection describes the information about JP1/IM - EG for NNMi that needs to be collected when an error has occurred. You can use the data collection tool (jegn_log.bat command) to collect the information about JP1/IM - EG for NNMi. The tables below list and describe the information about JP1/IM - EG for NNMi that can be collected by the data collection tool.

In the tables, the File name column shows the name of the file at the storage location after data has been collected by the data collection tool.

Table 10‒13: Information about JP1/IM - EG for NNMi (primary data for the physical host)
Type of information		Data that is collected	File name
Patch application history		`EG-for-NNMi-path\PATCHLOG.TXT`	`Patchlog_jp1eg4nnmi.txt`
Model name and version information		`EG-for-NNMi-path\Version.txt`	`Version.txt`
License type and expiration date		`EG-for-NNMi-path\ProductInfo.txt`	`ProductInfo.txt`
Configuration and definition files		Files under `EG-for-NNMi-path\conf\`	Copies of the files at the left
Log files	Operating log information for JP1/IM - EG for NNMi	Files under `EG-for-NNMi-path\log\`	Copies of the files at the left
Log files	Communication log information for JP1/IM - EG for NNMi	Files under `EG-for-NNMi-path\lib\uCPSB\CC\client\logs\`	Copies of the files at the left
Forwarding filter definition files		Files under `EG-for-NNMi-path\dat\`	Copies of the files at the left

Table 10‒14: Information about JP1/IM - EG for NNMi (primary data for the logical host)
Type of information	Data that is collected	File name
Configuration and definition files	Files under `shared-folder\JP1EG4NNMI\conf\`	Copies of the files at the left
Log files	Files under `shared-folder\JP1EG4NNMI\log\`	Copies of the files at the left
Forwarding filter definition files	Files under `shared-folder\JP1EG4NNMI\dat\`	Copies of the files at the left

To Page Top

(4) Information about JP1/Base

This subsection describes the information about JP1/Base that needs to be collected when an error has occurred. You can use the data collection tool (jegn_log.bat command) to collect the information about JP1/Base. If you do not collect this information, execute the jegn_log.bat command with the -n, -p, or -r option specified.

The tables below list and describe the information about JP1/Base that can be collected by the data collection tool.

In the tables, the File name column shows the name of the file at the storage location after data has been collected by the data collection tool.

Table 10‒15: Information about JP1/Base (primary data for the physical host)
Type of information	Data that is collected	File name
Patch information	`Base-path\PatchLog.txt`	`Patchlog_jp1base.txt`
Model name and version information	`Base-path\Version.txt`	`Version.txt`
License type and expiration date	`Base-path\ProductInfo.txt`	`ProductInfo.txt`
Configuration and definition files	Files under `Base-path\conf\`	Copies of the files at the left
Common definition information	Files under `Base-path\default\`	Copies of the files at the left
Log files	Files under `Base-path\log\`	All files under the folder at the left except `COMMAND`
Plug-in service configuration files	Files under `Base-path\plugin\conf\`	Copies of the files at the left
Log and temporary files	Files under `Base-path\sys\tmp\event\`	Copies of the files at the left
Log files (ALLUSERSPROFILE folder)	Files under `<%ALLUSERSPROFILE%>\Hitachi\jp1\jp1_default\JP1Base\log\`	Copies of the files at the left

Table 10‒16: Information about JP1/Base (secondary data for the physical host)
Type of information	Data that is collected	File name
Command execution log files	Files under `Base-path\log\COMMAND\`	Copies of the files at the left
Event database	Files under `Base-path\sys\event\servers\default\`	Copies of the files at the left

Table 10‒17: Information about JP1/Base (primary data for the logical host)
Type of information	Data that is collected	File name
Configuration and definition files	Files under `shared-folder\JP1Base\conf\`	Copies of the files at the left
Log files	Files under `shared-folder\JP1Base\log\`	All files under the folder at the left except `COMMAND`
Event server settings	`shared-folder\JP1Base\event`	All files under the folder at the left except `IMEvent.`
Log files (ALLUSERSPROFILE folder)	Files under `<%ALLUSERSPROFILE%>\Hitachi\jp1\logical-host-name\JP1Base\log\`	Copies of the files at the left

Table 10‒18: Information about JP1/Base (secondary data for the logical host)
Type of information	Data that is collected	File name
Command execution log files	Files under `shared-folder\JP1Base\log\COMMAND\`	Copies of the files at the left
Event database	`shared-folder\JP1Base\event`	`IMEvent.`

To Page Top

(5) Information about the operation

You need the following information about the operation at the time the error occurred:

Details of the operation (at the time of the error and before and after the error occurred)
Time the error occurred
Machine configuration (OS version, host name, JP1/IM - EG for NNMi system configuration)
Repeatability

To Page Top