Job Management Partner 1/Base User's Guide
Format
process-name|path|startup-options|restart-or-not|number-of-restarts|retry-interval|restart-count-reset-time|
File name
- In Windows:
installation-folder\conf\ shared-folder\jp1base\conf\ (in a cluster system)
- In UNIX:
/etc/opt/jp1base/conf/ shared-directory/jp1base/conf/ (in a cluster system)
Description
This file contains information on what processes to automatically restart, should a process abnormally stop, regardless the reason.
Application of settings
Execute the jbs_spmd_reload command or restart JP1/Base to apply the settings. For details on the jbs_spmd_reload command, see jbs_spmd_reload in 13. Commands.
Definition details
The definition file contains initial definitions when you open it first. Do not modify the parameters for the process name, path, and startup options. Also note that you cannot omit the parameter delimiter (|). To insert a comment line, prefix the line with #. The characters following # and up to the next linefeed constitute a comment.
- Restart or not
- Specify whether to restart a process when it ends abnormally. To restart a process, specify 1. Otherwise, specify 0. The default is 0.
- Number of restarts
- Specify how many times the system will attempt to restart a process. The specifiable range is 0 to 99. An optimum number is already set for each process. You can change the number as required. This parameter is valid only when the restart-or-not parameter is set to 1.
- Retry interval
- Specify the interval (in seconds) at which the system will attempt to restart a process. The specifiable range is 0 to 3,600. An optimum number is already set for each process. You can change the number as required. This parameter is valid only when the restart-or-not parameter is set to 1.
- Restart count reset time
- Specify the number of seconds that will elapse after the process is restarted, before the number of restarts is reset. The number of restarts is reset the specified time after the process is restarted. Then, the next time the process ends abnormally, the restart count starts from 1.
- If the restarted process ends abnormally before the specified time elapses after the restart, however, the previous restart count remains. The specifiable range is 3600 to 2147483647 (seconds). An optimum number is already set for each process. You can change the number as required. This parameter is valid only when the restart-or-not parameter is set to 1.
Notes
- If you omit a field or specify an invalid value, the process will fail with an error. If you execute the jbs_spmd_reload command with a field omitted or an invalid value specified, an error is returned without reflecting the settings.
- In a cluster system, when you start the process management process for the logical host without an extended startup process definition file (jp1bs_service_0700.conf) in the conf folder on the logical host, the extended startup process definition file (jp1bs_service_0700.conf) is copied from the physical host.
Definition examples
The following shows an example of settings in the extended startup process definition file (jp1bs_service_0700.conf) and the action taken when a process ends abnormally.
The following conditions are set for JP1/Base processes:
- Restart or not: Restart
- Number of restarts: 4
- Retry interval: 3 seconds
- Restart count reset time:3,600 seconds
jcocmd|C:\ProgramFiles\HITACHI\JP1Base\bin\jcocmd.exe||1|4|3|3600| jbsroute|C:\ProgramFiles\HITACHI\JP1Base\bin\jbsroute.exe|-o,600|1|4|3|3600| jbssessionmgr|C:\ProgramFiles\HITACHI\JP1Base\bin\jbssessionmgr.exe||1|4|3|3600| jbsplugin|C:\ProgramFiles\HITACHI\JP1Base\bin\jbsplugind.exe||1|4|3|3600|Figure 14-9 Example of action when a process ends abnormally
In this example, the number of restarts is reset 3,600 seconds after the process is restarted if the process does not end abnormally within 3,600 seconds. Then, the next time the process ends abnormally, the restart count starts from 1. If the process ends abnormally again no more than 3,600 seconds after a restart, the restart count is not reset. If the number of restarts reaches the specified value, the system no longer attempts to restart the process.
All Rights Reserved. Copyright (C) 2009, Hitachi, Ltd.