Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

--- invis_server_wiki:upgrade:kopano [2019/02/02 08:41]
flacco [Upgrade von 8.4.x auf 8.5.9]
+++ invis_server_wiki:upgrade:kopano [2019/02/03 10:23] (aktuell)
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 9: / Zeile 9: @@
 Stoppen Sie den Email-Abruf und die interne Email-Zustellung:
+<code>
+invis:~ # systemctl stop fetchmail.service
+invis:~ # systemctl stop postfix.service
+</code>
-Sichern Sie vor jedem Upgrade die Kopano-Datenbank, auch eine Ausführung des Kopano Brick-Level-Backups kann nicht schaden:
+Sichern per Kopano Brick-Level-Backup alle Kopano-Stores:
 <code>
-invis:~ # kdbdump
 invis:~ # kbackup
 </code>
+Stoppen Sie zunächst alle Kopano-Dienste:
+<code>
+invis:~ # runkopano stop
+</code>
+Sichern Sie jetzt die Kopano Datenbank im Ganzen:
+<code>
+invis:~ # kdbdump
+</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 =====
@@ Zeile 128: / Zeile 147: @@
 ===== Upgrade von 8.6.x auf 8.7.x =====
-Stoppen Sie zunächst alle Kopano-Dienste:
+//**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:~ # runkopano stop
+invis:~ # kopano-dbadm usmp
 </code>
-Aktualisieren Sie jetzt 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.
+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:
-Ist die Installation der Pakete abgeschlossen, müssen Anpassungen an der Kopano Datenbank vorgenommen werden. Führen Sie dazu folgenden Befehl 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>
-invis:~ # kopano-dbadm usmp
+...
+# 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>
+Nahezu identisch gehen Sie in Datei <file>/etc/kopano/ical.cfg</file> vor. Entfernen Sie folgende Zeilen:
+<code>
+...
+# whether normal connections can be made to the ical server
+ical_enable = no
+# port which the ical server listens on for normal connections
+ical_port = 8080
+# whether ssl connections can be made to the ical server
+icals_enable = yes
+# port which the ical server listens on for ssl connections
+icals_port = 8443
+...
+</code>
+und ersetzen Sie sie durch folgende:
+<code>
+...
+# Space-separated list of address:port specifiers for where the server should
+# listen for connections.
+#
+#    "*:8080" — port 8080, all protocols
+#    "[::]:8080" — port 8080 on IPv6 only
+#    "[2001:db8::1]:8080" — port 8080 on specific address only
+#
+# ical has often been placed on 8080 and icals on 8443.
+#
+ical_listen =
+icals_listen = *:8443
+...
+</code>
 Starten Sie jetzt alle Kopano-Dienste und kontrollieren Sie das Logfile des Servers auf Fehler.