Hitachi

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


jp1ssolog.sh (Linux 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 Linux.

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

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)

/var/log/messages*

/core (when applicable)

/etc/.hitachi/pplistd/pplistd

/etc/.hitachi/.hitachi.log*

/etc/.hitachi/.install.log*

/etc/.hitachi/.uninstall.log* (when applicable)

Command execution results

date

OS version information

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

df -k

Application patch list

rpm -qa -last

iptables -L -n

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/bin/.ssostart (when applicable)

/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

/opt/CM2/SSO/uCPSB/CC/client/logs/system/ejbcl/CJW

/opt/CM2/SSO/uCPSB/CC/web/redirector/logs

In /var/opt/CM2/SSO/auditlog

/var/opt/CM2/SSO/tmp/ssoclustersetup.log (when applicable)

/opt/CM2/SSO/uCPSB/etc/.hitachi

/opt/CM2/SSO/uCPSB/spkmanage.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

ssoapcom -F#2

ssocollectd -F#2

ssocolmng -F#2

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