Author: rjung
Date: Wed Feb 24 11:35:58 2010
New Revision: 915757
URL: http://svn.apache.org/viewvc?rev=915757&view=rev
Log:
Add remark about reliability of System.gc() to
manager diagnostics docs.
Modified:
tomcat/trunk/webapps/docs/html-manager-howto.xml
tomcat/trunk/webapps/docs/manager-howto.xml
Modified: tomcat/trunk/webapps/docs/html-manager-howto.xml
URL:
http://svn.apache.org/viewvc/tomcat/trunk/webapps/docs/html-manager-howto.xml?rev=915757&r1=915756&r2=915757&view=diff
==============================================================================
--- tomcat/trunk/webapps/docs/html-manager-howto.xml (original)
+++ tomcat/trunk/webapps/docs/html-manager-howto.xml Wed Feb 24 11:35:58 2010
@@ -558,6 +558,12 @@
StandardHost implementation. It will not work if a custom host is used that
does not extend StandardHost.</p>
+<p>Explicitely triggering a full garbage collection from Java Code is
documented
+to be unreliable. Furthermore, depending on the JVM used, there are options to
+disable explicit GC triggering, like <code>-XX:+DisableExplicitGC</code>.
+If you want to make sure, that the diagnostics were successfully running a
full GC,
+you will need to check using tools like GC logging, JConsole or simlar.</p>
+
</section>
<section name="Server Information">
Modified: tomcat/trunk/webapps/docs/manager-howto.xml
URL:
http://svn.apache.org/viewvc/tomcat/trunk/webapps/docs/manager-howto.xml?rev=915757&r1=915756&r2=915757&view=diff
==============================================================================
--- tomcat/trunk/webapps/docs/manager-howto.xml (original)
+++ tomcat/trunk/webapps/docs/manager-howto.xml Wed Feb 24 11:35:58 2010
@@ -908,6 +908,12 @@
StandardHost implementation. It will not work if a custom host is used that
does not extend StandardHost.</p>
+<p>Explicitely triggering a full garbage collection from Java Code is
documented
+to be unreliable. Furthermore, depending on the JVM used, there are options to
+disable explicit GC triggering, like <code>-XX:+DisableExplicitGC</code>.
+If you want to make sure, that the diagnostics were successfully running a
full GC,
+you will need to check using tools like GC logging, JConsole or simlar.</p>
+
<p>If this command succeeds, you will see a response like this:</p>
<source>
/leaking-webapp
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscr...@tomcat.apache.org
For additional commands, e-mail: dev-h...@tomcat.apache.org
