Extended startup process definition file
- Organization of this page
Format
process-name|path|startup-options|restart-or-not|number-of-restarts|retry-interval|restart-count-reset-time| |
Storage destination directory
- 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.
The following is a list of processes that are managed by the extended startup process definition file.
Parent process |
Function |
Child process |
Function |
---|---|---|---|
jbs_spmd |
JP1/Base process management |
jbscomd |
Inter-process communication A prerequisite process for the jbssrvmgr process and the jbslcact process |
jcocmd |
Command execution |
||
jbsroute |
Configuration management |
||
jbssessionmgr |
Authentication server |
||
jbsplugin |
Plug-in service |
||
jbshcd |
Health check (for local host monitoring) |
||
jbshchostd |
Health check (for remote host monitoring) |
||
jbssrvmgr |
Service management control This process depends on the jbscomd process |
||
jbslcact |
Local action This process depends on the jbscomd process |
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 15. 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.
For groups of processes that have dependencies, set the same value to all child processes.
- 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.
-
If you want to restart a process in a cluster system, use the cluster software.
Definition examples
-
Action to take if 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 16‒11: 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.
-
-
Action to take if a process with a dependency ends abnormally
The following action must be taken if a process with a dependency ends abnormally:
-
Restart or not: Restart
-
Number of restarts: 4
-
Retry interval: 3 seconds
-
Restart count reset time:21,600 seconds
jbscomd|C:\Program Files\Hitachi\JP1Base\bin\jbscomd.exe||1|4|3|21600| jcocmd|C:\Program Files\Hitachi\JP1Base\bin\jcocmd.exe||0|3|3|21600| jbsroute|C:\Program Files\Hitachi\JP1Base\bin\jbsroute.exe|-o,600|0|3|3|21600| jbssessionmgr|C:\Program Files\Hitachi\JP1Base\bin\jbssessionmgr.exe||0|3|3|21600| jbsplugin|C:\Program Files\Hitachi\JP1Base\bin\jbsplugind.exe||0|3|3|21600| jbshcd|C:\Program Files\Hitachi\JP1Base\bin\jbshcd.exe||0|3|3|21600| jbshchostd|C:\Program Files\Hitachi\JP1Base\bin\jbshchostd.exe||0|3|3|21600| jbssrvmgr|C:\Program Files\Hitachi\JP1Base\bin\jbssrvmgr.exe|jbscomd|1|4|3|21600| jbslcact|C:\Program Files\Hitachi\JP1Base\bin\jbslcact.exe|jbscomd|1|4|3|21600|
Figure 16‒12: Example action to take if a process with a dependency ends abnormally If the prerequisite process, jbscomd, stops abnormally, the dependent processes jbssrvmgr and jbslcact, also stop. If the "run or not" parameter is set to "restart", dependent processes restart after the prerequisite process has finished restarting.
Set the same value for the "run or not" parameter to all the process groups that have dependencies.
-