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


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 JVM reports that it is stopped and the time that the JVM process actually terminates. Setting this property value to "0" (zero) means never time out.

The default value is "15 seconds".


In normal operation, the Java side of the Wrapper will execute System.exit when it has completed its JVM shutdown cycle and is ready to exit. When this timeout is triggered, a message like the following will be logged.

wrapper  | Shutdown failed: Timed out waiting for the JVM to terminate.
wrapper  | JVM did not exit on request, terminated

If the application has registered its own Shutdown Hook which takes some time to complete, you could experience timeouts waiting for the JVM process to terminate. To avoid this problem, it may be necessary to extend the timeout to give the application's Shutdown Hook time to execute to completion. Be aware that as a rule, Shutdown Hooks should always complete almost instantly.

If you are having problems with your application timing out on shutdown, it may be useful to have the Wrapper attempt to request a thread dump prior to killing the JVM. This will usually make it clear what was preventing the JVM from shutting down. Please see the wrapper.request_thread_dump_on_failed_jvm_exit property for more information.


While the ability is there, be aware that setting this property value to "0" (zero) (= disable Timeout) or some large value will mean that the Wrapper's ability to detect a JVM hang as the JVM process terminates will be disabled.


While the wrapper.java.detect_debug_jvm property is set to "TRUE" and the Debugger Detection is functioning, this "timeout" property will be ignored.

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.