diff --git a/source/installation-guide/index.rst b/source/installation-guide/index.rst index dbc2cbf9..f1ec39fa 100644 --- a/source/installation-guide/index.rst +++ b/source/installation-guide/index.rst @@ -1,52 +1,61 @@ .. _install: ================== Installation Guide ================== Before you install Kolab Groupware ================================== .. toctree:: :maxdepth: 2 preparing-the-system overview Installing the Kolab Groupware Solution ======================================= -Install the Kolab Groupware solution for either of the following -platforms: +Install the latest stable version of the Kolab Groupware solution for either +of the following platforms: .. toctree:: :maxdepth: 1 centos-7 rhel-7 +If your personal favorite is not listed, please read the +"`Support Your Distribution, or else ... `_" +blog article, and follow the instructions. + +.. rubric:: Bleeding Edge + +.. toctree:: + :maxdepth: 1 + + winterfell/index + .. rubric:: Older versions of Kolab Groupware .. toctree:: :maxdepth: 1 - kolab-3.4/index - kolab-3.3/index kolab-14/index kolab-13/index Installing the Kolab Desktop Client =================================== The Kolab Desktop Client is maintained by community volunteers in their spare time. It has a fast release cycle and is in steady movement. If things do not -work as expected, please consider `contributing`_. +work as expected, please consider contributing. .. toctree:: :maxdepth: 1 kontact-fedora kontact-windows diff --git a/source/installation-guide/kolab-13/index.rst b/source/installation-guide/kolab-13/index.rst index 7525d0d8..511ce703 100644 --- a/source/installation-guide/kolab-13/index.rst +++ b/source/installation-guide/kolab-13/index.rst @@ -1,12 +1,15 @@ -Installation Instructions for Kolab 13 -====================================== +.. _installation-guide-kolab-enterprise-13: + +================================================= +Installation Instructions for Kolab Enterprise 13 +================================================= .. warning:: Kolab 13 is outdated and the latest release is Kolab 16. .. toctree:: :maxdepth: 1 :glob: * diff --git a/source/installation-guide/kolab-14/index.rst b/source/installation-guide/kolab-14/index.rst index 335e4fe8..c0052550 100644 --- a/source/installation-guide/kolab-14/index.rst +++ b/source/installation-guide/kolab-14/index.rst @@ -1,13 +1,15 @@ -====================================== -Installation Instructions for Kolab 14 -====================================== +.. _installation-guide-kolab-enterprise-14: + +================================================= +Installation Instructions for Kolab Enterprise 14 +================================================= .. WARNING:: Kolab 14 is outdated and the latest release is Kolab 16. .. toctree:: :maxdepth: 1 :glob: * diff --git a/source/installation-guide/winterfell/centos-7.rst b/source/installation-guide/winterfell/centos-7.rst new file mode 100644 index 00000000..61f57d13 --- /dev/null +++ b/source/installation-guide/winterfell/centos-7.rst @@ -0,0 +1,48 @@ +.. _installation-guide-winterfell-centos-7: + +============================================ +Installation of Kolab Winterfell on CentOS 7 +============================================ + +.. WARNING:: + + Kolab Winterfell eats babies, for breakfast. There is potential data-loss included. + +1. Install the :term:`EPEL` repository: + + .. parsed-literal:: + + # :command:`rpm -Uhv https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm` + +2. Install the Kolab Groupware repository configuration: + + .. parsed-literal:: + + # :command:`cd /etc/yum.repos.d/` + # :command:`wget http://obs.kolabsys.com/repositories/Kolab:/Winterfell/CentOS_7/Kolab:Winterfell.repo` + +3. Import the GPG key used to sign the packages: + + .. parsed-literal:: + + # :command:`rpm --import https://ssl.kolabsys.com/community.asc` + +4. Install the **yum-plugin-priorities** package: + + .. parsed-literal:: + + # :command:`yum install yum-plugin-priorities` + +5. Make sure that the packages from the Kolab repositories have a higher priority than eg. the Epel packages: + + .. parsed-literal:: + + # :command:`for f in /etc/yum.repos.d/Kolab*.repo; do echo "priority = 60" >> $f; done` + +6. Install Kolab Groupware: + + .. parsed-literal:: + + # :command:`yum install kolab` + +Continue to :ref:`install-setup-kolab`. diff --git a/source/installation-guide/winterfell/debian-8.rst b/source/installation-guide/winterfell/debian-8.rst new file mode 100644 index 00000000..34558e42 --- /dev/null +++ b/source/installation-guide/winterfell/debian-8.rst @@ -0,0 +1,48 @@ +.. _installation-winterfell-debian-8: + +============================================ +Installation of Kolab Winterfell on Debian 8 +============================================ + +.. WARNING:: + + Kolab Winterfell eats babies, for breakfast. There is potential data-loss included. + +1. Add the following two lines to ``/etc/apt/sources.list.d/kolab.list``: + + .. parsed-literal:: + + deb http://obs.kolabsys.com/repositories/Kolab:/Winterfell/Debian_8.0/ ./ + deb-src http://obs.kolabsys.com/repositories/Kolab:/Winterfell/Debian_8.0/ ./ + +2. Import the GPG key used to sign the packages: + + .. parsed-literal:: + + # :command:`wget -q -O- https://ssl.kolabsys.com/community.asc | apt-key add -` + +3. 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 pin the obs.kolabsys.com origin as a preferred source. + + Put the following in ``/etc/apt/preferences.d/kolab``: + + .. parsed-literal:: + + Package: * + Pin: origin obs.kolabsys.com + Pin-Priority: 501 + +4. Update the repository metadata: + + .. parsed-literal:: + + # :command:`apt-get update` + +5. Start the installation of the base package as follows: + + .. parsed-literal:: + + # :command:`aptitude -y install kolab` + +Continue to :ref:`install-setup-kolab`. diff --git a/source/installation-guide/winterfell/fedora-23.rst b/source/installation-guide/winterfell/fedora-23.rst new file mode 100644 index 00000000..75a11d3d --- /dev/null +++ b/source/installation-guide/winterfell/fedora-23.rst @@ -0,0 +1,36 @@ +.. _installation-guide-winterfell-fedora-23: + +============================================= +Installation of Kolab Winterfell on Fedora 23 +============================================= + +.. WARNING:: + + Kolab Winterfell eats babies, for breakfast. There is potential data-loss included. + +1. Install the Kolab Groupware repository configuration: + + .. parsed-literal:: + + # :command:`cd /etc/yum.repos.d/` + # :command:`wget http://obs.kolabsys.com/repositories/Kolab:/Winterfell/Fedora_23/Kolab:Winterfell.repo` + +2. Import the GPG key used to sign the packages: + + .. parsed-literal:: + + # :command:`rpm --import https://ssl.kolabsys.com/community.asc` + +3. Make sure that the packages from the Kolab repositories have a higher priority than the stock repositories: + + .. parsed-literal:: + + # :command:`for f in /etc/yum.repos.d/Kolab*.repo; do echo "priority = 60" >> $f; done` + +4. Install Kolab Groupware: + + .. parsed-literal:: + + # :command:`yum install kolab` + +Continue to :ref:`install-setup-kolab`. diff --git a/source/installation-guide/winterfell/index.rst b/source/installation-guide/winterfell/index.rst new file mode 100644 index 00000000..c36139c4 --- /dev/null +++ b/source/installation-guide/winterfell/index.rst @@ -0,0 +1,25 @@ +.. _installation-guide-winterfell: + +=========================== +Installing Kolab Winterfell +=========================== + +A word of caution is justified. Please, pretty please, puppy-face +and all that included: + + **Kolab Winterfell eats babies, for breakfast.** + +We expect consumers of Winterfell to be experienced contributors, or #YOLO believers. + +To clarify, this means that while Winterfell is tested through continuous +integration before updates land in the repositories, there is **NO** guarantee on +current CI dealing with technical debt appropriately, nor a functional upgrade path +having been provided. + +You've been warned. + +.. toctree:: + :maxdepth: 1 + :glob: + + * diff --git a/source/installation-guide/winterfell/rhel-7.rst b/source/installation-guide/winterfell/rhel-7.rst new file mode 100644 index 00000000..5c568d56 --- /dev/null +++ b/source/installation-guide/winterfell/rhel-7.rst @@ -0,0 +1,48 @@ +.. _installation-guide-winterfell-rhel-7: + +============================================================== +Installation of Kolab Winterfell on Red Hat Enterprise Linux 7 +============================================================== + +.. WARNING:: + + Kolab Winterfell eats babies, for breakfast. There is potential data-loss included. + +1. Install the :term:`EPEL` repository: + + .. parsed-literal:: + + # :command:`rpm -Uhv https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm` + +2. Install the Kolab Groupware repository configuration: + + .. parsed-literal:: + + # :command:`cd /etc/yum.repos.d/` + # :command:`wget http://obs.kolabsys.com/repositories/Kolab:/Winterfell/RHEL_7/Kolab:Winterfell.repo` + +3. Import the GPG key used to sign the packages: + + .. parsed-literal:: + + # :command:`rpm --import https://ssl.kolabsys.com/community.asc` + +4. Install the **yum-plugin-priorities** package: + + .. parsed-literal:: + + # :command:`yum install yum-plugin-priorities` + +5. Make sure that the packages from the Kolab repositories have a higher priority than eg. the :term:`EPEL` packages: + + .. parsed-literal:: + + # :command:`for f in /etc/yum.repos.d/Kolab*.repo; do echo "priority = 60" >> $f; done` + +6. Install Kolab Groupware: + + .. parsed-literal:: + + # :command:`yum --enablerepo=rhel-7-server-optional-rpms install kolab` + +Continue to :ref:`install-setup-kolab`. diff --git a/source/installation-guide/winterfell/ubuntu-14.04.rst b/source/installation-guide/winterfell/ubuntu-14.04.rst new file mode 100644 index 00000000..5aeb9735 --- /dev/null +++ b/source/installation-guide/winterfell/ubuntu-14.04.rst @@ -0,0 +1,48 @@ +.. _installation-winterfell-ubuntu-14.04: + +================================================ +Installation of Kolab Winterfell on Ubuntu 14.04 +================================================ + +.. WARNING:: + + Kolab Winterfell eats babies, for breakfast. There is potential data-loss included. + +1. Add the following two lines to ``/etc/apt/sources.list.d/kolab.list``: + + .. parsed-literal:: + + deb http://obs.kolabsys.com/repositories/Kolab:/Winterfell/Ubuntu_14.04/ ./ + deb-src http://obs.kolabsys.com/repositories/Kolab:/Winterfell/Ubuntu_14.04/ ./ + +2. Import the GPG key used to sign the packages: + + .. parsed-literal:: + + # :command:`wget -q -O- https://ssl.kolabsys.com/community.asc | apt-key add -` + +3. 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 pin the obs.kolabsys.com origin as a preferred source. + + Put the following in ``/etc/apt/preferences.d/kolab``: + + .. parsed-literal:: + + Package: * + Pin: origin obs.kolabsys.com + Pin-Priority: 501 + +4. Update the repository metadata: + + .. parsed-literal:: + + # :command:`apt-get update` + +5. Start the installation of the base package as follows: + + .. parsed-literal:: + + # :command:`aptitude -y install kolab` + +Continue to :ref:`install-setup-kolab`. diff --git a/source/installation-guide/winterfell/ubuntu-16.04.rst b/source/installation-guide/winterfell/ubuntu-16.04.rst new file mode 100644 index 00000000..8f7cbefb --- /dev/null +++ b/source/installation-guide/winterfell/ubuntu-16.04.rst @@ -0,0 +1,48 @@ +.. _installation-winterfell-ubuntu-16.04: + +================================================ +Installation of Kolab Winterfell on Ubuntu 16.04 +================================================ + +.. WARNING:: + + Kolab Winterfell eats babies, for breakfast. There is potential data-loss included. + +1. Add the following two lines to ``/etc/apt/sources.list.d/kolab.list``: + + .. parsed-literal:: + + deb http://obs.kolabsys.com/repositories/Kolab:/Winterfell/Ubuntu_16.04/ ./ + deb-src http://obs.kolabsys.com/repositories/Kolab:/Winterfell/Ubuntu_16.04/ ./ + +2. Import the GPG key used to sign the packages: + + .. parsed-literal:: + + # :command:`wget -q -O- https://ssl.kolabsys.com/community.asc | apt-key add -` + +3. 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 pin the obs.kolabsys.com origin as a preferred source. + + Put the following in ``/etc/apt/preferences.d/kolab``: + + .. parsed-literal:: + + Package: * + Pin: origin obs.kolabsys.com + Pin-Priority: 501 + +4. Update the repository metadata: + + .. parsed-literal:: + + # :command:`apt-get update` + +5. Start the installation of the base package as follows: + + .. parsed-literal:: + + # :command:`aptitude -y install kolab` + +Continue to :ref:`install-setup-kolab`.