[james-project] 03/03: JAMES-3574 Document LMTP default behaviour and mailetcontainer execution

[bt...@apache.org]

This is an automated email from the ASF dual-hosted git repository.

btellier pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/james-project.git

commit 071ffa9721603a3c86083807487f002517b953f0
Author: Benoit Tellier <bt...@linagora.com>
AuthorDate: Fri Apr 30 22:01:11 2021 +0700

    JAMES-3574 Document LMTP default behaviour and mailetcontainer execution
---
 .../servers/pages/distributed/configure/smtp.adoc  | 24 +++++++++++++++++++++-
 src/site/xdoc/server/config-smtp-lmtp.xml          | 24 ++++++++++++++++++++++
 2 files changed, 47 insertions(+), 1 deletion(-)

diff --git a/docs/modules/servers/pages/distributed/configure/smtp.adoc b/docs/modules/servers/pages/distributed/configure/smtp.adoc
index f9359f4..ae9f275 100644
--- a/docs/modules/servers/pages/distributed/configure/smtp.adoc
+++ b/docs/modules/servers/pages/distributed/configure/smtp.adoc
@@ -170,4 +170,26 @@ to get some examples and hints.
 
 The configuration is the same of for SMTP.
 
-By default, it is deactivated. You can activate it alongside SMTP and bind for example on port 24.
\ No newline at end of file
+By default, it is deactivated. You can activate it alongside SMTP and bind for example on port 24.
+
+The default LMTP server stores directly emails in user mailboxes, without further treatment.
+
+However we do ship an alternative handler chain allowing to execute the mailet container, thus achieving a behaviour similar
+to the default SMTP protocol. Here is how to achieve this:
+
+....
+<lmtpservers>
+    <lmtpserver enabled="true">
+        <jmxName>lmtpserver</jmxName>
+        <bind>0.0.0.0:0</bind>
+        <connectionBacklog>200</connectionBacklog>
+        <connectiontimeout>1200</connectiontimeout>
+        <connectionLimit>0</connectionLimit>
+        <connectionLimitPerIP>0</connectionLimitPerIP>
+        <maxmessagesize>0</maxmessagesize>
+        <handlerchain coreHandlersPackage="org.apache.james.lmtpserver.MailetContainerCmdHandlerLoader">
+            <handler class="org.apache.james.lmtpserver.MailetContainerCmdHandlerLoader"/>
+        </handlerchain>
+    </lmtpserver>
+</lmtpservers>
+....
\ No newline at end of file
diff --git a/src/site/xdoc/server/config-smtp-lmtp.xml b/src/site/xdoc/server/config-smtp-lmtp.xml
index f746960..42b419b 100644
--- a/src/site/xdoc/server/config-smtp-lmtp.xml
+++ b/src/site/xdoc/server/config-smtp-lmtp.xml
@@ -205,6 +205,30 @@ Correct this.
     
     <p>By default, it is deactivated. You can activate it with SMTP and bind for example on port 24.</p>
 
+      <p>The default LMTP server stores directly emails in user mailboxes, without further treatment.</p>
+
+      <p>However we do ship an alternative handler chain allowing to execute the mailet container, thus achieving a behaviour similar
+          to the default SMTP protocol. Here is how to achieve this:</p>
+
+      <pre>
+          <code>
+&lt;lmtpservers&gt;
+  &lt;lmtpserver enabled=&quot;true&quot;&gt;
+    &lt;jmxName&gt;lmtpserver&lt;/jmxName&gt;
+    &lt;bind&gt;0.0.0.0:0&lt;/bind&gt;
+    &lt;connectionBacklog&gt;200&lt;/connectionBacklog&gt;
+    &lt;connectiontimeout&gt;1200&lt;/connectiontimeout&gt;
+    &lt;connectionLimit&gt;0&lt;/connectionLimit&gt;
+    &lt;connectionLimitPerIP&gt;0&lt;/connectionLimitPerIP&gt;
+    &lt;maxmessagesize&gt;0&lt;/maxmessagesize&gt;
+    &lt;handlerchain coreHandlersPackage=&quot;org.apache.james.lmtpserver.MailetContainerCmdHandlerLoader&quot;&gt;
+      &lt;handler class=&quot;org.apache.james.lmtpserver.MailetContainerCmdHandlerLoader&quot;/&gt;
+    &lt;/handlerchain&gt;
+  &lt;/lmtpserver&gt;
+&lt;/lmtpservers&gt;
+          </code>
+      </pre>
+
   </section>
     
 </body>

---------------------------------------------------------------------
To unsubscribe, e-mail: notifications-unsubscribe@james.apache.org
For additional commands, e-mail: notifications-help@james.apache.org