337 lines
13 KiB
Plaintext
337 lines
13 KiB
Plaintext
# ------------------------------------
|
|
# Aktualisieren des Mattermost-Servers
|
|
# ------------------------------------
|
|
|
|
# How do I install the Extended Support Release (ESR)?
|
|
#
|
|
# see: https://docs.mattermost.com/upgrade/extended-support-release.html
|
|
|
|
#
|
|
# 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
|
|
# ===============================
|
|
|
|
# ---
|
|
# 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.
|
|
|
|
# ---
|
|
# 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
|
|
# ===========================================
|
|
|
|
MM_NEW_VERSION=5.33.3
|
|
MM_BASE_INSTALL_PATH=/opt
|
|
MM_DATA_DIR=/opt/mattermost/data
|
|
|
|
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
|
|
#
|
|
# 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:
|
|
#
|
|
# 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
|
|
|
|
|
|
|
|
# 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,'
|
|
|
|
|
|
|
|
# 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
|
|
|
|
|
|
|
|
# 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')/
|
|
|
|
|
|
# 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
|
|
#
|
|
|
|
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
|
|
|
|
|
|
|
|
# 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
|
|
# 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.
|
|
# ---
|
|
|
|
|
|
|
|
# 9.) ALT - entfällt (s.u.)
|
|
|
|
|
|
|
|
# 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/
|
|
|
|
|
|
|
|
# 11.) ALT - entfällt (s.u.)
|
|
|
|
|
|
|
|
# 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
|
|
|
|
|
|
|
|
# 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.
|
|
|
|
|
|
# ===================================================
|
|
# 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.
|