Debian 13 Upgrade: So hebst du deinen Server auf trixie
Ein Debian 13 Upgrade hebt einen laufenden Server von der Vorgängerfassung auf die neue Fassung mit dem Codenamen trixie, ohne dass du ihn neu aufsetzen musst. Diese Anleitung führt dich durch den gesamten Ablauf: vom ersten Blick auf die installierte Fassung bis zum Aufräumen nach dem Neustart. Gedacht ist sie für alle, die einen eigenen Linux-Server betreiben und Debian als Betriebssystem einsetzen.
Zusammenfassung
- Der Umstieg gelingt nur von der Vorgängerfassung 12 (bookworm) aus
- Vollständige Sicherung anlegen und einmal hineinsehen, bevor du startest
- System aktualisieren, festgehaltene Pakete lösen, fremde Quellen stilllegen
- In allen Quellen-Dateien den Codenamen bookworm durch trixie ersetzen
- Aktualisierung in zwei Etappen, abgesichert durch eine Hintergrundsitzung
- Nach dem Neustart den Kernel prüfen und veraltete Pakete entfernen
Bevor du etwas eingibst
Der Umstieg selbst besteht aus wenigen Befehlen. Der größere Teil der Arbeit liegt davor: prüfen, lesen, sichern. Diese drei Handgriffe entscheiden darüber, ob ein Problem später eine Randnotiz bleibt oder einen ganzen Abend kostet.
Lässt sich dein System überhaupt heben
Der Sprung funktioniert ausschließlich von der unmittelbaren Vorgängerfassung aus. Welche Fassung auf deinem Server läuft, verrät die Datei /etc/debian_version:
cat /etc/debian_versionbashIn der Ausgabe muss die Vorgängerfassung 12 stehen. Findest du dort eine ältere Fassung oder eine andere Distribution, führt kein direkter Weg nach trixie. Dann setzt du den Server neu auf und spielst deine Daten anschließend aus der Sicherung zurück.
Beide Schreibweisen begegnen dir im Lauf des Umstiegs: Die Versionsbezeichnung lautet 13, der Codename trixie. Die Vorgängerfassung heißt 12 und trägt den Codenamen bookworm. In Konfigurationsdateien und Ausgaben steht mal die eine, mal die andere Form.
Was in den Veröffentlichungshinweisen für dich drinsteht
Zu jeder Fassung veröffentlicht das Projekt Hinweise mit bekannten Problemen, mit Paketen, die besondere Aufmerksamkeit brauchen, und mit Einschränkungen. Für dich zählt davon vor allem das Kapitel zum Umstieg. Lies es mit Blick auf die Programme, die auf deinem Server tatsächlich laufen, also Webserver, Datenbank, Mailsystem und die Laufzeitumgebungen deiner Anwendungen. Die Hinweise findest du in den Veröffentlichungshinweisen zum Umstieg.
Sichern, und die Sicherung einmal prüfen
Ein Umstieg kann aus Gründen scheitern, die nichts mit deiner Sorgfalt zu tun haben: ein Stromausfall mitten im Vorgang, ein defekter Datenträger, ein Paketkonflikt. Danach startet das System unter Umständen nicht mehr. Lege deshalb vorher eine vollständige Sicherung an. Hinein gehören mindestens:
- die Konfigurationen unter
/etc - die Nutzerdaten unter
/home - Abzüge aller Datenbanken
- sämtliche Web- und Anwendungsdaten
- die Liste der installierten Pakete
Wie du eine solche Sicherung regelmäßig und automatisiert anlegst, zeigt dir der Beitrag zum Server-Backup mit rsync. Liegen sensible Daten darin, lohnt sich zusätzlich ein Blick darauf, wie du Backups verschlüsselst.
Läuft dein Server als virtuelle Maschine, erstellst du zusätzlich eine Momentaufnahme oder ein vollständiges Abbild. Damit kommst du am schnellsten zum alten Zustand zurück, falls der Umstieg abbricht.
Die Liste der installierten Pakete schreibst du so weg:
dpkg --get-selections '*'bashLeite die Ausgabe in eine Datei um und nimm diese Datei mit in die Sicherung. Sie hilft dir später beim Vergleich, wenn nach dem Umstieg ein Paket fehlt.
Sieh nach dem Anlegen einmal in die Sicherung hinein und lies eine Datei testweise zurück. Eine Sicherung, die niemand geprüft hat, ist keine Sicherung, sondern eine Annahme.
Das alte System aufräumen
Je sauberer die Ausgangslage, desto ruhiger verläuft der Umstieg. Vier Handgriffe bringen dein System in diesen Zustand.
Alles auf den letzten Stand bringen
Bring zuerst die laufende Fassung vollständig am neuesten Stand. Das behebt Kleinigkeiten, die sonst mitwandern, und schafft eine klare Ausgangslage:
sudo apt update
sudo apt upgrade -y
sudo apt full-upgrade -y
sudo apt autoremove --purge -ybashDer letzte Befehl räumt gleich auch Pakete ab, die niemand mehr braucht.
Festgehaltene Pakete lösen
Einzelne Pakete stehen womöglich auf „zurückgehalten“. Sie werden nicht mitaktualisiert und können verhindern, dass sich Abhängigkeiten sauber auflösen. Lass dir zuerst anzeigen, welche das sind:
apt-mark showholdbashJedes Paket aus dieser Liste löst du einzeln, indem du paketname durch den tatsächlichen Namen ersetzt:
sudo apt-mark unhold paketnamebashFremde Paketquellen stilllegen
Zusätzliche Paketquellen, die nicht vom Projekt selbst stammen, sind eine der häufigsten Fehlerursachen beim Umstieg. Am ruhigsten läuft der Vorgang, wenn ausschließlich offizielle Pakete beteiligt sind. Diese Abfrage zeigt dir, was aus fremder Quelle installiert ist:
apt list '?narrow(?installed, ?not(?origin(Debian)))'bashLege die zugehörigen Quellen vor dem Umstieg still oder entferne sie ganz. Danach kannst du sie Stück für Stück wieder aktivieren.
Genug Platz im Zwischenspeicher
Der Umstieg lädt sehr viele Pakete herunter und legt sie zwischenzeitlich ab. Reicht der Platz nicht, bricht er mittendrin ab. Ein Probelauf zeigt dir das vorher, ohne etwas zu verändern:
sudo apt -o APT::Get::Trivial-Only=true full-upgradebashFehlt Platz, meldet sich das System so:
E: You don't have enough free space in /var/cache/apt/archives/.textIn diesem Fall schaffst du zuerst Platz und startest den Probelauf danach erneut.
Die Vorbereitung ist damit abgeschlossen. Ab hier greifst du ins System ein.
Die Paketquellen umstellen
Jetzt sagst du deinem System, wo es die neuen Pakete findet. Dafür ersetzt du in allen Einträgen den alten Codename durch den neuen:
| Ort | Was dort steht | Was du änderst |
|---|---|---|
/etc/apt/sources.list |
die Hauptquellen des Systems | jedes bookworm wird zu trixie |
/etc/apt/sources.list.d/ |
je eine Datei pro zusätzlicher Quelle | dieselbe Ersetzung in jeder einzelnen Datei |
Lege vor der Änderung eine Kopie der alten Dateien an. Damit kommst du jederzeit zum vorherigen Zustand zurück. Arbeite anschließend wirklich jede Datei durch: Bleibt ein Eintrag auf bookworm stehen, zieht dein System weiterhin Pakete aus der alten Quelle, und die Mischung aus zwei Fassungen führt zu Konflikten.
Die Sitzung gegen Abbrüche absichern
Läuft dein System auf einem gemieteten Server, etwa einem Linux vServer, erreichst du ihn über SSH. Dann ist ein Verbindungsabbruch das größte praktische Risiko. Der Umstieg läuft dann unvollständig aus und hinterlässt ein System zwischen zwei Fassungen. Abhilfe schafft ein Programm, das deine Arbeitssitzung im Hintergrund weiterlaufen lässt. Verbreitet sind screen und tmux, die folgenden Befehle zeigen screen:
sudo apt install screen -y
screen -S upgrade-sessionbashInnerhalb dieser Sitzung führst du alle weiteren Befehle aus. Bricht die Verbindung weg, arbeitet der Vorgang weiter, und du verbindest dich einfach neu.
In zwei Etappen aktualisieren
Der eigentliche Umstieg läuft in zwei Durchgängen. Diese Aufteilung senkt das Risiko, dass wichtige Dienste mitten im Vorgang ausfallen.
Erst der verträgliche Teil
Im ersten Durchgang ersetzt das System nur die Pakete, die sich ohne größere Konflikte austauschen lassen. Nichts wird entfernt, nichts Neues kommt dazu:
sudo apt update
sudo apt upgrade --without-new-pkgsbashDann der vollständige Durchlauf
Der zweite Durchgang erledigt den Rest. Dabei lädt, entpackt und richtet das System sehr viele Pakete ein:
apt full-upgradebashWährenddessen fragt dich das System mehrfach, wie es mit geänderten Konfigurationsdateien verfahren soll. In der Regel ist die vorgeschlagene neue Fassung die richtige Wahl. Eigene Anpassungen trägst du danach nach, dafür hast du die Kopien aus /etc in der Sicherung. Der Durchlauf dauert je nach Rechner und Leitung eine Weile. Lass das Terminal offen.
Neu starten und den Kernel prüfen
Zum Umstieg gehört üblicherweise ein neuer Kernel. Damit künftige Kernel-Aktualisierungen von selbst nachkommen, sollte ein Metapaket für das Kernel-Abbild installiert sein. Ob das der Fall ist, zeigt dir diese Abfrage:
dpkg -l 'linux-image*' | grep ^ii | grep -i metabashBleibt die Ausgabe leer, fehlt das Metapaket. Auf der verbreiteten 64-Bit-Architektur AMD64 installierst du es so nach:
sudo apt install linux-image-amd64bashDanach startest du den Server neu, denn ein neuer Kernel läuft erst nach einem Neustart. Melde dich anschließend wieder an und sieh nach, ob deine Dienste erwartungsgemäß hochgekommen sind.
Der Umstieg ist geschafft. Bleibt noch der Kehraus.
Aufräumen, was übrig bleibt
Nach dem Umstieg liegen Pakete auf dem Server, die es in der neuen Fassung nicht mehr gibt. Lass sie dir zuerst auflisten und entferne sie dann:
apt list '?obsolete'
sudo apt purge '?obsolete'bashVon entfernten Paketen bleiben außerdem Konfigurationsdateien zurück. Auch die gehen denselben Weg:
apt list '?config-files'
sudo apt purge '?config-files'bashSieh dir beide Listen vor dem Entfernen an. Darin steht gelegentlich etwas, das du bewusst behalten möchtest.
Wenn es schiefgeht
Genau für diesen Abschnitt war die Vorbereitung gut. Vier Fälle decken fast alles ab, was beim Umstieg passieren kann:
| Was passiert ist | Was jetzt hilft |
|---|---|
| Der Server startet nicht mehr | Die Momentaufnahme der virtuellen Maschine bringt dich am schnellsten zum alten Zustand zurück |
| Nach dem Umstieg fehlen Pakete | Vergleiche den aktuellen Bestand mit der gesicherten Paketliste und installiere gezielt nach |
| Pakete kommen aus der falschen Quelle | Sieh die Quellen-Dateien erneut durch, wahrscheinlich ist ein Eintrag beim Umstellen übersehen worden |
| Der Durchlauf bricht mittendrin ab | Behebe die gemeldete Ursache und starte den Durchlauf danach erneut, statt von Hand nachzubessern |
Diese Liste zeigt auch, warum sich die Vorarbeit lohnt. Ohne Momentaufnahme, ohne Paketliste und ohne Kopie der Quellen-Dateien wird aus jedem dieser Fälle eine Neuinstallation.
Sobald der Server wieder rund läuft, geht es an die Nacharbeit: Prüfe die Konfigurationen, die du beim vollständigen Durchlauf durch die neuen Fassungen ersetzt hast, und aktiviere die fremden Paketquellen einzeln wieder, sofern du sie brauchst. Ein guter Zeitpunkt ist das auch, um deinen Linux-Server abzusichern und die Sicherung von nun an regelmäßig laufen zu lassen.