4 commits - Common_Content/en-US .gitignore Installation_Guide/en-US
Jeroen van Meeuwen
vanmeeuwen at kolabsys.com
Fri Jan 21 14:56:24 CET 2011
.gitignore | 9
Common_Content/en-US/sect-About_Kolab_Groupware.xml | 68 ++
Common_Content/en-US/sect-Feedback.xml | 77 ++
Common_Content/en-US/sect-Supported_Platforms_and_System_Requirements.xml | 82 +++
Installation_Guide/en-US/Bootstrapping_the_Kolab_Installation.xml | 119 ++++
Installation_Guide/en-US/Obtaining_Kolab_Software.xml | 264 ++++++++--
6 files changed, 575 insertions(+), 44 deletions(-)
New commits:
commit bdedd36b0182bb00d1a9066cfaeeeba5db7a3e1a
Author: Jeroen van Meeuwen (Kolab Systems) <vanmeeuwen at kolabsys.com>
Date: Fri Jan 21 13:55:44 2011 +0000
Mention the ports being check for listening daemons, in preparation of bootstrapping Kolab
diff --git a/Installation_Guide/en-US/Bootstrapping_the_Kolab_Installation.xml b/Installation_Guide/en-US/Bootstrapping_the_Kolab_Installation.xml
index aabf195..78f2e53 100644
--- a/Installation_Guide/en-US/Bootstrapping_the_Kolab_Installation.xml
+++ b/Installation_Guide/en-US/Bootstrapping_the_Kolab_Installation.xml
@@ -15,6 +15,125 @@
</para>
</important>
+ <section id="sect-Installation_Guide-Bootstrapping_the_Kolab_Installation-Preperating_the_System_for_Bootstrapping">
+ <title>Preperating the System for Bootstrapping</title>
+ <para>
+ Preparing the system for bootstrapping it requires any services that the Kolab Groupware is going to create, maintain and/or manage need to be shut down prior to bootstrapping.
+ </para>
+ <para>
+ The following ports are being checked for running services, in numeric order:
+ </para>
+ <para>
+ <orderedlist>
+ <listitem>
+ <para>
+ 25
+ </para>
+
+ </listitem>
+ <listitem>
+ <para>
+ 80
+ </para>
+
+ </listitem>
+ <listitem>
+ <para>
+ 110
+ </para>
+
+ </listitem>
+ <listitem>
+ <para>
+ 143
+ </para>
+
+ </listitem>
+ <listitem>
+ <para>
+ 443
+ </para>
+
+ </listitem>
+ <listitem>
+ <para>
+ 389
+ </para>
+
+ </listitem>
+ <listitem>
+ <para>
+ 465
+ </para>
+
+ </listitem>
+ <listitem>
+ <para>
+ 587
+ </para>
+
+ </listitem>
+ <listitem>
+ <para>
+ 636
+ </para>
+
+ </listitem>
+ <listitem>
+ <para>
+ 993
+ </para>
+
+ </listitem>
+ <listitem>
+ <para>
+ 995
+ </para>
+
+ </listitem>
+ <listitem>
+ <para>
+ 2000
+ </para>
+
+ </listitem>
+ <listitem>
+ <para>
+ 2003
+ </para>
+
+ </listitem>
+ <listitem>
+ <para>
+ 9999
+ </para>
+
+ </listitem>
+ <listitem>
+ <para>
+ 10024
+ </para>
+
+ </listitem>
+ <listitem>
+ <para>
+ 10025
+ </para>
+
+ </listitem>
+ <listitem>
+ <para>
+ 10026
+ </para>
+
+ </listitem>
+
+ </orderedlist>
+
+ </para>
+
+ </section>
+
<section id="sect-Installation_Guide-Bootstrapping_the_Kolab_Installation-New_Kolab_Environment">
<title>New Kolab Environment</title>
<para>
commit a729ddc89fda7dde9440b3ce007d89d64ed9b353
Author: Jeroen van Meeuwen (Kolab Systems) <vanmeeuwen at kolabsys.com>
Date: Fri Jan 21 13:55:06 2011 +0000
Expand on the installation procedure, adding the instructions to configure/enable EPEL, and disable the CentOS addons and extras repositories
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>
commit 1c2cbc9f40e8f82946444a5a7fa4eeb6cef209af
Author: Jeroen van Meeuwen (Kolab Systems) <vanmeeuwen at kolabsys.com>
Date: Fri Jan 21 11:01:13 2011 +0000
Correct .gitignore
diff --git a/.gitignore b/.gitignore
index bfc724c..8bebb00 100644
--- a/.gitignore
+++ b/.gitignore
@@ -1,11 +1,10 @@
*/tmp/
-!Common_Content/*/Author_Group.xml
-!Common_Content/*/sect-About_Kolab_Groupware.xml
-!Common_Content/*/sect-Feedback.xml
-!Common_Content/*/sect-Supported_Platforms_and_System_Requirements.xml
*/*/Author_Group.xml
*/*/sect-About_Kolab_Groupware.xml
*/*/sect-Feedback.xml
*/*/sect-Supported_Platforms_and_System_Requirements.xml
-
+!Common_Content/*/Author_Group.xml
+!Common_Content/*/sect-About_Kolab_Groupware.xml
+!Common_Content/*/sect-Feedback.xml
+!Common_Content/*/sect-Supported_Platforms_and_System_Requirements.xml
builds/
commit 48b3fbffd5b6f598a80cde7386a95cddf49bc69b
Author: Jeroen van Meeuwen (Kolab Systems) <vanmeeuwen at kolabsys.com>
Date: Fri Jan 21 11:00:51 2011 +0000
Add the Common_Content files (they're essential for building, you know)
diff --git a/Common_Content/en-US/sect-About_Kolab_Groupware.xml b/Common_Content/en-US/sect-About_Kolab_Groupware.xml
new file mode 100644
index 0000000..212023a
--- /dev/null
+++ b/Common_Content/en-US/sect-About_Kolab_Groupware.xml
@@ -0,0 +1,68 @@
+<?xml version='1.0' encoding='utf-8' ?>
+<!DOCTYPE section 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;
+]>
+<section id="sect-About_Kolab_Groupware">
+ <title>About Kolab Groupware</title>
+ <para>
+ Kolab is a Groupware Solution for Emails, Appointments, Contacts and more. It supports mixed client environments (Outlook/KDE) because of an open storage format. Any email client speaking standard protocols can be served.
+ </para>
+ <section id="sect-About_Kolab_Groupware-Free_Software_Components">
+ <title>Free Software Components</title>
+ <para>
+ TODO: Come on, be a little more verbose...
+ </para>
+ <section id="sect-Free_Software_Components-This_documentation">
+ <title>This documentation</title>
+ <para>
+ Describe how this documentation can be modified to custom, internal documentation
+ </para>
+
+ </section>
+
+
+ </section>
+
+ <section id="sect-About_Kolab_Groupware-Kolab_Groupware_Flavors">
+ <title>Kolab Groupware Flavors</title>
+ <para>
+ Kolab Groupware comes in two major flavors:
+ </para>
+ <para>
+ <orderedlist>
+ <listitem>
+ <formalpara id="form-Kolab_Groupware_Flavors-Kolab_Vanilla">
+ <title>Kolab (<emphasis>Vanilla</emphasis>)</title>
+ <para>
+ The vanilla flavor of Kolab is ideally suited for general purpose Groupware systems in which no specialist features are required.
+ </para>
+
+ </formalpara>
+
+ </listitem>
+ <listitem>
+ <formalpara id="form-Kolab_Groupware_Flavors-Hosted_Kolab">
+ <title>Hosted Kolab</title>
+ <para>
+ Hosted Kolab is the flavor targeted specifically at hosting providers (ISP, ASP, Cloud) offering Kolab Groupware environments to multiple customers, possibly through multiple resellers.
+ </para>
+
+ </formalpara>
+
+ </listitem>
+
+ </orderedlist>
+
+ </para>
+ <para>
+ Furthermore, the Kolab software are divided in a community version, and an enterprise version. The community version naturally moves forward a little faster and is subject to change a lot more so then the enterprise version. The community version of a product series will only become available as an enterprise version after thorough Quality Assurance and Certification of partner products.
+ </para>
+
+ </section>
+
+ <xi:include href="sect-Supported_Platforms_and_System_Requirements.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+
+</section>
+
+
diff --git a/Common_Content/en-US/sect-Feedback.xml b/Common_Content/en-US/sect-Feedback.xml
new file mode 100644
index 0000000..b160dfd
--- /dev/null
+++ b/Common_Content/en-US/sect-Feedback.xml
@@ -0,0 +1,77 @@
+<?xml version='1.0' encoding='utf-8' ?>
+<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd">
+<section lang="en-US" id="sect-Feedback">
+ <title>Feedback</title>
+ <indexterm>
+ <primary>feedback</primary>
+ <secondary>contact information for this manual</secondary>
+
+ </indexterm>
+ <para>
+ We value feedback on our software as well as our documentation. Please find ways to contact us in this section.
+ </para>
+
+ <section id="sect-Feedback-Reporting_Bugs_in_Kolab">
+ <title>Reporting Bugs in Kolab</title>
+ <para>
+ Bug reports can be logged in our <ulink url="https://bugzilla.kolabsys.com">Bugzilla issue tracker</ulink>. Please bear in mind registration is required.
+ </para>
+ <para>
+ When reporting a bug, please prepare to provide the following information;
+ </para>
+ <para>
+ <itemizedlist>
+ <listitem>
+ <para>
+ Your platform, and if applicable, your distribution and the distribution version.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ The version(s) of the Kolab component(s) you are using.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ If a custom version is used, any options that may have specified during the build process.
+ </para>
+ </listitem>
+ </itemizedlist>
+ </para>
+ <para>
+ provide some text on logging a new ticket in our bugzilla, information to provide, etc. Possibly mention the life cycle of a product version series.
+ </para>
+ </section>
+
+ <section id="sect-Feedback-Mailing_Lists">
+ <title>Mailing Lists</title>
+ <para>
+ For users of Kolab software, we run a public mailing list at <ulink url="https://lists.kolab.org/mailman/listinfo/kolab-users" />. To subscribe to the list, either click the aforementioned link and fill out the information requested, or send an email to <ulink url="mailto:kolab-users-subscribe at kolab.org">kolab-users-subscribe at kolab.org</ulink>.
+ </para>
+
+ <formalpara>
+ <title>Development Mailing List</title>
+ <para>
+ For developers of Kolab software, as well as general discussion on bugs and patches, we run a public mailing list at <ulink url="https://lists.kolab.org/mailman/listinfo/kolab-devel" />. To subscribe to the list and fill out the information requested, or send an email to <ulink url="mailto:kolab-devel-subscribe at kolab.org">kolab-devel-subscribe at kolab.org</ulink>.
+ </para>
+ </formalpara>
+
+ <section id="sect-Feedback-Mailing_Lists-Archives">
+ <title>Archives</title>
+ <para>
+ The archives of both the user support and development discussion mailing list are available through web archives.
+ </para>
+ </section>
+
+ </section>
+
+ <section id="sect-Feedback-IRC">
+ <title>IRC</title>
+ <para>
+ Refer to irc://irc.freenode.net/kolab here.
+ </para>
+ </section>
+
+</section>
+
+
diff --git a/Common_Content/en-US/sect-Supported_Platforms_and_System_Requirements.xml b/Common_Content/en-US/sect-Supported_Platforms_and_System_Requirements.xml
new file mode 100644
index 0000000..b27c32f
--- /dev/null
+++ b/Common_Content/en-US/sect-Supported_Platforms_and_System_Requirements.xml
@@ -0,0 +1,82 @@
+<?xml version='1.0' encoding='utf-8' ?>
+<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
+<!ENTITY % BOOK_ENTITIES SYSTEM "Deployment_Guide.ent">
+%BOOK_ENTITIES;
+]>
+<section id="sect-Supported_Platforms_and_System_Requirements">
+ <title>Supported Platforms and System Requirements</title>
+ <para>
+ Kolab Groupware is supported on the following platforms;
+ </para>
+ <para>
+ <itemizedlist>
+ <listitem>
+ <para>
+ All reasonably recent versions of Linux<footnote> <para>
+ By reasonably recent versions of Linux, we intend to indicate the Cyrus project can keep up with the latest distribution release ear-marked stable.
+ </para>
+ </footnote>, including but not limited to the following distributions, in no particular order other then alphabetic;
+ </para>
+ <para>
+ <itemizedlist>
+ <listitem>
+ <para>
+ <ulink url="http://centos.org">CentOS</ulink>
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <ulink url="http://debian.org">Debian</ulink>
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <ulink url="http://fedoraproject.org">Fedora</ulink>
+ </para>
+ </listitem>
+<!--
+ <listitem>
+ <para>
+ <ulink url="http://gentoo.org">Gentoo</ulink>
+ </para>
+ </listitem>
+-->
+<!--
+ <listitem>
+ <para>
+ <ulink url="http://opensuse.org">openSUSE</ulink>
+ </para>
+ </listitem>
+-->
+ <listitem>
+ <para>
+ <ulink url="http://redhat.com">Red Hat Enterprise Linux</ulink>
+ </para>
+ </listitem>
+<!--
+ <listitem>
+ <para>
+ <ulink url="http://www.novell.com/linux">SUSE Linux</ulink>
+ </para>
+ </listitem>
+-->
+ </itemizedlist>
+ </para>
+ <para>
+ Should your Linux distribution not be listed here, please refer to <xref linkend="sect-Feedback" /> for ways of contacting the Kolab Development team.
+ </para>
+ </listitem>
+<!--
+ <listitem>
+ <para>
+ Solaris
+ </para>
+ </listitem>
+-->
+ </itemizedlist>
+ </para>
+ <remark>
+ Obviously, the list is not complete
+ </remark>
+
+</section>
\ No newline at end of file
More information about the commits
mailing list