Installation_Guide/en-US

[Jeroen van Meeuwen]

 Installation_Guide/en-US/Kolab_Server_First_Login.xml |   84 ++++++++++++++++++
 1 file changed, 84 insertions(+)

New commits:
commit 4db148cc0da269a434f7061da39dbe62b52e11be
Author: Jeroen van Meeuwen (Kolab Systems) <vanmeeuwen at kolabsys.com>
Date:   Mon May 14 13:48:46 2012 +0100

    Add documentation on making Roundcube available outside localhost, and add some verbiage on logging in.

diff --git a/Installation_Guide/en-US/Kolab_Server_First_Login.xml b/Installation_Guide/en-US/Kolab_Server_First_Login.xml
index 3cccd06..7a3eb88 100644
--- a/Installation_Guide/en-US/Kolab_Server_First_Login.xml
+++ b/Installation_Guide/en-US/Kolab_Server_First_Login.xml
@@ -57,6 +57,66 @@
             <para>
                 For the procedure to edit the <literal>user_types</literal>, please refer to <ulink url="http://docs.kolab.org/en-US/Kolab_Groupware/2.4/html/Administrator_Guide/chap-Administrator_Guide-Kolab_Web_Administration_Panel.html#proc-Administrator_Guide-Editing_user_types-Manually_Changing_the_user_types_Available">this procedure</ulink> Administrator Guide.
             </para>
+            <formalpara id="form-Community_Installation_Guide-Troubleshooting-Cannot_Add_Users">
+                <title>Cannot Add Users</title>
+                <para>
+                    If you cannot add users in the Kolab Web Administration, because no link exists, please verify the following;
+                </para>
+
+            </formalpara>
+            <procedure id="proc-Community_Installation_Guide-Troubleshooting-Troubleshooting">
+                <title>Troubleshooting</title>
+                <step>
+                    <para>
+                        Please verify <filename>/usr/lib64/mozldap/ldapsearch</filename> (or <filename>/usr/lib/mozldap/ldapsearch</filename> on 32-bit systems) is executable under Apache HTTPd.
+                    </para>
+                    <para>
+
+<screen># <userinput>su -s /bin/bash - apache -c '/usr/lib64/mozldap/ldapsearch'</userinput>
+# <userinput>ls -l /usr/lib64/mozldap/ldapsearch</userinput></screen>
+
+                    </para>
+                    <para>
+                        Please also verify SELinux is not preventing Apache from executing the aforementioned binary:
+                    </para>
+                    <para>
+
+<screen># <userinput>sestatus</userinput>
+SELinux status:                enabled
+SELinuxfs mount:                /sys/fs/selinux
+SELinux root directory:        /etc/selinux
+Loaded policy name:            targeted
+Current mode:                permissive
+Mode from config file:        enforcing
+Policy MLS status:            enabled
+Policy deny_unknown status:    allowed
+Max kernel policy version:    26</screen>
+
+                    </para>
+
+                </step>
+                <step>
+                    <para>
+                        Please verify the MySQL database has been properly initialized:
+                    </para>
+                    <para>
+
+<screen># <userinput>mysql -u root -p kolab -e 'SHOW TABLES;'</userinput>
+Enter password:
++-------------------+
+| Tables_in_kolab   |
++-------------------+
+| group_types    |
+| options        |
+| user_types        |
++-------------------+</screen>
+
+                    </para>
+
+                </step>
+
+            </procedure>
+
 
         </section>
 
@@ -77,6 +137,30 @@
 
     </section>
 
+    <section id="sect-Community_Installation_Guide-First_Login-Creating_a_User">
+        <title>Logging in to Roundcube</title>
+        <para>
+            With the new user, you can now log in to the Kolab Groupware webmail client Roundcube.
+        </para>
+        <note>
+            <para>
+                The default access permissions on Roundcube, as deployed by the packages, only allows access from localhost, or 127.0.0.1.
+            </para>
+            <para>
+                To allow access from anywhere else, edit <filename>/etc/httpd/conf.d/roundcubemail.conf</filename> and adjust "Allow from 127.0.0.1" accordingly, or replace the entire access restrictions with:
+            </para>
+            <para>
+                <screen>Order Allow,Deny
+Allow from All</screen>
+            </para>
+        </note>
+        <para>
+            You can find the webmail interface at the /roundcubemail URL on your webserver using HTTP. For example, a server set up on 192.168.122.2 would have the webmail interface at http://192.168.122.2/roundcubemail.
+        </para>
+        <para>
+            The username can be any of the <literal>uid</literal>, <literal>mail</literal> or <literal>alias</literal> attribute values.
+        </para>
+    </section>
 
 </chapter>