Extended startup process definition file

Format

To Page Top

Parameters by type

Required parameters:

None

Custom parameters:

None

To Page Top

File name

jp1bs_service_0700.conf

To Page Top

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)

To Page Top

Description

This file contains information on what processes to automatically restart, should a process abnormally stop, regardless the reason. Normally, you do not need to change the initial settings.

The following is a list of processes that are managed by the extended startup process definition file.

To Page Top

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.

To Page Top

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.

To Page Top

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.

To Page Top

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‒12: 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‒13: 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.

To Page Top