Host Upgrade

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!

If you installed Zammad via package manager and need to upgrade your host operating system, make sure to read the steps below. Some additional steps are required compared to just updating Zammad itself.

WARNING

Always make sure to have a backup of your data before performing an upgrade.

The following operating systems are supported:

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

Allgemein

The general steps, no matter which operating system you are using, are:

1. Zammad stoppen
2. Disable updates for Zammad
3. Perform host upgrade
4. Reboot host
5. Adjust package repository
6. Zammad aktualisieren
7. Zammad starten

Detailed Steps

Zammad stoppen

sudo systemctl stop zammad

Disable Updates for Zammad

sudo apt-mark hold zammad

Perform Host Upgrade

Perform the host upgrade according to the documentation of your operating system. Because this is an advanced task, we don't provide detailed steps here. After upgrading your operating system, proceed with the next steps.

Reboot Host

In case you did not reboot your system after the upgrade, make sure to reboot your system now. Afterwards, check if everything is running as expected. In case Zammad starts automatically, stop it again before proceeding with the next steps.

Adjust Package Repository

Remove Old Repository

Remove the old repository configuration file or disable/delete the old repository in your package manager.

Ubuntu 22.04:

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

Ubuntu 20.04:

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

Add New Repository

If the repository key is different for the old and new version your distribution or your distribution expects it in a different location, add the new one. Otherwise, you can add the new repository configuration directly.

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

Repository-Schlüssel hinzufügen:

curl -fsSL https://dl.packager.io/srv/zammad/zammad/key | \
gpg --dearmor | sudo tee /etc/apt/keyrings/pkgr-zammad.gpg > /dev/null \
&& sudo chmod 644 /etc/apt/keyrings/pkgr-zammad.gpg

Ubuntu 22.04

echo "deb [signed-by=/etc/apt/keyrings/pkgr-zammad.gpg] https://dl.packager.io/srv/deb/zammad/zammad/stable/ubuntu 22.04 main"| \
sudo tee /etc/apt/sources.list.d/zammad.list > /dev/null

Ubuntu 24.04

INFO

Beginnend mit Ubuntu 24.04 enthält diese Dokumentation den Befehl zum Hinzufügen des Repository im deb822-Format.

printf "Types: deb
URIs: https://dl.packager.io/srv/deb/zammad/zammad/stable/ubuntu
Suites: 24.04
Components: main
Signed-By: /etc/apt/keyrings/pkgr-zammad.gpg" | \
sudo tee /etc/apt/sources.list.d/zammad.sources > /dev/null

Update package index:

sudo apt update

Re-enable updates for Zammad:

sudo apt-mark unhold zammad

Update Zammad:

sudo apt upgrade zammad