Document MUC domain_balancing broadcast (EJABS-1866)

1 files changed, 9 insertions, 0 deletions

diff --git a/doc/commercial.tex b/doc/commercial.tex
index 501ddda6a..e225dae8f 100644
--- a/doc/commercial.tex
+++ b/doc/commercial.tex
@@ -3362,6 +3362,14 @@ themselves are not clustered nor fault-tolerant: if the node managing a
 set of rooms goes down, the rooms disappear and they will be recreated
 on an available node on first connection attempt.
 
+If the global option \option{domain\_balancing} is set to \term{broadcast}
+(see section \ref{domainlb}),
+then the rooms exist on all nodes of the cluster at the same time.
+It means that all messages published
+on one instance of a room are broadcasted to the instances of the same
+rooms on all clusters. To avoid useless traffic, this broadcast is
+limited to non empty room instances.
+
 Module options:
 \begin{description}
 \hostitem{conference}
@@ -5932,6 +5940,7 @@ If you need a different behaviour, you can change the load balancing behaviour w
 
 Several balancing criteria are available:
 \begin{itemize}
+\item \term{broadcast}: ???
 \item \term{destination}: the full JID of the packet \term{to} attribute is used.
 \item \term{source}: the full JID of the packet \term{from} attribute is used.
 \item \term{bare\_destination}: the bare JID (without resource) of the packet \term{to} attribute is used.