16.1.1 Setting up the data collection tools

The UNIX versions of JP1/AJS3 - Manager, JP1/AJS3 - Agent, and JP1/AJS3 - Web Console provide data collection tools that can be used for collecting log data.

There are two data collection tools:

jajs_log

Use this tool if you did not change the output destinations of log files and other data from their default values, or if you need to collect standard data items only. You cannot customize this tool.
_04

Use this tool if you changed the output destinations of log files and other data from their default values, or if you need to collect non-standard data items. You can customize this tool to change the output destinations of log data and the storage locations of data to be collected.

Note that _04 is not provided by JP1/AJS3 - Web Console.

After installing JP1/AJS3 - Manager or JP1/AJS3 - Agent, copy the data collection tool (_04) to another directory and use it from that directory.

To set up the environment needed to use the data collection tool (_04):

Copy the data collection tool (_04) to any directory.

The following shows an example of the command you execute.
```
cp /opt/jp1ajs2/lib/sample_script/_04  /home/jp1ajs2/trouble.sh
```
Specify the permission settings required to edit the copied data collection tool.

The following shows an example of the command you execute.
```
chmod  +rw  /home/jp1ajs2/trouble.sh
```

Edit the copied data collection tool, and then change the file name to any convenient name.

Use an editor to edit the data collection tool.

The following table lists the initial values specified in the data collection tool. You can change any inappropriate initial values to the appropriate values. If you change a value, do not use characters and symbols that have special meanings in a script. If you use such characters and symbols, an error might occur.

Table 16‒1: Initial values specified in the data collection tool
No.	Item	Initial value
1	Directory for storing integrated trace log files	`HNTRLOG="/opt/hitachi/HNTRLib/spool"` `HNTR2LOG="/var/opt/hitachi/HNTRLib2/spool"`
2	Directory for storing user mapping and authentication settings files	`AUTHSV="/etc/opt/jp1base/conf/user_acl"`
3	syslog and syslog storage directory^#1	In HP-UX: `SYSLOGFILE="/var/adm/syslog/syslog.log"` In Solaris: `SYSLOGFILE="/var/adm/messages"` In AIX: `SYSLOGFILE="/var/adm/syslog"` In Linux: `SYSLOGFILE="/var/log/messages*"`
4	OS system file^{#2, #3}	`SYSTEMFILES="./etc/hosts ./etc/services ./etc/passwd"`
5	Database storage directory^{#3, #4}	`DATABASE="./var/opt/jp1ajs2/database[sq]*"`
6	Job error information directory^{#3, #5}	`JOBINF="./var/opt/jp1ajs2/jobinf"`
7	Directory used for storing data other than the above	`ADDFILE=` Specify the absolute path of the directory to be used for the purpose on the left. Specify an additional directory in cases such as the following: If you want to output information, such as log data on a logical host, to a directory other than the default directory in a cluster environment If you want to change a log file destination^#6 from its default value^#7 If you want to collect data other than the above For example, after changing the shared directory, to collect information about the new shared directory, specify the following: `ADDFILE="/new-shared-directory/jp1ajs2"` `ADDFILE="$ADDFILE /new-shared-directory/jp1base/log /new-shared-directory/jp1base/conf"`

#1:

Depending on the system environment, the syslog and the syslog storage directory settings might have been changed. Make sure that you set an appropriate syslog or a directory in which only syslog is stored, according to the system environment.

#2:

If OS system files will not be collected, delete the names of the files that are not to be collected.

#3:

If you want to change a file name, specify a period (.) followed by a relative path from the root directory.

#4:

Do not delete the directory name that is set by default. If a database directory that does not exist under this directory has been specified because a scheduler service has been added on the physical host, specify the directory name prefixed with a period (.).

Example:

DATABASE="./var/opt/jp1ajs2/database ./adddir/database2"

If you are using only logical hosts and you specified directories that differ from the default, specify the name of the parent directory of the database directory on the shared disk for ADDFILE. Do not change the DATABASE specification.

#5:

In the scheduler service settings on the physical host, if the job error information directory has been changed or a job error information directory has been added, modify the value to reflect the change. If you are using only logical hosts for operation and if you changed directories from the default directories, specify the name of the parent directory of the job error information directory on the shared disk for ADDFILE.

#6:

For details about the default storage directories for the log files specified in the data collection tool, see 1.2.5 List of log files and directories in the manual JP1/Automatic Job Management System 3 Troubleshooting and the list of files and directory in the appendix of the JP1/Base User's Guide.

#7:

The following table lists the output destinations that can be changed after JP1/AJS3 is installed.

Table 16‒2: List of output destinations that can be changed after JP1/AJS3 is installed
Control	Output destination that can be changed	Environment setting parameter
System management	System directory	`AJSSYSDIR`
	Log directory	`AJSLOGDIR`
	Host-based scheduler log file 1	`HOSTLOGFILE1`
	Host-based scheduler log file 2	`HOSTLOGFILE2`
Scheduler service	Scheduler trace log file	`TRACELOGFILE`
	Scheduler trace log file per scheduler service	`TRACELOGDIVDIR`
	Scheduler log file 1	`AJSLOGFILE1`
	Scheduler log file 2	`AJSLOGFILE2`
	Job error information directory	`JOBINFDIR`
	Database directory	`AJSDBDIRECTORY`
	System directory	`AJSSYSDIR`
	Log directory	`AJSLOGDIR`
	The directory to which performance log files are to be output	`AJSREPORTDIR`
JP1/AJS3 definition pre-check function	Definition check log directory	`AJSCHK_LOGDIR`
JP1/AJS3 definition pre-check function	Trace log file	`AJSCHK_TRACELOGFILE`
Queueless job execution environment	Trace log file	`AJSQL_TRACELOGFILE`
	Storage directory for internal log data output by the queueless file transfer service	`AJSQL_EXECLOG_FTPPATH`
	Storage directory for internal log data output by the queueless agent service	`AJSQL_EXECLOG_AGTPATH`
	Work path for queueless jobs or directory for temporary files	`AJSQL_AGTWORKPATH`

To Page Top