# ------------------------------------
# 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.