Adjust README.upgrade.

This commit is contained in:
Christoph 2020-12-30 02:00:24 +01:00
parent bada15070e
commit 17706ff197

View File

@ -8,48 +8,87 @@
# - 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.
# 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.
# ---
# Notice:
# 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.
# 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.
# 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.
# 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.
# 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
# {Installationspfad} /opt
# local storage directory: /opt/mattermost/data
# ===========================================
MM_NEW_VERSION=5.30.1
MM_BASE_INSTALL_PATH=/opt
MM_DATA_DIR=/opt/mattermost/data
So aktualisieren Sie Mattermost Server:
MM_USER=mattermost
MM_GROUP=mattermost
MM_DB_NAME=mattermost
MM_DB_USER=mattermost
MM_DB_PASSWD="C5jzznfvn%%WV6J7-4rgT"
MM_TMP_DIR=/tmp
# So aktualisieren Sie Mattermost Server:
# ---
# Hinweis
@ -58,133 +97,236 @@ So aktualisieren Sie Mattermost Server:
# 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.
# 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
# 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:
#
# 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
#
#
wget -P /tmp https://releases.mattermost.com/${MM_NEW_VERSION}/mattermost-${MM_NEW_VERSION}-linux-amd64.tar.gz
#wget -P /tmp https://releases.mattermost.com/${MM_NEW_VERSION}/mattermost-team-${MM_NEW_VERSION}-linux-amd64.tar.gz
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.
#
tar -xf ${MM_TMP_DIR}/mattermost-${MM_NEW_VERSION}-linux-amd64.tar.gz \
-C ${MM_TMP_DIR} --transform='s,^[^/]\+,\0-upgrade,'
4.) Extrahieren Sie die Mattermost Server-Dateien.
tar -xf mattermost*.gz --transform='s,^[^/]\+,\0-upgrade,'
# 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
systemctl stop mattermost
Die Transformationsoption fügt dem obersten extrahierten Verzeichnis ein Suffix hinzu, damit es nicht mit dem üblichen Installationsverzeichnis in Konflikt steht.
# 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. mattermost-JJJJ-MM-TT-HH-mm).
#
# cd {Installationspfad}
# sudo cp -ra mattermost / mattermost-back - $ (Datum + '% F-% H-% M') /
#
mysqldump --login-path=local --opt $MM_DB_NAME > ${MM_BASE_INSTALL_PATH}/mattermost-$(date +'%F-%H-%M').sql
#mysqldump -u $MM_DB_USER -p$MM_DB_PASSWD --opt $MM_DB_NAME > ${MM_BASE_INSTALL_PATH}/mattermost-$(date +'%F-%H-%M').sql
cp -ra ${MM_BASE_INSTALL_PATH}/mattermost/ ${MM_BASE_INSTALL_PATH}/mattermost-back-$(date +'%F-%H-%M')/
5.) Stoppen Sie den Mattermost Server.
# 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
#
Unter Ubuntu 14.04 und RHEL 6:
sudo service mattermost stop
Unter Ubuntu 16.04 und RHEL 7:
sudo systemctl stop mattermost
find ${MM_BASE_INSTALL_PATH}/mattermost/ ${MM_BASE_INSTALL_PATH}/mattermost/client/ -mindepth 1 -maxdepth 1 \
\! \( -type d \( -path ${MM_BASE_INSTALL_PATH}/mattermost/client \
-o -path ${MM_BASE_INSTALL_PATH}/mattermost/client/plugins \
-o -path ${MM_BASE_INSTALL_PATH}/mattermost/config \
-o -path ${MM_BASE_INSTALL_PATH}/mattermost/logs \
-o -path ${MM_BASE_INSTALL_PATH}/mattermost/plugins \
-o -path ${MM_BASE_INSTALL_PATH}/mattermost/data \) -prune \) | sort | sudo xargs rm -r
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/
# 8.) Ändern Sie den Besitz der neuen Dateien, bevor Sie sie kopieren.
#
# sudo chown -hR mattermost:mattermost /tmp/mattermost-upgrade/
#
chown -hR ${MM_USER}:${MM_GROUP} /tmp/mattermost-upgrade/
# ---
# Hinweis
#
# Wenn Sie mattermost nicht als Eigentümer und Gruppe des Installationsverzeichnisses verwendet haben, führen Sie
# 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
# 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
# 9.) ALT - entfällt (s.u.)
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
# 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/
#
cp -an ${MM_TMP_DIR}/mattermost-upgrade/. ${MM_BASE_INSTALL_PATH}/mattermost/
rm -r ${MM_TMP_DIR}/mattermost-upgrade/
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.
# 11.) ALT - entfällt (s.u.)
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~
# 12.) 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
#
setcap cap_net_bind_service=+ep ${MM_BASE_INSTALL_PATH}/mattermost/bin/mattermost
Nach dem Upgrade des Servers müssen Benutzer möglicherweise ihre Browser aktualisieren, um neue Funktionen nutzen zu können.
# 13.) Starten Sie den Mattermost-Server.
#
systemctl start mattermost
# 14.) Wenn Sie eine Hochverfügbarkeitsbereitstellung verwenden, müssen Sie die obigen
# Schritte auf alle Knoten in Ihrem Cluster anwenden. Nach Abschluss sollten die
# MD5-Spalten für Konfigurationsdateien im Abschnitt Hochverfügbarkeit der
# Systemkonsole grün sein. Wenn sie gelb sind, stellen Sie bitte sicher, dass alle
# Knoten dieselbe Serverversion und dieselbe Konfiguration haben.
#
# Wenn sie immer noch gelb angezeigt werden, müssen Sie eine Konfigurationsweitergabe
# (config propagation) im gesamten Cluster auslösen:
#
# - Öffnen Sie die Systemkonsole, ändern Sie eine Einstellung und setzen Sie sie zurück.
# Dadurch wird die Schaltfläche Speichern für diese Seite aktiviert.
# - Klicken Sie auf Speichern.
#
# Dadurch wird keine Konfiguration geändert, sondern die vorhandene Konfiguration wird an
# alle Knoten im Cluster gesendet.
# ---
# Nach dem Upgrade des Servers müssen Benutzer möglicherweise ihre Browser aktualisieren, um
# neue Funktionen nutzen zu können.
# ---
# --------------------------------------------------------------------------------
# ==========================================================================================
# 9. 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~
#
mv ${MM_BASE_INSTALL_PATH}/mattermost/plugins/ ${MM_BASE_INSTALL_PATH}/mattermost/plugins~
mv ${MM_BASE_INSTALL_PATH}/mattermost/client/plugins/ ${MM_BASE_INSTALL_PATH}/mattermost/client/plugins~
# ================================================================================================
# 11.) 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.
# =========================================
# 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.
# ===================================================
# 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.
# 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.
# ===================================================
# Lizenzschlüssel hochladen
# ===================================================
# Ö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.