summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorJeroen van Meeuwen (Kolab Systems) <vanmeeuwen@kolabsys.com>2012-05-14 12:48:46 (GMT)
committerJeroen van Meeuwen (Kolab Systems) <vanmeeuwen@kolabsys.com>2012-05-14 12:48:46 (GMT)
commit4db148cc0da269a434f7061da39dbe62b52e11be (patch)
tree5baa7ec867a708e06178df03d73422b075bfab2b
parent221ffe2f878af1b8ac3c21bf3655e33a36d1bb33 (diff)
downloadkolab-docs-4db148cc0da269a434f7061da39dbe62b52e11be.tar.gz
Add documentation on making Roundcube available outside localhost, and add some verbiage on logging in.
-rw-r--r--Installation_Guide/en-US/Kolab_Server_First_Login.xml84
1 files changed, 84 insertions, 0 deletions
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>