diff options
author | Jeroen van Meeuwen (Kolab Systems) <vanmeeuwen@kolabsys.com> | 2012-02-29 17:14:39 (GMT) |
---|---|---|
committer | Jeroen van Meeuwen (Kolab Systems) <vanmeeuwen@kolabsys.com> | 2012-02-29 17:14:39 (GMT) |
commit | 8b037880edc587883cb2ff72e682ddcdadaf2055 (patch) | |
tree | 945ec7ad731aff05686181861f01442eeb32c73f | |
parent | 72a17bfaac9168583bb1ceae4199dce6b72cdc95 (diff) | |
download | kolab-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-x | Installation_Guide/en-US/Kolab_Server_Installation.xml | 475 |
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 (>= 2.4) but it is not going to be installed + Depends: postfix-ldap (>= 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> |