Add file 'README.upgrade'.

This commit is contained in:
Christoph 2020-05-26 19:54:00 +02:00
parent e33fa32352
commit 819427fac0

190
README.upgrade Normal file
View File

@ -0,0 +1,190 @@
# ------------------------------------
# Aktualisieren des Mattermost-Servers
# ------------------------------------
#
# see:
# - https://docs.mattermost.com/guides/administrator.html#upgrade-mattermost
# - https://docs.mattermost.com/administration/upgrade.html#upgrading-to-the-latest-version
# - https://docs.mattermost.com/administration/upgrade.html#upgrading-team-edition-to-enterprise-edition
In den meisten Fällen können Sie Mattermost Server in wenigen Minuten aktualisieren. Das Upgrade kann jedoch in Abhängigkeit von verschiedenen Faktoren, einschließlich der Größe und Komplexität Ihrer Installation und der Version, von der Sie ein Upgrade durchführen, länger dauern.
# ===============================
# Upgrade auf die neueste Version
# ===============================
Wenn Sie ein Upgrade von Version 3.0 oder höher durchführen, gelten diese Anweisungen für Sie. Wenn Sie ein Upgrade von einer früheren Version als 3.0.0 durchführen, müssen Sie zuerst ein Upgrade auf Version 3.0.3 durchführen.
Bevor Sie beginnen
Lesen Sie diese Anweisungen von Anfang bis Ende sorgfältig durch. Stellen Sie sicher, dass Sie jeden Schritt verstanden haben, bevor Sie mit dem Upgrade beginnen. Wenn Sie Fragen oder Bedenken haben, können Sie diese im Mattermost-Forum unter https://forum.mattermost.org/ stellen.
# ---
# Wichtig
#
# Lesen Sie die wichtigen Upgrade-Hinweise, um sicherzustellen, dass Sie über alle Maßnahmen informiert sind, die Sie vor oder nach dem Upgrade von Ihrer bestimmten Version ausführen müssen.
# ---
# ---
# Wichtig
#
# Wenn Sie ein Upgrade von einer Version vor Version 5.0 durchführen, müssen Sie auch Ihre Servicedatei so ändern, dass sie mit den mit 5.0 eingeführten binären Änderungen funktioniert. Ihr Ausführungsverzeichnis sollte auf das Basisverzeichnis Mattermost (d. H. /opt/mattermost) und Ihre Binärdatei auf die Binärdatei matteratter (d. H. /opt/mattermost/bin/mattermost) verweisen.
# ---
Sie sollten die folgenden Informationen sammeln, bevor Sie mit dem Upgrade beginnen:
Vorhandenes Installationsverzeichnis - {Installationspfad}
Wenn Sie nicht wissen, wo Mattermost Server installiert ist, verwenden Sie den Befehl whereis mattermost. Die Ausgabe sollte /opt/mattermost/bin/mattermost ähnlich sein. Das Installationsverzeichnis ist alles vor dem ersten Auftreten der Zeichenfolge /mattermost. In diesem Beispiel lautet der {Installationspfad} /opt. Wenn dieser Befehl keine Ergebnisse liefert, weil Ihre Version älter ist, versuchen Sie stattdessen whereis platform.
Speicherort Ihres lokalen Speicherverzeichnisses
Das lokale Speicherverzeichnis enthält alle Dateien, die Benutzer an ihre Nachrichten angehängt haben. Wenn Sie den Speicherort nicht kennen, öffnen Sie die Systemkonsole und gehen Sie zu Dateien> Speicher in früheren Versionen oder Umgebung> Dateispeicher in Versionen nach 5.12 und lesen Sie den Wert im lokalen Speicherverzeichnis. Relative Pfade sind relativ zum mattermost Verzeichnis. Wenn das lokale Speicherverzeichnis beispielsweise ./data/ lautet, lautet der absolute Pfad {Installationspfad}/mattermost/data.
# ===========================================
{Installationspfad} /opt
local storage directory: /opt/mattermost/data
# ===========================================
So aktualisieren Sie Mattermost Server:
# ---
# Hinweis
#
# Wenn Sie ein HA-Cluster aktualisieren, lesen Sie stattdessen diese Aktualisierungshinweise:
# https://docs.mattermost.com/deployment/cluster.html#upgrade-guide
# ---
1.) Lesen Sie die wichtigen Upgrade-Hinweise, um sicherzustellen, dass Sie über alle Maßnahmen informiert sind, die Sie vor oder nach dem Upgrade von Ihrer bestimmten Version ausführen müssen.
2.) Wechseln Sie in einem Terminalfenster auf dem Server, auf dem sich Mattermost Server befindet, in Ihr Ausgangsverzeichnis. Löschen Sie gegebenenfalls Dateien und Verzeichnisse, die möglicherweise noch von einem vorherigen Download vorhanden sind.
cd / tmp
3.) Laden Sie die neueste Version von Mattermost Server herunter. Ersetzen Sie im folgenden Befehl X.X.X durch die Version, die Sie herunterladen möchten:
Enterprise Edition
wget https://releases.mattermost.com/X.X.X/mattermost-X.X.X-linux-amd64.tar.gz
Team Edition
wget https://releases.mattermost.com/X.X.X/mattermost-team-X.X.X-linux-amd64.tar.gz
4.) Extrahieren Sie die Mattermost Server-Dateien.
tar -xf mattermost*.gz --transform='s,^[^/]\+,\0-upgrade,'
Die Transformationsoption fügt dem obersten extrahierten Verzeichnis ein Suffix hinzu, damit es nicht mit dem üblichen Installationsverzeichnis in Konflikt steht.
5.) Stoppen Sie den Mattermost Server.
Unter Ubuntu 14.04 und RHEL 6:
sudo service mattermost stop
Unter Ubuntu 16.04 und RHEL 7:
sudo systemctl stop mattermost
6.) Sichern Sie Ihre Daten und Ihre Anwendung.
- Sichern Sie Ihre Datenbank mit den Standardverfahren Ihres Unternehmens zum Sichern von MySQL oder PostgreSQL.
- Sichern Sie Ihre Anwendung, indem Sie sie in einen Archivordner kopieren (z. B. am wenigsten zurück-JJJJ-MM-TT-HH-mm).
cd {Installationspfad}
sudo cp -ra mattermost / mattermost-back - $ (Datum + '% F-% H-% M') /
7.) Entfernen Sie alle Dateien mit Ausnahme spezieller Verzeichnisse aus dem aktuellen Verzeichnis.
Die speziellen Verzeichnisse innerhalb von mattermost sind config, logs, plugins, client / plugins und data (es sei denn, Sie haben einen anderen Wert für den lokalen Speicher konfiguriert, als zuvor beschrieben). Der folgende Befehl löscht den Inhalt von mattermost und behält nur diese Verzeichnisse und deren Inhalt bei. Sie sollten zuerst den letzten Teil in xargs echo rm -r ändern, um zu überprüfen, was ausgeführt wird.
sudo find mattermost/ mattermost/client/ -mindepth 1 -maxdepth 1 \! \( -type d \( -path mattermost/client -o -path mattermost/client/plugins -o -path mattermost/config -o -path mattermost/logs -o -path mattermost/plugins -o -path mattermost/data \) -prune \) | sort | sudo xargs rm -r
8.) Benennen Sie die Plugins-Verzeichnisse um, damit sie das Upgrade nicht beeinträchtigen.
sudo mv mattermost/plugins/ mattermost/plugins~
sudo mv mattermost/client/plugins/ mattermost/client/plugins~
9.) Ändern Sie den Besitz der neuen Dateien, bevor Sie sie kopieren.
sudo chown -hR mattermost:mattermost /tmp/mattermost-upgrade/
# ---
# Hinweis
#
# Wenn Sie mattermost nicht als Eigentümer und Gruppe des Installationsverzeichnisses verwendet haben, führen Sie
# sudo chown -hR {owner}:{group} tmp/mattermost-upgrade/.
# aus.
#
# Wenn Sie sich nicht sicher sind, welcher Eigentümer oder welche Gruppe definiert wurde, verwenden Sie den Befehl
# ls -l {install-path}/mattermost/bin/mattermost
# um sie zu erhalten.
# ---
10.) Kopieren Sie die neuen Dateien in Ihr Installationsverzeichnis und entfernen Sie die temporären Dateien.
Beachten Sie, dass das n-Flag (kein Clobber) und der abschliessende Punkt '.' an der Quelle sind sehr wichtig.
sudo cp -an /tmp/mattermost-upgrade/. mattermost/
sudo rm -r /tmp/mattermost-upgrade/
11.) Wenn Sie Port 80 verwenden möchten, um Ihren Server zu bedienen, oder wenn Sie TLS auf Ihrem Mattermost-Server eingerichtet haben, müssen Sie die CAP_NET_BIND_SERVICE-Funktion aktivieren, damit die neue Mattermost-Binärdatei an niedrige Ports gebunden werden kann.
cd {Installationspfad}/mattermost
sudo setcap cap_net_bind_service=+ep ./bin/mattermost
12.) Starten Sie den Mattermost-Server.
Unter Ubuntu 14.04 und RHEL 6:
sudo service mattermost start
Unter Ubuntu 16.04 und RHEL 7:
sudo systemctl start mattermost
13.) Aktualisieren Sie Ihr config.json-Schema:
- Öffnen Sie die Systemkonsole, ändern Sie eine Einstellung und setzen Sie sie zurück. Dies sollte die Schaltfläche Speichern für diese Seite aktivieren.
- Klicken Sie auf Speichern.
- Lade die Seite neu.
Ihre aktuellen Einstellungen bleiben erhalten und neue Einstellungen werden mit Standardwerten hinzugefügt.
14.) Stellen Sie die Plugins-Verzeichnisse wieder her und starten Sie den mattermost Dienst neu.
cd {install-path}/mattermost
sudo rsync -au plugins~/ plugins
sudo rm -rf plugins~
sudo rsync -au client/plugins~/ client/plugins
sudo rm -rf client/plugins~
Nach dem Upgrade des Servers müssen Benutzer möglicherweise ihre Browser aktualisieren, um neue Funktionen nutzen zu können.
# ===================================================
# Upgrade der Team Edition auf die Enterprise Edition
# ===================================================
Befolgen Sie zum Aktualisieren von der Team Edition auf die Enterprise Edition die oben genannten normalen Upgrade-Anweisungen. Stellen Sie jedoch sicher, dass Sie die Enterprise Edition in Schritt 3 herunterladen.
Öffnen Sie nach der Ausführung der Enterprise Edition die Systemkonsole und gehen Sie zu OTHER> Edition und Lizenz> Lizenzschlüssel in früheren Versionen oder Systemkonsole> Info> Editionen und Lizenz in Versionen nach 5.12 und laden Sie Ihre Lizenzschlüsseldatei hoch.