Nice docs Remko. I think it would be good to note which Java version the options applies to since some jvm options are no longer supported in Java 8 IIRC. Gary
-------- Original message -------- From: [email protected] Date: 09/11/2015 23:13 (GMT-08:00) To: [email protected] Subject: [1/2] logging-log4j2 git commit: LOG4J2-1119 documented RMI GC impact Repository: logging-log4j2 Updated Branches: refs/heads/master fde357353 -> a61f1a129 LOG4J2-1119 documented RMI GC impact Project: http://git-wip-us.apache.org/repos/asf/logging-log4j2/repo Commit: http://git-wip-us.apache.org/repos/asf/logging-log4j2/commit/a41c6ccc Tree: http://git-wip-us.apache.org/repos/asf/logging-log4j2/tree/a41c6ccc Diff: http://git-wip-us.apache.org/repos/asf/logging-log4j2/diff/a41c6ccc Branch: refs/heads/master Commit: a41c6cccc50478791db6d0a2e76ba3291b0055f4 Parents: 6eafff1 Author: rpopma <[email protected]> Authored: Sat Sep 12 15:12:44 2015 +0900 Committer: rpopma <[email protected]> Committed: Sat Sep 12 15:12:44 2015 +0900 ---------------------------------------------------------------------- src/site/xdoc/manual/jmx.xml.vm | 17 +++++++++++++++++ 1 file changed, 17 insertions(+) ---------------------------------------------------------------------- http://git-wip-us.apache.org/repos/asf/logging-log4j2/blob/a41c6ccc/src/site/xdoc/manual/jmx.xml.vm ---------------------------------------------------------------------- diff --git a/src/site/xdoc/manual/jmx.xml.vm b/src/site/xdoc/manual/jmx.xml.vm index 3a6498c..9940d26 100644 --- a/src/site/xdoc/manual/jmx.xml.vm +++ b/src/site/xdoc/manual/jmx.xml.vm @@ -69,6 +69,23 @@ <a href="http://docs.oracle.com/javase/7/docs/technotes/guides/management/agent.html#gdenl";>Remote Monitoring and Management</a>.</p> </subsection> + <subsection name="RMI impact on Garbage Collection"> + <a name="RMI_GC" /> + <p> + Be aware that RMI by default triggers a full GC every hour. + See the <a href="http://docs.oracle.com/javase/7/docs/technotes/guides/rmi/sunrmiproperties.html";>Oracle + documentation</a> for the <code>sun.rmi.dgc.server.gcInterval</code> and <code>sun.rmi.dgc.client.gcInterval</code> properties. + The default value of both properties is 3600000 milliseconds (one hour). Before Java 6, it was one minute. + </p><p> + The two sun.rmi arguments reflect whether your JVM is running in server or client mode. + If you want to modify the GC interval time it may be best to specify both properties to ensure the argument is picked up by the JVM. + </p><p> + An alternative may be to disable explicit calls to <code>System.gc()</code> altogether with + <code>-XX:+DisableExplicitGC</code>, or (if you are using the CMS or G1 collector) + add <code>-XX:+ExplicitGCInvokesConcurrent</code> to ensure the full GCs are done + concurrently in parallel with your application instead of forcing a stop-the-world collection. + </p> + </subsection> </section> <section name="Log4j Instrumented Components"> <a name="Log4j_MBeans" />
