Fernwartung Download starten

ZFS-Pool importieren und exportieren: Rettung in sieben Schritten, wenn das System abgeraucht ist

ZFSRescueTrueNAS
ZFS-Pool importieren und exportieren: Rettung in sieben Schritten, wenn das System abgeraucht ist

Wenn ein TrueNAS- oder Proxmox-Host nach einem Mainboard-Tod, einem verunglückten Update oder einem Blitzschaden nicht mehr startet, sind die Daten auf einem gesunden ZFS-Pool trotzdem fast immer zu retten. ZFS trennt die Daten konsequent vom Host: Pool-Metadaten liegen auf den Datenträgern selbst, nicht in einer Controller-Konfiguration und nicht in einer Datenbank des Betriebssystems. Wer die richtigen Schritte kennt, bekommt den Pool auf eine andere Appliance umgezogen, bevor der Kunde das erste Mal nachfragt.

In diesem Beitrag beschreiben wir den Ablauf, mit dem wir in der DATAZONE-Werkstatt kaputte Systeme regelmäßig wieder lauffähig machen. Die sieben Schritte sind nach dem realen Ablauf sortiert: vom sauberen zpool export über den korrekten Import mit by-id-Pfaden bis zum Scrub nach dem Umzug. Jeder Schritt enthält die typischen Stolperfallen, die uns in den letzten Jahren begegnet sind.

Warum ZFS-Pool-Rettung überhaupt funktioniert

Ein ZFS-Pool ist ein geschlossenes Konstrukt. Jede Platte eines vdevs trägt ein Label mit Pool-GUID, vdev-GUID, Hostid und Membership-Informationen. Das Hostsystem braucht nur die Platten im Zugriff und ein kompatibles ZFS-Modul – welches Betriebssystem darüber läuft, ist für den Pool selbst egal. Ein Pool aus einem TrueNAS 25.10 lässt sich im Rescue-Fall genauso in einem Debian-Live-System oder einer frischen Proxmox-Installation importieren, solange die ZFS-Version auf dem Zielsystem die Pool-Features unterstützt.

Zwei Dinge sind dabei entscheidend: Die Platten müssen vollständig und stabil erkannt werden, und das Zielsystem muss die Pool-Features kennen. Letzteres ist der häufigere Stolperstein: Wer einen Pool aus OpenZFS 2.2 auf einem älteren OpenZFS 2.1 importieren will und nebenbei neue Features wie raidz_expansion aktiviert hatte, bekommt beim Import einen harten Abbruch. Für den umgekehrten Weg – alter Pool auf neuem System – gibt es dieses Problem nicht.

Schritt 1: zpool export sauber auf dem alten System

Wenn das alte System noch irgendwie läuft, ist der sauberste Weg immer der zpool export. Dabei schreibt ZFS alle offenen Transaktionen aus dem Cache, entfernt den Pool aus /etc/zfs/zpool.cache und setzt im Label das “pool is exported”-Flag. Beim späteren Import auf dem neuen System gibt es dann keine Diskussionen über Hostids oder Force-Flags.

# Alle aktiven Shares, Jails, VMs oder Container stoppen
systemctl stop smbd nfs-kernel-server
zfs unmount -a

# Pool sauber aus dem System nehmen
zpool export tank

Wenn der Export mit pool is busy abbricht, hält irgendein Prozess noch ein Dataset offen. lsof +D /mnt/tank oder fuser -vm /mnt/tank zeigen den Verursacher. Bei TrueNAS SCALE sind das meist noch laufende Apps oder NFS-Clients, die ihre Mounts nicht freigegeben haben. Erst wenn zpool export ohne Fehler durchläuft, darf man die Platten physisch bewegen. Diesen Schritt überspringen wir nur dann, wenn das alte System gar nicht mehr bootet – dann wird der Import im Zweifel mit -f nachgeholt (siehe Schritt 4).

Schritt 2: Platten im neuen System erkennen lassen

Vor dem eigentlichen Import muss man sicher sein, dass alle Platten im Zielsystem sauber erkannt werden. Fehlt auch nur ein Member eines Mirror- oder RAID-Z-vdevs, importiert ZFS den Pool entweder gar nicht oder nur im degraded Modus. In unserer Werkstatt arbeiten wir nach einer festen Reihenfolge: Platten einbauen, System hochfahren, HBA im BIOS prüfen, dann lsblk, dmesg | grep -i ata und smartctl -a pro Platte durchlaufen lassen.

Besonders wichtig ist der Weg über /dev/disk/by-id/. Diese Pfade enthalten die Seriennummer der Platte und bleiben stabil, egal auf welchem Port oder in welchem Gehäuse die Disk hängt. Die klassischen /dev/sdX-Pfade sind beim Rescue tabu – sie können sich zwischen zwei Boots verschieben und führen zu Pools, in denen die halben Platten als UNAVAIL markiert sind.

# Platten mit Seriennummer und Mapping auflisten
ls -l /dev/disk/by-id/ | grep -v part
lsblk -o NAME,SIZE,MODEL,SERIAL,WWN

Wer von einem HBA im IT-Modus umzieht und im neuen System einen RAID-Controller findet, muss diesen zwingend auf JBOD oder HBA-Modus umkonfigurieren. ZFS braucht direkten Blockzugriff, sonst sind alle Checksum- und Self-Healing-Funktionen nutzlos.

Schritt 3: zpool import mit /dev/disk/by-id als Suchpfad

Der eigentliche Import beginnt immer mit einem lesenden zpool import ohne Argument. Dieser Aufruf scannt die konfigurierten Suchpfade nach ZFS-Labels und listet alle gefundenen Pools auf. In diesem Schritt wird nichts verändert, der Pool bleibt exportiert.

# Nur anzeigen, welche Pools gefunden werden
zpool import -d /dev/disk/by-id/

# Beispielausgabe:
#   pool: tank
#   id:   12345678901234567890
#   state: ONLINE
#   status: Some supported features are not enabled on the pool.
#   action: The pool can be imported using its name or numeric identifier.

Zeigt die Ausgabe state: ONLINE, ist der Pool komplett und gesund. Erscheint DEGRADED, fehlt ein Member, und man muss zurück zu Schritt 2. Bei FAULTED liegt ein echtes Problem vor – ein zweiter Ausfall in einem RAID-Z1, ein zerstörtes Label oder ein unvollständiger Mirror. Vor einem Force-Import ist dann zwingend eine Diagnose nötig, sonst verschlimmert man die Lage.

Mit -d /dev/disk/by-id/ wird ZFS gezwungen, die Platten über ihre stabilen Identifier aufzulisten. Das macht spätere Diagnosen deutlich einfacher, weil zpool status dann die Seriennummern statt sdX-Pfade zeigt.

Schritt 4: Force-Import, wenn der Pool nie exportiert wurde

Fehlt der saubere Export aus Schritt 1, meldet ZFS beim Import die bekannte Fehlermeldung “pool was previously in use from another system”. Das ist kein Datenschaden, sondern ein Schutzmechanismus: ZFS merkt sich im Label die Hostid des letzten Importers. Ein neues System hat eine andere Hostid, also verweigert ZFS den Import, um einen gleichzeitigen Doppelimport (z. B. bei SAN-Setups) zu verhindern.

Wenn man sicher ist, dass die alten Platten nirgendwo mehr aktiv sind, hilft der Force-Import:

zpool import -d /dev/disk/by-id/ -f tank

Nach dem erzwungenen Import setzt ZFS die Hostid auf das neue System um, und der Pool verhält sich wieder normal. Wichtig: -f ist kein Werkzeug für kaputte Pools, sondern nur für fehlenden Export. Wer einen FAULTED-Pool mit -f zwangsweise importiert, löst damit kein Problem, sondern maskiert nur die Warnung.

Schritt 5: Readonly-Import als Rettungsmodus

In zwei Fällen ist ein Readonly-Import die bessere Wahl: wenn der Pool nach einem Stromverlust in einem schlechten Zustand ist und man vor dem Mount zuerst die Daten sichern will, oder wenn ein Pool-Feature des Quellsystems auf dem Rescue-System fehlt. Readonly-Import schreibt kein neues Label, legt keinen neuen Pool-Cache an und verändert keine Metadaten.

# Readonly-Import mit alternativem Mountpoint
zpool import -d /dev/disk/by-id/ -o readonly=on -R /mnt/rescue tank

Mit -R /mnt/rescue setzt man einen altroot. Alle Datasets des Pools landen dadurch unter /mnt/rescue/... statt auf ihren ursprünglichen Mountpunkten. Das ist beim Rescue entscheidend, sonst versucht ZFS den Pool z. B. auf /mnt/tank zu mounten und zerlegt bei einem TrueNAS-Live-System die laufende Konfiguration.

Im Readonly-Modus kann man dann in Ruhe per rsync, zfs send oder restic eine konsistente Kopie auf ein zweites Ziel schieben, bevor man den Pool im Schreibmodus importiert und produktiv nimmt. Dieser Schritt hat uns in den letzten Jahren mehr als einmal den Hintern gerettet, wenn ein Kunde schon einmal versucht hatte, “selbst etwas zu reparieren”.

Schritt 6: Pool prüfen und Features anpassen

Nach dem Import, egal ob regulär oder mit Force, ist der erste Blick immer auf zpool status:

zpool status -v tank
zpool list -o name,size,alloc,free,fragmentation,health

Interessant sind drei Punkte: der Zustand jedes vdevs (ONLINE, DEGRADED, UNAVAIL), die Anzahl der Checksum-Fehler pro Platte und die Status-Zeile des Pools. Steht dort “Some supported features are not enabled”, bietet das neue System mehr Features als der Pool nutzt. Mit zpool upgrade tank schaltet man diese frei – aber nur, wenn man den Pool nicht wieder zurück auf das alte System transportieren will. Ein Pool-Upgrade ist nicht reversibel.

Taucht die Meldung “features are not supported on this pool” auf, läuft es umgekehrt: Der Pool nutzt Features, die das Zielsystem noch nicht kennt. In diesem Fall ist entweder ein Update der ZFS-Version auf dem Zielsystem fällig oder ein Downgrade des Pools unmöglich – dann hilft nur ein weiter Weg über zfs send auf ein kompatibles Ziel. Wir sehen das vor allem bei älteren TrueNAS-CORE-Hosts, die mit Pools aus aktuellen SCALE-Systemen überfordert sind.

Schritt 7: Scrub nach dem Import als Pflichtprogramm

Jeder gerettete Pool bekommt bei uns direkt nach dem Import einen vollständigen Scrub. Ein Scrub liest alle Daten plus alle Paritäts- oder Mirror-Kopien von der Platte und prüft sie gegen die ZFS-Checksummen. Beschädigte Blöcke werden aus der Redundanz repariert, und am Ende weiß man genau, in welchem Zustand der Pool ist.

# Scrub starten und Fortschritt verfolgen
zpool scrub tank
zpool status tank | grep scan

Der Scrub läuft im Hintergrund und kostet je nach Pool-Größe und Platten-IOPS zwischen wenigen Stunden und mehreren Tagen. Bei einem produktiven System planen wir den Scrub bewusst in eine Phase mit geringer Last ein – vollständig abschalten muss man die Dienste nicht, der Pool bleibt während des Scrubs voll nutzbar. Mehr zum Thema haben wir in ZFS Scrub und SMART ausführlicher beschrieben.

Findet der Scrub Fehler, zeigt zpool status -v die betroffenen Dateien einzeln an. Das ist der Moment, in dem man ein zweites Backup oder eine Replik aus dem Offsite-System einspielen kann – und der Grund, warum wir jeden produktiven TrueNAS mit mindestens einer replizierten Zweitkopie empfehlen.

Praxisfall: TrueNAS defekt, Disks in neue Appliance

Ein typischer Fall aus unserem Alltag: Ein Kunde meldet, dass seine TrueNAS Mini R nach einem Stromausfall nicht mehr startet. Nach Diagnose ist das Mainboard tot, die Platten sind unversehrt. Wir bauen die Disks in eine Ersatz-Appliance aus unserem TrueNAS-Konfigurator ein, booten das neue System und arbeiten die sieben Schritte durch. Ergebnis: Nach rund zwei Stunden läuft der Pool wieder, die SMB-Shares sind erreichbar, die Scrub-Prüfung läuft über Nacht. Für den Kunden sind das zwei Stunden Ausfall statt einer Woche Datenverlust.

Diese Art Rettungsarbeit gehört zu unserem Standard-Repertoire. Wer regelmäßig mit ZFS arbeitet, weiß, dass der Pool fast immer gerettet werden kann – kritisch wird es nur, wenn jemand ohne Erfahrung mit -f oder -FX an die Metadaten geht und dabei den Pool final zerlegt. Wenn Sie sich unsicher sind, erreichen Sie uns direkt über den TrueNAS-Support oder den allgemeinen IT-Service. Für die klassischen Bootpool-Fälle unter Linux haben wir die Rescue-Wege in Linux ZFS Boot-Mirror-Rescue separat beschrieben.

FAQ zur ZFS-Pool-Rettung

Kann ich einen ZFS-Pool von TrueNAS CORE in TrueNAS SCALE importieren?

Ja, das ist der klassische Migrationsweg bei iXsystems. CORE basiert auf FreeBSD mit OpenZFS, SCALE auf Debian mit OpenZFS. Pool-Features sind kompatibel, solange die OpenZFS-Versionen zueinander passen. Wichtig ist der saubere Export auf CORE vor dem Umzug und ein Readonly-Import als erster Testschritt auf SCALE. Mehr dazu haben wir in unserem Beitrag zur TrueNAS-Partnerschaft umrissen.

Was mache ich, wenn zpool import den Pool gar nicht findet?

Dann liegt das Problem meistens unterhalb von ZFS. Prüfen Sie lsblk, ob alle Platten mit korrekter Größe erkannt werden, und dmesg auf HBA- oder Kabelfehler. Fehlt eine Platte, taucht der Pool nicht auf, weil kein vollständiges vdev gefunden wird. Bei RAID-Z2 oder Mirror darf eine Platte fehlen, aber ZFS listet den Pool trotzdem – wenn er nicht auftaucht, fehlen Metadaten-Platten oder der HBA erkennt die Disks nicht.

Darf ich einen Pool mit -f erzwingen, der im Status FAULTED steht?

Nein, das ist das Gegenteil der richtigen Reaktion. -f übergeht nur die Hostid-Prüfung, nicht die Pool-Integrität. Ein FAULTED-Pool hat ein echtes Redundanz-Problem (etwa zwei ausgefallene Platten in RAID-Z1). Vor einem Import muss hier zuerst die fehlende Platte zurückgeholt oder repariert werden. Für die kritischen Fälle gibt es zpool import -FX, aber das ist Spezialistenarbeit – wir sehen bei unseren Kunden regelmäßig Pools, die nach einem unüberlegten -FX endgültig zerstört waren.

Wie lange dauert ein Scrub nach dem Import?

Faustregel: Ein Scrub schafft ungefähr die rohe sequenzielle Leserate der langsamsten Platte im vdev, verteilt über alle vdevs. Bei einem Pool aus acht 20-TB-HDDs in RAID-Z2 planen wir rund 24 bis 36 Stunden ein, bei einem reinen NVMe-Pool meist unter einer Stunde. Der Scrub läuft nebenher, der Pool bleibt produktiv.

Muss ich den Pool exportieren, bevor ich das System ausschalte?

Nein, ein geordnetes shutdown oder reboot reicht aus – das Betriebssystem exportiert den Pool automatisch. zpool export ist nur dann wichtig, wenn Sie die Platten physisch ausbauen oder in ein anderes System umziehen wollen. Ein Export schreibt zusätzlich das “exported”-Flag ins Label und macht den späteren Import ohne -f möglich.

Was passiert, wenn das Zielsystem eine ältere ZFS-Version hat als der Pool?

Dann verweigert zpool import den Zugriff, sobald der Pool mindestens ein Feature nutzt, das das Zielsystem nicht kennt. Readonly-Import funktioniert in manchen Fällen noch – ZFS liest die Daten dann, ohne die unbekannten Features zu modifizieren. Für den Produktivbetrieb muss das Zielsystem auf eine kompatible OpenZFS-Version aktualisiert werden. Wir setzen bei neuen Appliances im DATAZONE-Lager durchgehend auf TrueNAS 25.10 Goldeye als stabile Basis, so dass dieses Problem bei Umzügen zwischen unseren Systemen praktisch nicht auftritt.

Mehr zu diesen Themen:

TrueNAS-Sizing live durchspielen
Setzen Sie diesen Artikel direkt in eine konkrete Konfiguration um: Modell, Drives, RAID-Level und Netzwerk wählen — Kapazität wird in Echtzeit berechnet.
Jetzt konfigurieren

IT-Beratung gewünscht?

Kontaktieren Sie uns für eine unverbindliche Beratung zu Proxmox, OPNsense, TrueNAS und mehr.

Jetzt Kontakt aufnehmen