Waarom werkt een ZFS-hervattingstoken niet meer nadat de bestemming opnieuw is opgestart?

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.

Een herstart van de bestemming zou een ZFS-hervattingstoken normaal gesproken niet ongeldig moeten maken, tenzij de opgeslagen ontvangststatus, de dataset of de vereiste bronhistorie is gewijzigd.

Het token is een ondoorzichtige beschrijving van een specifieke onderbroken ontvangst, geen herbruikbare bladwijzer voor een latere replicatiepoging. Het hoort bij het bestemmingsbestandssysteem of -volume waarop de gedeeltelijke status met een hervatbare ontvangst is bewaard. Na het opnieuw opstarten kan een taak de verkeerde dataset uitlezen, de pool anders importeren, de gedeeltelijke status wissen, de bestemming wijzigen, een vereiste bronsnapshot kwijtraken of een incompatibele stream genereren. Controleer het token aan beide kanten voordat u een volledige overdracht opnieuw start.

Bevestig dat de gedeeltelijke ontvangststatus na het opnieuw opstarten behouden is gebleven

Lees op de bestemming de eigenschap receive_resume_token uit van het exacte bestandssysteem of volume dat voor de onderbroken ontvangst is gebruikt. Noteer de poolnaam, het datasetpad, de tokenwaarde en de ruimte die door de gedeeltelijke status wordt gebruikt.

Het FreeBSD-handboek legt uit dat hervatbare ontvangsten de gedeeltelijke status bewaren en een ondoorzichtig token op de ontvangende dataset bewaren totdat de overdracht is voltooid of de status expliciet is opgegeven.

Als de eigenschap na het opnieuw opstarten leeg is, is de ontvangst niet opgeslagen met de optie voor hervatbare ontvangst, is de gedeeltelijke status voltooid of afgebroken, wordt de verkeerde dataset bevraagd of heeft een geautomatiseerde opschoning de status verwijderd. Gebruik geen token opnieuw dat van een eerdere overdracht is gekopieerd.

Controleer of het token bij de exacte bestemmingsdataset hoort

Controleer of de bestemmingspool onder de verwachte naam is geïmporteerd en of de replicatie nog steeds op hetzelfde datasetpad is gericht. Let op alternatieve roots, hernoemde pools, wijzigingen in bovenliggende paden en taakopties die padcomponenten toevoegen of verwijderen.

In de ZFS-eigenschappenreferentie van Ubuntu wordt receive_resume_token gedefinieerd als een eigenschap van een dataset, wat betekent dat het token moet worden gelezen van het bestandssysteem of volume waarop die specifieke opgeslagen status zich bevindt.

Een token dat is opgehaald uit backup/pool/data kan niet zonder meer worden gebruikt om een ontvangst te hervatten die nu is gericht op backup/data. Corrigeer het taakpad voordat u snapshots wijzigt of de gedeeltelijke ontvangst verwijdert.

Controleer of de bestemming is gewijzigd of teruggedraaid

Controleer opdrachten, geplande taken, replicatiesoftware, bewaarbeleid voor momentopnamen en beheeractiviteiten sinds de onderbreking. Let op terugdraaiingen, promoties van klonen, hernoemingen van datasets, afgebroken ontvangsten of nieuwe ontvangsten naar hetzelfde doel.

Klara Systems merkt op dat replicatiesoftware de bestemmingsstatus beheert rond ZFS send en receive. Een orkestratietaak kan het oorspronkelijke herstelpad dus ongeldig maken door de opgeslagen status op te schonen of te vervangen.

Schrijf tijdens het onderzoek geen gewone bestanden naar een replicatiebestemming. Zelfs als het token nog bestaat, kunnen wijzigingen op de bestemming de stream blokkeren of een terugdraaiing afdwingen waardoor nieuwere gegevens op de bestemming verloren gaan.

Single board computer zimaboard2

Controleer of de bron de keten van momentopnamen of bladwijzers nog bevat

Identificeer de brondataset en de momentopnamen of bladwijzers die in de onderbroken overdracht zijn gecodeerd. Vergelijk deze met het huidige bewaarbeleid en eventuele hernoemingen of verwijderingen van momentopnamen sinds de overdracht is gestopt.

De handleiding voor zfs-send van FreeBSD vermeldt dat zfs send -t een stream genereert op basis van het hervattingstoken van de ontvangst. De nieuwe stream is daarmee gekoppeld aan de onderbroken ontvangst en niet aan een willekeurige huidige momentopname.

Als bewaarbeleid de benodigde bronhistorie heeft verwijderd, kan het token geen gegevens terughalen die niet meer bestaan. Behoud de resterende gedeeltelijke status op de bestemming totdat u hebt besloten of een andere bronkopie of een nieuwe volledige verzending nodig is.

Controleer de poolfuncties en streamopties op beide systemen

Noteer de ZFS-versies, ingeschakelde poolfuncties, versleutelingsstatus en de oorspronkelijke streamopties, zoals verzenden met raw, gecomprimeerde, ingebedde of grote blokken. Vergelijk deze na elke software- of poolupgrade.

De documentatie van Oracle over hervatbare replicatie beschrijft het hervatten van een onderbroken overdracht als een gecoördineerde verzend- en ontvangstbewerking. Compatibiliteit en de context van de oorspronkelijke overdracht blijven dus ook na een herstart van belang.

Alleen opnieuw opstarten verandert de functievlaggen niet, maar een upgrade tijdens de storing kan dat wel doen. Voer de hervattingsopdracht handmatig uit met uitgebreide uitvoer voordat u ervan uitgaat dat het token zelf beschadigd is.

Controleer replicatieservices en SSH nadat de bestemming is opgestart

Controleer of de bestemmingspool is geïmporteerd, vereiste versleutelde datasets zijn ontgrendeld, SSH actief is, de replicatiegebruiker ZFS-opdrachten kan uitvoeren en de taak pas start nadat de opslag gereed is.

Volgens de richtlijnen voor replicatie op afstand van TrueNAS moeten de vereisten voor SSH en datasets op de bestemming na het opnieuw opstarten beschikbaar zijn. Anders kan de automatisering mislukken voordat deze het opgeslagen token probeert te gebruiken.

Test de verificatie en voer een alleen-lezen-eigenschapsquery uit voordat je de hervatte stream start. Een netwerk- of machtigingsfout kan in een taaklogboek op hoofdlijnen op een tokenfout lijken.

Eenmaal hervatten of de gedeeltelijke ontvangst bewust afbreken

Genereer met het huidige token één hervatte verzendstream en voer die naar een hervatbare ontvangst op dezelfde bestemming. Sla de volledige foutuitvoer op en start geen replicatietaken parallel.

De NAS-datamigratiehandleiding van ZimaSpace bevat de aanvullende veiligheidsregel: behoud de bron en de mogelijkheid om terug te draaien totdat de bestemming is geverifieerd.

Als het token onbruikbaar is en de gedeeltelijke status niet langer waardevol is, breek deze dan af met de ondersteunde opdracht voor het afbreken van een ontvangst, maar pas nadat je hebt bevestigd dat er een nieuwe volledige of incrementele overdracht kan worden gegenereerd. Door het afbreken wordt de opgeslagen gedeeltelijke status vrijgemaakt; dit kan niet ongedaan worden gemaakt.

Veelgestelde vragen

Maakt het opnieuw opstarten van de bestemming een ZFS-hervattoken altijd ongeldig?

Nee. Een opgeslagen gedeeltelijke ontvangst is bedoeld om onderbrekingen, waaronder een niet-schone afsluiting, te overleven. Een fout na het opnieuw opstarten betekent meestal dat de taak een andere dataset leest, de gedeeltelijke status is gewist, de vereiste bronhistorie is gewijzigd of dat opstartafhankelijkheden ontbreken.

Kan er alleen vanaf de bron een nieuw hervattoken worden gegenereerd?

Nee. Het ondoorzichtige token is afkomstig uit de opgeslagen gedeeltelijke ontvangststatus van de bestemmingsdataset. De bron gebruikt dat token om een voortzettingsstream te genereren, maar kan een verwijderde status op de bestemming niet zelf herstellen.

Wanneer moet de gedeeltelijke ontvangst worden afgebroken?

Breek alleen af als is aangetoond dat het hervatpad onbruikbaar is, de bron een vervangende overdracht kan genereren en de gedeeltelijke toestand op de bestemming niet langer nodig is voor herstel. Bewaar logboeken en beschikbare momentopnamen voordat je deze verwijdert.

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.