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,83 @@ +.. _upgrade-guide-centos-7: + +====================================== +Upgrade of Kolab 3.4 to 16 on CentOS 7 +====================================== + +The installation of Kolab Groupware on CentOS installs +a number of additional packages, from the :term:`EPEL` software +repository. + +Installation Procedure +====================== + +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:/16/CentOS_7/Kolab:16.repo` + +3. Import the community 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. Replace php-mysql with php-mysqlnd: + + .. parsed-literal:: + + # :command:`yum shell` + `> remove php-mysql` + `> install php-mysqlnd` + `> run` + `(Confirm as requested)` + `> exit` + + +7. 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` + +Continue to :ref:`install-kolab`. + +