5 commits - Installation_Guide/en-US
Jeroen van Meeuwen
vanmeeuwen at kolabsys.com
Fri Jan 21 11:36:33 CET 2011
Installation_Guide/en-US/Bootstrapping_the_Kolab_Installation.xml | 1
Installation_Guide/en-US/Installation_Guide.xml | 5
Installation_Guide/en-US/Obtaining_Kolab_Software.xml | 244 +++++++---
Installation_Guide/en-US/Part-Kolab_Server_Installation.xml | 15
4 files changed, 192 insertions(+), 73 deletions(-)
New commits:
commit ca8af9fc89a2a7053e188d40d089a3ed1bbc6939
Author: Jeroen van Meeuwen (Kolab Systems) <vanmeeuwen at kolabsys.com>
Date: Fri Jan 21 10:36:15 2011 +0000
Update the section on Obtaining Kolab software for Enterprise Linux 5
diff --git a/Installation_Guide/en-US/Obtaining_Kolab_Software.xml b/Installation_Guide/en-US/Obtaining_Kolab_Software.xml
index fb19746..4808ae9 100644
--- a/Installation_Guide/en-US/Obtaining_Kolab_Software.xml
+++ b/Installation_Guide/en-US/Obtaining_Kolab_Software.xml
@@ -466,25 +466,43 @@ E: Broken packages</screen>
<para>
The Kolab software repositories for Red Hat Enterprise Linux ship two so-called <literal>-release</literal> packages. The <literal>kolab-&PRODUCT_VERSION;-community-release</literal> package contains the configuration for the stable software channels, e.g. <emphasis>release</emphasis> and <emphasis>updates</emphasis>.
</para>
- <para>
- Depending on the version of Red Hat Enterprise Linux, install the following package:
- </para>
- <para>
- <itemizedlist>
- <listitem>
- <para>
- <ulink url="http://mirror.kolabsys.com/pub/redhat/kolab-/el5/development/x86_64/kolab--community-release-5-6.el5.kolab.noarch.rpm">Enterprise Linux 5</ulink>
- </para>
+ <procedure id="proc-Installation_Guide-Red_Hat_Enterprise_Linux-Installing_the_kolab_PRODUCT_VERSION_community_release_Package">
+ <title>Installing the <application>kolab-&PRODUCT_VERSION;-community-release</application> Package</title>
+ <step>
+ <para>
+ Depending on the version of Red Hat Enterprise Linux, install the package as it is listed on the following page:
+ </para>
+ <para>
+ <itemizedlist>
+ <listitem>
+ <para>
+ <ulink url="http://mirror.kolabsys.com/pub/redhat/kolab-2.3/el5/release/i386/repoview/kolab-2.3-community-release.html">Enterprise Linux 5</ulink>
+ </para>
- </listitem>
+ </listitem>
- </itemizedlist>
+ </itemizedlist>
- </para>
- <para>
- To test the installation of the repository configuration, please execute:
- </para>
- <para>
+ </para>
+
+ </step>
+ <step>
+ <para>
+ Install this package using the following command:
+ </para>
+ <para>
+
+<screen># <userinput>wget http://url/to/rpm</userinput>
+<userinput># yum localinstall --nogpgcheck /path/to/rpm</userinput></screen>
+
+ </para>
+
+ </step>
+ <step>
+ <para>
+ To test the installation of the repository configuration, please execute:
+ </para>
+ <para>
<screen># <userinput>yum repolist</userinput>
(...snip...)
@@ -492,11 +510,18 @@ kolab-&PRODUCT_VERSION;
kolab-&PRODUCT_VERSION;-updates
(...snip...)</screen>
- </para>
- <para>
- Note that the output is abbreviated for clarity. The output may actually include the description of the repository, and the number of packages available. Optionally, to see which repositories have been configured though not enabled, also execute:
- </para>
- <para>
+ </para>
+ <note>
+ <title>Output Abbreviated</title>
+ <para>
+ Note that the output is abbreviated for clarity. The output may actually include the description of the repository, and the number of packages available.
+ </para>
+
+ </note>
+ <para>
+ Optionally, to see which repositories have been configured though not enabled, also execute:
+ </para>
+ <para>
<screen># <userinput>yum repolist all</userinput>
(...snip...)
@@ -511,10 +536,19 @@ kolab-&PRODUCT_VERSION;-updates-testing-debuginfo
kolab-&PRODUCT_VERSION;-updates-testing-source
(...snip...)</screen>
- </para>
- <para>
- Note that the output is abbreviated for clarity. The output may actually include the description of the repository, whether the repository is enabled by default or not, and the number of packages available.
- </para>
+ </para>
+ <note>
+ <title>Output Abbreviated</title>
+ <para>
+ Note that the output is abbreviated for clarity. The output may actually include the description of the repository, whether the repository is enabled by default or not, and the number of packages available.
+ </para>
+
+ </note>
+
+ </step>
+
+ </procedure>
+
</section>
@@ -526,6 +560,30 @@ kolab-&PRODUCT_VERSION;-updates-testing-source
</section>
+ <section id="sect-Installation_Guide-Installation_with_RPM_Packages-Using_yum_priorities_to_Avoid_Package_Conflicts">
+ <title>Using <application>yum-priorities</application> to Avoid Package Conflicts</title>
+ <para>
+ Since any given package may at any time be shipped by the Kolab repositories as well as through the regular distribution repositories, and to avoid switching back and forth between the two different versions continuously, by mistake or by accident, we recommend you use the following procedure including employing YUM repository priorities to smooth out any future problems.
+ </para>
+ <procedure id="proc-Installation_Guide-Using_yum_priorities_to_Avoid_Package_Conflicts-Installing_and_Configuring_YUM_priorities">
+ <title>Installing and Configuring YUM priorities</title>
+ <step>
+ <para>
+ The <application>yum-priorities</application> is available from the <ulink url="http://fedoraproject.org/wiki/EPEL">package repository</ulink>. Please install it:
+ </para>
+ <para>
+
+<screen># <userinput>yum install yum-priorities</userinput></screen>
+
+ </para>
+
+ </step>
+
+ </procedure>
+
+
+ </section>
+
</section>
commit 13103482d98133ac846da77d98a3d04217b1f1f8
Author: Jeroen van Meeuwen (Kolab Systems) <vanmeeuwen at kolabsys.com>
Date: Fri Jan 21 10:33:17 2011 +0000
Result of publican clean_ids
diff --git a/Installation_Guide/en-US/Bootstrapping_the_Kolab_Installation.xml b/Installation_Guide/en-US/Bootstrapping_the_Kolab_Installation.xml
index dbf73df..aabf195 100644
--- a/Installation_Guide/en-US/Bootstrapping_the_Kolab_Installation.xml
+++ b/Installation_Guide/en-US/Bootstrapping_the_Kolab_Installation.xml
@@ -13,6 +13,7 @@
<para>
The infrastructure around the Kolab environment matters. The system's hostname, <emphasis>Fully Qualified Domain Name</emphasis> (FQDN) and other infrastructural aspects impact the installation procedure as well as the resulting runtime environment. The Deployment Guide has more details.
</para>
+
</important>
<section id="sect-Installation_Guide-Bootstrapping_the_Kolab_Installation-New_Kolab_Environment">
<title>New Kolab Environment</title>
commit 9dd15456651877ed14a4ca41dd77d4e464f55831
Author: Jeroen van Meeuwen (Kolab Systems) <vanmeeuwen at kolabsys.com>
Date: Fri Jan 21 10:32:01 2011 +0000
Remove the part on Installation, as it has become irrelevant.
Add a chapter on configuring the Horde Web Client
diff --git a/Installation_Guide/en-US/Installation_Guide.xml b/Installation_Guide/en-US/Installation_Guide.xml
index 0095208..cc3d307 100644
--- a/Installation_Guide/en-US/Installation_Guide.xml
+++ b/Installation_Guide/en-US/Installation_Guide.xml
@@ -6,10 +6,9 @@
<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="Part-Kolab_Server_Installation.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="Obtaining_Kolab_Software.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" />
<!--
<xi:include href="Cyrus_IMAP.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
// --> <xi:include href="Revision_History.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
commit d647ae9d09c6118dacd023b3e9b07fc5d5f51b5f
Author: Jeroen van Meeuwen (Kolab Systems) <vanmeeuwen at kolabsys.com>
Date: Fri Jan 21 10:31:31 2011 +0000
This part is no longer in use
diff --git a/Installation_Guide/en-US/Part-Kolab_Server_Installation.xml b/Installation_Guide/en-US/Part-Kolab_Server_Installation.xml
deleted file mode 100644
index 4c8c2bb..0000000
--- a/Installation_Guide/en-US/Part-Kolab_Server_Installation.xml
+++ /dev/null
@@ -1,15 +0,0 @@
-<?xml version='1.0' encoding='utf-8' ?>
-<!DOCTYPE part PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
-<!ENTITY % BOOK_ENTITIES SYSTEM "Installation_Guide.ent">
-%BOOK_ENTITIES;
-]>
-<part id="part-Installation_Guide-Kolab_Groupware_Server_Installation">
- <title>Kolab Groupware Server Installation</title>
- <subtitle>Installation Manual for Kolab Groupware on server systems</subtitle>
- <xi:include href="Installation_Introduction.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
- <xi:include href="Kolab_Server_on_Enterprise_Linux.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
- <xi:include href="Kolab_Initial_Configuration.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
- <xi:include href="Kolab_Webclient_Installation.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
-
-</part>
-
commit c44647434149ede266e402d08dcb63e407cce354
Author: Jeroen van Meeuwen (Kolab Systems) <vanmeeuwen at kolabsys.com>
Date: Tue Jan 18 14:10:00 2011 +0000
Update sections on obtaining kolab software from the repositories
diff --git a/Installation_Guide/en-US/Obtaining_Kolab_Software.xml b/Installation_Guide/en-US/Obtaining_Kolab_Software.xml
index 452dc6d..fb19746 100644
--- a/Installation_Guide/en-US/Obtaining_Kolab_Software.xml
+++ b/Installation_Guide/en-US/Obtaining_Kolab_Software.xml
@@ -126,40 +126,109 @@ $ <userinput>sha1sum -c SHA1SUMS</userinput></screen>
<section id="sect-Installation_Guide-Obtaining_Kolab_Software-Installation_with_APT_Packages">
<title>Installation with APT Packages</title>
<para>
- APT pakages are provided for the following GNU/Linux distributions, and distribution versions:
+ APT packages are provided for the following GNU/Linux distributions, and distribution versions:
</para>
<para>
- <itemizedlist>
- <listitem>
- <formalpara id="form-Installation_Guide-Installation_with_APT_Packages-Debian">
- <title>Debian</title>
- <para>
- <simplelist>
- <member>Lenny (Debian 4.0), until approximately Q1 2012</member>
- <member>Squeeze (Debian 5.0), until approximately Q1 2014</member>
-
- </simplelist>
-
- </para>
-
- </formalpara>
-
- </listitem>
- <listitem>
- <formalpara id="form-Installation_Guide-Installation_with_APT_Packages-Ubuntu">
- <title>Ubuntu</title>
- <para>
- Lucid, Maverick, Natty
- </para>
-
- </formalpara>
-
- </listitem>
-
- </itemizedlist>
+ <table frame="all" id="tabl-Installation_Guide-Installation_with_APT_Packages-APT_Packages_Distribution_Support">
+ <title>APT Packages Distribution Support</title>
+ <tgroup align="left" cols="5" colsep="1" rowsep="1">
+ <colspec colname="c1"></colspec>
+ <colspec colname="c2"></colspec>
+ <colspec colname="c3"></colspec>
+ <colspec colname="c4"></colspec>
+ <colspec colname="c5" colnum="5"></colspec>
+ <thead>
+ <row>
+ <entry align="center" nameend="c4" namest="c1">
+ Distribution Information
+ </entry>
+ <entry morerows="1">
+ EOS / EOL Date
+ </entry>
+
+ </row>
+ <row>
+ <entry>
+ Name
+ </entry>
+ <entry>
+ CodeName
+ </entry>
+ <entry>
+ Version
+ </entry>
+ <entry>
+ Architectures
+ </entry>
+
+ </row>
+
+ </thead>
+ <!--
+ <tfoot> <row>
+ <entry>
+ f1
+ </entry>
+ <entry>
+ f2
+ </entry>
+ <entry>
+ f3
+ </entry>
+ <entry>
+ f4
+ </entry>
+ <entry>
+ f5
+ </entry>
+
+ </row>
+ </tfoot>
+ --> <tbody>
+ <row>
+ <entry>
+ Debian
+ </entry>
+ <entry>
+ Lenny
+ </entry>
+ <entry>
+ 5.0
+ </entry>
+ <entry>
+ i386, amd64
+ </entry>
+ <entry>
+ T.B.D.
+ </entry>
+
+ </row>
+ <row>
+ <entry>
+ Debian
+ </entry>
+ <entry>
+ Squeeze
+ </entry>
+ <entry>
+ 6.0
+ </entry>
+ <entry>
+ i386, amd64
+ </entry>
+ <entry>
+ T.B.D.
+ </entry>
+
+ </row>
+
+ </tbody>
+
+ </tgroup>
+
+ </table>
</para>
- <remark>This should really be a table, and include version numbers as well as EOL dates</remark>
<section id="sect-Installation_Guide-Installation_with_APT_Packages-Debian">
<title>Debian</title>
<procedure>
@@ -346,6 +415,13 @@ E: Broken packages</screen>
</para>
</formalpara>
+ <note>
+ <title>Disable 'addon' and 'extras' repositories</title>
+ <para>
+ As per the title, centos ships its own version of some of the packages we build.
+ </para>
+
+ </note>
</listitem>
<listitem>
More information about the commits
mailing list