Please or
Try NowBuy Now

Locations of visitors to this page

SourceForge.net

SourceForge.JP

wrapper.on_exit.<n> Property
wrapper.on_exit.<n> Property

Configuration Property Overview

wrapper.on_exit.<n>

Compatibility :3.1.0
Editions :Professional EditionStandard EditionCommunity Edition
Platforms :WindowsMac OSXLinuxIBM AIXFreeBSDHP-UXSolarisIBM z/OSIBM z/Linux

Some applications are good about returning "exit codes" with meaning. In such cases, it may be desirable to restart the application in the event that it exits with certain exit codes. This set of properties makes this possible.

wrapper.on_exit.default

It's possible to specify an action to take for any exit code by making use of the wrapper.on_exit.default property and setting it to either SHUTDOWN or RESTART. The default value is SHUTDOWN.

The action can be one of the following:

  • RESTART
  • SHUTDOWN
Example: (Default Action)
wrapper.on_exit.default=SHUTDOWN

wrapper.on_exit.<n>

In addition, it is possible to specify what will happen for a specific exit code by defining a property whose name is wrapper.on_exit. followed by the exit code.

The property name starts with wrapper.on_exit.<n>. and the "<n>" component of the property name is an exit code. wrapper.ignore_sequence_gaps property can optionally be set to allow gaps in the sequence.

The action can be one of the following:

  • RESTART - will launch a new JVM.
  • SHUTDOWN - will proceed to shutdown the Wrapper.
  • PAUSE (ver. 3.5.0 or later) - will put the the Wrapper into a paused state. This delays the restart of the JVM until the Wrapper is resumed. If Wrapper's pausing is not enabled then the JVM will be restart as if the RESTART action was configured. See the wrapper.pausable property for details.

If an on_exit.<n> property is not defined for a given exit code, then it will default to the value of the wrapper.on_exit.default property.

Example: (Restart on the exit code 1)
wrapper.on_exit.1=RESTART

Usage Example:

To configure the Wrapper to restart the JVM for all exit codes except the exit code "0" (zero), use the following:

Example: (Exit code "0": Shutdown JVM, All the other exit codes: Restart JVM)
wrapper.on_exit.default=RESTART
wrapper.on_exit.0=SHUTDOWN

on_exit properties will be triggered by calls to WrapperManager.stop(n), WrapperManager.stopImmediate(n), and System.exit(n).

External signals or actions which trigger the shutdown of the Wrapper and its JVM will cause these properties to be ignored as the Wrapper is shutting down. This means configuring the Wrapper to restart on any exit code will not prevent the Wrapper from shutting down.





User Comments

If you notice something that is incorrect, missing, or simply feel that some part of this page could be explained better, feel free to log in and add a comment. You will need to register before you can log on.

Email:
Password:
Java Service Wrapper Version: 3.5.4