Page MenuHomePhorge
Files F117980754

D80.1775521481.diff
No OneTemporary
Actions

Authored By
Unknown
Size
3 KB
Referenced Files
None
Subscribers
None

D80.1775521481.diff
View Options

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,99 @@
+==================================
+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 having upgraded the files in the Kolab installation via the packages from the Kolab 16 repository, the configuraiton needs to be updated. Use the command :term:`setup-kolab` for this operation.
+
+#. Update the roundcube configuration:
+
+ .. parsed-literal::
+
+ # :command:`setup-kolab roundcube`
+
+ As setup-kolab is unable to write to the already existing mysql database, it will write the new and updated config file and restart the appropriate services.
+
+#. Update the imap configuration:
+
+ .. parsed-literal::
+
+ # :command:`setup-kolab imap`
+
+#. Configure the new module "Guam":
+
+
+ .. parsed-literal::
+
+ # :command:`setup-kolab guam`
+
+#. Configure the new module "Manticore":
+
+ .. parsed-literal::
+
+ # :command:`setup-kolab manticore`
+

File Metadata

Mime Type
text/plain
Expires
Tue, Apr 7, 12:24 AM (8 h, 19 m ago)
Storage Engine
blob
Storage Format
Raw Data
Storage Handle
18840231
Default Alt Text
D80.1775521481.diff (3 KB)

Event Timeline