Hitachi

JP1 Version 12 JP1/Automatic Job Management System 3 Troubleshooting

1.3.2 Data to collect in UNIX

Organization of this subsection

(1) Log information about the OS

You need to collect the following log information about the OS.

Table 1‒33: OS log information that must be collected when a problem occurs in JP1/AJS3

Type of information

Default file name or default storage location for files

Collection by the tool

syslog#1, #2

  1. /var/adm/syslog/syslog.log

    (for HP-UX)

  2. /var/adm/messages

    (for Solaris)

  3. /var/adm/syslog/

    or /var/adm/syslog/*

    (for AIX)

  4. /var/log/messages*

    (for Linux)

Y

hosts file

services file

passwd file

environment file#3

inittab file

  1. /etc/hosts

  2. /etc/services

  3. /etc/passwd

  4. /etc/environment

  5. /etc/inittab

Y

Patch information for each OS

--

Y

Shared library file for each OS

--

Y

List of processes

--

Y

core file#4

  1. core under /opt/jp1ajs2

  2. core under /var/opt/jp1ajs2

  3. core in the home directory of the OS user that is mapped to a JP1/AJS3 - View login user (this information cannot be collected by the tool)

  4. core under /opt/jp1base

  5. core under /var/opt/jp1base/log

You also need to collect the following file in a cluster system:

/shared-directory/jp1ajs2/database/core

Y#5

Error log information#3

--

Y

Network configuration

--

Y

Information about installed Hitachi products

/etc/.hitachi/pplistd/pplistd

Y
Legend:

Y: The data collection tools can collect data.

--: There is no default file name or default storage location.

#1

Depending on the system settings, the past syslog information might be required for investigation. If syslog is set to be changed frequently in the system settings, manually collect past syslog files.

#2

If the OS of the host on which JP1/AJS3 operates is AIX, depending on the OS function, incomplete messages might result when many messages are output to syslog. Note, however, that messages output to syslog are also output to the integrated trace log (HNTRLib2), so the complete text of any incomplete messages can be viewed there.

#3

This information is collected only for AIX.

#4

Do not limit the core file output setting of the JP1/AJS3 processes when not the setting violates the security policies of the host you are using.

If the output of core file is incomplete, you might not be able to identify the cause of the error. For details about the setting, see the documentation for your OS.

#5

You need to manually obtain the core file in the current directory if information is output to the core file by executing a command. In addition, if the problem occurred in the network control process while JP1/AJS3 - View was being used, you need to manually obtain the core file in the home directory of the OS user mapped to the JP1 user who was logged in.

To Page Top

(2) Information about JP1

You need to collect the following information about JP1. If the problem occurred while your system was connected to a network, you also need to obtain files on the host to which the system is connected.

Table 1‒34: JP1 information to be collected for a problem occurring in JP1/AJS3

Type of information

Default storage location for files

Collection by the tool

Log files

Work files

Definition files

  1. /var/opt/jp1ajs2/log

  2. /var/opt/jp1base/log

  3. /etc/opt/jp1base/conf/user_acl

  4. /etc/opt/jp1ajs2/conf

  5. /var/opt/jp1ajs2/database

  6. /var/opt/jp1ajs2/sys

  7. /var/opt/jp1ajs2/jobinf

  8. /var/opt/jp1ajs2/tmp/schedule

  9. /opt/jp1ajs2/PatchHistory

  10. /opt/jp1ajs2/PatchLog

  11. /var/opt/jp1ajs3web/log

  12. /var/opt/jp1ajs3web/sys

  13. /etc/opt/jp1ajs3web/conf

  14. /opt/jp1ajs3web/PatchLog

  15. /opt/jp1ajs3web/sys

  16. /opt/jp1ajs3web/uCPSB/CC/server/usrconf

  17. /opt/jp1ajs3web/uCPSB/CC/web/redirector

  18. /opt/jp1ajs3web/uCPSB/httpsd/conf

In a cluster system, you also need to obtain the following directories:

  1. /shared-directory/jp1ajs2

  2. /shared-directory/jp1base/log

  3. /shared-directory/jp1base/conf

  4. /shared-directory/jp1ajs3web

Y

Integrated trace log directory

/var/opt/hitachi/HNTRLib2/spool

Y

List of files in the database directory

--

Y

List of JP1/Base files

--

Y

Information required for analysis of the core file

--

Y
Legend:

Y: The data collection tools can collect data.

--: There is no default file name or default storage location.

Important

When you collect information, use the tar command instead of the cp command. Because the directory from which files are obtained also contains system files, using the cp command might lead to unexpected results.

To Page Top

(3) JP1/AJS3 processes

Use the ps command to check the operation status of processes.

For details about JP1/AJS3 processes, see B.3 Processes (for UNIX).

To Page Top

(4) Operation data

Collect the following information about the operation that was being performed when the problem occurred:

  1. Details about the operation

  2. Time that the problem occurred

  3. Machine configuration (the version of each OS, host name, JP1/AJS3 - Manager and JP1/AJS3 - Agent configuration)

  4. Whether the problem is reproducible

  5. Name of the user who logged in from JP1/AJS3 - View (if there is one)

  6. Name of the user who logged in if JP1/AJS3 - Web Console is used and login is performed from the Web GUI or a user application

To Page Top

(5) Information about the embedded database

You need to collect the following information about the embedded database.

Table 1‒35: JP1 information to be collected for a problem occurring in JP1/AJS3

Type of information

Default storage location for files

Collection by the tool

Definition file

embedded-database-practical-directory/conf

Y

Failure information

embedded-database-practical-directory/spool

Y

Database information

Unload file that is obtained by specifying the -k unld option in the ajsembdbrorg command

Y
Legend:

Y: The data collection tools can collect data.

To Page Top

(6) Information about the external database

If JP1/AJS3 is operated by using an external database, the following information about the external database must be collected.

Table 1‒36: JP1 information to be collected for a problem occurring in JP1/AJS3

Type of information

Default strage location for files

Collection by the tool

Database information

--

Y
Legend:

Y: The data collection tools can collect data.

--: There is no default file name or default storage location.

To Page Top

(7) Other information

When trouble occurred at the time of command execution, collecting of the argument specified in the command is needed.

To Page Top

Copyright (C) 2019, 2022, Hitachi, Ltd.

Copyright (C) 2019, 2022, Hitachi Solutions, Ltd.