Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

--- invis_server_wiki:upgrade:13.5_to_14.1 [2019/08/14 16:24]
flacco [Samba Upgrade]
+++ invis_server_wiki:upgrade:13.5_to_14.1 [2019/08/29 09:08]
flacco [Konfigurationsanpassung invis Portal]
@@ Zeile 7: / Zeile 7: @@
 Weiterhin basiert invis-Server 14.1 bereits auf openSUSE Leap 15.1, d.h. es müssen 2 Distributionsupgrades in Folge gemacht werden.
-Deaktivieren Sie bevor es losgeht den Email-Abruf:
+//**Hinweis:** Die folgende Anleitung setzt voraus, dass Ihr Server definitiv auf dem Stand von Version 13.5 ist, also bereits PHP7 und ownCloud 10.x verwendet. Ist das nicht der Fall müssen Sie zunächst auf Version 13.5 aktualisieren. Eine Anleitung dazu finden Sie hier.//
+===== Vorbereitung =====
+Sichern Sie alle Datenbanken des Servers. Sie können dafür die Tools des invis-Servers nutzen:
+**ActiveDirectory**
 <code>
-invis:~ # systemctl disable fetchmail.service
+invis:~ # adbackup
-invis:~ # systemctl stop fetchmail.service
 </code>
-===== Samba Upgrade =====
+**Kopano**
-Beginnen wir mit dem Herz des Servers, dem ActiveDirectory. Stoppen Sie Samba, nehmen Sie es aus dem automatischen Start, und erstellen Sie zunächst eine Datensicherung Ihres ADs:
+Führen Sie hier beide Sicherungswege durch:
+<code>
+invis:~ # kdbdump
+...
+invis:~ # kbackup
+</code>
+**Weitere Datenbanken**
+<code>
+invis:~ # alldump
+</code>
+**Dokuwiki**
+<code>
+invis:~ # dwdatasnapshot
+</code>
+Da mit der neuen auf MIT-Kerberos basierenden Samba-Version 4.7. die im Laufe des Upgrades installiert wird, werden überarbeitete AppArmor Profile notwendig. Um negative Effekte auf das Upgrade durch mögliche AppArmor-Blockaden vorzubereiten wird AppArmor vor dem Upgrade deaktiviert.
+<code>
+invis:~ # systemctl stop apparmor.service
+...
+invis:~ # systemctl disable apparmor.service
+</code>
+Im späteren Verlauf des Upgrades wird AppArmor mit neuen Profilen wieder aktiviert.
+Auch der Email-Abruf sollte vor dem Upgrade deaktiviert werden:
+<code>
+invis:~ # systemctl stop fetchmail.service
+invis:~ # systemctl disable fetchmail.service
+</code>
+Auch der Samba Domain-Controller wird abgeschaltet und deaktiviert.
 <code>
 invis:~ # systemctl stop samba.service
 invis:~ # systemctl disable samba.service
-invis:~ # adbackup
 </code>
-Entfernen Sie jetzt das bisherige Samba-Repository. Ermitteln Sie dazu die Nummer des Repositories:
+Die neue Samba-Version bringt ohnehin ein eigenes Service-Unit-File mit.
+===== Samba Upgrade =====
+Beginnen wir mit dem Herz des Servers, dem ActiveDirectory.
+//**Achtung:** Stellen Sie sicher, dass alle Client-PCs bevor Sie beginnen herunter gefahren sind!//
+Entfernen Sie zunächst das bisherige Samba-Repository. Ermitteln Sie dazu die Nummer des Repositories:
 <code>
@@ Zeile 35: / Zeile 83: @@
 <code>
-invis:~ # zypper rm 22
+invis:~ # zypper rr 22
 </code>
-Jetzt können Sie das neue Samba-Repository hinzufügen:
+Jetzt können Sie das neue Samba-Repository hinzufügen und den Repository-Cache auffrischen:
 <code>
-invis:~ # zypper ar https://download.opensuse.org/repositories/spins:/invis:/15:/testing:/samba410/openSUSE_Leap_42.3/spins:invis:15:testing:samba410.repo
+invis:~ # zypper ar https://download.opensuse.org/repositories/spins:/invis:/15:/stable:/samba/openSUSE_Leap_42.3/spins:invis:15:stable:samba.repo
+invis:~ # zypper ref
 </code>
+Jetzt können die neuen Samba-Pakete installiert werden. Es wird dabei direkt von Samba-Version 4.6.x auf 4.10.x aktualisiert. Dies erfordert ein wenig Nacharbeit.
+Ermitteln Sie zunächst die Nummer des neuen Samba-Repositories:
+<code>
+invis:~ # zypper repos | grep samba
+| spins_invis_15_stable_samba     | Samba 4.10 with Heimdal Kerberos  (openSUSE_Leap_42.3)             | Ja        | (r ) Ja         | Nein
+invis:~ #
+</code>
+Im Beispiel trägt das neue Repository die Nr. 20, daraus ergibt sich das Kommando zum Paket-Upgrade:
+<code>
+invis:~ # zypper dup --from 20 --allow-vendor-change
+</code>
+Dieses Kommando löst eine Reihe Paketkonflikten aus.
+Wählen Sie jeweils Lösung **2**:
+<code>
+...
+ Lösung 2: Deinstallation von libdcerpc-server0-4.6.16-103.19.x86_64
+...
+</code>
+<code>
+...
+  Lösung 2: Deinstallation von samba-ad-4.6.16-103.19.x86_64
+...
+</code>
+<code>
+...
+ Lösung 2: Deinstallation von libsamba-policy0-4.6.16-103.19.x86_64
+...
+</code>
+<code>
+...
+ Lösung 2: Deinstallation von libsmbldap0-4.6.16-103.19.x86_64
+...
+</code>
+Installieren Sie jetzt noch fehlende Samba-Pakete nach:
+<code>
+invis:~ # zypper in samba-ad-dc ldb-tools
+</code>
+Sind alle Pakete installiert, darf Samba noch **nicht** wieder gestartet werden. Mit Samba 4.10. hat sich die Verzeichnisstruktur unter <file>/var/lib/samba</file> moderat geändert. D.h. die zuvor angelegte Datensicherung muss in die neue Verzeichnisstruktur wiederhergestellt werden. Für diesen Zweck haben wir ein Script entwickelt. Zwar ist dieses Script im aktuellen invisAD Setup Paket enthalten, leider stehen dieses Paket erst nach Umstrukturierung der Software-Repositories wie nachfolgend beschrieben zur Verfügung. Um das Samba-Upgrade jetzt dennoch abschließen zu können stellen wir das Script auch hier zum direkten Download zur Verfügung. Laden Sie die Datei wie folgt auf Ihren Server herunter:
+<code>
+invis:~ # wget -O upgradead.gz http://wiki.invis-server.org/lib/exe/fetch.php/invis_server_wiki:upgradead.gz
+</code>
+Entzippen Sie die Datei:
+<code>
+invis:~ # gunzip upgradead.gz
+</code>
+...und machen Sie sie ausführbar:
+<code>
+invis:~ # chmod +x upgradead
+</code>
+Jetzt können Sie damit Ihr AD wiederherstellen. Sie benötigen dazu den Pfad zur AD-Sicherung. Sie finden die Sicherungen und <file>/srv/shares/archiv/sicherungen/vollsicherungen/ad/</file> Sie benötigen von dort die aktuellste Datei, was anhand des Datums im Dateinamen leicht zu erkennen ist. Führen Sie das Script wie folgt aus:
+<code>
+invis:~ # ./upgradead /srv/shares/archiv/sicherungen/vollsicherungen/ad/Samba_20190815-075033.tar.gz
+</code>
+Zur Fehlervermeidung stellt das Script nach der Ausführung eine "Sind Sie sicher?" Abfrage, die zu bejahen ist. Das Script startet den Samba-AD-DC Dienst automatisch wieder. Sie können jetzt verschiedene Tests durchführen. Z.B.: Anmelden an einem Windows-PC, Anmelden am invis-Portal, DNS-Abfragen mit //**dig**// usw.
+Klappt alles ist das Samba-Upgrade muss der neue Samba-Domain-Controller Dienst zum automatischen Start vorgesehen werden.
+<code>
+invis:~ # systemctl enable samba-ad-dc.service
+</code>
+Damit ist das Samba-Upgrade abgeschlossen.
+===== Distributions-Upgrade Sprung 1 =====
+Mit dem Sprung auf invis-Server 14.0 muss auf openSUSE Leap 15.0 aktualisiert werden. Die Vorgehensweise dazu ist denkbar einfach. Zunächst müssen Sie Ihre Software-Repositories daran anpassen. Es kann auch nicht schaden zunächst mal alles zu sichern, so wie es ist:
+<code>
+invis:~ # cp -R /etc/zypp/repos.d /etc/zypp/repos.d.bak
+</code>
+Prüfen wir jetzt, ob ein CD/DVD Repository bei der Installation verwendet wurde. Ist das der Fall, kann es gelöscht werden:
+<code>
+invis:~ # grep "cd://" /etc/zypp/repos.d/*
+/etc/zypp/repos.d/openSUSE-42.3-0.repo:baseurl=cd:///?devices=/dev/disk/by-id/ata-TSSTcorp_CDDVDW_SH-224BB_R8WS68BCB00TYX
+invis:~ # rm /etc/zypp/repos.d/openSUSE-42.3-0.repo
+</code>
+Weiterhin verfügt Ihr invis-Server über zwei weitere Repositories unseres Projektes. Da wir für Version 14.x des invis-Servers eine neue Repository-Struktur aufgebaut haben, können diese beiden Repositories entfernt und dann durch die neuen Repositories ersetzt werden:
+<code>
+invis:~ # zypper repos |grep spins_invis
+| spins_invis_15_stable_samba     | Samba 4.10 with Heimdal Kerberos  (openSUSE_Leap_42.3)             | Ja        | (r ) Ja         | Nein
+| spins_invis_common              | Common packages for invis-Server stable & unstable (openSUSE_42.3) | Ja        | (r ) Ja         | Ja
+| spins_invis_stable              | Stable Packages for invis-servers (openSUSE_Leap_42.3)             | Ja        | (r ) Ja         | Ja
+</code>
+Zu entfernen sind also die Repositories Nr. 21 und 22:
+<code>
+invis:~ # zypper rr 22
+Repository 'Production Project for the openSUSE invis-Server Spin (openSUSE_Leap_42.3)' entfernen .....................................[fertig]
+Repository 'Production Project for the openSUSE invis-Server Spin (openSUSE_Leap_42.3)' wurde entfernt.
+invis:~ # zypper rr 21
+Repository 'Common packages for invis-Server stable & unstable (openSUSE_42.3)' entfernen .............................................[fertig]
+Repository 'Common packages for invis-Server stable & unstable (openSUSE_42.3)' wurde entfernt.
+invis:~ #
+</code>
+Fügen wir jetzt die neuen Repositories hinzu:
+<code>
+invis:~ # zypper ar https://download.opensuse.org/repositories/spins:/invis:/15:/common/openSUSE_Leap_15.0/spins:invis:15:common.repo
+...
+invis:~ # zypper ar https://download.opensuse.org/repositories/spins:/invis:/15:/stable/openSUSE_Leap_15.0/spins:invis:15:stable.repo
+</code>
+Wenn Sie Kopano auf Basis einer offiziellen Kopano-Subskription einsetzen müssen Sie eine der Repository-Dateien manuell anpassen. Editieren Sie die Datei: <file>/etc/zypp/repos.d/Kopano-openSUSE_limited.repo</file>, indem Sie die mit "baseurl=" beginnende Zeile auf folgende URL abändern:
+<code>
+[Kopano-openSUSE-15.0_limited]
+name=Kopano-openSUSE-15.0_limited
+enabled=1
+autorefresh=1
+baseurl=https://download.kopano.io/limited/core:/final/openSUSE_Leap_15.0
+path=/
+type=rpm-md
+keeppackages=0
+</code>
+Dieses Kopano-Repository verlangt Zugangsdaten, diese wurden während des Server-Setups eingegeben und in <file>/root/.zypp/credentials.cat</file> hinterlegt. Sie können in dieser Datei ebenfalls die URL zum Repository anpassen oder die Zugangsdaten beim nächsten **//zypper ref//** Kommando erneut eingeben. In der genannten Datei muss die erste Zeile geändert werden:
+<code>
+[https://download.kopano.io/limited/core:/final/openSUSE_Leap_15.0/]]
+username = FSP Computer und Netzwerke
+password = supergeheim
+...
+</code>
+Abschließend sind noch die openSUSE Versionsnummern in den verbleibenden Repository-Dateien zu ersetzen:
+<code>
+invis:~ # sed -i 's/42\.3/15\.0/g' /etc/zypp/repos.d/*
+</code>
+Jetzt kann das Distributions-Upgrade durchgeführt werden:
+<code>
+invis:~ # zypper ref
+...
+invis:~ # zypper dup
+</code>
+Stimmen Sie dem Vorschlag den //**zypper dup**// macht zu, danach beginnt das Paket-Upgrade.
+//**Hinweis:** Je nach Stand Ihrer Kopano-Installation, kann es sein, dass das Upgrade einige Paketkonflikte mit sich bringt. Lösen Sie diese Pakete in dem Sie jeweils die Deinstallation der älteren Pakete (vermutlich Version 8.6.9) als Lösung auswählen. In unseren Tests war dies in der Regel Lösung 2.//
+//**Hinweis:** Weiterhin wird **zypper** einige Dateikonflikte melden. Erlauben Sie das Ersetzen der Dateien mit "ja" um das Distributionsupgrade abzuschließen.//
+Mit dem Distributionsupgrade wird eine aktuelle Version von MariaDB installiert, was ein Upgrade der Tabellenstrukturen erfordert. Normalerweise geschieht dies mit einem Neustart des Dienstes automatisch. Je nach Datenbankgröße kann dies aber so lange dauern, dass systemd die Geduld verliert und in einen Timeout läuft. Daher sollte das Upgrade manuell durchgeführt werden:
+<code>
+invis:~ # /usr/lib/mysql/mysql-systemd-helper upgrade
+</code>
+Starten Sie den Server jetzt neu.
+===== Distributions-Upgrade Sprung 2 =====
+Der Sprung von openSUSE Leap 15.0 nach 15.1 ist deutlich unkomplizierter als der vorherige Schritt. Passen Sie zunächst die Repositories an:
+<code>
+invis:~ # sed -i 's/15\.0/15\.1/g' /etc/zypp/repos.d/*
+</code>
+Dabei werden auch die Kopano Repositories aktualisiert, leider stehen derzeit noch keine Repositories für Leap 15.1 zur Verfügung, entsprechend müssen hier die Änderungen wieder zurück genommen werden.
+Ändern Sie in der Datei <file>/etc/zypp/repos.d/Kopano-openSUSE_limited.repo</file> die openSUSE Versionsnummer wieder auf 15.0 zurück:
+<code>
+invis:~ # sed -i 's/15\.1/15\.0/g' /etc/zypp/repos.d/Kopano-openSUSE_limited.repo
+</code>
+Jetzt kann das Upgrade gestartet werden:
+<code>
+invis:~ # zypper ref
+...
+invis:~ # zypper dup
+</code>
+Diesmal treten keine Paketkonflikte auf, ggf. aber wieder Dateikonflikte. Erlauben Sie das überschreiben der alten Dateien mit "ja". Danach starten Sie das System neu.
+===== invis-Setup aktualisieren =====
+Durch den Wechsel der Repository-Struktur für invis-Server ab Version 14.0 wird beim Distributionsupgrade das invis-Server Setup-Paket gelöscht. Dies ist jetzt neu zu installieren:
+<code>
+invis:~ # zypper in invisAD-setup-14
+</code>
+Nach der Installation sind zunächst ein paar Anpassungen der Konfiguration erforderlich, zunächst sind allerdings die vorherigen Konfigurationen wieder herzustellen:
+<code>
+invis:~ # old /etc/invis/invis.conf
+invis:~ # cp /etc/invis/invis.conf.rpmsave /etc/invis/invis.conf
+...
+invis:~ # old /etc/invis/invis-pws.conf
+invis:~ # cp /etc/invis/invis-pws.conf.rpmsave /etc/invis/invis-pws.conf
+</code>
+==== Konfigurationsanpassung invis Server ====
+Passen Sie jetzt in der Haupkonfigurationsdatei <file>/etc/invis/invis.conf</file> die Versionsnummer des invis-Server-Setups an:
+<code>
+#invis-server Version
+invisVersion:14.1
+</code>
+Suchen Sie jetzt in der genannten Datei nach einer mit der Direktive "avCheck" beginnenden Zeile und ändern Sie sie wie folgt ab:
+<code>
+# [all|profiles|none]
+avCheck:none
+</code>
+Statt nur "ja" oder "nein" bezogen auf regelmäßige Virenprüfungen im Fileserver, können Sie jetzt entscheiden, ob alles, nichts oder lediglich die Benutzerprofile geprüft werden.
+Gehen Sie an eine regelmäßigen Virenprüfung vorsichtig heran. Je nach Datenmenge laufen diese Prüfungen sehr lange und erzeugen hohe Systemauslastungen. Wir nutzten dieses Feature in der Praxis oft gar nicht, viel wichtiger sind aktuelle und aktive Virenscanner auf den Clients.
+Jetzt ist die Datei noch mit neuen Konfigurationen zu ergänzen. Fügen Sie folgende Blöcke hinzu:
+<code>
+# Disk Warranty Time - Garantiezeitraum der eingesetzten Festplatten
+# 5 Jahre = 43800 Stunden (Gilt für die meisten 24/7 Festplatten)
+# 3 Jahre = 26280 Stunden (Gilt für gute Consumer Festplatten)
+# 1 Jahr = 14140 Stunde (Gilt für Low-Budged Festplatten)
+diskWarrantyTime:43800
+</code>
+Das regelmäßig laufende Tool //**diskchecker**// überprüft jetzt auch die absolvierten Betriebsstunden der eingesetzten Festplatten und setzt diese mit der vom Hersteller garantierten Laufzeit in Beziehung. Passen Sie die Konfiguration entsprechend den von Ihnen eingesetzten Festplatten an.
+<code>
+# Pfad zu den Verzeichnisvorlagen der Gruppenverzeichnisse
+groupDirTemplatePath:/srv/shares/media/portal/verzeichnisvorlagen
+</code>
+Hier müssen Sie nichts weiter unternehmen. Beim Anlegen von Gruppen mit Gruppenarbeitsverzeichnissen, können diese jetzt auf Basis von Verzeichnisvorlagen erzeugt werden.
+==== Konfigurationsanpassung invis Portal ====
+Die Anpassungen der invis-Portal Konfiguration sind zwar nicht zwingend, sollten aber dennoch durchgeführt werden. Anzupassen ist die Datei <file>/etc/invis/portal/config.php</file>
+Passen Sie zunächst die Versionsnummern am Anfang der Datei an:
+<code>
+...
+$GROUPWARE = 'kopano';
+$INVISVERSION = '14.1';
+$OPENSUSEVERSION = '15.1';
+...
+</code>
+Jetzt sind auch hier ein paar neue Konfigurationen hinzuzufügen:
+...to be continued
+===== Kopano Konfiguration anpassen =====
+...to be continued