3 commits - Administrator_Guide/en-US

Jeroen van Meeuwen vanmeeuwen at kolabsys.com
Mon Aug 6 11:52:15 CEST 2012


 Administrator_Guide/en-US/Tweaking_Tips_for_389_Directory_Server.xml |   29 +
 Administrator_Guide/en-US/Tweaking_Tips_for_Cyrus_IMAP.xml           |  271 ++++++++++
 Administrator_Guide/en-US/Tweaking_Tips_for_Postfix.xml              |   13 
 Administrator_Guide/en-US/Tweaking_Tips_for_Roundcube.xml            |   13 
 Administrator_Guide/en-US/part-Kolab_Server.xml                      |    4 
 5 files changed, 330 insertions(+)

New commits:
commit a68e9090dccca6bf52e021200bf61bcaf272068b
Author: Jeroen van Meeuwen (Kolab Systems) <vanmeeuwen at kolabsys.com>
Date:   Mon Aug 6 10:52:04 2012 +0100

    publican clean_ids does it again

diff --git a/Administrator_Guide/en-US/Tweaking_Tips_for_389_Directory_Server.xml b/Administrator_Guide/en-US/Tweaking_Tips_for_389_Directory_Server.xml
index 57915e2..fd86b13 100644
--- a/Administrator_Guide/en-US/Tweaking_Tips_for_389_Directory_Server.xml
+++ b/Administrator_Guide/en-US/Tweaking_Tips_for_389_Directory_Server.xml
@@ -3,23 +3,27 @@
 <!ENTITY % BOOK_ENTITIES SYSTEM "Administrator_Guide.ent">
 %BOOK_ENTITIES;
 ]>
-<chapter id="chap-Administrator_Guide-Tweaking_Tips_for_Roundcube">
+<chapter id="chap-Administrator_Guide-Tweaking_Tips_for_389_Directory_Server">
     <title>Tweaking Tips for 389 Directory Server</title>
     <para>
         para
     </para>
-    <section>
+    <section id="sect-Administrator_Guide-Tweaking_Tips_for_389_Directory_Server-Adjusting_Cache_Sizes">
         <title>Adjusting Cache Sizes</title>
         <para>
             para
         </para>
+
     </section>
-    <section>
+
+    <section id="sect-Administrator_Guide-Tweaking_Tips_for_389_Directory_Server-Using_Virtual_List_View_Control_for_Larger_Directory_Information_Trees">
         <title>Using Virtual List View Control for Larger Directory Information Trees</title>
         <para>
             para
         </para>
+
     </section>
 
+
 </chapter>
 


commit 5d1abffd02319078516f66cbd815c835b3ca6b77
Author: Jeroen van Meeuwen (Kolab Systems) <vanmeeuwen at kolabsys.com>
Date:   Mon Aug 6 10:41:00 2012 +0100

    Also add a chapter on tweaking 389 Directory Server

diff --git a/Administrator_Guide/en-US/Tweaking_Tips_for_389_Directory_Server.xml b/Administrator_Guide/en-US/Tweaking_Tips_for_389_Directory_Server.xml
new file mode 100644
index 0000000..57915e2
--- /dev/null
+++ b/Administrator_Guide/en-US/Tweaking_Tips_for_389_Directory_Server.xml
@@ -0,0 +1,25 @@
+<?xml version='1.0' encoding='utf-8' ?>
+<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
+<!ENTITY % BOOK_ENTITIES SYSTEM "Administrator_Guide.ent">
+%BOOK_ENTITIES;
+]>
+<chapter id="chap-Administrator_Guide-Tweaking_Tips_for_Roundcube">
+    <title>Tweaking Tips for 389 Directory Server</title>
+    <para>
+        para
+    </para>
+    <section>
+        <title>Adjusting Cache Sizes</title>
+        <para>
+            para
+        </para>
+    </section>
+    <section>
+        <title>Using Virtual List View Control for Larger Directory Information Trees</title>
+        <para>
+            para
+        </para>
+    </section>
+
+</chapter>
+
diff --git a/Administrator_Guide/en-US/part-Kolab_Server.xml b/Administrator_Guide/en-US/part-Kolab_Server.xml
index c8ce198..f98606e 100755
--- a/Administrator_Guide/en-US/part-Kolab_Server.xml
+++ b/Administrator_Guide/en-US/part-Kolab_Server.xml
@@ -10,6 +10,7 @@
     <xi:include href="Detailed_Kolab_Server_Overview.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
     <xi:include href="Kolab_Web_Administration_Panel.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
     <xi:include href="Combating_Spam.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+    <xi:include href="Tweaking_Tips_for_389_Directory_Server.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
     <xi:include href="Tweaking_Tips_for_Cyrus_IMAP.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
     <xi:include href="Tweaking_Tips_for_Postfix.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
     <xi:include href="Tweaking_Tips_for_Roundcube.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />


commit 5886d7d970c761971ac2cbc1034c6576228564be
Author: Jeroen van Meeuwen (Kolab Systems) <vanmeeuwen at kolabsys.com>
Date:   Mon Aug 6 10:39:09 2012 +0100

    Add sections on Tweaking Tips for various Kolab Groupware components

diff --git a/Administrator_Guide/en-US/Tweaking_Tips_for_Cyrus_IMAP.xml b/Administrator_Guide/en-US/Tweaking_Tips_for_Cyrus_IMAP.xml
new file mode 100644
index 0000000..46bee2e
--- /dev/null
+++ b/Administrator_Guide/en-US/Tweaking_Tips_for_Cyrus_IMAP.xml
@@ -0,0 +1,271 @@
+<?xml version='1.0' encoding='utf-8' ?>
+<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
+<!ENTITY % BOOK_ENTITIES SYSTEM "Administrator_Guide.ent">
+%BOOK_ENTITIES;
+]>
+<chapter id="chap-Administrator_Guide-Tweaking_Tips_for_Cyrus_IMAP">
+    <title>Tweaking Tips for Cyrus IMAP</title>
+    <para>
+        A default Kolab Groupware environment includes most if not all features that Cyrus IMAP offers, which is not necessarily optimal for all deployments. The sections in this chapter address some of the various opportunities to tweak settings for your deployment.
+    </para>
+    <section id="sect-Administrator_Guide-Tweaking_Tips_for_Cyrus_IMAP-Flushing_Seen_State">
+        <title>Flushing Seen State</title>
+        <para>
+            When users connect multiple clients to Cyrus IMAP, or when multiple users use the same mail folder that has shared seen state enabled, one client may be marking a message as \Seen, and another client may seem to take a while before it picks up on the message having been marked as read.
+        </para>
+        <para>
+            In a default deployment scenario, Cyrus IMAP keeps the flagging of messages from being flushed to disk immediately, which saves on disk I/O, making Cyrus IMAP more efficient in most deployment scenarios. If, however, you have the aforementioned situation occurring in your deployment, you may need to flush the seen state of messages to disk at the first opportunity.
+        </para>
+        <para>
+            In order to do so, execute
+        </para>
+        <procedure id="proc-Administrator_Guide-Flushing_Seen_State-Configuring_Cyrus_IMAP_to_Flush_the_Seen_State_to_Disk_Immediately">
+            <title>Configuring Cyrus IMAP to Flush the Seen State to Disk Immediately</title>
+            <step>
+                <para>
+                    Open up /etc/imapd.conf in your favorite editor
+                </para>
+
+            </step>
+            <step>
+                <para>
+                    Set (add the setting if not available already) <literal>flushseenstate</literal> to <literal>1</literal>.
+                </para>
+
+            </step>
+            <step>
+                <para>
+                    Restart the Cyrus IMAP service
+                </para>
+
+            </step>
+
+        </procedure>
+
+
+    </section>
+
+    <section id="sect-Administrator_Guide-Tweaking_Tips_for_Cyrus_IMAP-Disabling_the_Shared_Folders_Namespace">
+        <title>Disabling the "Shared Folders" Namespace</title>
+        <para>
+            para
+        </para>
+
+    </section>
+
+    <section id="sect-Administrator_Guide-Tweaking_Tips_for_Cyrus_IMAP-Speeding_Up_Authentication">
+        <title>Speeding Up Authentication</title>
+        <para>
+            para
+        </para>
+
+    </section>
+
+    <section id="sect-Administrator_Guide-Tweaking_Tips_for_Cyrus_IMAP-Full_text_Indexing_of_Mail_Folders">
+        <title>Full-text Indexing of Mail Folders</title>
+        <para>
+            para
+        </para>
+
+    </section>
+
+    <section id="sect-Administrator_Guide-Tweaking_Tips_for_Cyrus_IMAP-IMAP_Single_Instance_Store">
+        <title>IMAP Single Instance Store</title>
+        <para>
+            Cyrus IMAP allows for <emphasis>single instance store</emphasis> that de-duplicates messages being delivered to its mailboxes, but with a certain set of restrictions. This section addresses some of those restrictions and advises on parameters to tweak in Kolab to make optimal use of the feature.
+        </para>
+        <para>
+            Single instance store requires delivery of the message (through LMTP) in one single shot (a single LMTP session). For deployments that expect to have significant numbers of emails be sent to significant numbers of users through Kolab Distribution Groups, tweaking the Postfix settings <literal>lmtp_destination_concurrency_limit</literal> and <literal>lmtp_destination_concurrency_limit</literal> may be necessary.
+        </para>
+        <procedure id="proc-Administrator_Guide-IMAP_Single_Instance_Store-Example_of_Single_Instance_Store">
+            <title>Example of Single Instance Store</title>
+            <para>
+                The following example depicts a scenario in which single instance store can be shown in full force.
+            </para>
+            <step>
+                <para>
+                    Set the destination concurrency and recipient limits for LMTP to 1 (from a default 20):
+                </para>
+                <para>
+
+<screen># <userinput>postconf -e lmtp_destination_concurrency_limit=1</userinput>
+# <userinput>postconf -e lmtp_destination_recipient_limit=1</userinput>
+<userinput># service postfix reload</userinput></screen>
+
+                </para>
+
+            </step>
+            <step>
+                <para>
+                    Create a Kolab Distribution Group with 20 users.
+                </para>
+
+            </step>
+            <step>
+                <para>
+                    Send an email to the distribution group, such as:
+                </para>
+                <para>
+
+<screen># <userinput>date | mail -s "single instance store test #1" kolab-users at example.org</userinput></screen>
+
+                </para>
+
+            </step>
+            <step>
+                <para>
+                    Await delivery of the mail message to all users.
+                </para>
+
+            </step>
+            <step>
+                <para>
+                    Examine the inode numbers (links) and the cumulative size on disk for the files.
+                </para>
+                <para>
+
+<screen># <userinput>cd /var/spool/imap/domain/e/example.org/</userinput>
+# <userinput>files=$(grep -lr "^Subject: single instance store test #1" \</userinput>
+> <userinput>$(find . -type f -name "*.") | sort -u)</userinput>
+# <userinput>du -k -sch $files</userinput>
+4.0K    ./a/user/awmaf^utkfnxkkvt/1.
+4.0K    ./e/user/eekac^brllxsoxqz/1.
+4.0K    ./e/user/ettkm^myomrfnbiv/1.
+4.0K    ./h/user/hqjvf^dmlykpdbne/1.
+4.0K    ./i/user/ixkip^yfnwqozsbd/1.
+4.0K    ./l/user/ldhlx^svldlbiqio/1.
+4.0K    ./n/user/nbxgn^tguudjsxux/1.
+4.0K    ./n/user/ndqgm^tivbvcmvib/1.
+4.0K    ./n/user/ngwzy^rdrjpfidqq/1.
+4.0K    ./o/user/owepg^qhhxzsrkvq/1.
+4.0K    ./p/user/powim^kqbijipeuh/1.
+4.0K    ./p/user/pzrwn^mnophuvwhn/1.
+4.0K    ./q/user/qggwd^mumqpumusq/1.
+4.0K    ./r/user/rtgnu^agwkxslsvp/1.
+4.0K    ./s/user/sfsms^fgbyccivws/1.
+4.0K    ./t/user/tdwdn^vfjmasjers/1.
+4.0K    ./u/user/ufdus^zrrcuvboie/1.
+4.0K    ./u/user/uuojh^pgztopgsjz/1.
+4.0K    ./x/user/xdayf^xvfqgswkub/1.
+4.0K    ./y/user/ydays^rpspowozte/1.
+80K total
+# <userinput>du -k -sch -l $files</userinput>
+4.0K    ./a/user/awmaf^utkfnxkkvt/1.
+4.0K    ./e/user/eekac^brllxsoxqz/1.
+4.0K    ./e/user/ettkm^myomrfnbiv/1.
+4.0K    ./h/user/hqjvf^dmlykpdbne/1.
+4.0K    ./i/user/ixkip^yfnwqozsbd/1.
+4.0K    ./l/user/ldhlx^svldlbiqio/1.
+4.0K    ./n/user/nbxgn^tguudjsxux/1.
+4.0K    ./n/user/ndqgm^tivbvcmvib/1.
+4.0K    ./n/user/ngwzy^rdrjpfidqq/1.
+4.0K    ./o/user/owepg^qhhxzsrkvq/1.
+4.0K    ./p/user/powim^kqbijipeuh/1.
+4.0K    ./p/user/pzrwn^mnophuvwhn/1.
+4.0K    ./q/user/qggwd^mumqpumusq/1.
+4.0K    ./r/user/rtgnu^agwkxslsvp/1.
+4.0K    ./s/user/sfsms^fgbyccivws/1.
+4.0K    ./t/user/tdwdn^vfjmasjers/1.
+4.0K    ./u/user/ufdus^zrrcuvboie/1.
+4.0K    ./u/user/uuojh^pgztopgsjz/1.
+4.0K    ./x/user/xdayf^xvfqgswkub/1.
+4.0K    ./y/user/ydays^rpspowozte/1.
+80K total
+# <userinput>stat $(echo $files | cut -d' ' -f1)</userinput>
+  File: `./h/user/hqjvf^dmlykpdbne/1.'
+  Size: 1495        Blocks: 8        IO Block: 4096   regular file
+Device: fd00h/64768d    Inode: 131125    Links: 1
+Access: (0600/-rw-------)  Uid: (   76/   cyrus)   Gid: (   12/    mail)
+Access: 2012-08-06 11:04:45.391468108 +0200
+Modify: 2012-08-06 11:04:06.000000000 +0200
+Change: 2012-08-06 11:04:06.757235163 +0200
+</screen>
+
+                </para>
+
+            </step>
+            <step>
+                <para>
+                    Set the destination concurrency and recipient limits for LMTP back to the default 20:
+                </para>
+                <para>
+
+<screen># <userinput>postconf -e lmtp_destination_concurrency_limit=20</userinput>
+# <userinput>postconf -e lmtp_destination_recipient_limit=20</userinput>
+<userinput># service postfix reload</userinput></screen>
+
+                </para>
+
+            </step>
+            <step>
+                <para>
+                    Send an email to the distribution group, such as:
+                </para>
+                <para>
+
+<screen># <userinput>date | mail -s "single instance store test #2" kolab-users at example.org</userinput></screen>
+
+                </para>
+
+            </step>
+            <step>
+                <para>
+                    Await delivery of the mail message to all users.
+                </para>
+
+            </step>
+            <step>
+                <para>
+                    Examine the inode numbers (links) and the cumulative size on disk for the files.
+                </para>
+                <para>
+
+<screen># <userinput>cd /var/spool/imap/domain/e/example.org/</userinput>
+# <userinput>files=$(grep -lr "^Subject: single instance store test #2" \</userinput>
+> <userinput>$(find . -type f -name "*.") | sort -u)</userinput>
+# <userinput>du -k -sch $files</userinput>
+4.0K    ./a/user/awmaf^utkfnxkkvt/2.
+4.0K    total
+# <userinput>du -k -sch -l $files</userinput>
+4.0K    ./a/user/awmaf^utkfnxkkvt/2.
+4.0K    ./e/user/eekac^brllxsoxqz/2.
+4.0K    ./e/user/ettkm^myomrfnbiv/2.
+4.0K    ./h/user/hqjvf^dmlykpdbne/2.
+4.0K    ./i/user/ixkip^yfnwqozsbd/2.
+4.0K    ./l/user/ldhlx^svldlbiqio/2.
+4.0K    ./n/user/nbxgn^tguudjsxux/2.
+4.0K    ./n/user/ndqgm^tivbvcmvib/2.
+4.0K    ./n/user/ngwzy^rdrjpfidqq/2.
+4.0K    ./o/user/owepg^qhhxzsrkvq/2.
+4.0K    ./p/user/powim^kqbijipeuh/2.
+4.0K    ./p/user/pzrwn^mnophuvwhn/2.
+4.0K    ./q/user/qggwd^mumqpumusq/2.
+4.0K    ./r/user/rtgnu^agwkxslsvp/2.
+4.0K    ./s/user/sfsms^fgbyccivws/2.
+4.0K    ./t/user/tdwdn^vfjmasjers/2.
+4.0K    ./u/user/ufdus^zrrcuvboie/2.
+4.0K    ./u/user/uuojh^pgztopgsjz/2.
+4.0K    ./x/user/xdayf^xvfqgswkub/2.
+4.0K    ./y/user/ydays^rpspowozte/2.
+80K total
+# <userinput>stat $(echo $files | cut -d' ' -f1)</userinput>
+  File: `./a/user/awmaf^utkfnxkkvt/2.'
+  Size: 1495        Blocks: 8        IO Block: 4096   regular file
+Device: fd00h/64768d    Inode: 130722    Links: 20
+Access: (0600/-rw-------)  Uid: (   76/   cyrus)   Gid: (   12/    mail)
+Access: 2012-08-06 11:08:56.742891364 +0200
+Modify: 2012-08-06 11:08:28.000000000 +0200
+Change: 2012-08-06 11:08:28.760261876 +0200</screen>
+
+                </para>
+
+            </step>
+
+        </procedure>
+
+
+    </section>
+
+
+</chapter>
+
diff --git a/Administrator_Guide/en-US/Tweaking_Tips_for_Postfix.xml b/Administrator_Guide/en-US/Tweaking_Tips_for_Postfix.xml
new file mode 100644
index 0000000..51cf20a
--- /dev/null
+++ b/Administrator_Guide/en-US/Tweaking_Tips_for_Postfix.xml
@@ -0,0 +1,13 @@
+<?xml version='1.0' encoding='utf-8' ?>
+<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
+<!ENTITY % BOOK_ENTITIES SYSTEM "Administrator_Guide.ent">
+%BOOK_ENTITIES;
+]>
+<chapter id="chap-Administrator_Guide-Tweaking_Tips_for_Postfix">
+    <title>Tweaking Tips for Postfix</title>
+    <para>
+        para
+    </para>
+
+</chapter>
+
diff --git a/Administrator_Guide/en-US/Tweaking_Tips_for_Roundcube.xml b/Administrator_Guide/en-US/Tweaking_Tips_for_Roundcube.xml
new file mode 100644
index 0000000..5b737b3
--- /dev/null
+++ b/Administrator_Guide/en-US/Tweaking_Tips_for_Roundcube.xml
@@ -0,0 +1,13 @@
+<?xml version='1.0' encoding='utf-8' ?>
+<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
+<!ENTITY % BOOK_ENTITIES SYSTEM "Administrator_Guide.ent">
+%BOOK_ENTITIES;
+]>
+<chapter id="chap-Administrator_Guide-Tweaking_Tips_for_Roundcube">
+    <title>Tweaking Tips for Roundcube</title>
+    <para>
+        para
+    </para>
+
+</chapter>
+
diff --git a/Administrator_Guide/en-US/part-Kolab_Server.xml b/Administrator_Guide/en-US/part-Kolab_Server.xml
index 2612ba0..c8ce198 100755
--- a/Administrator_Guide/en-US/part-Kolab_Server.xml
+++ b/Administrator_Guide/en-US/part-Kolab_Server.xml
@@ -10,5 +10,8 @@
     <xi:include href="Detailed_Kolab_Server_Overview.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
     <xi:include href="Kolab_Web_Administration_Panel.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
     <xi:include href="Combating_Spam.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+    <xi:include href="Tweaking_Tips_for_Cyrus_IMAP.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+    <xi:include href="Tweaking_Tips_for_Postfix.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+    <xi:include href="Tweaking_Tips_for_Roundcube.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
 </part>
 





More information about the commits mailing list