Hitachi

JP1 Version 12 JP1/SNMP System Observer Description, Operator's Guide and Reference


jp1apmlog.sh (UNIX only)

Organization of this page

Format

jp1apmlog.sh [-d Output-destination-directory-name]

Function

The jp1apmlog.sh command collects data for an error investigation upon occurrence of an error in APM. This command is provided by APM running in a UNIX system.

This command bundles collected data into a tar format archive file and then uses the compress command to compress the data. Note that the data is compressed only if the compress command is provided as a standard command. The default destinations of the collected data are as follows:

When the data is compressed:

/tmp/jp1apm/jp1apm.log.tar.Z

When the data is not compressed:

/tmp/jp1apm/work/jp1apm.log.tar

You can specify the output directory of the *.tar.Z file or tar file by directly editing the environment variable setting of this command. For details, see Customize.

In addition, the output destination directory for the *.tar.Z file or tar file can be specified by using an option. Priority is placed on the output destination specified by using an option instead of the default output destination and the edited output destination.

Option

-d Output-destination-directory-name

Used to specify the output destination for the file created by this command. For the directory name, you cannot use spaces, double quotation marks ("), asterisks (*), vertical bars (|), angle brackets (< >), question marks (?), commas (,), backslashes (\), or hash marks (#).

Customize

This command is a shell script. You can customize the following item:

If you want to change the default output directory

Edit the output destination directory in the following line:

# Output directory
OUTPUTDIR="/tmp/jp1apm"

Collected data list

The following table lists and describes the data for an error investigation to be collected:

Classification

Collection condition

Acquired data

Common information

Collected files

/etc/hosts

/etc/nsswitch.conf (when applicable)

/etc/services

System log file (when applicable)

HP-UX: /var/adm/syslog/syslog.log*

Solaris: /var/adm/messages*

AIX: /var/adm/syslog*

Linux: /var/log/messages*

/etc/inittab (AIX only)

/etc/rc.log (when applicable)

/core (when applicable)

/etc/.hitachi/pplistd/pplistd

Command execution results

OS version information

HP-UX: uname -a

Solaris 10: showrev

Solaris 11: uname -a

AIX: oslevel

Linux: uname -a

date

ps -elf (Data is collected twice at different times.)

hostname

netstat -a

netstat -an

netstat -rn

netstat -i

set

env

ls -lRaL /tmp

Free disk space information

HP-UX: bdf

(Other than HP-UX): df -k

JP1/ESA information

Collected files

/etc/SnmpAgent.d/snmpd.conf

APM information

Collected files

Under $APM_CONF

Under $APM_LOG

$APM_BIN/apmstart

$APM_BIN/apmstop

$APM_BIN/sub_apmstart (Linux only)

$APM_BIN/sub_apmstop (Linux only)

$APM_BIN/fprocess.exe (AIX, Linux only)

$APM_BIN/cprocess.exe (AIX, Linux only)

Port file

AIX: Under /usr/CM2/APM/port

Other than AIX: Under /var/opt/CM2/APM/port

out file

AIX: Under /usr/CM2/APM/out

Linux: Under /opt/CM2/APM/out

Command execution results

apmcheck

apmproclist -ec

A list of folders and files under the installation directory

AIX

ls -lRaL /usr/CM2/APM

Other than AIX

ls -lRaL /opt/CM2/APM

ls -lRaL /etc/opt/CM2/APM

ls -lRaL /var/opt/CM2/APM

Return values

0

Data collection is completed.

1

At least a part of data collection failed.

2

The user who executed the command does not belong to the Administrators group.

3

System error

4

An inappropriate output destination directory path was specified.

Notes