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.

Positive values must be in the range 5-1728000 seconds (20 days).

The default value is "0" (zero) which means never time out.

NOTE

Prior to version 3.5.54, default value was "10 seconds".

The new default behavior of waiting for the Java process to terminate as long as necessary was chosen because the alternative would be to stop the wrapper, which would negate any possibility of restarting the application.

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.

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.