Proxmox VE 7 auf Proxmox VE 8 aktualisieren

Diese Anleitung beschreibt ein Inplace-Upgrade eines Proxmox-VE-7-Knotens auf Proxmox VE 8 mit apt. Das System wird dabei von Debian 11 Bullseye auf Debian 12 Bookworm aktualisiert, und der Kernel 5.15 wird durch einen neueren ersetzt. Planen Sie Ausfallzeit ein: Der Knoten muss mindestens einmal, in der Regel zweimal neu gestartet werden.

Vor dem Start

Voraussetzungen

Prüfen Sie Folgendes, bevor Sie ein Repository anfassen:

• alle Knoten verwenden die neuesten Pakete von Proxmox VE 7.4 (pve-manager 7.4-15 oder neuer);
• mindestens 5 GB freier Speicherplatz im Root-Dateisystem;
• der Cluster ist in einwandfreiem Zustand, falls der Knoten Teil eines Clusters ist;
• Sie haben einen netzwerkunabhängigen Zugriff auf den Server, zum Beispiel über IP-KVM;
• ein gültiges, getestetes Backup aller virtuellen Maschinen und Container ist vorhanden.

Freien Speicherplatz im Root-Dateisystem prüfen:

df -h /

Verbindung zum Knoten herstellen

Verbinden Sie sich per SSH oder über IP-KVM. Starten Sie bei SSH eine tmux-Sitzung, damit das Upgrade weiterläuft, wenn die Verbindung abbricht:

apt update
apt install tmux
tmux new -s upgrade

Wenn die Verbindung verloren geht, verbinden Sie sich erneut und kehren Sie zur Sitzung zurück:

tmux attach -t upgrade

Am sichersten ist IP-KVM, da es auch dann funktioniert, wenn das Netzwerk des Knotens nach dem Neustart nicht hochkommt. Informationen zur Verbindung mit einem dedizierten Server über IP-KVM finden Sie unter Verbindung zum IDRAC KVM oder IP-KVM-Zugriff über OpenVPN (Server in DC2, DC3).

Virtuelle Maschinen und Container auf dem Knoten

Fahren Sie die virtuellen Maschinen und Container auf dem Knoten herunter oder migrieren Sie sie auf einen anderen Knoten, falls sie weiterlaufen müssen. Die Migration von einer älteren Proxmox-VE-Version auf eine neuere wird unterstützt. Die Migration von einer neueren Version zurück auf eine ältere wird nicht unterstützt.

Schritt 1. Proxmox VE 7 auf Version 7.4 aktualisieren

Das Prüfwerkzeug pve7to8 und ein sicherer Upgrade-Pfad sind nur mit den neuesten 7.4-Paketen verfügbar. Sie können die Updates in der Weboberfläche oder in der Kommandozeile installieren.

Repositories konfigurieren

Öffnen Sie den Knoten in der Weboberfläche und gehen Sie zu Updates → Repositories.

Wenn Sie kein kostenpflichtiges Abonnement haben, wählen Sie das Repository pve-enterprise aus und klicken Sie auf Disable. Dieses Repository erfordert einen Subscription-Key.

Klicken Sie auf Add, wählen Sie No-Subscription und klicken Sie im Dialog auf Add.

Updates installieren

Gehen Sie zu Updates und klicken Sie auf Refresh. Warten Sie, bis die Paketliste aktualisiert ist.

Klicken Sie auf Upgrade. Es öffnet sich ein Terminalfenster. Geben Sie auf die Rückfrage, ob fortgefahren werden soll, Y ein und drücken Sie die Eingabetaste.

Warten Sie, bis der Vorgang abgeschlossen ist, und schließen Sie das Fenster nicht. Am Ende fordert die Ausgabe zum Neustart des Knotens auf.

Dasselbe Update in der Kommandozeile. Ohne kostenpflichtiges Abonnement deaktivieren Sie zuerst das Enterprise-Repository und fügen das No-Subscription-Repository hinzu, wie oben in der Weboberfläche:

sed -i 's/^deb/#deb/' /etc/apt/sources.list.d/pve-enterprise.list
echo "deb http://download.proxmox.com/debian/pve bullseye pve-no-subscription" > /etc/apt/sources.list.d/pve-no-subscription.list

Installieren Sie anschließend die Updates:

apt update
apt dist-upgrade

deb http://archive.debian.org/debian bullseye main contrib
deb http://archive.debian.org/debian-security bullseye-security main contrib

Diese Zeilen werden nur benötigt, um Schritt 1 abzuschließen. Ersetzen Sie sie in Schritt 3 durch die dort gezeigten Bookworm-Zeilen, anstatt sed auszuführen.

Neustart und Versionsprüfung

Starten Sie den Knoten neu:

reboot

Aktualisieren Sie nach dem Start des Knotens die Browserseite und prüfen Sie die Version in der Summary des Knotens oder führen Sie aus:

pveversion

Die Ausgabe muss 7.4-15 oder neuer anzeigen.

Schritt 2. Das Prüfwerkzeug pve7to8 ausführen

Proxmox VE 7.4 enthält das Skript pve7to8. Es prüft das System lediglich und meldet Probleme; es ändert nichts. Führen Sie es mit allen aktivierten Prüfungen aus:

pve7to8 --full

Werten Sie das Ergebnis aus:

• FAIL-Einträge müssen vor dem Upgrade behoben werden;
• WARN-Einträge müssen gelesen und bewertet werden, auch wenn sie das Upgrade nicht blockieren;
• führen Sie das Skript nach jeder Korrektur erneut aus, um sicherzustellen, dass das Problem behoben ist.

Schritt 3. Repositories auf Bookworm umstellen

Debian-Repositories

Ersetzen Sie Bullseye durch Bookworm in der Haupt-Quellenliste:

sed -i 's/bullseye/bookworm/g' /etc/apt/sources.list

Wenn Sie in Schritt 1 auf archive.debian.org umgestellt haben, würde sed die Zeilen auf einen Bookworm-Pfad umbiegen, der im Archiv nicht existiert. Ersetzen Sie stattdessen den Inhalt von /etc/apt/sources.list durch die Standardzeilen für Debian 12:

deb http://deb.debian.org/debian bookworm main contrib
deb http://deb.debian.org/debian bookworm-updates main contrib
deb http://security.debian.org/debian-security bookworm-security main contrib

Stellen Sie anschließend sicher, dass in keiner Datei Bullseye-Einträge verbleiben:

grep -r bullseye /etc/apt/sources.list /etc/apt/sources.list.d/

Findet der Befehl Zeilen, aktualisieren Sie diese auf Bookworm oder kommentieren Sie sie mit # aus. Entfernen Sie alle Backports-Zeilen: Das Upgrade wurde nicht mit Paketen aus Backports getestet.

Prüfen Sie außerdem, dass keine zurückgehaltenen (held) oder halb installierten Pakete vorhanden sind. Beide Befehle müssen eine leere Ausgabe liefern:

apt-mark showhold
dpkg --audit

Proxmox-VE-Repository

Der Name der Repository-Datei hängt davon ab, wie das Repository hinzugefügt wurde. Listen Sie zunächst die Dateien auf:

ls /etc/apt/sources.list.d/

Ohne Abonnement aktualisieren Sie die Datei, die die Zeile pve-no-subscription enthält. Auf einem von der ISO installierten System ist das meist pve-install-repo.list:

sed -i 's/bullseye/bookworm/g' /etc/apt/sources.list.d/pve-install-repo.list

Die korrekte Zeile für Proxmox VE 8 ohne Abonnement lautet:

deb http://download.proxmox.com/debian/pve bookworm pve-no-subscription

Auf manchen Systemen enthält die Zeile nach deb zusätzlich [arch=amd64]. Das ist in Ordnung, behalten Sie es bei.

Stellen Sie sicher, dass das Enterprise-Repository deaktiviert ist: Wenn pve-enterprise.list existiert, muss ihre Zeile mit # auskommentiert sein, wie es nach der Deaktivierung in Schritt 1 der Fall ist.

Mit einem kostenpflichtigen Abonnement schreiben Sie das Enterprise-Repository und stellen sicher, dass in anderen Dateien keine aktive pve-no-subscription-Zeile verbleibt:

echo "deb https://enterprise.proxmox.com/debian/pve bookworm pve-enterprise" > /etc/apt/sources.list.d/pve-enterprise.list

Ceph-Repository

Überspringen Sie diesen Abschnitt, wenn Ceph auf dem Knoten nicht installiert ist.

Mit kostenpflichtigem Abonnement:

echo "deb https://enterprise.proxmox.com/debian/ceph-quincy bookworm enterprise" > /etc/apt/sources.list.d/ceph.list

Ohne Abonnement:

echo "deb http://download.proxmox.com/debian/ceph-quincy bookworm no-subscription" > /etc/apt/sources.list.d/ceph.list

Paketindex aktualisieren

apt update

Die Ausgabe darf keine Fehler enthalten. Jede Zeile muss auf bookworm verweisen.

Schritt 4. System auf Proxmox VE 8 aktualisieren

Starten Sie das Upgrade:

apt dist-upgrade

Die Dauer hängt von der Geschwindigkeit der Root-Platte ab: einige Minuten auf einer SSD, bis zu einer Stunde oder mehr auf einer langsamen HDD.

Abfragen während des Upgrades

Öffnet sich zu Beginn eine Seite mit Release Notes, schließen Sie sie mit q und fahren Sie fort.

Wenn gefragt wird, ob Dienste bei Paket-Upgrades automatisch neu gestartet werden sollen, wählen Sie mit den Pfeiltasten Yes und drücken Sie die Eingabetaste.

Abfragen zu Konfigurationsdateien

Während des Upgrades fragt apt, wie mit Konfigurationsdateien zu verfahren ist, die sowohl von Ihnen als auch vom Paket geändert wurden. Drücken Sie D, um den Unterschied anzuzeigen, bevor Sie antworten. Empfohlene Antworten für gängige Dateien:

• /etc/issue: behalten Sie Ihre Version (N). Proxmox VE erzeugt diese Datei beim Booten neu, sie betrifft nur den Anmeldebildschirm;
• /etc/lvm/lvm.conf: installieren Sie die Version des Paketbetreuers (Y), wenn Sie die Datei nicht selbst bearbeitet haben;
• /etc/apt/sources.list.d/pve-enterprise.list: wenn apt nach dieser Datei fragt, behalten Sie Ihre Version (N), andernfalls überschreibt apt das in Schritt 3 konfigurierte Repository;
• /etc/ssh/sshd_config: wenn Sie die Datei nicht bearbeitet haben, installieren Sie die Version des Betreuers (Y); sie ersetzt die veraltete Option ChallengeResponseAuthentication durch KbdInteractiveAuthentication. Wenn Sie SSH-Einstellungen selbst geändert haben, vergleichen Sie die Dateien sorgfältig;
• /etc/default/grub: diese Abfrage erscheint in der Regel nur, wenn Sie die Datei geändert haben, zum Beispiel um Kernelparameter hinzuzufügen. Prüfen Sie den Unterschied; wenn Sie unsicher sind, behalten Sie Ihre Version (N).

[ -d /sys/firmware/efi ] && apt install grub-efi-amd64

Führen Sie diesen Befehl auf UEFI-Systemen aus, die mit GRUB booten; das ist der Standard bei Installationen vom Proxmox-VE-ISO mit Root auf LVM. Auf einem System mit Legacy-BIOS bewirkt er nichts. Überspringen Sie ihn, wenn Root auf ZFS liegt: Solche Systeme booten über proxmox-boot-tool und sind nicht betroffen.

Ergebnis prüfen

Wenn apt dist-upgrade ohne Fehler abgeschlossen ist, führen Sie das Prüfwerkzeug erneut aus:

pve7to8 --full

Vor dem Neustart kann das Prüfwerkzeug WARN-Einträge zum laufenden Kernel und dazu anzeigen, dass LXCFS noch die alte FUSE-Bibliothek verwendet. Das ist zu erwarten: Beide verschwinden, nachdem Sie in Schritt 5 in den neuen Kernel neu gestartet haben. Es darf keine FAIL-Einträge geben.

Schritt 5. In den neuen Kernel neu starten

Starten Sie den Knoten neu. Das ist erforderlich, auch wenn Sie unter Proxmox VE 7 bereits den optionalen 6.2-Kernel verwendet haben:

reboot

Schritt 6. Ergebnis prüfen

Leeren Sie den Browser-Cache oder laden Sie die Weboberfläche mit Strg+Umschalt+R (Cmd+Umschalt+R unter macOS) neu. Prüfen Sie die Version in der Summary des Knotens oder mit:

pveversion

Starten Sie die virtuellen Maschinen und Container und prüfen Sie, ob sie funktionieren. Deaktivieren Sie in einem Cluster den Wartungsmodus auf dem Knoten und fahren Sie mit dem nächsten Knoten fort, wieder beginnend mit der Prüfung der Voraussetzungen.

Fehlerbehebung

Das Upgrade will proxmox-ve entfernen

Die Meldung W: (pve-apt-hook) You are attempting to remove the meta-package 'proxmox-ve'! bedeutet, dass noch ein Repository für Bullseye konfiguriert ist oder für Bookworm nicht existiert. Prüfen Sie alle Dateien in /etc/apt/sources.list.d/, korrigieren Sie die Repositories und führen Sie apt update erneut aus. Bestätigen Sie die Entfernung nicht.

Das Upgrade wurde unterbrochen

Wenn die Verbindung abgebrochen ist oder das Upgrade auf halbem Weg stehen geblieben ist, verbinden Sie sich erneut mit der tmux-Sitzung oder melden Sie sich neu an und führen Sie aus:

dpkg --configure -a
apt -f install
apt dist-upgrade

Abhängigkeitsfehler bei Ceph-Paketen

Meldet apt dist-upgrade auf einem Knoten ohne Ceph nicht erfüllte Abhängigkeiten für Ceph-Pakete, fügen Sie das Ceph-Quincy-No-Subscription-Repository aus Schritt 3 hinzu und führen Sie apt update erneut aus. Einige Proxmox-VE-Pakete können es während des Upgrades benötigen.

Der Knoten bootet nicht

Verbinden Sie sich über IP-KVM, um den Boot-Fehler zu sehen. Bei GRUB-Problemen siehe die offizielle Seite Recover From Grub Failure.

Wie geht es weiter

Proxmox VE 8 erhält keine Updates mehr. Planen Sie das Upgrade auf Proxmox VE 9 auf Debian 13 Trixie, das nach demselben Verfahren mit dem Prüfwerkzeug pve8to9 abläuft.

Wenn Sie Major-Upgrades lieber nicht selbst durchführen möchten, können die Spezialisten der Systemadministration von INTROSERV das Upgrade für Sie planen und durchführen.