Mention SMP support option in ejabberd setup user/tsbere/smp_readme
authorThomas Berezansky <tsbere@mvlc.org>
Fri, 18 May 2012 13:23:44 +0000 (09:23 -0400)
committerThomas Berezansky <tsbere@mvlc.org>
Fri, 18 May 2012 13:23:44 +0000 (09:23 -0400)
Because without it ejabberd can quickly become a bottleneck.

Signed-off-by: Thomas Berezansky <tsbere@mvlc.org>
README

diff --git a/README b/README
index 9a895d9..0b476d3 100644 (file)
--- a/README
+++ b/README
@@ -207,7 +207,27 @@ changes:
   d. Change all `max_stanza_size` values to 2000000
   e. Change all `maxrate` values to 500000 
 +
-3. Restart the ejabberd server to make the changes take effect:
+3. On multi-core or multi-processor systems with packaged ejabberd you may wish
+   to check the status of SMP support. Most systems create a file that controls
+   and indicates the default status of various settings. On Debian / Ubuntu
+   this file is normally found at `/etc/default/ejabberd`, and on Redhat based
+   sysems like Fedora it would be found at `/etc/ejabberd/ejabberdctl`. If you
+   find that the file contains a line like the following:
++
+---------------------------------------------------------------------------
+#SMP=disable
+---------------------------------------------------------------------------
++
+For performance reasons it is recommended you change it to:
++
+---------------------------------------------------------------------------
+SMP=auto
+---------------------------------------------------------------------------
++
+This will allow your ejabberd to use multiple cores/processors when placed
+under heavy load.
++
+4. Restart the ejabberd server to make the changes take effect:
 +
 .(Debian / Ubuntu) Starting ejabberd
 [source, bash]