Extended startup process definition file (jp1co_service.conf)
- Organization of this page
Format
process-name|startup-options|whether-restartable|restart-count|retry-interval|restart-count-reset-time|
File
jp1co_service.conf (extended startup process definition file)
jp1co_service.conf.model (model file for the extended startup process definition file)
Storage directory
- In Windows
-
- For a physical host:
-
Console-path\conf\
- For a logical host:
-
shared-folder\jp1cons\conf\
- In UNIX
-
- For a physical host:
-
/etc/opt/jp1cons/conf/
- For a logical host:
-
shared-directory/jp1cons/conf/
Description
This file defines process information for the functions that constitute JP1/IM - Manager.
JP1/IM - Manager uses the process management function to control restart in the event of abnormal termination of a process. The process management function controls processes according to the definition in the extended startup process definition file.
Do not specify in this file any unneeded characters, such as spaces. Edit numeric values for only those parameters on which editing is permitted.
Customize only the applicable parameters as appropriate to your operations. Normally, there is no need to change the settings for other parameters because appropriate values have already been set in them as the default values for each process.
In the case of a cluster configuration, if the extended startup process definition file is not found in the conf folder for the logical host when the a process management process is started at the logical host, the extended startup process definition file for the physical host is copied.
When the definitions are applied
The contents of the definition file take effect when JP1/IM - Manager starts or when the jco_spmd_reload command is executed to reload the definition. A change in the startup-options parameter takes effect only when JP1/IM - Manager starts.
Information that is specified
- process-name
-
Specifies the name of a process that is to be started and terminated by the process management function of JP1/IM - Manager.
JP1/IM - Manager's process name is already specified, and must not be edited.
The name specified here must be a process name displayed by the jco_spmd_status command.
- startup-options
-
Specifies startup options for the process.
The evtcon process of JP1/IM - Manager requires startup options.
The -Xmx parameter of the evtcon process sets the size of the heap area that is used by the evtcon process of JP1/IM - Manager. A value of 512 megabytes is set as the initial value for the heap area size.
The size of the heap area used by the evtcon process might exceed the initial value, depending on user settings. If the estimated heap area size that is required exceeds 512 megabytes, you must change the -Xmx parameter's value. For details about how to estimate the heap area size, see the Release Notes for JP1/IM - Manager.
- Notes about startup options
-
• If you change the heap area size for the evtcon process of JP1/IM - Manager, check by performing appropriate tests that the change will not cause problems. Even if the value is within the permissible range for the heap area size, a memory shortage might occur and JP1/IM - Manager might terminate or information might not be updated in the Event Console window, resulting in unstable operation. If this occurs, revise as necessary the Event buffer and Num. of events to acquire in 1 search settings by referencing the formula for estimating the heap area size.
• The maximum memory size cited in the Release Notes for JP1/IM - Manager is a logical value. It might not be possible to allocate the set heap area depending on the OS, the environment in use, and the applications that run concurrently. If the heap area cannot be allocated or the set value is less than the initial value (512 megabytes), problems might occur, such as a JP1/IM - Manager startup error.
The following example changes the heap area size from 512 to 1,024 megabytes in Windows:
Example:
- Before the heap area size is changed to 1,024 megabytes (from an initial size of 512 megabytes):
-
evtcon|-Xmx512m|0|3|3|3600|
- After the heap area size has been changed to 1,024 megabytes:
-
evtcon|-Xmx1024m|0|3|3|3600|
- whether-restartable
-
Specifies whether the process is to be restarted if it terminates abnormally.
Specify 0 to not restart the process and 1 to restart the process.
The default is 0.
- restart-count
-
Specifies the number of times process restart is to be attempted.
The permitted value range is from 0 to 99. The default is 3.
Note that if 0 is specified in the whether-restartable field, this field is ignored even if a value is specified.
- retry-interval
-
Specifies in seconds the interval between process restart attempts.
The permitted value range is from 0 to 3,600. The default is 3.
Note that if 0 is specified in the whether-restartable field, this field is ignored even if a value is specified.
- restart-count-reset-time
-
Specifies in seconds the amount of time that is to elapse before the restart count will be reset after the process has restarted.
The permitted value range is from 3,600 to 2,147,483,647 (seconds). The default is 3,600.
The restart count is reset when the specified amount of time has elapsed after the process has restarted. If the process terminates abnormally again after this amount of time has elapsed, the restart count starts again from 1. If the process terminates abnormally again within the specified amount of time after it has restarted, the previous restart count is inherited.
Note that if 0 is specified in the whether-restartable field, this field is ignored even if a value is specified.
Example definition
The following shows an example of an extended startup process definition file:
evflow||0|3|3|3600| jcamain||0|3|3|3600| evtcon|-Xmx512m|0|3|3|3600| evgen||0|3|3|3600| jcsmain||0|3|3|3600| jcfmain||0|3|3|3600|