2 commits - Installation_Guide/en-US

Jeroen van Meeuwen vanmeeuwen at kolabsys.com
Wed Feb 29 18:15:14 CET 2012


 Installation_Guide/en-US/Kolab_Server_Installation.xml |  478 ++++++++++++++++-
 1 file changed, 473 insertions(+), 5 deletions(-)

New commits:
commit 8b037880edc587883cb2ff72e682ddcdadaf2055
Author: Jeroen van Meeuwen (Kolab Systems) <vanmeeuwen at kolabsys.com>
Date:   Wed Feb 29 17:14:39 2012 +0000

    Restore the section on APT package repositories to configure and installation
    Remove the FIXME on pages missing since repoview is back in business

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 at 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>


commit 72a17bfaac9168583bb1ceae4199dce6b72cdc95
Author: Jeroen van Meeuwen (Kolab Systems) <vanmeeuwen at kolabsys.com>
Date:   Sat Feb 25 10:48:26 2012 +0000

    Correct the name of the package to install

diff --git a/Installation_Guide/en-US/Kolab_Server_Installation.xml b/Installation_Guide/en-US/Kolab_Server_Installation.xml
index 9fd0236..0b2c583 100755
--- a/Installation_Guide/en-US/Kolab_Server_Installation.xml
+++ b/Installation_Guide/en-US/Kolab_Server_Installation.xml
@@ -576,6 +576,7 @@ kolab-&PRODUCT_VERSION;-updates-testing-source
                         <para>
                             This is necessary only for Enterprise Linux 5.
                         </para>
+
                     </note>
                     <procedure id="proc-Community_Installation_Guide-Using_yum_priorities_to_Avoid_Package_Conflicts-Installing_and_Configuring_YUM_priorities">
                         <title>Installing and Configuring YUM priorities</title>
@@ -615,7 +616,7 @@ kolab-&PRODUCT_VERSION;-updates-testing-source
         <title>Full default installation on a single server</title>
         <para>
             If you want a default installation with all components on a single server, pleas run:
-<screen># <userinput>yum install kolab-groupware-server</userinput></screen>
+<screen># <userinput>yum install kolab</userinput></screen>
             This meta-package will install all needed components.
         </para>
         <para>





More information about the commits mailing list