jp1ssolog.sh (UNIX only)
- Organization of this page
Format
jp1ssolog.sh [-col] [-d output-destination-directory-name] [<agent> ...]
Function
The jp1ssolog.bat command collects data for an error investigation upon occurrence of an error in SSO. This command is only for UNIX.
This command creates a work directory in the default directory or the directory specified for the -d option. Then, the command creates a JP1SSO directory temporarily in the work directory and outputs data to be collected in the JP1SSO directory created. If a JP1SSO directory already exists, it is deleted and a new JP1SSO directory is created. The default directory is /tmp/jp1sso/work/JP1SSO.
Data that is output in a temporary directory is collectively archived to a file in tar format and the file is compressed by the compress command. However, if the compress command is not included in the standard commands, the file is not compressed. If the file already exists, it is deleted and a new file is created.
The default output destination of the data to be collected is as follows.
- When data is compressed:
-
/tmp/jp1sso/jp1ssolog.tar.Z file
- When data is not compressed:
-
/tmp/jp1sso/jp1ssolog.tar file
If the file is output successfully, all the compression-source data pieces to be temporarily output are deleted. You can change the default output destination by editing this command (a shell script file).
Option
-col
Collects the data in $SSO_DB/Coll as data for an error investigation.
-d output-destination-directory-name
Specifies the output destination of the data to be collected by using either a relative or absolute path.
<agent> ...
Collects the results of executing the ping command on the specified monitoring server as data for an error investigation. Specify an IP address or host name for <agent>. If the specified IP address or host name is incorrect, or the monitoring server is not running, the return value of the command is a value other than 0.
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:
OUTPUTDIR="/tmp/jp1sso"
Usage example
-
To collect data when an error has occurred on monitoring servers agt1 and agt2, execute the following command:
jp1ssolog.sh agt1 agt2
Collected data list
The following table lists and describes the data for an error investigation to be collected:
|
Classification |
Collection method |
Acquired data |
||
|---|---|---|---|---|
|
Common information |
Manual |
An environment configuration chart (OS, IP address, No. of interfaces, and the product configuration and version of each terminal) |
||
|
A memo about how an error occurred (details about the occurrence date/time, OS, host name, IP address, performed operations, and symptoms) |
||||
|
OS information |
jp1ssolog.sh |
Collected files |
/etc/hosts |
|
|
/etc/nsswitch.conf (when applicable) |
||||
|
/etc/services |
||||
|
/etc/rc.log (when applicable) |
||||
|
syslog file#1 (when applicable) |
HP-UX: /var/adm/syslog/syslog.log* |
|||
|
Solaris: /var/adm/messages* |
||||
|
Linux: /var/log/messages* |
||||
|
/core (when applicable) |
||||
|
/etc/.hitachi/pplistd/pplistd |
||||
|
/etc/.hitachi/.hitachi.log* |
||||
|
Command execution results |
date |
|||
|
OS version information |
HP-UX: uname -a |
|||
|
Solaris: showrev |
||||
|
Linux: uname -a |
||||
|
ps -elf (collects data twice at a specific time interval) |
||||
|
hostname |
||||
|
netstat -a |
||||
|
netstat -an |
||||
|
netstat -rn |
||||
|
netstat -i |
||||
|
set |
||||
|
env |
||||
|
Free disk space information |
HP-UX: bdf |
|||
|
Solaris: df -k |
||||
|
Linux: df -k |
||||
|
Application patch list |
HP-UX: swlist -l patch |
|||
|
Solaris: patchadd -p |
||||
|
Linux: rpm -qa -last |
||||
|
Linux only: /sbin/iptables -L -n |
||||
|
Linux only: /sbin/ip6tables -L -n |
||||
|
SSO information |
jp1ssolog.sh |
Collected files |
In /var/opt/CM2/SSO/log |
|
|
In /etc/opt/CM2/SSO/conf |
||||
|
In /etc/opt/CM2/SSO/report |
||||
|
/opt/CM2/SSO/uCPSB/CC/web/containers/SSOConsole/logs |
||||
|
/opt/CM2/SSO/uCPSB/CC/web/containers/SSOConsole/usrconf |
||||
|
/opt/CM2/SSO/uCPSB/CC/web/containers/SSOConsole/work |
||||
|
/opt/CM2/SSO/uCPSB/httpsd/conf |
||||
|
/opt/CM2/SSO/uCPSB/httpsd/logs |
||||
|
Linux and Solaris only: /opt/CM2/SSO/uCPSB/CC/client/logs/system/ejbcl/CJW |
||||
|
/opt/CM2/SSO/uCPSB/CC/web/redirector/logs |
||||
|
In /var/opt/CM2/SSO/auditlog |
||||
|
In /var/opt/CM2/SSO/tmp/ssoclustersetup.log (when applicable) |
||||
|
Command execution results |
ssostatus |
|||
|
ssoapcom -X 4095#2 |
||||
|
ssocollectd -X 4095#2 |
||||
|
ssocolmng -X 4095#2 |
||||
|
ssorprtd -X 4095#2 |
||||
|
ssotrapd -X 4095#2 |
||||
|
ssomapstatus -show -all |
||||
|
A list of folders and files in the installation directory |
ls -lRaL /opt/CM2/SSO |
|||
|
ls -lRaL /etc/opt/CM2/SSO |
||||
|
ls -lRaL /var/opt/CM2/SSO |
||||
|
jp1ssolog.sh with the -col option specified |
In /var/opt/CM2/SSO/databases/Coll |
|||
|
jp1ssolog.sh with the IP address or host name of the monitoring server specified |
Results of executing ping -n 5 on the specified monitoring server#3 |
|||
|
NNMi information |
Manual |
Command execution results |
ovstatus |
|
- #1
-
If the output destination of the syslog file is not the default, manually collect the syslog file.
- #2
-
Data cannot be collected when the corresponding daemon process is not running.
- #3
-
When the OS is Linux, if the return value of the ping command is not 0, execute the ping6 command.
Return values
|
0 |
Data collection is completed. |
|
1 |
Part of the data could not be collected, but no problem exists. |
|
2 |
The executing user has no superuser privileges. |
|
3 |
System error |
|
4 |
Data collection failed (incorrect output-destination directory). |
Notes
-
Execute this command immediately after the failure occurs, if possible. Even if a daemon process terminates abnormally, you must execute the command before restarting the daemon process or SSO.
-
If the disk space becomes insufficient while the collected data is being saved, the data cannot be saved correctly. When you execute this command, make sure beforehand that the output-destination disk has enough free space. When the -col option is not specified, {log-capacity + 100-megabytes} x 2 is required for free space as a rule-of-thumb. When the -col option is specified, {log-capacity + 100-megabytes + $SSO_DB-capacity} x 2 is required for free space as a rule-of-thumb.