# ------------------------------------
# Aktualisieren des Mattermost-Servers
# ------------------------------------
# How do I install the Extended Support Release (ESR)?
#
# see: https://docs.mattermost.com/upgrade/extended-support-release.html
#
# see:
# # Deploy Mattermost
# - https://docs.mattermost.com/guides/deployment.html
#
# # Extended Support Release
# - https://docs.mattermost.com/upgrade/extended-support-release.html
#
# # Mattermost Releases - Archive
# - https://mattermost.com/blog/category/platform/releases/
#
# # Version Archive
# - https://docs.mattermost.com/upgrade/version-archive.html
#
# # Mattermost changelog
# - https://docs.mattermost.com/deploy/mattermost-changelog.html
#
# # Upgrade Mattermost Server
# - https://docs.mattermost.com/administration/upgrade.html
#
# # Upgrade Mattermost Server
# - https://docs.mattermost.com/upgrade/upgrading-mattermost-server.html#id2
#
# # Upgrade Team Edition to Enterprise Edition
# - https://docs.mattermost.com/upgrade/upgrading-mattermost-server.html#upgrade-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=9.5.6
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.
