Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

--- invis_server_wiki:upgrade:kopano [2018/09/01 08:46]
flacco [Upgrade von 8.5.9 auf 8.6.x]
+++ invis_server_wiki:upgrade:kopano [2019/02/03 10:20]
flacco [Upgrade von 8.6.x auf 8.7.x]
@@ Zeile 1: / Zeile 1: @@
-====== Kopano Upgrade ab 8.4.x aufwärts unter openSUSE Leap 42.3 / invis-Server 13.x ======
+====== Kopano Upgrade ab 8.4.x aufwärts ======
 //**Hinweis:** Die nachfolgende Beschreibung bezieht sich auf die Verwendung der supporteten Kopano "limited" Pakete und nicht auf die Community-Version aus der openSUSE Distribution.//
@@ Zeile 5: / Zeile 5: @@
 In Kopano Versionen bis einschließlich 8.4.x verbarg sich ein Fehler der dazu führen konnte dass es in der Datenbank zu Datenverlusten kommen konnte. Beim Upgrade auf Version 8.5.x kann die Kopano Datenbank auf Fehler überprüft und ggf. bereinigt werden.
-===== Upgrade von 8.4.x auf 8.5.9 =====
+Folgende Schritte sollten Sie vor jedem der nachfolgend beschriebenen Upgrades vornehmen.
-Da in den Kopano Limited Repositories für openSUSE Leap 42.3 bereits Kopano Version 8.6.x vorgehalten wird, empfehle ich sich zunächst ein lokales Repository der letzten 8.5er Version anzulegen. Dazu lässt sich ein Tarball-Archiv bei Kopano herunterladen:
+Stoppen Sie den Email-Abruf und die interne Email-Zustellung:
-[[https://download.kopano.io/limited/core:/final/tarballs/archives/core-8.5.9.5_0%2B2-openSUSE_Leap_42.3-x86_64.tar.gz]]
+<code>
+invis:~ # systemctl stop fetchmail.service
+invis:~ # systemctl stop postfix.service
+</code>
-//**Hinweis:** Für den Download benötigen Sie Ihre Kopano Zugangsdaten.//
+Sichern per Kopano Brick-Level-Backup alle Kopano-Stores:
-Beenden Sie zunächst den Mailabruf und alle Kopano-Dienste:
+<code>
+invis:~ # kbackup
+</code>
+Stoppen Sie zunächst alle Kopano-Dienste:
 <code>
-invis:~ # systemctl stop fetchmail.service
 invis:~ # runkopano stop
 </code>
-Sichern Sie jetzt die Kopano-Datenbank, auch eine Ausführung des Kopano Brick-Level-Backups kann nicht schaden:
+Sichern Sie jetzt die Kopano Datenbank im Ganzen:
 <code>
 invis:~ # kdbdump
-invis:~ # kbackup
 </code>
+Wir empfehlen keinen der einzelnen Versionssprünge auszulassen. Sollte dies versehentlich geschehen, können Sie sich die erforderlichen Software-Pakete der verpassten Version direkt bei Kopano herunterladen:
+**[[https://download.kopano.io/limited/core:/final/tarballs/archives/]]**
+Sie benötigen dazu Ihre Kopano-Zugangsdaten. Wie ein solches Upgrade abläuft wird im nächsten Abschnitt beschrieben.
+===== Upgrade von 8.4.x auf 8.5.9 =====
+Da in den Kopano Limited Repositories für openSUSE Leap 42.3 bereits Kopano Version 8.6.x vorgehalten wird, empfehle ich sich zunächst ein lokales Repository der letzten 8.5er Version anzulegen. Dazu lässt sich ein Tarball-Archiv bei Kopano herunterladen:
+[[https://download.kopano.io/limited/core:/final/tarballs/archives/core-8.5.9.5_0%2B2-openSUSE_Leap_42.3-x86_64.tar.gz]]
+//**Hinweis:** Für den Download benötigen Sie Ihre Kopano Zugangsdaten.//
 Verschieben Sie anschließend die bisherige Repository-Datei des Kopano Limited-Repositories an einen anderen Ort:
@@ Zeile 52: / Zeile 70: @@
 Je nach Größe der Datenbank kann dieser Vorgang eine ganze Weile dauern.
+Beim Wechsel von Version 8.4.x nach 8.5.x wurden in den Konfigurationsdateien ein paar Änderungen vorgenommen. Sie können diese Änderungen manuell nachvollziehen. Aktualisieren Sie über YaST das Paket invisAD-setup-13 auf Version 13.2.
+Jetzt finden unter <file>/usr/share/sine/templates/groupware/kopano</file> einen Satz aktuelle Vorlagen der neuen Dateien. Daran ist nur wenig anzupassen. Benötigt werden Die Dateien:
+  * gateway.cfg
+  * ical.cfg
+  * monitor.cfg
+  * presence.cfg
+  * search.cfg
+  * server.cfg
+  * spooler.cfg
+Anpassungen müssen lediglich in den Dateien "server.cfg" und "presence.cfg" vorgenommen werden. Aus den bisher aktiven Dateien in <file>/etc/kopano</file> müssen Sie aus der Datei "server.cfg" das MySQL-Passwort für den Zugriff auf die Kopano-Datenbank (Zeile: ca. 132), den "cache_cell_size" (Zeile ca. 275) und ggf. die Adresse des Postmasters (system_email_address) (Zeile: ca. 52) übernehmen.
+Aus der Datei "presence.cfg" ist der "server_secret_key" (Zeile: ca. 32) in die neue Datei zu übernehmen.
+Wenn Sie möchten können Sie in den Dateien die Sicherheit der Verschlüsselung ein wenig hochschrauben. Suchen Sie jeweils nach der Konfigurationsoption "server_ssl_protocols" und fügen Sie am Ende der Zeile folgendes an:
+<code>
+!TLSv1
+</code>
+Hier wäre eigentlich auch bereits TLS Version 1.1 aus Sicherheitsgründen auszuklammern. Wenn Sie dies tun, sollten Sie aber testen, ob all Ihre Clients speziell ältere Outlook Versionen damit klar kommen.
 Starten Sie jetzt nur den Kopano-Server-Dienst und kontrollieren Sie dessen Logfile dabei auf Fehler:
@@ Zeile 59: / Zeile 101: @@
 </code>
-Treten dabei keine Auffälligkeiten auf (ist bisher noch nie schief gegangen) können Sie alle Kopano-Dienste wieder starten und sich in der Webapp anschauen, ob alles wie gewohnt funktioniert.
+Treten dabei keine Auffälligkeiten auf (ist bisher noch nie schief gegangen) können Sie alle Kopano-Dienste wieder und den Apache Webserver neu starten und sich in der Webapp anschauen, ob alles wie gewohnt funktioniert.
+<code>
+invis:~ # systemctl restart apache2.service
+invis:~ # runkopano start
+</code>
 ===== Upgrade von 8.5.9 auf 8.6.x =====
@@ Zeile 89: / Zeile 136: @@
 Das im vorigen Abschnitt angelegte lokale Repository können Sie jetzt wieder löschen.
+Bei diesem Upgrade Schritt sind keine Konfigurationsanpassungen erforderlich.
+Starten Sie ggf. den Apache Webserver neu:
+<code>
+invis:~ # systemctl restart apache2.service
+</code>
+===== Upgrade von 8.6.x auf 8.7.x =====
+//**Achtung: Aktualisieren Sie bitte noch nicht auf Kopano Verion 8.7.0. Sie scheint noch fehlerhaft zu sein.//
+Aktualisieren Sie nach dem Stoppen der Kopano-Dienste via YaST alle Kopano-Pakete. Suchen Sie mit YaST einfach nach "kopano" und wählen Sie die Pakete "kopano-server-packages" und "kopano-bash-completion" aus. Es ergeben sich dabei ein paar Paket-Konflikte. Zur Auflösung der Konflikte wählen Sie immer die vorgeschlagene Lösung 1, Deinstallation eines veralteten Pakets.
+Ist die Installation der Pakete abgeschlossen, müssen Anpassungen an der Kopano Datenbank vorgenommen werden. Führen Sie dazu folgenden Befehl aus:
+<code>
+invis:~ # kopano-dbadm usmp
+</code>
+Auch in der LDAP-Konfiguration müssen ein paar kleine Anpassungen vorgenommen werden. Öffnen Sie dazu die Datei: <file>/etc/kopano/ldap.cfg</file> und führen Sie folgenden Anpassungen durch. Kommentieren Sie am Anfang der Datei die Direktiven ''ldap_host'', ''ldap_port'' und ''ldap_protokoll'' aus:
+<code>
+...
+# LDAP host name/IP address
+# Optional, default = localhost
+#ldap_host = localhost
+# LDAP port
+# Optional, default = 389
+# Use 636 for ldaps
+#ldap_port = 636
+# LDAP protocol
+# Optional, default = ldap
+# use 'ldaps' for SSL encryption. Make sure /etc/ldap/ldap.conf is
+# configured correctly with TLS_CACERT
+#ldap_protocol = ldaps
+...
+</code>
+Diese Direktiven werden durch Setzen der Direktive ''ldap_uri'' ersetzt:
+<code>
+...
+# LDAP URI
+# Optional, override ldap_host, ldap_port and ldap_protocol if set
+# e.g. ldaps://servername:port. You may also specify multiple space-separated
+# URI's
+ldap_uri = ldaps://invis.invis-net.loc
+...
+</code>
+Selbstverständlich müssen Sie den Hostnamen Ihres Servers in den URI einfügen.
+Mit Version 8.7.0 wandern die "userscripts", eine Sammlung von Scripts die beim Anlegen eines Benutzer dessen Store in der Kopano-Datenbank erstellen, aus "/etc/kopano/userscripts" nach "/usr/lib/kopano/userscripts". Dies muss in der Server-Konfiguration angepasst werden. Öffnen sie dazu die Datei: <file>/etc/kopano/server.cfg</file> und passen Sie die Pfade etwa ab Zeile 344 wie nachfolgend gezeigt ab:
+<code>
+...
+# scripts which create stores for users from an external source
+# used for ldap and unix plugins only
+createuser_script               =       /usr/lib/kopano/userscripts/createuser
+deleteuser_script               =       /usr/lib/kopano/userscripts/deleteuser
+creategroup_script              =       /usr/lib/kopano/userscripts/creategroup
+deletegroup_script              =       /usr/lib/kopano/userscripts/deletegroup
+createcompany_script            =       /usr/lib/kopano/userscripts/createcompany
+deletecompany_script            =       /usr/lib/kopano/userscripts/deletecompany
+...
+</code>
+In den Konfigurationen von der Kopano-Dienste "ical" und "gateway" wurden mit Einführungen von Version 8.7.0 Änderungen vorgenommen, mit denen unsere Vorlagen-Dateien inkompatibel sind. Die Änderungen sind beim Upgrade manuell vorzunehmen. In beiden Fällen sind die Änderungen gleichartig. Beginnen wir mit Kopano-Gateway. Kommentieren Sie in Datei <file>/etc/kopano/gateway.cfg</file> folgende Zeilen aus oder entfernen Sie sie:
+<code>
+...
+# enable/disable POP3, and POP3 listen port
+pop3_enable     =       no
+pop3_port       =       110
+# enable/disable Secure POP3, and Secure POP3 listen port
+pop3s_enable    =       no
+pop3s_port      =       995
+# enable/disable IMAP, and IMAP listen port
+imap_enable     =       yes
+imap_port       =       143
+# enable/disable Secure IMAP, and Secure IMAP listen port
+imaps_enable    =       yes
+imaps_port      =       993
+...
+</code>
+Ersetzen Sie sie durch folgende Zeilen:
+<code>
+...
+# Space-separated list of address:port specifiers for where the server should
+# listen for connections.
+#
+#    "*:143" — port 143, all protocols
+#    "[::]:143" — port 143 on IPv6 only
+#    "[2001:db8::1]:143" — port 143 on specific address only
+#
+# imaps is normally on 993, pop3s on 995.
+#
+pop3_listen =
+pop3s_listen =
+imap_listen = *:143
+imaps_listen = *:993
+...
+</code>
+Starten Sie jetzt alle Kopano-Dienste und kontrollieren Sie das Logfile des Servers auf Fehler.
+<code>
+invis:~ # runkopano start
+</code>
+<code>
+invis:~ # less /var/log/kopano/server.log
+</code>