World Map
Java Service Wrapper is the easiest way to make your product more reliable.
  • Free Trial
  • Buy Now
wrapper.jvm_terminate.timeout Property

wrapper.jvm_terminate.timeout

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

WARNING

DO NOT modify any of these parameters unless you have read this property description. Incorrect settings can cause the Wrapper to fail to operate as expected.

Number of seconds to allow between the time that the Wrapper asks the system to forcibly terminate the JVM process and the time that the Wrapper verifies that the JVM has actually been terminated. Setting this property value to "0" (zero) means never time out.

The default value is "10 seconds".

Example:
wrapper.jvm_terminate.timeout=10

In most cases this property should not need to be adjusted. Setting it too short could have adverse affects.

In almost all cases the system will be able to forcibly terminate a process, assuming it has access to do so. We received reports from a couple users on Windows where a request to terminate a frozen JVM process was returning successfully, but the JVM process was never actually being terminated. This unfortunately is an unrecoverable state for the Wrapper. Implementation of this property was done to allow the Wrapper to accurately explain the problem in the logs and then shutdown cleanly.

wrapper  | Timed out waiting for the OS to forcibly terminate the JVM process, unable to continue.
wrapper  |   The scheduled restart of the JVM has been cancelled.

If you see this problem, please contact support about it as we are interested in finding an environment where it can be reproduced reliably.

WARNING

While the ability is there, be aware that setting this property value to "0" (zero) (= disable Timeout) or some large value will mean that Wrapper could end up stuck when entering this state.

Reference: Timeout

Reference: Shutdown

The Java Service Wrapper provides a full set of configuration properties that allows you to make the Wrapper meet your exact needs. Please take a look at the documentation for the individual properties to see all of the possibilities beyond the examples shown above.