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 two ping responses coming from the JVM.
The default value is "30 seconds".
Setting this property value to "0" (zero) means never time out.
The ping timeout must be at least 5 seconds longer than the value of
The Wrapper will modify the value at run time if necessary to avoid problems.
In normal operation, the Wrapper pings the JVM once every 5 seconds to make sure that its process has not frozen up.
The ping timeout is the amount of time to allow for 2 responses from the JVM before the Wrapper assumes that it is hung and restarts it.
This property also controls the amount of time that the JVM will allow to pass without being pinged by the Wrapper.
If the Wrapper does not ping the JVM for longer than the specified timeout, it will exit, allowing the Wrapper to resync by launching a new JVM.
This also makes sure that the JVM will exit if the Wrapper process is terminated abnormally.
(By killing the Wrapper process in the Windows Task Manager, or using "kill -9" signal on UNIX systems.)
With the addition of the wrapper.cpu.timeout
property, there is now almost no reason why you should ever need to change this property.
The only reasons why you should be getting ping timeouts
are if the system is under heavy load or if the JVM is really hung.
The CPU timeout should now detect any problems in with CPU.
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 while it is running will be disabled.
Also note that if the Wrapper process is killed abnormally or God forbid crashes,
then the JVM will never attempt to resync with the Wrapper.
If the Wrapper was running as a Windows Service at the time, it may be necessary to then reboot the machine to stop the Java process.
With normal ping timeouts, the JVM would exit on its own after a few seconds.
While the wrapper.java.detect_debug_jvm
property is set to "TRUE" and the Debugger Detection is functioning, this "timeout" property will be ignored.
This property allows to specify a certain action to be performed
whenever a ping timeout takes place after the seconds specified in the wrapper.ping.timeout property above.
For consistency and backwards compatibility, the default action is specified as RESTART.
will invoke a full garbage collection sweep in the JVM.
Be aware that doing this frequently can affect performance of the JVM, as a full sweep
will often cause all threads to freeze for the duration of the GC.
will stop the current JVM and then restart a new invocation.
will stop the JVM as well as the Wrapper.
USER_<n> (Since ver. 3.5.0, Professional Edition) :
will resume the Java application if it is in a paused state.
This could be used if the JVM is not stopped when paused.
See the wrapper.pausable property for details.
SUSPEND_TIMEOUTS_<n> (Since ver. 3.5.40, Standard /Professional Edition) :
Tells the Wrapper to suspend all timeouts used when the JVM is not responding.
<n> specifies the number of seconds to suspend timeouts, and should be in the range 1-3600 (1h).
This could be used if the Java application needs to perform a long blocking task and avoid having the Wrapper considering the application as unresponsive.
If several requests to suspend timeouts are made, the number of seconds specified by each request will not be summed.
Instead, the newly specified time will replace the remaining suspension time if it is longer, and will be ignored otherwise.
RESUME_TIMEOUTS (Since ver. 3.5.40, Standard /Professional Edition) :
Tells the Wrapper to resume all timeouts previously suspended.