Ein Debian 13 Upgrade hebt einen laufenden Server von der Vor­gän­ger­fas­sung 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 in­stal­lier­te Fassung bis zum Aufräumen nach dem Neustart. Gedacht ist sie für alle, die einen eigenen Linux-Server betreiben und Debian als Be­triebs­sys­tem einsetzen.

Zu­sam­men­fas­sung

  • Der Umstieg gelingt nur von der Vor­gän­ger­fas­sung 12 (bookworm) aus
  • Voll­stän­di­ge Sicherung anlegen und einmal hin­ein­se­hen, bevor du startest
  • System ak­tua­li­sie­ren, fest­ge­hal­te­ne Pakete lösen, fremde Quellen still­le­gen
  • In allen Quellen-Dateien den Codenamen bookworm durch trixie ersetzen
  • Ak­tua­li­sie­rung in zwei Etappen, ab­ge­si­chert durch eine Hin­ter­grund­sit­zung
  • 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 Hand­grif­fe ent­schei­den darüber, ob ein Problem später eine Randnotiz bleibt oder einen ganzen Abend kostet.

Lässt sich dein System überhaupt heben

Der Sprung funk­tio­niert aus­schließ­lich von der un­mit­tel­ba­ren Vor­gän­ger­fas­sung aus. Welche Fassung auf deinem Server läuft, verrät die Datei /etc/debian_version:

cat /etc/debian_version
bash

In der Ausgabe muss die Vor­gän­ger­fas­sung 12 stehen. Findest du dort eine ältere Fassung oder eine andere Dis­tri­bu­ti­on, führt kein direkter Weg nach trixie. Dann setzt du den Server neu auf und spielst deine Daten an­schlie­ßend aus der Sicherung zurück.

Zwei Namen für dieselbe Fassung

Beide Schreib­wei­sen begegnen dir im Lauf des Umstiegs: Die Ver­si­ons­be­zeich­nung lautet 13, der Codename trixie. Die Vor­gän­ger­fas­sung heißt 12 und trägt den Codenamen bookworm. In Kon­fi­gu­ra­ti­ons­da­tei­en und Ausgaben steht mal die eine, mal die andere Form.

Was in den Ver­öf­fent­li­chungs­hin­wei­sen für dich drinsteht

Zu jeder Fassung ver­öf­fent­licht das Projekt Hinweise mit bekannten Problemen, mit Paketen, die besondere Auf­merk­sam­keit brauchen, und mit Ein­schrän­kun­gen. Für dich zählt davon vor allem das Kapitel zum Umstieg. Lies es mit Blick auf die Programme, die auf deinem Server tat­säch­lich laufen, also Webserver, Datenbank, Mail­sys­tem und die Lauf­zeit­um­ge­bun­gen deiner An­wen­dun­gen. Die Hinweise findest du in den Ver­öf­fent­li­chungs­hin­wei­sen 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 Strom­aus­fall mitten im Vorgang, ein defekter Da­ten­trä­ger, ein Pa­ket­kon­flikt. Danach startet das System unter Umständen nicht mehr. Lege deshalb vorher eine voll­stän­di­ge Sicherung an. Hinein gehören min­des­tens:

  • die Kon­fi­gu­ra­tio­nen unter /etc
  • die Nut­zer­da­ten unter /home
  • Abzüge aller Da­ten­ban­ken
  • sämtliche Web- und An­wen­dungs­da­ten
  • die Liste der in­stal­lier­ten Pakete

Wie du eine solche Sicherung re­gel­mä­ßig und au­to­ma­ti­siert anlegst, zeigt dir der Beitrag zum Server-Backup mit rsync. Liegen sensible Daten darin, lohnt sich zu­sätz­lich ein Blick darauf, wie du Backups ver­schlüs­selst.

Läuft dein Server als virtuelle Maschine, erstellst du zu­sätz­lich eine Mo­ment­auf­nah­me oder ein voll­stän­di­ges Abbild. Damit kommst du am schnells­ten zum alten Zustand zurück, falls der Umstieg abbricht.

Die Liste der in­stal­lier­ten Pakete schreibst du so weg:

dpkg --get-selections '*'
bash

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

Eine un­ge­prüf­te Sicherung zählt nicht

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 Aus­gangs­la­ge, desto ruhiger verläuft der Umstieg. Vier Hand­grif­fe bringen dein System in diesen Zustand.

Alles auf den letzten Stand bringen

Bring zuerst die laufende Fassung voll­stän­dig am neuesten Stand. Das behebt Klei­nig­kei­ten, die sonst mit­wan­dern, und schafft eine klare Aus­gangs­la­ge:

sudo apt update
sudo apt upgrade -y
sudo apt full-upgrade -y
sudo apt autoremove --purge -y
bash

Der letzte Befehl räumt gleich auch Pakete ab, die niemand mehr braucht.

Fest­ge­hal­te­ne Pakete lösen

Einzelne Pakete stehen womöglich auf „zu­rück­ge­hal­ten“. Sie werden nicht mit­ak­tua­li­siert und können ver­hin­dern, dass sich Ab­hän­gig­kei­ten sauber auflösen. Lass dir zuerst anzeigen, welche das sind:

apt-mark showhold
bash

Jedes Paket aus dieser Liste löst du einzeln, indem du paketname durch den tat­säch­li­chen Namen ersetzt:

sudo apt-mark unhold paketname
bash

Fremde Pa­ket­quel­len still­le­gen

Zu­sätz­li­che Pa­ket­quel­len, die nicht vom Projekt selbst stammen, sind eine der häu­figs­ten Feh­ler­ur­sa­chen beim Umstieg. Am ruhigsten läuft der Vorgang, wenn aus­schließ­lich of­fi­zi­el­le Pakete beteiligt sind. Diese Abfrage zeigt dir, was aus fremder Quelle in­stal­liert ist:

apt list '?narrow(?installed, ?not(?origin(Debian)))'
bash

Lege die zu­ge­hö­ri­gen Quellen vor dem Umstieg still oder entferne sie ganz. Danach kannst du sie Stück für Stück wieder ak­ti­vie­ren.

Genug Platz im Zwi­schen­spei­cher

Der Umstieg lädt sehr viele Pakete herunter und legt sie zwi­schen­zeit­lich ab. Reicht der Platz nicht, bricht er mit­ten­drin ab. Ein Probelauf zeigt dir das vorher, ohne etwas zu verändern:

sudo apt -o APT::Get::Trivial-Only=true full-upgrade
bash

Fehlt Platz, meldet sich das System so:

E: You don't have enough free space in /var/cache/apt/archives/.
text

In diesem Fall schaffst du zuerst Platz und startest den Probelauf danach erneut.

Die Vor­be­rei­tung ist damit ab­ge­schlos­sen. Ab hier greifst du ins System ein.

Die Pa­ket­quel­len 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 Haupt­quel­len des Systems jedes bookworm wird zu trixie
/etc/apt/sources.list.d/ je eine Datei pro zu­sätz­li­cher Quelle dieselbe Ersetzung in jeder einzelnen Datei

Lege vor der Änderung eine Kopie der alten Dateien an. Damit kommst du jederzeit zum vor­he­ri­gen Zustand zurück. Arbeite an­schlie­ß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 Kon­flik­ten.

Die Sitzung gegen Abbrüche absichern

Läuft dein System auf einem ge­mie­te­ten Server, etwa einem Linux vServer, erreichst du ihn über SSH. Dann ist ein Ver­bin­dungs­ab­bruch das größte prak­ti­sche Risiko. Der Umstieg läuft dann un­voll­stän­dig aus und hin­ter­lässt ein System zwischen zwei Fassungen. Abhilfe schafft ein Programm, das deine Ar­beits­sit­zung im Hin­ter­grund wei­ter­lau­fen lässt. Ver­brei­tet sind screen und tmux, die folgenden Befehle zeigen screen:

sudo apt install screen -y
screen -S upgrade-session
bash

Innerhalb dieser Sitzung führst du alle weiteren Befehle aus. Bricht die Ver­bin­dung weg, arbeitet der Vorgang weiter, und du ver­bin­dest dich einfach neu.

In zwei Etappen ak­tua­li­sie­ren

Der ei­gent­li­che Umstieg läuft in zwei Durch­gän­gen. Diese Auf­tei­lung senkt das Risiko, dass wichtige Dienste mitten im Vorgang ausfallen.

Erst der ver­träg­li­che Teil

Im ersten Durchgang ersetzt das System nur die Pakete, die sich ohne größere Konflikte aus­tau­schen lassen. Nichts wird entfernt, nichts Neues kommt dazu:

sudo apt update
sudo apt upgrade --without-new-pkgs
bash

Dann der voll­stän­di­ge Durchlauf

Der zweite Durchgang erledigt den Rest. Dabei lädt, entpackt und richtet das System sehr viele Pakete ein:

apt full-upgrade
bash

Wäh­rend­des­sen fragt dich das System mehrfach, wie es mit ge­än­der­ten Kon­fi­gu­ra­ti­ons­da­tei­en verfahren soll. In der Regel ist die vor­ge­schla­ge­ne neue Fassung die richtige Wahl. Eigene An­pas­sun­gen 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 üb­li­cher­wei­se ein neuer Kernel. Damit künftige Kernel-Ak­tua­li­sie­run­gen von selbst nach­kom­men, sollte ein Metapaket für das Kernel-Abbild in­stal­liert sein. Ob das der Fall ist, zeigt dir diese Abfrage:

dpkg -l 'linux-image*' | grep ^ii | grep -i meta
bash

Bleibt die Ausgabe leer, fehlt das Metapaket. Auf der ver­brei­te­ten 64-Bit-Ar­chi­tek­tur AMD64 in­stal­lierst du es so nach:

sudo apt install linux-image-amd64
bash

Danach startest du den Server neu, denn ein neuer Kernel läuft erst nach einem Neustart. Melde dich an­schlie­ßend wieder an und sieh nach, ob deine Dienste er­war­tungs­ge­mäß hoch­ge­kom­men 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'
bash

Von ent­fern­ten Paketen bleiben außerdem Kon­fi­gu­ra­ti­ons­da­tei­en zurück. Auch die gehen denselben Weg:

apt list '?config-files'
sudo apt purge '?config-files'
bash

Sieh dir beide Listen vor dem Entfernen an. Darin steht ge­le­gent­lich etwas, das du bewusst behalten möchtest.

Wenn es schief­geht

Genau für diesen Abschnitt war die Vor­be­rei­tung 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 Mo­ment­auf­nah­me der vir­tu­el­len Maschine bringt dich am schnells­ten zum alten Zustand zurück
Nach dem Umstieg fehlen Pakete Ver­glei­che den aktuellen Bestand mit der ge­si­cher­ten Pa­ket­lis­te und in­stal­lie­re gezielt nach
Pakete kommen aus der falschen Quelle Sieh die Quellen-Dateien erneut durch, wahr­schein­lich ist ein Eintrag beim Umstellen übersehen worden
Der Durchlauf bricht mit­ten­drin ab Behebe die gemeldete Ursache und starte den Durchlauf danach erneut, statt von Hand nach­zu­bes­sern

Diese Liste zeigt auch, warum sich die Vorarbeit lohnt. Ohne Mo­ment­auf­nah­me, ohne Pa­ket­lis­te und ohne Kopie der Quellen-Dateien wird aus jedem dieser Fälle eine Neu­in­stal­la­ti­on.

Sobald der Server wieder rund läuft, geht es an die Nach­ar­beit: Prüfe die Kon­fi­gu­ra­tio­nen, die du beim voll­stän­di­gen Durchlauf durch die neuen Fassungen ersetzt hast, und aktiviere die fremden Pa­ket­quel­len einzeln wieder, sofern du sie brauchst. Ein guter Zeitpunkt ist das auch, um deinen Linux-Server ab­zu­si­chern und die Sicherung von nun an re­gel­mä­ßig laufen zu lassen.

Zum Hauptmenü