16.1.1 Setting up the data collection tools
The UNIX versions of JP1/AJS3 - Manager and JP1/AJS3 - Agent 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.
After installing JP1/AJS3 - Manager or JP1/AJS3 - Agent, copy the data collection tool (_04) to another folder and use it from that folder.
- Important note
-
If you are using JP1/AJS3 Console, there are two cases where you do not need to specify the settings for using a data collection tool in JP1/AJS3 Console Agent, or where JP1/AJS3 Console View is not necessary. One case is if you are using the data collection tool of JP1/AJS3 - Manager or JP1/AJS3 - View (jajs_log), and the other case is if you specified the environment settings for the data collection tool (_04).
If you have not set up the environment for a data collection tool (_04), use the following procedure.
To set up the environment needed to use the data collection tool (_04):
-
Copy the data collection tool (_04) to any folder.
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
JP1/AJS3 Console Manager data directory#3, #6
JP1AJS2CMDB="/var/opt/jp1ajs2cm/database"
8
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 change the output directory of a logical host in a cluster system from its default value
-
If you want to change a log file destination#7 from its default value#8
-
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 for operation and if you changed directories from the default directories, 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:
-
If the data directory of JP1/AJS3 Console Manager on the physical host has been changed, modify the directory specification to reflect the change. Specify each data directory of the logical host for ADDFILE.
- #7:
-
For details about the default storage directories for the log files specified in the data collection tool, see 1.2.4 List of log files and directories in the manual Job Management Partner 1/Automatic Job Management System 3 Troubleshooting and the list of files and directory in the appendix of the Job Management Partner 1/Base User's Guide.
- #8:
-
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 log file 1
AJSLOGFILE1
Scheduler log file 2
AJSLOGFILE2
Job error information directory
JOBINFDIR
Database directory
AJSDBDIRECTORY
System directory
AJSSYSDIR
Log directory
AJSLOGDIR
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
JP1/AJS3 Console
Data directory path
DATADIRECTORY
Trace log file
TRACELOGFILE
-