Host-Upgrade und Paketquellenmigration

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!

Diese Seite beinhaltet die erforderlichen Schritte für ein Host-Upgrade und den Wechsel zu Zammads neuen Paketquellen. Wenn Sie nur Zammad selbst aktualisieren möchten, schauen Sie sich Sie bitte die Aktualisierung von Zammad an. Um nur zu den neuen Paketquellen zu wechseln ohne ein Host-Upgrade durchzuführen, überspringen Sie die Host-Upgrade-Schritte.

Ab Zammad 7 werden Pakete mit einer neuen Toolchain erstellt und unter einer anderen URL gehostet. Die Pakete werden für eine Zeit lang zwar weiterhin mit der alten Toolchain erstellt (mit Ausnahme von Debian 13), aber wir empfehlen Ihnen, die neuen Paketquellen zeitnah zu verwenden. Dies bedeutet, dass Sie einen neuen Paketquellen-Schlüssel hinzufügen und Ihre Paketquellen-Konfiguration ändern müssen.

WARNING

Stellen Sie immer sicher, dass Sie eine Sicherung Ihrer Daten haben, bevor Sie ein Upgrade durchführen.

Die folgenden Betriebssysteme werden unterstützt:

Distribution	Version
CentOS/RHEL	9
Debian	11, 12 & 13
OpenSUSE/SLES	Leap 15.x / 15
Ubuntu	22.04, 24.04

Zammad stoppen

sudo systemctl stop zammad

Host-Upgrade-Schritte

Aktualisierungen für Zammad deaktivieren

sudo apt-mark hold zammad

Host-Upgrade durchführen

Führen Sie das Host-Upgrade gemäß der Dokumentation Ihres Betriebssystems durch. Da es sich hierbei um eine anspruchsvolle und umfangreiche Aufgabe handelt, gibt es dazu hier keine Anleitung. Nach dem Upgrade Ihres Betriebssystems fahren Sie mit den nächsten Schritten fort.

Host neu starten

Falls Sie Ihr System nach dem Upgrade nicht neu gestartet haben, müssen Sie es jetzt neu starten. Prüfen Sie anschließend, ob alles wie erwartet läuft. Falls Zammad automatisch startet, stoppen Sie es wieder, bevor Sie mit den nächsten Schritten fortfahren.

Paketquelle anpassen

Alte Paketquelle entfernen

Entfernen Sie die alte Konfigurationsdatei der Paketquelle oder deaktivieren/löschen Sie die alte Paketquelle in Ihrem Paketmanager.

Ubuntu 22.04:

sudo rm /etc/apt/sources.list.d/zammad.sources

Ubuntu 24.04:

sudo rm /etc/apt/sources.list.d/zammad.list

Alten Paketquellen-Schlüssel entfernen

Entfernen Sie den alten Paketquellen-Schlüssel von Ihrem System. Je nach Betriebssystem und Version ist der Ort bzw. die Methode unterschiedlich.

sudo rm /etc/apt/keyrings/pkgr-zammad.gpg

Neue Paketquelle hinzufügen

Wenn der Paketquellen-Schlüssel für die alte und die neue Version Ihrer Distribution unterschiedlich ist oder Ihre Distribution diesen an einem anderen Ort erwartet, fügen Sie den neuen Schlüssel hinzu. Andernfalls können Sie direkt die neue Konfiguration der Paketquelle hinzufügen.

INFO

Es kann sein, dass Packager.io aus reinen IPv6-Umgebungen nicht erreichbar ist, daher sollten Sie dies bei der Durchführung der folgenden Schritte berücksichtigen.

Paketquellen-Schlüssel hinzufügen:

sudo curl -fsSL "https://go.packager.io/srv/deb/zammad/zammad/gpg-key.gpg" \
  -o /usr/share/keyrings/zammad.gpg && sudo chmod 644 /usr/share/keyrings/zammad.gpg

Paketquelle hinzufügen (Ubuntu 22.04):

sudo curl -fsSL "https://go.packager.io/srv/zammad/zammad/stable/installer/ubuntu/22.04.list" \
  -o /etc/apt/sources.list.d/zammad.list

Paketquelle hinzufügen (Ubuntu 24.04):

sudo curl -fsSL "https://go.packager.io/srv/zammad/zammad/stable/installer/ubuntu/24.04.list" \
  -o /etc/apt/sources.list.d/zammad.list

Zammad installieren

sudo apt update

sudo apt install zammad

Zammad aktualisieren

TIP

Wenn eine neue Version von Zammad verfügbar ist und Sie auf diese aktualisieren möchten, lesen Sie die Release Notes für erforderliche zusätzliche Schritte.

Aktivieren Sie die Updates für Zammad wieder und aktualisieren Sie Zammad auf die neueste Version, die für Ihr Betriebssystem verfügbar ist.

Aktualisierung des Paketindexes:

sudo apt update

Aktivieren der Aktualisierung für Zammad:

sudo apt-mark unhold zammad

Zammad aktualisieren:

sudo apt upgrade zammad

Zammad starten

sudo systemctl start zammad