Zammad aktualisieren

TIP

Haben Sie genug von komplizierten Aufgaben rund um die Einrichtung, Konfiguration, Sicherung und Aktualisierung? Lassen Sie uns diese Dinge für Sie erledigen! 🚀

Der einfachste und oft auch kostengünstigste Weg, Zammad zu betreiben, ist unser Cloud-Dienst. Testen Sie es in einer kostenlosen Testinstanz!

Bevor Sie Zammad aktualisieren, empfehlen wir Ihnen dringend, einen Blick in unsere Release Notes zu werfen. Dort finden Sie Informationen über Funktionen und Fehlerbehebungen sowie Anmerkungen zu Änderungen und Breaking Changes.

Beachten Sie, dass Sie bei der Aktualisierung keine Hauptversionen von Zammad überspringen sollten. Das bedeutet zum Beispiel, dass Ihr Upgrade-Pfad von Version 2.4 auf 5.1 (unter der Annahme, dass dies die aktuelle stabile Version ist) folgendermaßen aussehen würde: 2.4 → 3.0 → 4.0 → 5.0 → letzte stabile Version (5.1)

INFO

Diese Seite beinhaltet ausschließlich die Aktualisierung von Zammad. Wenn Sie Ihr Host-Betriebssystem ebenfalls aktualisieren möchten, sehen Sie sich die Seite Host-Upgrade und Paketquellen-Migration an.

Update package installation

Check dependencies

Bevor Sie fortfahren, überprüfen Sie, ob Ihre Systemumgebung den Anforderungen von Zammad entspricht (siehe Voraussetzungen und Paketinstallation).

Zammad stoppen

sudo systemctl stop zammad

Backup von Zammad

Erstellen Sie ein Backup. Sie können das Backup-Skript verwenden, das mit dem Zammad-Paket ausgeliefert wird.

Zammad aktualisieren

INFO

Wenn Sie Ihr gesamtes System aktualisieren und es gibt Updates für Zammad und Ihren Datenbankserver, kann dies zu Fehlern führen, da Ihre Datenbank möglicherweise nicht wieder online ist, wenn Zammad aktualisiert wird.

In einem solchen Fall sollten Sie Zammad vorübergehend von der Aktualisierung ausschließen, wie in den folgenden Befehlen zu sehen.

Paketlisten aktualisieren:

sudo apt update

Aktualisierung für Zammad deaktivieren:

sudo apt-mark hold zammad

Alle Pakete außer Zammad aktualisieren:

sudo apt upgrade

Aktivieren der Aktualisierung für Zammad:

sudo apt-mark unhold zammad

Zammad aktualisieren:

sudo apt upgrade

Additional steps

Auch die Aktualisierung von Elasticsearch kann relevant sein. Stellen Sie sicher, dass Sie eine unterstützte Version von Elasticsearch installiert haben (siehe Paket-Installation für unterstützte Versionen).

Wenn Sie Elasticsearch aktualisieren müssen, werfen Sie bitte einen Blick auf deren Dokumentation und folgen Sie den Anweisungen.

Rebuild Elasticsearch index optional

Wird nur benötigt, wenn Sie in den Release-Notes aufgefordert werden, den Elasticsearch-Index neu zu erstellen.

Ohne Vorgabe der zu verwendenden CPU-Kerne:

zammad run rake zammad:searchindex:rebuild

Mit Vorgabe der zu verwendenden CPU-Kerne (Beispiel 8):

zammad run rake zammad:searchindex:rebuild[8]

Zammad starten

sudo systemctl start zammad

Update Docker installation

WARNING

Aktualisierungen des Docker Compose Stacks können zusätzliche Schritte erfordern oder Breaking Changes beinhalten. Prüfen Sie immer zuerst die Docker Compose Release-Notes auf Hinweise für die Aktualisierungen.

TIP

Wenn Sie Zammad auf eine bestimmte Version aktualisieren möchten, verwenden Sie die Umgebungsvariable VERSION (Beispiel mit weiteren Details) und geben die gewünscht Version an.

Updating Portainer based installations

Klicken Sie in Ihrem Zammad-Stack auf Pull and redeploy, aktivieren Sie Re-pull image and redeploy und klicken Sie auf Update.

Updating Docker Compose based installations

cd zammad-docker-compose

git pull

docker compose pull

docker compose up -d

Rebuild Elasticsearch index optional

Wird nur benötigt, wenn Sie in den Release-Notes aufgefordert werden, den Elasticsearch-Index neu zu erstellen.

Without specifying CPU cores:

docker compose run --rm zammad-railsserver bundle exec rake zammad:searchindex:rebuild

With specifying CPU cores to use (example 8):

docker compose run --rm zammad-railsserver bundle exec rake zammad:searchindex:rebuild[8]