Author: danny
Date: Wed Apr 11 05:08:37 2007
New Revision: 527466
URL: http://svn.apache.org/viewvc?view=rev&rev=527466
Log:
JAMES-774 (added documentation)
Modified:
james/server/trunk/src/site/xdoc/dns_configuration.xml
Modified: james/server/trunk/src/site/xdoc/dns_configuration.xml
URL:
http://svn.apache.org/viewvc/james/server/trunk/src/site/xdoc/dns_configuration.xml?view=diff&rev=527466&r1=527465&r2=527466
==============================================================================
--- james/server/trunk/src/site/xdoc/dns_configuration.xml (original)
+++ james/server/trunk/src/site/xdoc/dns_configuration.xml Wed Apr 11 05:08:37
2007
@@ -55,5 +55,13 @@
</li>
</ul>
</section>
+<section name="Sun JVM DNS Lookup Configuration.">
+<p>Sun's JVM Internet address lookup uses a cache which is unbounded and
doesn't time out.<br/>
+This is obviously not great for a long running process like a mail server so
we have introduced a system property <strong>networkaddress.cache.ttl<strong>
that is used by the distributed phoenix start-up scripts, at startup, to
override the java 1.4
<strong>Security.setProperty("networkaddress.cache.ttl")</strong>.<br/> By
default this is set to <strong>300</strong> seconds.</p>
+<p>This workaround will only be present if you use James as distributed. If
you use James in any other container, including different versions of Phoenix,
you will need to ensure that you make a similar configuration change to allow
the internet address cache to perform acceptably.</p>
+<p>James 2.3 has this workaround and it requires it to operate acceptably.
Future versions of James will continue to have the workaround in place but will
*not* require it. This will provide continued support for any mailets which you
may deploy from other sources which might continue to use Sun's InetAddress
class for DNS resolution.</p>
+<p>We are not currently aware of the behaviour of this cache in other JVM
implementations, nor of the effect, if any, which this change might have on
them</p>
+<p>For more on this read defect report <a
href="http://issues.apache.org/jira/browse/JAMES-592";>JAMES-592</a> and related
defects.</p>
+</section>
</body>
</document>
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
