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
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
-