summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorJeroen van Meeuwen (Kolab Systems) <vanmeeuwen@kolabsys.com>2011-02-17 11:14:16 (GMT)
committerJeroen van Meeuwen (Kolab Systems) <vanmeeuwen@kolabsys.com>2011-02-17 11:14:16 (GMT)
commitf783cfd63f265b39adc6d9d0f040434fbb431c55 (patch)
tree7bcdfffab6a9dcd254ab9ee92402c9274dd855b7
parent709735342cfe8a4f12207b764419e25290ac91c0 (diff)
downloadkolab-docs-f783cfd63f265b39adc6d9d0f040434fbb431c55.tar.gz
Rename 'Obtaining Kolab Software' to 'Kolab Server Installation'
Update various tidbits based on recent developments
-rw-r--r--Installation_Guide/en-US/Installation_Guide.xml2
-rw-r--r--Installation_Guide/en-US/Kolab_Server_Installation.xml (renamed from Installation_Guide/en-US/Obtaining_Kolab_Software.xml)20
-rw-r--r--Installation_Guide/en-US/Kolab_Server_on_Enterprise_Linux.xml28
-rw-r--r--Installation_Guide/en-US/Kolab_Webclient_Installation.xml156
4 files changed, 188 insertions, 18 deletions
diff --git a/Installation_Guide/en-US/Installation_Guide.xml b/Installation_Guide/en-US/Installation_Guide.xml
index cc3d307..5c28407 100644
--- a/Installation_Guide/en-US/Installation_Guide.xml
+++ b/Installation_Guide/en-US/Installation_Guide.xml
@@ -6,7 +6,7 @@
<book>
<xi:include href="Book_Info.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
<xi:include href="Preface.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
- <xi:include href="Obtaining_Kolab_Software.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+ <xi:include href="Kolab_Server_Installation.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
<xi:include href="Bootstrapping_the_Kolab_Installation.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
<xi:include href="Kolab_Webclient_Installation.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
<!--
diff --git a/Installation_Guide/en-US/Obtaining_Kolab_Software.xml b/Installation_Guide/en-US/Kolab_Server_Installation.xml
index 98d7f8e..c58d80e 100644
--- a/Installation_Guide/en-US/Obtaining_Kolab_Software.xml
+++ b/Installation_Guide/en-US/Kolab_Server_Installation.xml
@@ -4,9 +4,9 @@
%BOOK_ENTITIES;
]>
<chapter id="chap-Installation_Guide-Obtaining_Kolab_Software">
- <title>Obtaining Kolab Software</title>
+ <title>Kolab Server Installation</title>
<para>
- Kolab is built out of the best available Free and Open Source software components, most if not all of which are available through the Linux distribution of your preference. However, such Linux distribution may not be as up-to-date as one might wish for the Kolab Groupware to provide the latest and greatest functionality, or may simply have a different update policy from what is typically acceptable for a Groupware environment. Kolab therefor provides two alternative deployment methods;
+ The Kolab server is built out of the best available Free and Open Source software components, most if not all of which are available through the Linux distribution of your preference. However, such Linux distribution may not be as up-to-date as one might wish for the Kolab Groupware to provide the latest and greatest functionality, or may simply have a different update policy from what is typically acceptable for a Groupware environment. Kolab therefor provides two alternative deployment methods;
</para>
<para>
<itemizedlist>
@@ -26,6 +26,7 @@
</itemizedlist>
</para>
+
<section id="sect-Installation_Guide-Obtaining_Kolab_Software-Installation_with_OpenPKG">
<title>Installation with OpenPKG</title>
<para>
@@ -190,7 +191,7 @@ $ <userinput>sha1sum -c SHA1SUMS</userinput></screen>
Debian
</entry>
<entry>
- Lenny
+ Lenny (oldstable)
</entry>
<entry>
5.0
@@ -208,7 +209,7 @@ $ <userinput>sha1sum -c SHA1SUMS</userinput></screen>
Debian
</entry>
<entry>
- Squeeze
+ Squeeze (stable)
</entry>
<entry>
6.0
@@ -221,16 +222,15 @@ $ <userinput>sha1sum -c SHA1SUMS</userinput></screen>
</entry>
</row>
-
<row>
<entry>
Debian
</entry>
<entry>
- Wheezy
+ Wheezy (testing)
</entry>
<entry>
- 7.0 (next stable)
+ 7.0
</entry>
<entry>
i386, amd64
@@ -245,10 +245,10 @@ $ <userinput>sha1sum -c SHA1SUMS</userinput></screen>
Debian
</entry>
<entry>
- Sid
+ Sid (unstable)
</entry>
<entry>
- Current unstable
+ N/A
</entry>
<entry>
i386, amd64
@@ -339,7 +339,7 @@ Pin-Priority: 501</screen>
</step>
<step>
<para>
- When asked to confirm you want to continue installing the packages of which the integrity nor source can be securely verified, press y then Enter.
+ When asked to confirm you want to continue installing the packages of which the integrity nor source can be securely verified, press <keycap>y</keycap> then <keycap>Enter</keycap>.
</para>
</step>
diff --git a/Installation_Guide/en-US/Kolab_Server_on_Enterprise_Linux.xml b/Installation_Guide/en-US/Kolab_Server_on_Enterprise_Linux.xml
index 83a2031..2c339c4 100644
--- a/Installation_Guide/en-US/Kolab_Server_on_Enterprise_Linux.xml
+++ b/Installation_Guide/en-US/Kolab_Server_on_Enterprise_Linux.xml
@@ -22,6 +22,18 @@
</para>
</listitem>
+ <listitem>
+ <para>
+ Red Hat Enterprise Linux 6 (recommended)
+ </para>
+
+ </listitem>
+ <listitem>
+ <para>
+ CentOS 6
+ </para>
+
+ </listitem>
</itemizedlist>
@@ -60,7 +72,7 @@
<title>Operating System Resources</title>
<listitem>
<para>
- The following software packages may not be installed on the Kolab Groupware server system:
+ The following software packages may not be installed on the Kolab Groupware server system prior to the installation of Kolab:
</para>
<para>
<itemizedlist>
@@ -70,12 +82,6 @@
</para>
</listitem>
- <listitem>
- <para>
- <literal>openldap</literal>
- </para>
-
- </listitem>
</itemizedlist>
@@ -171,6 +177,14 @@
</section>
+ <section id="sect-Installation_Guide-Kolab_Server_on_Enterprise_Linux-Installing_Kolab">
+ <title>Installing Kolab</title>
+ <para>
+ Kolab Groupware consists of the following major components; The Kolab Groupware daemon (<application>kolabd</application>), the Kolab Web Administration Panel (<application>kolab-webadmin</application>) and the Kolab Web Client (<application>kolab-webadmin</application>).
+ </para>
+
+ </section>
+
</chapter>
diff --git a/Installation_Guide/en-US/Kolab_Webclient_Installation.xml b/Installation_Guide/en-US/Kolab_Webclient_Installation.xml
index 30a8c11..675ab1c 100644
--- a/Installation_Guide/en-US/Kolab_Webclient_Installation.xml
+++ b/Installation_Guide/en-US/Kolab_Webclient_Installation.xml
@@ -20,5 +20,161 @@
</itemizedlist>
</para>
+ <section id="sect-Installation_Guide-Kolab_Webclient_Installation-Installing_Horde_Database">
+ <title>Installing Horde Database</title>
+ <para>
+ The following procedure ...
+ </para>
+ <procedure id="proc-Installation_Guide-Installing_Horde_Database-Installing_the_Horde_Database">
+ <title>Installing the Horde Database</title>
+ <step>
+ <para>
+ Install the MySQL server package <application>mysql-server</application>:
+ </para>
+ <para>
+
+<screen># <userinput>yum -y install mysql-server</userinput></screen>
+
+ </para>
+
+ </step>
+ <step>
+ <para>
+ Configure the <application>mysqld</application> service to start on boot (runlevels 2 through 5):
+ </para>
+ <para>
+ chkconfig mysqld on
+ </para>
+
+ </step>
+ <step>
+ <para>
+ Edit <filename>/etc/my.cnf</filename>, and execute the following edits:
+ </para>
+ <para>
+ <orderedlist>
+ <listitem>
+ <para>
+ Set <code>old_passwords</code> to <code>0</code>.
+ </para>
+
+ </listitem>
+ <listitem>
+ <para>
+ Make sure the InnoDB storage engine is enabled, by providing the MySQL server with the binary log settings:
+ </para>
+ <para>
+
+<screen># Make sure all logs are flushed on shutdown
+innodb_fast_shutdown=0
+
+innodb_file_per_table
+innodb_data_file_path = ibdata1:128M:autoextend</screen>
+
+ </para>
+ <note>
+ <title>The Size Values are Defaults</title>
+ <para>
+ Adjust the default size values as shown in this step of the procedure to your needs as appropriate.
+ </para>
+
+ </note>
+
+ </listitem>
+
+ </orderedlist>
+
+ </para>
+
+ </step>
+ <step>
+ <para>
+ Start the MySQL server for the first time:
+ </para>
+ <para>
+
+<screen># <userinput>service mysqld start</userinput>
+
+Initializing MySQL database: Installing MySQL system tables...
+OK
+Filling help tables...
+OK
+
+To start mysqld at boot time you have to copy
+support-files/mysql.server to the right place for your system
+
+PLEASE REMEMBER TO SET A PASSWORD FOR THE MySQL root USER !
+To do so, start the server, then issue the following commands:
+/usr/bin/mysqladmin -u root password 'new-password'
+/usr/bin/mysqladmin -u root -h test90-2.test90.kolabsys.com password 'new-password'
+
+Alternatively you can run:
+/usr/bin/mysql_secure_installation
+
+which will also give you the option of removing the test
+databases and anonymous user created by default. This is
+strongly recommended for production servers.
+
+See the manual for more instructions.
+
+You can start the MySQL daemon with:
+cd /usr ; /usr/bin/mysqld_safe &amp;
+
+You can test the MySQL daemon with mysql-test-run.pl
+cd mysql-test ; perl mysql-test-run.pl
+
+Please report any problems with the /usr/bin/mysqlbug script!
+
+The latest information about MySQL is available on the web at
+http://www.mysql.com
+Support MySQL by buying support/licenses at http://shop.mysql.com
+ [ OK ]
+Starting MySQL: [ OK ]
+</screen>
+
+ </para>
+
+ </step>
+ <step>
+ <para>
+ Run the initial configuration and securing, and follow the instructions:
+ </para>
+ <para>
+
+<screen># <userinput>/usr/bin/mysql_secure_installation</userinput></screen>
+
+ </para>
+
+ </step>
+ <step>
+ <para>
+ Create the horde database:
+ </para>
+ <para>
+
+<screen># <userinput>mysql -p -e 'CREATE DATABASE horde;'</userinput></screen>
+
+ </para>
+
+ </step>
+ <step>
+ <para>
+ Create the horde user and grant all privileges to the horde database to that horde user:
+ </para>
+ <para>
+
+<screen># <userinput>mysql -p -e 'GRANT ALL PRIVILEGES on `horde`.* TO</userinput>
+ <userinput>`horde`@`localhost` IDENTIFIED BY "YourPassword";'</userinput></screen>
+
+ </para>
+
+ </step>
+
+ </procedure>
+
+
+ </section>
+
+
</chapter>