Checklist voor herstel van Btrfs-metagegevens op een bijna volle homeserver

Eva Wong is de technisch schrijver en vaste knutselaar bij ZimaSpace. Als levenslange geek met een passie voor homelabs en open-sourcesoftwareis ze gespecialiseerd in het vertalen van complexe technische concepten naar toegankelijke, praktische handleidingen. Eva vindt dat self-hosting leuk moet zijn en niet intimiderend. Met haar tutorials helpt ze de community om hardware-installaties te doorgronden, van het bouwen van hun eerste NAS tot het beheersen van Docker-containers.

De veilige aanpak is om schrijfbewerkingen te stabiliseren, werkruimte terug te winnen, alleen een gefilterde balance uit te voeren en gegevens te controleren voordat je de normale dienstverlening hervat. Behandel dit als een reeks controleerbare stappen, niet als één enkele opdracht.

Bij een bijna vol Btrfs-bestandssysteem op een homeserver bestaat het praktische risico dat Btrfs ENOSPC meldt of alleen-lezen wordt doordat de metadataruimte op is. Noteer de huidige identiteit en het herstelpunt, begin met de minst ingrijpende manier om de oorzaak te bepalen, beoordeel geslaagde en mislukte resultaten voordat je een andere variabele wijzigt en stop zodra de opslag instabiel wordt of de enige herstelbare kopie gevaar loopt. De onderstaande werkwijze is pas afgerond als de oorspronkelijke workload slaagt of het bewijs een grens bereikt waarop opschaling nodig is.

Stabiliseer het bestandssysteem voordat je herstel probeert

Stop containers, downloads, snapshots en logintensieve taken die naar het getroffen bestandssysteem schrijven. Sla kernelmeldingen en de uitvoer van btrfs device stats ergens anders op. Als het bestandssysteem opnieuw alleen-lezen is aangekoppeld of checksum-, parent-transid- of I/O-fouten meldt, houd het dan alleen-lezen totdat je een herstelbare kopie hebt.

Begin niet met btrfs check --repair, een volledige balance, defragmentatie of het massaal verwijderen van bestanden. De directe vraag is of de geldige bestandssysteemstatus geen ruimte voor toewijzing heeft, of dat opslagfouten metadata beschadigen; repareren als eerste stap kan het lastiger maken om dit onderscheid te zien en de resterende ruimte opgebruiken.

De veiligheidscontrole slaagt als schrijfintensieve services zijn gestopt, belangrijke gegevens een tweede kopie hebben en je weet welk blokapparaat en aankoppelpunt je onderzoekt. Schakel over op een herstelimage als het apparaat opnieuw wordt ingesteld, verdwijnt of leesfouten vertoont.

Lees de toewijzing af, niet alleen het algemene getal voor vrije ruimte

Voer btrfs filesystem usage -T /mount, btrfs filesystem df /mount en btrfs device usage /mount uit en controleer recente kernelmeldingen. Vergelijk de toegewezen met de gebruikte metadata en de niet-toegewezen ruimte op elk apparaat; met alleen de gewone opdracht df kun je niet zien of Btrfs nog een metadatachunk kan toewijzen.

Een gerichte balance vereist volledig ongebruikte werkruimte. Een uitgebreide gids voor een gerichte Btrfs-balance legt uit dat een niet-gefilterde balance alle daarvoor in aanmerking komende blockgroepen herschrijft en dat het doel is om niet-toegewezen ruimte op apparaatniveau te behouden, niet alleen een groot bestand te verwijderen en ervan uit te gaan dat metadata kan groeien.

Als het metadatagebruik hoog is maar er niet-toegewezen ruimte overblijft, kan een kleine gefilterde balance lege of licht gebruikte chunks terugwinnen. Als geen enkel apparaat werkruimte heeft, verwijder dan eerst veilig overbodige gegevens of snapshots in kleine batches, of voeg een tijdelijk apparaat toe dat geschikt is voor het bestandssysteemprofiel. Start geen verplaatsing die niet kan worden voltooid.

Werkruimte herstellen met de minst ingrijpende actie

Begin met het verwijderen van overbodige bestanden die niet door snapshots worden bewaard en verwijder daarna alleen snapshots waarvan is bevestigd dat ze niet nodig zijn. Synchroniseer en controleer het gebruik na elke kleine wijziging opnieuw. Als een balance gerechtvaardigd is, begin dan met btrfs balance start -dusage=0 -musage=0 /mount of een ander nauw begrensd filter dat is gekozen op basis van de waargenomen toewijzing, niet met een volledige balance.

De Linux-handleiding beschrijft dat filters voor balance de verplaatsing beperken en dat ENOSPC kan optreden wanneer balance zelf geen werkruimte heeft. Houd btrfs balance status en de kernel-logboeken in de gaten. Als het verplaatsen meer fouten veroorzaakt, vastloopt door apparaatfouten of de laatste veiligheidsmarge opsoupeert, annuleer het dan en ga terug naar herstel in alleen-lezenmodus.

Combineer geen filters en verwijderacties zonder tussendoor metingen te doen. Het herstel is geslaagd wanneer er ruimte over is voor metadata, er niet-toegewezen ruimte beschikbaar is op de benodigde apparaten en een kleine schrijfactie wordt voltooid zonder nieuwe ENOSPC-fout of gedwongen alleen-lezenstatus.

Controleer de gegevens en voorkom een onmiddellijke terugval

Herstart slechts één service met een laag risico en voer de workload na waarmee de metadata oorspronkelijk vol liep, zoals het maken van snapshots of het wijzigen van veel kleine bestanden. Controleer het gebruik en de kernel-logboeken opnieuw na de workload en na een herstart. Een mount die één keer werkt, maar bij normale wijzigingen weer alleen-lezen wordt, is niet hersteld.

Gebruik de ZimaSpace-methode om te bepalen of snapshots of actieve bestanden NAS-ruimte gebruiken voordat je de bewaartermijn wijzigt. Extents die door snapshots worden vastgehouden, kunnen ervoor zorgen dat verwijderen geen effect lijkt te hebben, terwijl wijzigingen in veel kleine actieve bestanden de metadata zwaar kunnen belasten. Het juiste beleid hangt af van wat de metingen aantonen.

Hervat de normale dienstverlening pas wanneer het bestandssysteem schrijfbaar blijft, de apparaatstatistieken niet meer oplopen, een representatief bestand correct wordt hersteld of de hash klopt, en monitoring waarschuwt voordat dezelfde veiligheidsmarge verdwijnt. Schakel bij aanhoudende structurele fouten een Btrfs-hersteltechnicus in en werk met een kloon in plaats van herstelopdrachten te herhalen op de enige kopie.

Ondersteuning en tips

Meer om te lezen

Get More Builds Like This

Stay in the Loop

Get updates from Zima - new products, exclusive deals, and real builds from the community.

Stay in the Loop preferences

We respect your inbox. Unsubscribe anytime.