G.2 Points to be checked before installing JP1/AJS3 - Agent Minimal Edition

(a) Version compatibility between JP1/Base and JP1/AJS3 - Agent Minimal Edition

For details about version compatibility between JP1/Base and JP1/AJS3 - Agent Minimal Edition, see 8.1.1 Version compatibility between JP1/Base and JP1/AJS3.

(b) Version compatibility between JP1/AJS3 - Manager and JP1/AJS3 - Agent Minimal Edition

For details about version compatibility between JP1/AJS3 - Manager and JP1/AJS3 - Agent Minimal Edition, see 8.1.3 Version compatibility between JP1/AJS3 - Manager and JP1/AJS3 - Agent.

(a) About the job execution history log file

The job execution history log file is generated in the computer on which JP1/AJS3 - Agent Minimal Edition is installed. If multiple agent hosts (physical and logical hosts) exist on the same computer, the history of jobs executed by all the hosts is output to the same job execution history log file.

The default settings of the job execution history log file are as follows:

• Storage location

  In Windows, if the installation folder is the default installation folder or is in a folder protected by the system:

  %ALLUSERSPROFILE%\Hitachi\JP1\JP1_DEFAULT\JP1AJS2\log

  The default %ALLUSERSPROFILE% value is system-drive\ProgramData.

  A folder protected by the system is the path to a folder in any of the following:

  - system-drive\Windows

  - system-drive\Program Files

  - system-drive\Program Files (x86)

  In Windows, if the installation folder is other than the above:

  JP1/AJS3-Agent-Minimal-Edition-installation-folder\log

  In Linux:

  /var/opt/jp1ajs2/log

• Size

  512 kilobytes

• Number

  2

(b) Estimating the size of the job execution history log file

The required size of a job execution history log file and the required number of job execution history log files vary depending on how the log file is operated. Estimate the appropriate size of the job execution history log file, and change its size and the number of files as needed.

Use the following formula to estimate the size of a job execution history log file:

Appropriate the job execution history log file capacity (units: kilobytes) = 3^# x number-of-days-to-save-logs

#

3 (kilobytes) is the value obtained by multiplying 0.3 (approximate size of the log data output per job) by 10 (number of job executions).

To more accurately estimate the size of log data output per day, calculate the size of the log output per job by the following formula, and multiply the calculation result by the number of job executions per day.

Size of the log data output per job (units: kilobytes) = 0.135 + unit-full-name-length + manager-host-name-length

Example:

If 10 jobs are to be executed per day and the logs for 365 days are to be saved, the appropriate capacity of the job execution history log file is as follows:

0.3 x 10 x 365 = 1,095 kilobytes

You can specify the size of a job execution history log file and the number of job execution history log files by using the environment setting parameters listed in the following table.

Table G‒1: Environment setting parameters to change the size of a job execution history log file

No.	Environment setting parameter	Description	Relevant section
1	JobHistoryLogFileSize	Size of a job execution history log file	20.5.2(94) JobHistoryLogFileSize in the JP1/Automatic Job Management System 3 Configuration Guide
2	JobHistoryLogFileCount	Number of the job execution history log files	20.5.2(95) JobHistoryLogFileCount in the JP1/Automatic Job Management System 3 Configuration Guide

(c) Changing the size of a job execution history log file or the number of job execution history log files

To change the size of a job execution history log file or the number of job execution history log files, you must delete any existing job execution history log files and the management file for them before changing the value of relevant environment setting parameter. If you do not delete the existing job execution history log files and management file, the new size of a job execution history log file or the new number of job execution history log files will not be applied.

To change the size of a job execution history log file or the number of job execution history log files:

1. Stop the JP1/AJS3 services on the physical host and all logical hosts running on the computer where the job execution history log files exist.

2. Back up the job execution history log files (jpqjobhistory{0|1}.log) as needed.

   For details on the location of the job execution history log file, see (a) About the job execution history log file.

3. Delete all job execution history log files.

4. Delete the management file for the job execution history log file (jpqjobhistory.mm).

   The management file for the job execution history log file is stored in the mmap folder under the storage directory for the job execution history log files.

   For details on the location of the job execution history log file, see (a) About the job execution history log file.

5. Change the value of the JobHistoryLogFileSize or JobHistoryLogFileCount environment setting parameter.

6. Start the JP1/AJS3 service stopped in step 1.