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
-
Execute this command when the APM process is running. However, do not restart the abnormally terminated APM process when executing this command.
-
Execute this command immediately after an error has occurred, when possible.
-
When the disk becomes full while files are being saved, data cannot be stored correctly. Make sure that the disk has sufficient free space before executing this command.
-
Files already exist will be overwritten.