Hitachi

JP1 Version 12 JP1/Performance Management - Agent Option for Enterprise Applications Description, User's Guide and Reference


13.4.2 Data to be collected during troubleshooting in a Linux environment

Organization of this subsection

(1) Log information about the OS

The following OS-related information must be collected:

Type of information

Overview

Default file name

Collected by the jpcras command?

System log

syslog

/var/log/messages*

Y#

Process information

List of processes

N/A

Y

System file

hosts file

/etc/hosts

Y

services file

/etc/services

Y

OS information

Patch information

N/A

Y

Kernel information

N/A

Y

Version information

N/A

Y

Network status

N/A

Y

Environment variable

N/A

Y

Host name

N/A

Y

Dump information

core file

N/A

Y

Legend:

Y: Can be collected.

N/A: Not applicable.

#

The information cannot be collected if the system is set to output the information to a location other than the default path and file. In such a case, collect the information manually.

(2) Information about Performance Management

You need to collect information about Performance Management, as listed below. In the case of a network error, you also need to collect applicable files from the connection-destination machine.

Type of information

Overview

Default file name

Collected by the jpcras command?

Common message log

Message log output from Performance Management (sequential file method)

/opt/jp1pc/log/jpclog{01|02}#1

Y

Message log output from Performance Management (wraparound file method)

/opt/jp1pc/log/jpclogw{01|02}#1

Y

Common message log (for logical host operation)

Configuration information

Message log output from Performance Management for logical host operation (sequential file method)

environment-directory#2/jp1pc/log/jpclog{01|02}#1

Y

Message log output from Performance Management for logical host operation (wraparound file method)

environment-directory#2/jp1pc/log/jpclogw{01|02}#1

Y

Each configuration information file

N/A

Y

Output results of the jpctool service list command

N/A

Y

Version information

Product version

N/A

Y

Historical information

N/A

Y

Database information

Agent Store service

  • For Store version 1.0

    /opt/jp1pc/agtm/store/instance-name/*.DB

    /opt/jp1pc/agtm/store/instance-name/*.IDX

  • For Store version 2.0

    /opt/jp1pc/agtm/store/instance-name/STPD/

    /opt/jp1pc/agtm/store/instance-name/STPI/

    The following files under the above directories:

    *.DB

    *.IDX

Y

Database information (for logical host operation)

Agent Store service for logical host operation

  • For Store version 1.0

    environment-directory#2/jp1pc/agtm/store/instance-name/*.DB

    environment-directory#2/jp1pc/agtm/store/instance-name/*.IDX

  • For Store version 2.0

    environment-directory#2/jp1pc/agtm/store/instance-name/STPD/

    environment-directory#2/jp1pc/agtm/store/instance-name/STPI/

    The following files under the above directories:

    *.DB

    *.IDX

Y

Trace log

Trace information for each Performance Management program service

N/A#3

Y

Install log#4

Standard log of Hitachi Program Product Installer

/etc/.hitachi/.hitachi.log

/etc/.hitachi/.hitachi.log{01|02|03|04|05}

/etc/.hitachi/.install.log

/etc/.hitachi/.install.log{01|02|03|04|05}

N

Command information

Environment parameters file

/opt/jp1pc/agtm/agent/instance-name/jr3alget.ini

/opt/jp1pc/agtm/agent/instance-name/jr3slget.ini

Y

Trace information

N/A

Y

Timestamp file

N/A

Y

Storage file

  • WRAP1

    /opt/jp1pc/agtm/agent/instance-name/log/ALERT

    /opt/jp1pc/agtm/agent/instance-name/log/SYSLOG

  • WRAP2

    /opt/jp1pc/agtm/agent/instance-name/log/ALERTn#5

    /opt/jp1pc/agtm/agent/instance-name/log/SYSLOGn#5

Y#6

Management file

/opt/jp1pc/agtm/agent/instance-name/log/ALERT.ofs

/opt/jp1pc/agtm/agent/instance-name/log/SYSLOG.ofs

Y

Command information (for logical host operation)

Environment parameters file

environment-directory#2/jp1pc/agtm/agent/instance-name/jr3alget.ini

environment-directory#2/jp1pc/agtm/agent/instance-name/jr3slget.ini

Y

Trace information

N/A

Y

Timestamp file

N/A

Y

Storage file

  • WRAP1

    environment-directory#2/jp1pc/agtm/agent/instance-name/log/ALERT

    environment-directory#2/jp1pc/agtm/agent/instance-name/log/SYSLOG

  • WRAP2

    environment-directory#2/jp1pc/agtm/agent/instance-name/log/ALERTn#5

    environment-directory#2/jp1pc/agtm/agent/instance-name/log/SYSLOGn#5

Y#6

Management file

environment-directory#2/jp1pc/agtm/agent/instance-name/log/ALERT.ofs

environment-directory#2/jp1pc/agtm/agent/instance-name/log/SYSLOG.ofs

Y

Legend:

Y: Can be collected.

N: Cannot be collected.

N/A: Not applicable.

#1

For details about how to output log information to log files, see the chapter that describes detection of Performance Management failures in the JP1/Performance Management User's Guide.

#2

The environment directory is on the shared disk that was specified when the logical host was created.

#3

For details about the trace log storage directory, see 13.3.2 Lists of log files and directories to be collected during troubleshooting.

#4

Collect this log information if installation fails.

#5

n indicates a number.

#6

If the default storage location is changed, the jpcras command cannot collect the information. Collect the information manually.

For details about the location of storage file, see the EXTRACTFILE section in 5.3.2 Settings and the EXTRACTFILE section in 6.3.2 Settings.

(3) Information about the SAP system

You must collect the following information about the SAP system which is being monitored.

Table 13‒6: Information about the SAP system

Type of information

Data to be collected

System log

Data collected by using transaction SM21 in the SAP front-end software with the following conditions:

  • User: Not specified.

  • Transaction code: Not specified.

  • SAP process: Not specified.

  • Error class: All messages

  • Start date and time, end date and time: Time period in which the error occurred

For details about the system log, see the manual and Help for the SAP system.

XMI log

Data collected by using transaction RZ15 in the SAP front-end software with the following conditions:

  • Interface: *

  • Object: *

  • Session ID: *

  • External user: *

  • Period: Time period in which the error occurred

For details about the XMI log, see the manual and Help for the SAP system.

Release and patch information

  • Hardcopy of a screenshot of the window that is displayed when Status is selected from the SAP front-end software's System menu

  • Hardcopy of screenshots of the following windows that are displayed from the above window:

    System: Status window

    System: Component Information window

    System: Kernel Information window

Developer trace

Developer traces in the SAP system that are collected if an error occurs during execution of a command provided by PFM - Agent for Enterprise Applications or in the Agent Collector service (dev_w*, dev_rfc*, and dev_rd files that are collected by using transaction ST11 in the SAP front-end software)

Legend:

*: A wildcard indicating a string of any one or more characters

(4) Operation information

You should collect the following information about the operation being performed when the error occurred:

(5) Error information

You should obtain the following error information:

(6) Other information

You should also collect the following information: