diff --git a/source/installation-guide/kolab-14/debian-7-enterprise-14.rst b/source/installation-guide/kolab-14/debian-7-enterprise-14.rst --- a/source/installation-guide/kolab-14/debian-7-enterprise-14.rst +++ b/source/installation-guide/kolab-14/debian-7-enterprise-14.rst @@ -4,20 +4,23 @@ Installation of Kolab Enterprise 14 on Debian 7 (Wheezy) ======================================================== -1. Install the **apt-transport-https** package: +1. As with any Kolab installation, it is essential that the host has a FQDN. + + +2. Install the **apt-transport-https** package: .. parsed-literal:: # :command:`aptitude -y install apt-transport-https` -2. Add the following two lines to ``/etc/apt/sources.list.d/kolab.list``: +3. Add the following two lines to ``/etc/apt/sources.list.d/kolab.list``: .. parsed-literal:: - deb https://mirror.kolabsys.com/debian/kolab-14/ wheezy release updates - deb-src https://mirror.kolabsys.com/debian/kolab-14/ wheezy release updates + deb https://mirror.kolabenterprise.com/debian/kolab-14/ wheezy release updates + deb-src https://mirror.kolabenterprise.com/debian/kolab-14/ wheezy release updates -3. To ensure the Kolab packages have priority over the Debian packages, such as +4. 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 mirror.kolabsys.com origin as a preferred source. @@ -26,12 +29,44 @@ .. parsed-literal:: Package: * - Pin: origin mirror.kolabsys.com + Pin: origin mirror.kolabenterprise.com Pin-Priority: 501 -4. Install the client certificate and certificate authority files: +5. Install the client certificate and certificate authority files: + + A. Remove the passphrase from the SSL certificate key: + + .. parsed-literal:: + + # :command:`openssl rsa -in /path/to/private.key \\ + -out /path/to/private.key.nopass` + + B. Concatenate the certificate file and the new key file without + passphrase: + + .. parsed-literal:: + + # :command:`cat /path/to/public.crt /path/to/private.key.nopass \\ + > /path/to/mirror.kolabsys.com.client.pem` + + C. Place the file :file:`mirror.kolabsys.client.pem` in + :file:`/etc/apt/certs/`. + + D. Download the kolabenterprice mirror certificate: + + .. parsed-literal:: + + # :command:`cd /etc/apt/certs/` + # :command:`wget https://ssl.kolabsys.com/mirror.kolabenterprise.com.ca.cert` + + E. Correct the permissions on the private key: + + .. parsed-literal:: + + # :command:`chown root:root /etc/apt/certs/mirror.kolabsys.com.client.pem` + # :command:`chmod 640 /etc/apt/certs/mirror.kolabsys.com.client.pem -5. Configure **APT** to use the certificates installed in step 4 by +6. Configure **APT** to use the certificates installed in step 4 by creating a file ``/etc/apt/apt.conf.d/71kolab`` with the following contents: @@ -39,10 +74,10 @@ Acquire { https { - mirror.kolabsys.com { - Verify-Peer "false"; - Verify-Host "false"; - CaInfo "/etc/apt/certs/mirror.kolabsys.com.ca.cert"; + mirror.kolabenterprise.com { + Verify-Peer "true"; + Verify-Host "true"; + CaInfo "/etc/apt/certs/mirror.kolabenterprise.com.ca.cert"; SslCert "/etc/apt/certs/mirror.kolabsys.com.client.pem"; SslKey "/etc/apt/certs/mirror.kolabsys.com.client.pem"; @@ -50,18 +85,18 @@ }; }; -6. Update the repository metadata: +7. Update the repository metadata: .. parsed-literal:: # :command:`apt-get update` -7. Start the installation of the base package as follows: +8. Start the installation of the base package as follows: .. parsed-literal:: # :command:`aptitude install kolab` -8. When asked to confirm you want to install the package and its dependencies, press Enter. +9. When asked to confirm you want to install the package and its dependencies, press Enter. Continue to :ref:`installation-guide-setup-kolab`. diff --git a/source/upgrade-guide/index.rst b/source/upgrade-guide/index.rst --- a/source/upgrade-guide/index.rst +++ b/source/upgrade-guide/index.rst @@ -8,6 +8,7 @@ .. toctree:: :maxdepth: 1 + kolab-16 kolab-enterprise-14 .. toctree:: diff --git a/source/upgrade-guide/kolab-16.rst b/source/upgrade-guide/kolab-16.rst new file mode 100644 --- /dev/null +++ b/source/upgrade-guide/kolab-16.rst @@ -0,0 +1,119 @@ +================================== +Upgrade Notes from Kolab 3.4 to 16 +================================== + +The purpose of this document is, to describe the procedure of upgrading a Kolab Goupware installation from a default installed Kolab 3.4 (last "community verison") to Kolab 16. + + +Upgrade Procedure +================= + +#. Install the Kolab Groupware repository configuration: + + .. parsed-literal:: + + # :command:`cd /etc/yum.repos.d/` + # :command:`wget http://obs.kolabsys.com/repositories/Kolab:/16/CentOS_7/Kolab:16.repo` + +#. Remove the existing Kolab 3.4 repositories: + + .. parsed-literal:: + + # :command:`rm Kolab\\:3.4.repo` + # :command:`rm Kolab\\:3.4\\:Updates.repo` + +#. 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` + + +#. Replace php-mysql with php-mysqlnd: + + .. parsed-literal:: + + # :command:`yum shell` + > :command:`remove php-mysql` + > :command:`install php-mysqlnd` + > :command:`run` + (Confirm as requested) + > :command:`exit` + +#. Update all: + + .. parsed-literal:: + + # :command:`yum -y update` + + + .. NOTE:: During the cleanup, you might see the message: + + .. parsed-literal:: + + `/var/tmp/rpm-tmp.TUmak9: line 1: fg: no job control` + `Cleanup : cyrus-imapd-2.5-108.3.el7.kolab_3.4.x86_64 347/404` + `/var/tmp/rpm-tmp.K51Mal: line 2: fg: no job control` + `warning: %postun(cyrus-imapd-2.5-108.3.el7.kolab_3.4.x86_64) scriptlet failed, exit status 1` + `Non-fatal POSTUN scriptlet failure in rpm package cyrus-imapd-2.5-108.3.el7.kolab_3.4.x86_64` + + This is a warning, and the Cyrus-imapd package will be updated. This can be checked after the update with the command: + + .. parsed-literal:: + + # :command:`rpm -qv cyrus-imapd` + + + +Updating the Configuration +========================== + +After upgrading the packages to Kolab 16 repository, the configuration needs to be updated. + +1. Configure the new module "Guam": + + .. parsed-literal:: + + # :command:`setup-kolab guam` + +2. Configure the new module "Manticore": + + .. parsed-literal:: + + # :command:`setup-kolab manticore` + + .. WARNING:: + + If the Kolab 3.4 installation was a standard installation with no changes to the defaults, then the following 2 commands can be run at no risk (The correct password for the current roundcube database user is still needed for verification). + + However, if changes were made to the defaults, the original configuration should be copied off for later compare with the newly written configuration. + +3. Update the roundcube configuration: + + .. NOTE:: + + As setup-kolab is unable to write to the already existing mysql database, an error message will show: + + .. parsed-literal:: + + `ERROR 1007 (HY000) at line 1: Can't create database 'roundcube'; database exists` + `ERROR 1050 (42S01) at line 8: Table 'session' already exists` + + The new and updated config file will however be written and restart the appropriate services. + + The correct password for the current roundcube database user is still needed for verification. + + .. parsed-literal:: + + # :command:`setup-kolab roundcube` + + + +4. Update the imap configuration: + + .. parsed-literal:: + + # :command:`setup-kolab imap` + + +