summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorJeroen van Meeuwen (Kolab Systems) <vanmeeuwen@kolabsys.com>2011-01-21 13:55:06 (GMT)
committerJeroen van Meeuwen (Kolab Systems) <vanmeeuwen@kolabsys.com>2011-01-21 13:55:06 (GMT)
commita729ddc89fda7dde9440b3ce007d89d64ed9b353 (patch)
treeb702e37ef4e0d64b2e6ef0ca25f58cb889de6b0c
parent1c2cbc9f40e8f82946444a5a7fa4eeb6cef209af (diff)
downloadkolab-docs-a729ddc89fda7dde9440b3ce007d89d64ed9b353.tar.gz
Expand on the installation procedure, adding the instructions to configure/enable EPEL, and disable the CentOS addons and extras repositories
-rw-r--r--Installation_Guide/en-US/Obtaining_Kolab_Software.xml264
1 files changed, 225 insertions, 39 deletions
diff --git a/Installation_Guide/en-US/Obtaining_Kolab_Software.xml b/Installation_Guide/en-US/Obtaining_Kolab_Software.xml
index 8d71428..8e0ee28 100644
--- a/Installation_Guide/en-US/Obtaining_Kolab_Software.xml
+++ b/Installation_Guide/en-US/Obtaining_Kolab_Software.xml
@@ -401,69 +401,243 @@ E: Broken packages</screen>
RPM packages are being provided for the following Linux distributions and versions:
</para>
<para>
- <itemizedlist>
- <listitem>
- <formalpara id="form-Installation_Guide-Installation_with_RPM_Packages-CentOS">
- <title>CentOS</title>
- <para>
- <simplelist>
- <member>CentOS 5, until approximately Q1 2014</member>
- <member>CentOS 6, until approximately Q4 2017</member>
+ <table frame="all" id="tabl-Installation_Guide-Installation_with_RPM_Packages-RPM_Packages_Distribution_Support">
+ <title>RPM 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>
- </simplelist>
+ </row>
+ <row>
+ <entry>
+ Name
+ </entry>
+ <entry>
+ CodeName
+ </entry>
+ <entry>
+ Version
+ </entry>
+ <entry>
+ Architectures
+ </entry>
- </para>
+ </row>
- </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>
+ </thead>
+ <!--
+ <tfoot> <row>
+ <entry>
+ f1
+ </entry>
+ <entry>
+ f2
+ </entry>
+ <entry>
+ f3
+ </entry>
+ <entry>
+ f4
+ </entry>
+ <entry>
+ f5
+ </entry>
- </note>
+ </row>
+ </tfoot>
+ --> <tbody>
+ <row>
+ <entry>
+ CentOS
+ </entry>
+ <entry>
+ -
+ </entry>
+ <entry>
+ 5
+ </entry>
+ <entry>
+ i386, amd64
+ </entry>
+ <entry>
+ Approximately Q1, 2014
+ </entry>
- </listitem>
- <listitem>
- <formalpara id="form-Installation_Guide-Installation_with_RPM_Packages-Fedora">
- <title>Fedora</title>
- <para>
- As Fedora is a development platform, and not a server platform, it suffices to say all current versions of Fedora are supported for as long as the lifecycle of the Fedora distribution lasts (e.g. approximately 13 months).
- </para>
+ </row>
+ <row>
+ <entry>
+ CentOS
+ </entry>
+ <entry>
+ -
+ </entry>
+ <entry>
+ 6
+ </entry>
+ <entry>
+ i386, amd64
+ </entry>
+ <entry>
+ Approximately Q4, 2017
+ </entry>
- </formalpara>
+ </row>
+ <row>
+ <entry>
+ Fedora
+ </entry>
+ <entry>
+ Goddard
+ </entry>
+ <entry>
+ 13
+ </entry>
+ <entry>
+ i386, amd64
+ </entry>
+ <entry>
+ Q2, 2011
+ </entry>
- </listitem>
- <listitem>
- <formalpara id="form-Installation_Guide-Installation_with_RPM_Packages-Red_Hat_Enterprise_Linux">
- <title>Red Hat Enterprise Linux</title>
- <para>
- <simplelist>
- <member>Red Hat Enterprise Linux 5 (Tikanga), until approximately Q1 2014</member>
- <member>Red Hat Enterprise Linux 6 (Santiago), until approximately Q4 2017</member>
+ </row>
+ <row>
+ <entry>
+ Fedora
+ </entry>
+ <entry>
+ Laughlin
+ </entry>
+ <entry>
+ 14
+ </entry>
+ <entry>
+ i386, amd64
+ </entry>
+ <entry>
+ Q4, 2011
+ </entry>
- </simplelist>
+ </row>
+ <row>
+ <entry>
+ Red Hat Enterprise Linux
+ </entry>
+ <entry>
+ Tikanga
+ </entry>
+ <entry>
+ 5
+ </entry>
+ <entry>
+ i386, amd64
+ </entry>
+ <entry>
+ Approximately Q1, 2014
+ </entry>
- </para>
+ </row>
+ <row>
+ <entry>
+ Red Hat Enterprise Linux
+ </entry>
+ <entry>
+ Santiago
+ </entry>
+ <entry>
+ 6
+ </entry>
+ <entry>
+ i386, amd64
+ </entry>
+ <entry>
+ Approximately Q4, 2017
+ </entry>
+
+ </row>
- </formalpara>
+ </tbody>
- </listitem>
+ </tgroup>
- </itemizedlist>
+ </table>
</para>
<section id="sect-Installation_Guide-Installation_with_RPM_Packages-CentOS">
<title>CentOS</title>
<para>
- For the instructions on installing Kolab on CentOS, please refer to the instructions in <xref linkend="sect-Installation_Guide-Installation_with_RPM_Packages-Red_Hat_Enterprise_Linux" />.
+ For full instructions on installing Kolab Groupware on CentOS, please refer to the instructions in <xref linkend="sect-Installation_Guide-Installation_with_RPM_Packages-Red_Hat_Enterprise_Linux" />.
</para>
+ <note>
+ <title>Disable 'addons' and 'extras' repositories</title>
+ <para>
+ Please be aware that on CentOS, you will need to disable the 'addons' and 'extras' repositories, as they contain packages not part of the Enterprise Linux base operating system.
+ </para>
+ <para>
+ The disable these repositories, edit <filename>/etc/yum.repos.d/CentOS-Base.repo</filename> and append a setting <code>enabled=0</code> to sections <code>[addons]</code> and <code>[extras]</code>, or delete the sections entirely.
+ </para>
+
+ </note>
</section>
<section id="sect-Installation_Guide-Installation_with_RPM_Packages-Red_Hat_Enterprise_Linux">
<title>Red Hat Enterprise Linux</title>
<para>
+ The <ulink url="http://fedoraproject.org/wiki/EPEL">EPEL</ulink> repository is required for Kolab Groupware on Enterprise Linux 5. Install the EPEL repository using the following procedure:
+ </para>
+ <procedure id="proc-Installation_Guide-Red_Hat_Enterprise_Linux-Installing_the_epel_release_Package">
+ <title>Installing the <application>epel-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://download.fedora.redhat.com/pub/epel/5/i386/repoview/epel-release.html">Enterprise Linux 5</ulink> (Tikanga)
+ </para>
+
+ </listitem>
+ <listitem>
+ <para>
+ <ulink url="http://download.fedora.redhat.com/pub/epel/6/i386/repoview/epel-release.html">Enterprise Linux 6</ulink> (Santiago)
+ </para>
+
+ </listitem>
+
+ </itemizedlist>
+
+ </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>
+
+ </procedure>
+
+ <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>
<procedure id="proc-Installation_Guide-Red_Hat_Enterprise_Linux-Installing_the_kolab_PRODUCT_VERSION_community_release_Package">
@@ -480,6 +654,12 @@ E: Broken packages</screen>
</para>
</listitem>
+ <listitem>
+ <para>
+ <ulink url="http://mirror.kolabsys.com/pub/redhat/kolab-2.3/el6/release/i386/repoview/kolab-2.3-community-release.html">Enterprise Linux 6</ulink>
+ </para>
+
+ </listitem>
</itemizedlist>
@@ -581,6 +761,12 @@ kolab-&PRODUCT_VERSION;-updates-testing-source
</para>
</step>
+ <step>
+ <para>
+ The repositories that have been installed using the <application>kolab-&PRODUCT_VERSION;-community-release</application> package(s) have a pre-configured priority of <code>50</code>. The default repository priority is <code>99</code>. Unless you have repositories configured other then the base operating system repositories (not including 'addons' and 'extras' on CentOS platforms), EPEL and the Kolab Groupware repositories, you are good to go.
+ </para>
+
+ </step>
</procedure>