Zum Inhalt springen
labkompass

Assistent · ZFS

ZFS-Fehlerdiagnose

Wähle, was du beobachtest — der Assistent zeigt, was du in welcher Reihenfolge prüfst, welcher Befehl das zeigt und wie du das Ergebnis liest. Alle Befehle lesen nur. Reparaturen wie Platten tauschen, Fehler zurücksetzen oder einen Import erzwingen stehen bewusst im Guide, mit Voraussetzungen und Warnungen.

Was beobachtest du?

Pool ist DEGRADED

zpool status zeigt state: DEGRADED — der Pool läuft, aber ohne volle Redundanz.

Prüfe in dieser Reihenfolge

  1. 01Welches Gerät ist betroffen?

    zpool status -x

    Zeigt nur Pools mit Problemen, samt Gerätebaum, Fehlerzählern und Hinweistext („action:“).

    • Ein Gerät steht auf FAULTED, UNAVAIL oder REMOVED → weiter im Fall „Platte FAULTED, UNAVAIL oder REMOVED“.
    • Ein Gerät steht auf OFFLINE → es wurde mit zpool offline bewusst abgeschaltet; prüfen, ob das noch gewollt ist.
    • Alle Geräte ONLINE, aber Fehlerzähler ≠ 0 → weiter im Fall „READ-, WRITE- oder CKSUM-Fehler“.

  2. 02Was ist zuletzt passiert?

    zpool events -v | tail -n 60

    Das Ereignisprotokoll des Kernelmoduls: I/O-Fehler, Zustandswechsel, Resilver-Start und -Ende.

    • ereport.fs.zfs.io oder .checksum für dasselbe Gerät → Hardwareproblem an diesem Pfad (Platte, Kabel, Port).
    • resource.fs.zfs.statechange kurz nach einem Neustart → Gerät wurde beim Booten nicht rechtzeitig gefunden.

  3. 03Meldet das System selbst Fehler?

    sudo journalctl -k --since "-24h" | grep -iE 'ata|nvme|sd[a-z]|i/o error|reset'

    Kernelmeldungen der letzten 24 Stunden zu Laufwerken, Links und I/O-Fehlern.

    • Link-Resets oder Timeouts auf einem Port → häufig Kabel, Stromversorgung oder Controller, nicht zwingend die Platte.
    • Keine Meldungen → Gerät eher sauber entfernt oder beim Import nicht gefunden.

Mögliche Ursachen

Hypothesen, keine Diagnose — welche zutrifft, zeigen erst die Prüfungen oben.

  • Eine Platte ist ausgefallen oder wird nicht mehr erkannt.
  • Ein SATA-/SAS-Kabel, ein Port oder ein Netzteilstrang ist wackelig.
  • Die Platte wurde absichtlich offline genommen und nicht wieder eingebunden.
  • Beim Booten tauchte das Gerät unter einem anderen Namen auf (Pool mit /dev/sdX statt /dev/disk/by-id angelegt).

Häufige Fragen

Sind die Befehle gefahrlos?

Ja, sie zeigen nur Zustand, Ereignisse, Belegung und SMART-Werte an. Ein zpool import ohne Poolnamen sucht nur nach importierbaren Pools und importiert nichts. Alles, was den Pool verändert, steht im Guide zur Fehlersuche — dort mit Erklärung, wann es sicher ist.

Was mache ich zuerst, wenn ein Pool Probleme meldet?

Nichts überstürzt ändern: erst zpool status lesen, dann prüfen, ob ein aktuelles Backup existiert. Viele Folgeschäden entstehen durch hastige Befehle wie zpool clear, einen erzwungenen Import oder das Tauschen der falschen Platte.

Werden meine Eingaben gespeichert?

Es gibt keine Eingaben außer der Auswahl des Symptoms. In der Adresszeile steht höchstens dessen Kennung, damit sich ein Fall verlinken lässt.

Passende Tools

ZFS-RAM- und ARC-Planer →

ARC-Defaults je OpenZFS-Version, Platz neben Diensten und VMs, Dedup-Bedarf laut Doku und die modprobe-Zeile für ein dauerhaftes ARC-Limit.

smartctl Command Builder →

Festplatten-Gesundheit prüfen: Health-Check, SMART-Attribute und Selbsttests — mit Erklärung, wie Tests ablaufen.

ZFS-Pool-Konfigurator →

ZFS-Pool planen: Mirror oder RAIDZ, Platten per by-id, ashift, Kompression und Datasets — mit Probelauf (-n), Topologie-Vorschau und Prüfbefehlen.