G.2 Points to be checked before installing JP1/AJS3 - Agent Minimal Edition
This section describes the points to be checked before installing JP1/AJS3 - Agent Minimal Edition.
The operating environment and prerequisites for JP1/AJS3 - Agent Minimal Edition are almost the same as those for JP1/AJS3 - Agent.
The following describes the differences between JP1/AJS3 - Agent Minimal Edition and JP1/AJS3 - Agent.
- Organization of this subsection
(1) Prerequisite operating systems
For details about OSs that are supported for JP1/AJS3 - Agent Minimal Edition, see 2.1.2(1) Prerequisite operating systems.
(2) Version compatibility
To use JP1/AJS3 - Agent Minimal Edition, you must consider the compatibility among the versions of the following: JP1/Base (which is a prerequisite product for JP1/AJS3), and JP1/AJS3 - Manager.
(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.
(3) Estimating the job execution history log file
JP1/AJS3 - Agent Minimal Edition outputs a history of executed jobs to the job execution history file, or a log file dedicated to executed jobs.
(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.
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:
-
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.
-
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.
-
Delete all job execution history log files.
-
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.
-
Change the value of the JobHistoryLogFileSize or JobHistoryLogFileCount environment setting parameter.
-
Start the JP1/AJS3 service stopped in step 1.
(4) Computer on which JP1/AJS3 - Agent Minimal Edition is installed
You cannot install JP1/AJS3 - Manager, JP1/AJS3 - Agent and JP1/AJS3 - Agent Minimal Edition on the same computer.