10.3.2 Data to be collected (in UNIX)

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

The data collection tool (jegn_log.sh command) classifies the target directories and files for data collection into primary data and secondary data categories, archives the data directly under the specified data storage directory, and then creates compressed files.

The following table lists the compressed files that are stored in the data storage folder.

Table 10‒19: Compressed file containing collected data
Compressed file	Description
`data-storage-directory/jp1_default_jp1eg4nnmi_1st.tar.gz`	Stores primary data for the physical host
`data-storage-directory/jp1_default_jp1eg4nnmi_2nd.tar.gz`	Stores secondary data for the physical host
`data-storage-directory/logical-host-name_jp1eg4nnmi_1st.tar.gz`	Stores primary data for the logical host
`data-storage-directory/logical-host-name_jp1eg4nnmi_2nd.tar.gz`	Stores secondary data for the logical host

For details about the jegn_log.sh command, see jegn_log.sh (UNIX only) in 7. Commands.

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.sh 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.

Table 10‒20: OS log information (primary data for the physical host)
Type of information	Data that is collected	Storage location^#
Information about the installed Hitachi products	`/etc/.hitachi/pplistd/pplistd`	`./var/opt/jp1eg4nnmi/log/_jp1_default/oslog/pplistd`
Hitachi PP Installer installation log file	`/etc/.hitachi/.install.log*`	`./var/opt/jp1eg4nnmi/log/_jp1_default/oslog/.install.log*`
Uninstallation log file for Hitachi PP Installer	`/etc/.hitachi/.uninstall.log*`	`./var/opt/jp1eg4nnmi/log/_jp1_default/oslog/.uninstall.log*`
Common definition information	Files under `/opt/jp1/hcclibcnf/`	`./opt/jp1/hcclibcnf/` (contains copies of the files indicated at left)
JP1/Base installation log files	`/tmp/HITACHI_JP1_INST_LOG/jp1base_inst{1\|2\|3\|4\|5}.log`	`./var/opt/jp1eg4nnmi/log/_jp1_default/oslog/HITACHI_JP1_INST_LOG/` `jp1base_inst{1\|2\|3\|4\|5}.log`
JP1/IM - EG for NNMi installation log files	`/tmp/HITACHI_JP1_INST_LOG/jp1eg_inst{1\|2\|3\|4\|5}.log`	`./var/opt/jp1eg4nnmi/log/_jp1_default/oslog/HITACHI_JP1_INST_LOG/` `jp1eg_inst{1\|2\|3\|4\|5}.log`
JP1/IM - Manager installation log files	`/tmp/HITACHI_JP1_INST_LOG/jp1imm_inst{1\|2\|3\|4\|5}.log`	`./var/opt/jp1eg4nnmi/log/_jp1_default/oslog/HITACHI_JP1_INST_LOG/` `jp1imm_inst{1\|2\|3\|4\|5}.log`
List of files	Execution result of `ls -lRa /opt/jp1eg4nnmi` Execution result of `ls -lRa /etc/opt/jp1eg4nnmi` Execution result of `ls -lRa /var/opt/jp1eg4nnmi` Execution result of `ls -lRa /opt/jp1base` Execution result of `ls -lRa /etc/opt/jp1base` Execution result of `ls -lRa /var/opt/jp1base` Execution result of `ls -lRa /tmp/HITACHI_JP1_INST_LOG` Execution result of `ls -lRa /etc/.hitachi` Execution result of `ls -lRa /etc/.hlic`	`./var/opt/jp1eg4nnmi/log/_jp1_default/oslog/inst_dir_lRa.log`
List of files	Execution result of `ls -lRLa /opt/jp1eg4nnmi` Execution result of `ls -lRLa /etc/opt/jp1eg4nnmi` Execution result of `ls -lRLa /var/opt/jp1eg4nnmi` Execution result of `ls -lRLa /opt/jp1base` Execution result of `ls -lRLa /etc/opt/jp1base` Execution result of `ls -lRLa /var/opt/jp1base` Execution result of `ls -lRLa /tmp/HITACHI_JP1_INST_LOG` Execution result of `ls -lRLa /etc/.hitachi` Execution result of `ls -lRLa /etc/.hlic`	`./var/opt/jp1eg4nnmi/log/_jp1_default/oslog/inst_dir.log`
Data collection date and time	Execution result of `date`	`./var/opt/jp1eg4nnmi/log/_jp1_default/oslog/date.log`
Disk information	Execution result of `df -T -k`	`./var/opt/jp1eg4nnmi/log/_jp1_default/oslog/df.log`
btrfs file system information	When btrfs is installed: Execution result of `btrfs filesystem show -all-device`	`./var/opt/jp1eg4nnmi/log/_jp1_default/oslog/btrfs.log`
Process activity information from the automatic startup service (systemd)	When systemd is installed: •Execution result of `systemctl --all` •Execution result of `systemctl list-unit-files` •Execution result of `systemctl status jp1_base` •Execution result of `systemctl status jp1_eg4nnmi`	`./var/opt/jp1eg4nnmi/log/_jp1_default/oslog/systemctl.log`
Environment variables for the computer	Execution result of `env`	`./var/opt/jp1eg4nnmi/log/_jp1_default/oslog/env.log`
Host name settings set in the computer	`/etc/hosts`	`./var/opt/jp1eg4nnmi/log/_jp1_default/oslog/hosts`
Shared memory status in process-to-process communication	Execution result of `ipcs -ma`	`./var/opt/jp1eg4nnmi/log/_jp1_default/oslog/ipcs.log`
Host name for resolving the network address	Execution result of `jbsgethostbyname`	`./var/opt/jp1eg4nnmi/log/_jp1_default/oslog/` `jbsgethostbyname.log` (standard output) `jbsgethostbyname_err.log` (standard error)
Health check	Execution result of `jbshcstatus -debug -a`	`./var/opt/jp1eg4nnmi/log/_jp1_default/oslog/` `jbshcstatus.log` (standard output) `jbshcstatus_err.log` (standard error)
Event service's process activity status	Execution result of `jevstat`	`./var/opt/jp1eg4nnmi/log/_jp1_default/oslog/` `jevstat.log` (standard output) `jevstat_err.log` (standard error)
Process activity status (JP1/Base)	Execution result of `jbs_spmd_status`	`./var/opt/jp1eg4nnmi/log/_jp1_default/oslog/` `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`	`./var/opt/jp1eg4nnmi/log/_jp1_default/oslog/` `jegn_spmd_status.log` (standard output) `jegn_spmd_status_err.log` (standard error)
jp1hosts2 information registered on the host	Execution result of `jbshosts2export`	`./var/opt/jp1eg4nnmi/log/_jp1_default/oslog/` `jbshosts2export.log` (standard output) `jbshosts2export_err.log` (standard error)
Execution result of the data collection command	Execution result of the `jegn_log.sh` command	`./var/opt/jp1eg4nnmi/log/_jp1_default/oslog/jegn_log_result.log`
Obtaining IP addresses	Execution result of `ifconfig -a`	`./var/opt/jp1eg4nnmi/log/_jp1_default/oslog/ifconfig.log`
Obtaining IP addresses	Execution result of `ip addr show`	`./var/opt/jp1eg4nnmi/log/_jp1_default/oslog/ip_addr_show.log`
NIC installation status	Execution result of `netstat -ia`	`./var/opt/jp1eg4nnmi/log/_jp1_default/oslog/netstat_ia.log`
NIC installation status	Execution result of `ip -s link`	`./var/opt/jp1eg4nnmi/log/_jp1_default/oslog/ip_s_link.log`
Network statistical information	Execution result of `netstat -nap`	`./var/opt/jp1eg4nnmi/log/_jp1_default/oslog/netstat_na.log`
Network statistical information	Execution result of `ss -nap`	`./var/opt/jp1eg4nnmi/log/_jp1_default/oslog/ss_na.log`
List of users set in the computer	`/etc/passwd`	`./var/opt/jp1eg4nnmi/log/_jp1_default/oslog/passwd`
List of processes	Execution result of `ps -elfa`	`./var/opt/jp1eg4nnmi/log/_jp1_default/oslog/ps.log`
Service port settings set in the computer	`/etc/services`	`./var/opt/jp1eg4nnmi/log/_jp1_default/oslog/services`
Memory information	`cat /proc/meminfo`	`./var/opt/jp1eg4nnmi/log/_jp1_default/oslog/swapinfo.log`
System diagnostic information	Execution result of `dmesg`	`./var/opt/jp1eg4nnmi/log/_jp1_default/oslog/sys_info.log`
syslog	`/var/log/messages`	`./var/opt/jp1eg4nnmi/log/_jp1_default/oslog/syslog.log`
OS version information	Execution result of `uname -a`	`./var/opt/jp1eg4nnmi/log/_jp1_default/oslog/uname_a.log`
Kernel parameter information	Execution result of `sysctl -a` Execution result of `ulimit -a`	`./var/opt/jp1eg4nnmi/log/_jp1_default/oslog/` `sysctl.log` `ulimit.log`
Page size information	Execution result of `dmesg`	`./var/opt/jp1eg4nnmi/log/_jp1_default/oslog/pagesize.log`
OS patch application status	Execution result of `rpm-qa`	`./var/opt/jp1eg4nnmi/log/_jp1_default/oslog/rpm.log`
Process startup information used by init daemon	`/etc/inittab`	`./var/opt/jp1eg4nnmi/log/_jp1_default/oslog/inittab`
Boot process information	In Oracle Linux 6: Files under `/etc/init`	`./var/opt/jp1eg4nnmi/log/_jp1_default/oslog` (contains copies of the files indicated at left)
Disk mount information	`/etc/fstab`	`./var/opt/jp1eg4nnmi/log/_jp1_default/oslog/fstab`
Distribution information	In Linux 6 or Linux 7: Files under `/etc/redhat-release` In Oracle Linux 6 or Oracle Linux 7: Files under `/etc/oracle-release` In CentOS 6 or CentOS 7: Files under `/etc/centos-release` In SUSE Linux 12: Files under `/etc/SuSE-release`	`./var/opt/jp1eg4nnmi/log/_jp1_default/oslog` (contains copies of the files indicated at left)
Product information log (JP1/IM - EG for NNMi)	Trace logs and error logs that are output at installation `hliccmd{n}.log` `hlicliberr{n}.log` `hliclibmgrerr{n}.log` `hliclibtrc{n}.log` `hliclibmgrtrc{n}.log`	`./var/opt/jp1eg4nnmi/log/_jp1_default/oslog/hliclog` (contains copies of the files indicated at left)

#: This is the storage location after a compressed file (jp1_default_jp1eg4nnmi_1st.tar.gz) that was created by the data collection tool has been decompressed.

Table 10‒21: OS log information (secondary data for the physical host)
Type of information	Data that is collected	Storage location^#
Data collection date and time	Execution result of `date`	`./var/opt/jp1eg4nnmi/log/_jp1_default/oslog/date.log`

#: This is the storage location after a compressed file (jp1_default_jp1eg4nnmi_2nd.tar.gz) that was created by the data collection tool has been decompressed.

Table 10‒22: OS log information (primary data for the logical host)
Type of information	Data that is collected	Storage location^#
Data collection date and time	Execution result of `date`	`./var/opt/jp1eg4nnmi/log/_logical-host-name/oslog/date.log`
Host name for resolving the network address	Execution result of `jbsgethostbyname` `logical-host-name`	`./var/opt/jp1eg4nnmi/log/_logical-host-name/oslog/` `jbsgethostbyname.log` (standard output) `jbsgethostbyname_err.log` (standard error)
Event service's process activity status	Execution result of `jevstat` `logical-host-name`	`./var/opt/jp1eg4nnmi/log/_logical-host-name/oslog/` `jevstat.log` (standard output) `jevstat_err.log` (standard error)
Health check	Execution result of `jbshcstatus -debug -a -h` `logical-host-name`	`./var/opt/jp1eg4nnmi/log/_logical-host-name/oslog/` `jbshcstatus.log` (standard output) `jbshcstatus_err.log` (standard error)
Process activity status (JP1/Base)	Execution result of `jbs_spmd_status -h` `logical-host-name`	`./var/opt/jp1eg4nnmi/log/_logical-host-name/oslog/` `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`	`./var/opt/jp1eg4nnmi/log/_logical-host-name/oslog/` `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`	`./var/opt/jp1eg4nnmi/log/_logical-host-name/oslog/` `jbshosts2export.log` (standard output) `jbshosts2export_err.log` (standard error)
List of files	Execution result of `ls -lRa` `shared-directory/jp1base` Execution result of `ls -lRa` `shared-directory/jp1eg4nnmi` Execution result of `ls -lRa` `shared-directory/event`	`./var/opt/jp1eg4nnmi/log/_logical-host-name/oslog/share_dir_lRa.log`
List of files	Execution result of `ls -lRLa` `shared-directory/jp1base` Execution result of `ls -lRLa` `shared-directory/jp1eg4nnmi` Execution result of `ls -lRLa` `shared-directory/event`	`./var/opt/jp1eg4nnmi/log/_logical-host-name/oslog/share_dir.log`

#: This is the storage location after a compressed file (logical-host-name_jp1eg4nnmi_1st.tar.gz) that was created by the data collection tool has been decompressed.

Table 10‒23: OS log information (secondary data for the logical host)
Type of information	Data that is collected	Storage location^#
Data collection date and time	Execution result of `date`	`./var/opt/jp1eg4nnmi/log/_logical-host-name/oslog/date.log`

#: This is the storage location after a compressed file (logical-host-name_jp1eg4nnmi_2nd.tar.gz) that was created by the data collection tool has been decompressed.

To Page Top

(2) Integrated trace log

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

Table 10‒24: Integrated trace log (primary data for the physical host)
Type of information	Data that is collected	Storage location^#
Integrated trace log	Files under `/var/opt/hitachi/HNTRLib2/spool/`	`./var/opt/hitachi/HNTRLib2/spool/` (contains copies of the files indicated at left)

#: This is the storage location after a compressed file (jp1_default_jp1eg4nnmi_1st.tar.gz) that was created by the data collection tool has been decompressed.

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.sh 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.

Table 10‒25: Information about JP1/IM - EG for NNMi (primary data for the physical host)
Type of information		Data that is collected	Storage location^#
Patch application history		`/opt/jp1eg4nnmi/patch_history`	`./opt/jp1eg4nnmi/patch_history`
Patch log information		`/opt/jp1eg4nnmi/update.log`	`./opt/jp1eg4nnmi/update.log`
Configuration and definition files		Files under `/etc/opt/jp1eg4nnmi/conf`	`./etc/opt/jp1eg4nnmi/conf/` (contains copies of the files indicated at left)
Log files	Operating log information for JP1/IM - EG for NNMi	Files under `/var/opt/jp1eg4nnmi/log`	`./var/opt/jp1eg4nnmi/log/` (contains copies of the files indicated at left)
Log files	Communication log information for JP1/IM - EG for NNMi	Files under `/opt/jp1eg4nnmi/lib/uCPSB/CC/client/logs`	`./opt/jp1eg4nnmi/lib/uCPSB/CC/client/logs/` (contains copies of the files indicated at left)
Core analysis information (result of analysis by `seraph`)		Analysis result of the core file under `/var/opt/jp1eg4nnmi/log`	`./var/opt/jp1eg4nnmi/`log/_jp1_default/oslog/`core_module-name.log`
Forwarding filter definition files		Files under `/var/opt/jp1eg4nnmi/dat`	`./var/opt/jp1eg4nnmi/dat/` (contains copies of the files indicated at left)
Automated startup and stop scripts		Files under `/etc/opt/jp1eg4nnmi`	`./etc/opt/jp1eg4nnmi/` (contains copies of the files indicated at left)

#: This is the storage location after a compressed file (jp1_default_jp1eg4nnmi_1st.tar.gz) that was created by the data collection tool has been decompressed.

Table 10‒26: Information about JP1/IM - EG for NNMi (secondary data for the physical host)
Type of information	Data that is collected	Storage location^#
Core analysis information (result of the `car` command)	`car` file of the core file under `/var/opt/jp1eg4nnmi/log`	`./var/opt/jp1eg4nnmi/log/_jp1_default/core/core_module-name_car.tar.gz`

#: This is the storage location after a compressed file (jp1_default_jp1eg4nnmi_2nd.tar.gz) that was created by the data collection tool has been decompressed.

Table 10‒27: Information about JP1/IM - EG for NNMi (primary data for the logical host)
Type of information	Data that is collected	Storage location^#
Configuration and definition files	Files under `shared-directory/jp1eg4nnmi/conf`	`.shared-directory/jp1eg4nnmi/conf/` (contains copies of the files indicated at left)
Log files	Files under `shared-directory/jp1eg4nnmi/log`	`.shared-directory/jp1eg4nnmi/log/` (contains copies of the files indicated at left)
Core analysis information (result of analysis by `seraph`)	Analysis result of the core file under `shared-directory/jp1eg4nnmi/log`	`./var/opt/jp1eg4nnmi/log/_shared-directory/oslog/core_module-name.log`
Forwarding filter definition files	Files under `shared-directory/jp1eg4nnmi/dat`	`.shared-directory/jp1eg4nnmi/dat/` (contains copies of the files indicated at left)

#: This is the storage location after a compressed file (logical-host-name_jp1eg4nnmi_1st.tar.gz) that was created by the data collection tool has been decompressed.

Table 10‒28: Information about JP1/IM - EG for NNMi (secondary data for the logical host)
Type of information	Data that is collected	Storage location^#
Core analysis information (result of the `car` command)	`car` file of the core file under `shared-directory/jp1eg4nnmi/log`	`./var/opt/jp1eg4nnmi/log/_shared-directory/core/core_module-name_car.tar.gz`

#: This is the storage location after a compressed file (logical-host-name_jp1eg4nnmi_2nd.tar.gz) that was created by the data collection tool has been decompressed.

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.sh command) to collect the information about JP1/Base. If you do not collect this information, execute the jegn_log.sh 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.

Table 10‒29: Information about JP1/Base (primary data for the physical host)
Type of information	Data that is collected	Storage location^#
Automated startup and stop scripts	Files under `/etc/opt/jp1base/`	`./etc/opt/jp1base/` (contains copies of the files indicated at left)
Configuration and definition files	Files under `/etc/opt/jp1base/conf/`	`./etc/opt/jp1base/conf/` (contains copies of the files indicated at left)
Common definition information	Files under `/etc/opt/jp1base/default/`	`./etc/opt/jp1base/default/` (contains copies of the files indicated at left)
Plug-in service configuration files	Files under `/opt/jp1base/plugin/conf/`	`./opt/jp1base/plugin/conf/` (contains copies of the files indicated at left)
Patch application history	`/opt/jp1base/PatchInfo`	`./opt/jp1base/PatchInfo`
Patch log information	`/opt/jp1base/PatchLog`	`./opt/jp1base/PatchLog`
Log files	`/var/opt/jp1base/log`	`./var/opt/jp1base/log/` (contains copies of the files indicated at left except the `COMMAND` and core files)
Log and temporary files	Files under `/var/opt/jp1base/sys/tmp/`	`./var/opt/jp1base/sys/tmp/` (contains copies of the files indicated at left)

#: This is the storage location after a compressed file (jp1_default_jp1eg4nnmi_1st.tar.gz) that was created by the data collection tool has been decompressed.

Table 10‒30: Information about JP1/Base (secondary data for the physical host)
Type of information	Data that is collected	Storage location^#
SES configuration files	`/tmp/.JP1_SES` `/usr/tmp/jp1_ses` `/usr/lib/jp1_ses/log` `/usr/lib/jp1_ses/sys` `/usr/bin/jp1_ses/jp` `/var/opt/jp1_ses`	`./tmp/.JP1_SES` `./usr/tmp/jp1_ses` `./usr/lib/jp1_ses/log` `./usr/lib/jp1_ses/sys` `./usr/bin/jp1_ses/jp` `./var/opt/jp1_ses`
Command execution log files	Files under `/var/opt/jp1base/log/COMMAND/`	`./var/opt/jp1base/log/COMMAND/` (contains copies of the files indicated at left)
Event database	Files under `/var/opt/jp1base/sys/event/servers/default/`	`./var/opt/jp1base/sys/event/servers/default/` (contains copies of the files indicated at left)

#: This is the storage location after a compressed file (jp1_default_jp1eg4nnmi_2nd.tar.gz) that was created by the data collection tool has been decompressed.

Table 10‒31: Information about JP1/Base (primary data for the logical host)
Type of information	Data that is collected	Storage location^#
Configuration and definition files	Files under `shared-directory/jp1base/conf/`	`.shared-directory/jp1base/conf/` (contains copies of the files indicated at left)
Log files	`shared-directory/jp1base/log`	`.shared-directory/jp1base/log/` (contains copies of the files indicated at left except the `COMMAND` and core files)
Event server settings	`shared-directory/event`	All files under the `.shared-directory/event/` (contains copies of the files indicated at left except `IMEvent*`)

#: This is the storage location after a compressed file (logical-host-name_jp1eg4nnmi_1st.tar.gz) that was created by the data collection tool has been decompressed.

Table 10‒32: Information about JP1/Base (secondary data for the logical host)
Type of information	Data that is collected	Storage location^#
Command execution log files	Files under `shared-directory/jp1base/log/COMMAND/`	`.shared-directory/jp1base/log/COMMAND/` (contains copies of the files indicated at left)
Event database	`shared-directory/event`	`.shared-directory/event/IMEvent.`

#: This is the storage location after a compressed file (logical-host-name_jp1eg4nnmi_2nd.tar.gz) that was created by the data collection tool has been decompressed.

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