summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorJeroen van Meeuwen (Kolab Systems) <vanmeeuwen@kolabsys.com>2012-02-29 17:14:39 (GMT)
committerJeroen van Meeuwen (Kolab Systems) <vanmeeuwen@kolabsys.com>2012-02-29 17:14:39 (GMT)
commit8b037880edc587883cb2ff72e682ddcdadaf2055 (patch)
tree945ec7ad731aff05686181861f01442eeb32c73f
parent72a17bfaac9168583bb1ceae4199dce6b72cdc95 (diff)
downloadkolab-docs-8b037880edc587883cb2ff72e682ddcdadaf2055.tar.gz
Restore the section on APT package repositories to configure and installation
Remove the FIXME on pages missing since repoview is back in business
-rwxr-xr-xInstallation_Guide/en-US/Kolab_Server_Installation.xml475
1 files changed, 471 insertions, 4 deletions
diff --git a/Installation_Guide/en-US/Kolab_Server_Installation.xml b/Installation_Guide/en-US/Kolab_Server_Installation.xml
index 0b2c583..2adc303 100755
--- a/Installation_Guide/en-US/Kolab_Server_Installation.xml
+++ b/Installation_Guide/en-US/Kolab_Server_Installation.xml
@@ -36,8 +36,475 @@
<section id="sect-Community_Installation_Guide-Repository_Configuration-Installation_with_APT_Packages">
<title>Installation with APT Packages</title>
<para>
- APT packages are being provided for the following Linux distributions and versions:
+ APT packages are provided for the following GNU/Linux distributions, and distribution versions:
</para>
+ <para>
+ <table frame="all" id="tabl-Community_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 (oldstable)
+ </entry>
+ <entry>
+ 5.0
+ </entry>
+ <entry>
+ i386, amd64
+ </entry>
+ <entry>
+ February 6th, 2012
+ </entry>
+
+ </row>
+ <row>
+ <entry>
+ Debian
+ </entry>
+ <entry>
+ Squeeze (stable)
+ </entry>
+ <entry>
+ 6.0
+ </entry>
+ <entry>
+ i386, amd64
+ </entry>
+ <entry>
+ T.B.D.
+ </entry>
+
+ </row>
+ <row condition="community">
+ <entry>
+ Debian
+ </entry>
+ <entry>
+ Wheezy (testing)
+ </entry>
+ <entry>
+ 7.0
+ </entry>
+ <entry>
+ i386, amd64
+ </entry>
+ <entry>
+ T.B.D.
+ </entry>
+
+ </row>
+ <row condition="community">
+ <entry>
+ Debian
+ </entry>
+ <entry>
+ Sid (unstable)
+ </entry>
+ <entry>
+ N/A
+ </entry>
+ <entry>
+ i386, amd64
+ </entry>
+ <entry>
+ T.B.D.
+ </entry>
+
+ </row>
+ <row condition="enterprise">
+ <entry>
+ Ubuntu
+ </entry>
+ <entry>
+ Dapper
+ </entry>
+ <entry>
+ 6.06 LTS
+ </entry>
+ <entry>
+ i386, amd64
+ </entry>
+ <entry>
+ T.B.D.
+ </entry>
+
+ </row>
+ <row condition="enterprise">
+ <entry>
+ Ubuntu
+ </entry>
+ <entry>
+ Hardy
+ </entry>
+ <entry>
+ 8.04 LTS
+ </entry>
+ <entry>
+ i386, amd64
+ </entry>
+ <entry>
+ T.B.D.
+ </entry>
+
+ </row>
+ <row condition="enterprise">
+ <entry>
+ Ubuntu
+ </entry>
+ <entry>
+ Karmic
+ </entry>
+ <entry>
+ 9.10
+ </entry>
+ <entry>
+ i386, amd64
+ </entry>
+ <entry>
+ T.B.D.
+ </entry>
+
+ </row>
+ <row>
+ <entry>
+ Ubuntu
+ </entry>
+ <entry>
+ Lucid
+ </entry>
+ <entry>
+ 10.04 LTS
+ </entry>
+ <entry>
+ i386, amd64
+ </entry>
+ <entry>
+ T.B.D.
+ </entry>
+
+ </row>
+ <row>
+ <entry>
+ Ubuntu
+ </entry>
+ <entry>
+ Maverick
+ </entry>
+ <entry>
+ 10.10
+ </entry>
+ <entry>
+ i386, amd64
+ </entry>
+ <entry>
+ T.B.D.
+ </entry>
+
+ </row>
+ <row condition="community">
+ <entry>
+ Ubuntu
+ </entry>
+ <entry>
+ Natty
+ </entry>
+ <entry>
+ -
+ </entry>
+ <entry>
+ i386, amd64
+ </entry>
+ <entry>
+ T.B.D.
+ </entry>
+
+ </row>
+
+ </tbody>
+
+ </tgroup>
+
+ </table>
+
+ </para>
+ <section id="sect-Community_Installation_Guide-Installation_with_APT_Packages-Debian">
+ <title>Debian</title>
+ <procedure>
+ <step>
+ <para>
+ For Kolab &PRODUCT_VERSION; software packages for Debian Squeeze, add the following two lines to <filename>/etc/apt/sources.list</filename>:
+ </para>
+ <para condition="community">
+
+<screen>deb http://mirror.kolabsys.com/pub/debian/kolab-&PRODUCT_VERSION;/ squeeze release updates
+deb-src http://mirror.kolabsys.com/pub/debian/kolab-&PRODUCT_VERSION;/ squeeze release updates</screen>
+
+ </para>
+ <para condition="enterprise">
+
+<screen>deb https://mirror.kolabsys.com/debian/kolab-&PRODUCT_VERSION;/ squeeze release updates
+deb-src https://mirror.kolabsys.com/debian/kolab-&PRODUCT_VERSION;/ squeeze release updates</screen>
+
+ </para>
+ <note>
+ <title>Updates in Testing Phase and Packages in Development</title>
+ <para>
+ Optionally, enable the <literal>updates-testing</literal> and <literal>development</literal> components for newer, but less stable packages.
+ </para>
+
+ </note>
+ <para>
+ For other versions of the Debian distribution, please replace <code>squeeze</code> with the corresponding distribution codename.
+ </para>
+ <important>
+ <title>Debian Volatile (Updates) Repositories</title>
+ <para>
+ It is critically important to consider also enabling the so-called volatile repository for your Debian version, to enable updates for components such as <application>clamav</application>.
+ </para>
+ <para>
+ To enable the volatile repository for Debian Lenny, include the following line in <filename>/etc/apt/sources.list</filename>:
+ </para>
+ <para>
+
+<screen>deb http://volatile.debian.org/debian-volatile stable/volatile main</screen>
+
+ </para>
+
+ </important>
+
+ </step>
+ <step>
+ <para>
+ To ensure the Kolab packages have priority over the Debian packages, such as must be the case for PHP as well as Cyrus IMAP, please make sure the APT preferences <emphasis>pin</emphasis> the mirror.kolabsys.com origin as a preferred source. Put the following in <filename>/etc/apt/preferences</filename>:
+ </para>
+ <para>
+
+<screen>Package: *
+Pin: origin mirror.kolabsys.com
+Pin-Priority: 501</screen>
+
+ </para>
+
+ </step>
+ <step condition="enterprise">
+ <para>
+ Import the GPG key with which the repository metadata is signed:
+ </para>
+ <para>
+
+<screen>$ <userinput>gpg --search squeeze-packages@kolabsys.com</userinput></screen>
+
+ </para>
+ <para>
+ For Debian Lenny, please replace <code>squeeze</code> with the corresponding distribution codename.
+ </para>
+
+ </step>
+ <step condition="enterprise">
+ <para>
+ For access to the Enterprise edition, you have been issued a SSL certificate by Kolab Systems. How to obtain, renew and use the SSL certificate to provide you with access to the Enterprise editions, please read <ulink url="https://support.kolabsys.com/Obtaining,_Renewing_and_Using_a_Client_SSL_Certificate" />.
+ </para>
+
+ </step>
+ <step>
+ <para>
+ Update the repository metadata:
+ </para>
+ <para>
+
+<screen># <userinput>apt-get update</userinput></screen>
+
+ </para>
+
+ </step>
+ <step>
+ <para>
+ Start the installation of the base package as follows:
+ </para>
+ <para>
+
+<screen># <userinput>aptitude install kolabd</userinput></screen>
+
+ </para>
+
+ </step>
+ <step>
+ <para>
+ When asked to confirm you want to install the package and its dependencies, press Enter.
+ </para>
+
+ </step>
+ <step condition="community">
+ <para>
+ 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>
+
+ </procedure>
+
+
+ </section>
+
+ <section id="sect-Community_Installation_Guide-Installation_with_APT_Packages-Ubuntu">
+ <title>Ubuntu</title>
+ <procedure>
+ <step>
+ <para>
+ For Kolab &PRODUCT_VERSION; software packages for Ubuntu Lucid, add the following two lines to <filename>/etc/apt/sources.list</filename>:
+ </para>
+ <para condition="community">
+
+<screen>deb http://mirror.kolabsys.com/pub/ubuntu/kolab-&PRODUCT_VERSION;/ lucid release updates
+deb-src http://mirror.kolabsys.com/pub/ubuntu/kolab-&PRODUCT_VERSION;/ lucid release updates</screen>
+
+ </para>
+ <para condition="enterprise">
+
+<screen>deb http://mirror.kolabsys.com/pub/ubuntu/kolab-&PRODUCT_VERSION;/ lucid release updates
+deb-src http://mirror.kolabsys.com/pub/ubuntu/kolab-&PRODUCT_VERSION;/ lucid release updates</screen>
+
+ </para>
+ <para>
+ For other versions of the Ubuntu distribution, please replace <code>lucid</code> with the corresponding distribution codename.
+ </para>
+
+ </step>
+ <step>
+ <para>
+ To ensure the Kolab packages have priority over the Ubuntu packages, such as must be the case for PHP as well as Cyrus IMAP, please make sure the APT preferences <emphasis>pin</emphasis> the mirror.kolabsys.com origin as a preferred source. Put the following in <filename>/etc/apt/preferences</filename>:
+ </para>
+ <para>
+
+<screen>Package: *
+Pin: origin mirror.kolabsys.com
+Pin-Priority: 501</screen>
+
+ </para>
+
+ </step>
+
+ </procedure>
+
+ <para condition="enterprise">
+ For access to the Enterprise edition, you have been issued a SSL certificate by Kolab Systems. How to obtain, renew and use the SSL certificate to provide you with access to the Enterprise editions, please read <ulink url="https://support.kolabsys.com/Obtaining,_Renewing_and_Using_a_Client_SSL_Certificate" />.
+ </para>
+
+ </section>
+
+ <section id="sect-Community_Installation_Guide-Installation_with_APT_Packages-Troubleshooting_the_APT_Package_Manager">
+ <title>Troubleshooting the APT Package Manager</title>
+ <section id="sect-Community_Installation_Guide-Troubleshooting_the_APT_Package_Manager-Broken_Packages">
+ <title>Broken Packages</title>
+ <para>
+ If you get an error similar to, for example:
+ </para>
+ <para>
+
+<screen>test90-1:~# apt-get install kolabd
+Reading package lists... Done
+Building dependency tree
+Reading state information... Done
+Some packages could not be installed. This may mean that you have
+requested an impossible situation or if you are using the unstable
+distribution that some required packages have not yet been created
+or been moved out of Incoming.
+The following information may help to resolve the situation:
+
+The following packages have unmet dependencies:
+ kolabd: Depends: postfix (&gt;= 2.4) but it is not going to be installed
+ Depends: postfix-ldap (&gt;= 2.4) but it is not going to be installed
+E: Broken packages</screen>
+
+ </para>
+ <para>
+ The error is not caused by broken packages, but a broken package manager that cannot install <application>exim</application> and <application>postfix</application> in parallel.
+ </para>
+ <formalpara id="form-Community_Installation_Guide-Broken_Packages-Solution">
+ <title>Solution</title>
+ <para>
+ First remove any non-postfix MTA you may have installed, which in a default Debian installation is probably <application>exim</application>.
+ </para>
+
+ </formalpara>
+ <para>
+ To remove <application>exim</application>, execute the following with superuser privileges:
+ </para>
+ <para>
+
+<screen># <userinput>apt-get remove exim4 exim4-base exim4-config exim4-daemon-light</userinput></screen>
+
+ </para>
+ <para>
+ Then continue installing Kolab:
+ </para>
+ <para>
+
+<screen># <userinput>aptitude install kolabd</userinput></screen>
+
+ </para>
+
+ </section>
+
+
+ </section>
+
</section>
@@ -461,16 +928,16 @@
<itemizedlist>
<listitem>
<para>
- <ulink condition="community" url="http://mirror.kolabsys.com/pub/redhat/kolab-2.4/el5/release/i386/repoview/kolab-2.4-community-release.html">Enterprise Linux 5 (FIXME: page missing)</ulink> <ulink condition="enterprise" url="https://mirror.kolabsys.com/redhat/kolab-2.4/el5/release/i386/repoview/kolab-2.4-enterprise-release.html">Enterprise Linux 5 (FIXME: page missing) </ulink>
+ <ulink condition="community" url="http://mirror.kolabsys.com/pub/redhat/kolab-2.4/el5/release/i386/repoview/kolab-2.4-community-release.html">Enterprise Linux 5</ulink> <ulink condition="enterprise" url="https://mirror.kolabsys.com/redhat/kolab-2.4/el5/release/i386/repoview/kolab-2.4-enterprise-release.html">Enterprise Linux 5</ulink>
</para>
<para>
- <ulink condition="community" url="http://mirror.kolabsys.com/pub/redhat/kolab-2.4/el5/development/x86_64/">Enterprise Linux 5</ulink> <ulink condition="enterprise" url="https://mirror.kolabsys.com/redhat/kolab-2.4/el5/release/i386/repoview/kolab-2.4-enterprise-release.html">Enterprise Linux 5 </ulink>
+ <ulink condition="community" url="http://mirror.kolabsys.com/pub/redhat/kolab-2.4/el5/development/x86_64/">Enterprise Linux 5</ulink> <ulink condition="enterprise" url="https://mirror.kolabsys.com/redhat/kolab-2.4/el5/release/i386/repoview/kolab-2.4-enterprise-release.html">Enterprise Linux 5</ulink>
</para>
</listitem>
<listitem>
<para>
- <ulink condition="community" url="http://mirror.kolabsys.com/pub/redhat/kolab-2.4/el6/release/i386/repoview/kolab-2.4-community-release.html">Enterprise Linux 6 (FIXME: page missing)</ulink> <ulink condition="enterprise" url="https://mirror.kolabsys.com/redhat/kolab-2.4/el6/release/i386/repoview/kolab-2.4-enterprise-release.html">Enterprise Linux 6 (FIXME: page missing) </ulink>
+ <ulink condition="community" url="http://mirror.kolabsys.com/pub/redhat/kolab-2.4/el6/release/i386/repoview/kolab-2.4-community-release.html">Enterprise Linux 6</ulink> <ulink condition="enterprise" url="https://mirror.kolabsys.com/redhat/kolab-2.4/el6/release/i386/repoview/kolab-2.4-enterprise-release.html">Enterprise Linux 6</ulink>
</para>
</listitem>