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 a7d2418e0f4115806917aae839ed7ade904bd68c Author: Benoit Tellier <[email protected]> AuthorDate: Thu Nov 19 08:57:45 2020 +0700 JAMES-3441 Document listeners.xml <executeGroupListeners> --- docs/modules/servers/pages/distributed/configure/listeners.adoc | 6 +++++- src/site/xdoc/server/config-listeners.xml | 6 ++++++ 2 files changed, 11 insertions(+), 1 deletion(-) diff --git a/docs/modules/servers/pages/distributed/configure/listeners.adoc b/docs/modules/servers/pages/distributed/configure/listeners.adoc index 6f8fc00..04bd9f9 100644 --- a/docs/modules/servers/pages/distributed/configure/listeners.adoc +++ b/docs/modules/servers/pages/distributed/configure/listeners.adoc @@ -17,13 +17,17 @@ to get some examples and hints. == Configuration +The <executeGroupListeners> controls whether to launch group mailbox listener consumption. Defaults to true. Use with caution: +never disable on standalone james servers, and ensure at least some instances do consume group mailbox listeners within a +clustered topology. + Mailbox listener configuration is under the XML element <listener>. Some MailboxListener allows you to specify if you want to run them synchronously or asynchronously. To do so, for MailboxListener that supports this, you can use the *async* attribute (optional, per mailet default) to govern the execution mode. If *true* the execution will be scheduled in a reactor elastic scheduler. If *false*, the execution is synchronous. -Already provided additional listeners are docmented below. +Already provided additional listeners are documented below. === SpamAssassinListener diff --git a/src/site/xdoc/server/config-listeners.xml b/src/site/xdoc/server/config-listeners.xml index aa35f71..d9c6c18 100644 --- a/src/site/xdoc/server/config-listeners.xml +++ b/src/site/xdoc/server/config-listeners.xml @@ -44,6 +44,12 @@ <section name="MailboxListener configuration"> <p> + The <executeGroupListeners> controls whether to launch group mailbox listener consumption. + Defaults to true. Use with caution: + never disable on standalone james servers, and ensure at least some instances do consume group mailbox listeners within a + clustered topology. + </p> + <p> Mailbox listener configuration is under the XML element <listener> </p> <p> --------------------------------------------------------------------- To unsubscribe, e-mail: [email protected] For additional commands, e-mail: [email protected]
