Reinstalling Proxmox VE Without Losing VM/LXC Data (ZFS Only)

TODO – WORK IN PROGRESSARBEIT

Warning:Warnung: ThisDiese methodMethode appliesgilt onlynur, whenwenn VMs andund LXCs areauf storedeinem onseparaten a separate ZFS poolZFS-Pool thatliegen, isder notnicht thedein Proxmox boot poolProxmox-Boot-Pool (rpool). Selectingist.
theWählst wrongdu diskswährend duringder installationInstallation willdie permanentlyfalschen eraseFestplatten VM/containeraus, data.löschst du deine VM-/Container-Daten für immer.

Scope:Geltungsbereich:
DesignedEntwickelt forfür single-nodeProxmox-Systeme Proxmoxmit systemseinem einzigen Knoten, usingdie ZFS.ZFS Multi-nodenutzen.
clustersBei requireeinem additionalCluster stepsmit formehreren clusterKnoten recoverybrauchst anddu arezusätzliche Schritte für die Cluster-Wiederherstellung – die werden nothier coverednicht herebehandelt.

---

Baseline ScenarioBasisszenario

• Host Type:Host-Typ: SingleEinzelner Proxmox VEVE-Knoten node usingmit ZFS

  • Boot Boot-Pool: rpool —– ZFS MirrorZFS-Spiegel (2× SSD)
  • Data Pool:Datenpool: zfs-data —– RAIDZ2 (4× NVMe) —– containshier allliegen VM/LXCalle disksVM-/LXC-Festplatten
  • Goal:Ziel: Reinstall Proxmox VE neu installieren withoutohne backingdie upVM-Festplatten-Images VMsichern diskzu imagesmüssen

---

StepSchritt 1: BackupWichtige CriticalKonfigurationsdateien Configuration Filessichern

VMDie andVM- LXCund LXC-metadataMetadaten ("shells"also quasi die „Shells“) areliegen stored in:hier:

/etc/pve

TheseDiese filesDateien defineenthalten names,Namen, hardwareHardware, settings,Festplatten disks,und and resources.Ressourcen.

VM Configuration FilesVM-Konfigurationsdateien

/etc/pve/qemu-server/*.conf

LXC Configuration FilesLXC-Konfigurationsdateien

/etc/pve/lxc/*.conf

RecommendedEmpfohlene Additionalzusätzliche BackupsSicherungen

/etc/network/interfaces
/etc/hosts
/etc/pve/storage.cfg

Tip:Tipp: UseNutze scp, rsync, oroder WinSCPWinSCP, toum copydie theseDateien toan aeinen safesicheren location.Ort zu kopieren.

---

StepSchritt 2: GracefullyAlle ShutRessourcen Downsauber All Resourcesherunterfahren

EnsuresDamit datadie consistency:Daten konsistent bleiben:

# Stop allAlle VMs stoppen
qm stop $(qm list | awk '‚NR>1 {print $1}'‘)

# Stop allAlle LXCs stoppen
pct stop $(pct list | awk '‚NR>1 {print $1}'‘)

ShutDanach downden theHost host:ausschalten:

shutdown -h now

---

StepSchritt 3: Reinstall Proxmox VE (Carefully)sehr vorsichtig) neu installieren

1. BootVon fromder Proxmox VEVE-ISO ISObooten

2. DuringBei diskder selection:Festplattenauswahl:

   • SelectWähle onlynur thedie SSDs usedaus, fordie zu rpool gehören
   • DoWähle notauf keinen Fall selectdie NVMeNVMe-Platten disks fromaus zfs-data aus

3. CompleteRest installationder normallyInstallation ganz normal durchlaufen

Critical:Wichtig: SelectingFalsche theFestplatten wrongauswählen disks= willdeine permanentlyVM-Daten destroysind VMfür data.immer weg.

---

StepSchritt 4: ImportDen thevorhandenen ExistingZFS-Datenpool ZFS Data Poolimportieren

AfterNach firstdem boot:ersten Boot:

zpool import

IfWenn zfs-data appearsautomatisch importedda automatically,ist continue.

→

Ifsuper, not:weiter.
Falls nicht:

zpool import -f zfs-data

Verify:Check danach:

zpool status zfs-data
zfs list

ConfirmSchau, thatob datasetsdie containingDatensätze VMmit disksdeinen areVM-Festplatten present.da sind.

---

StepSchritt 5: RestoreKonfigurationsdateien Configuration Fileszurückspielen

CopyKopier thedie savedgesicherten filesDateien back:wieder zurück:

scp qemu/*.conf root@<new-proxmox-ip>:/etc/pve/qemu-server/
scp lxc/*.conf root@<new-proxmox-ip>:/etc/pve/lxc/

TheyDie shouldsollten appearsofort in theder webWeboberfläche interface immediately.auftauchen.

---

StepSchritt 6: Re-AddDen the ZFS ZFS-Pool aswieder Storageals Speicher hinzufügen

Option A: Web Web-GUI (Recommended)empfohlen)

DatacenterRechenzentrum → StorageSpeicher → AddHinzufügen → ZFS
Select:Auswählen: zfs-data
Content:Inhalt: Disk image,Festplatten-Image, Container

Option B: Restore storage.cfg wiederherstellen

scp storage.cfg root@<new-proxmox-ip>:/etc/pve/storage.cfg
systemctl restart pve-cluster

---

StepSchritt 7: VerifyPrüfen, ob /etc/pve Availabilityfunktioniert (Important)sehr wichtig)

IfFalls /etc/pve appearsleer empty:aussieht:

systemctl status pve-cluster
systemctl status corosync
journalctl -xe

TheDas clusterCluster-Dateisystem filesystemmuss mustlaufen, besonst activekannst beforedu configurationdie filesKonfigurationsdateien arenicht usable.nutzen.

---

FinalAbschließende Check:Überprüfung: Start a Test Test-VM/LXC starten

qm start 100
pct start 103

IfStarten bothbeide startsauber correctly,→ theSystem systemist iswieder operational.einsatzbereit.

---

RecoveryHinweis Notezur Wiederherstellung

IfFalls configurationdu backupsdie areKonfigurationssicherungen missing,verloren metadatahast, maykannst stilldu bedie recoverableMetadaten byeventuell inspecting:trotzdem retten, indem du schaust:

/zfs-data

or:oder:

zfs list

DatasetDie namesDatensatz-Namen oftenentsprechen correspondmeist toden VM VM-IDs.

---

SummaryZusammenfassung

ByWenn preservingdu configurationdie filesKonfigurationsdateien andsicherst re-importingund theden existingalten ZFSZFS-Datenpool dataeinfach pool,wieder youimportierst, cankannst reinstalldu Proxmox VE neu installieren withoutohne migratingriesige largeVM-Disk-Images VMzu diskkopieren. images,Das significantlyspart reducingdir downtimemassiv andZeit, storageBandbreite requirements.und TheAusfallzeit. addedDie safetyganzen checksPrüfschritte helpmachen ensureden aProzess reliabledeutlich andsicherer recoverableund process.wiederholbar.