Gå til innhold

ZFS-datasett

ZFS-datasett er elementer i listen Sikkerhetskopier, som containere og VM-er. Et element er ett datasett sammen med hvert datasett under det. For hver sikkerhetskopi tar BombVault ett ZFS-øyeblikksbilde av hele treet, så hvert datasett i det fanges i samme øyeblikk. Deretter leser det filene til hvert datasett fra det øyeblikksbildet og lagrer dem med restic, på samme måte som en mappe, og fjerner øyeblikksbildet rett etterpå. Sikkerhetskopiene er deduplisert, du kan bla gjennom hver av dem, og enkeltfiler kan gjenopprettes.

Sikkerhetskopien sender aldri en strøm inn i restic og ruller aldri et datasett tilbake. BombVault sletter bare øyeblikksbilder det har laget selv. Den valgfrie replikaen er det eneste stedet som bruker zfs send: den kopierer datasettene til en andre ZFS-server og rører ikke sikkerhetskopien.

Krav

  • SSH-forbindelsen til denne serveren. ZFS-datasett bruker samme nøkkel, vert og bruker som VM-sikkerhetskopier. Fungerer VM-sikkerhetskopier allerede, fungerer dette også. Ellers følger du veiledningen for VM-sikkerhetskopi over SSH. Malfeltene heter Host SSH: Address, Host SSH: Port og Host SSH: User.
  • Kommandoen zfs på den verten. Unraid 6.12 og nyere og TrueNAS SCALE har den.
  • Host Data mappet som /mnt med Access Mode Read/Write - Slave. Det er malens standard. Øyeblikksbildet av et datasett dukker først opp i datasettets mappe .zfs/snapshot etter at BombVault har startet, så containeren må motta monteringene verten lager senere.
  • Datasettene montert under /mnt. På Unraid ligger pools under /mnt/<pool>, så det er allerede tilfellet.

Slå på området under Innstillinger, Generelt (ZFS-datasett). ZFS-tilkobling til denne serveren under Mer på siden Sikkerhetskopier åpner da Forbindelse til denne serveren. Det tester SSH-forbindelsen, navngir brukeren og verten det kobler til, og sier hva som mangler når noe mangler. Er forbindelsen nede, sier listen Sikkerhetskopier det med Vis tilkoblingen, og kortet Host-integrasjon på oversikten viser det samme resultatet.

Elementer og underdatasett

Velg Legg til på siden Sikkerhetskopier, deretter Et ZFS-datasett. Listen kommer fra serveren. Velg datasettet øverst i det du vil sikkerhetskopiere, for eksempel cache/appdata, så dekker elementet det og hvert datasett under det.

  • Nye underdatasett blir med av seg selv. Et datasett som opprettes senere under elementet, sikkerhetskopieres ved neste kjøring, og den kjøringen nevner det som nytt. Den første sikkerhetskopien leser det helt én gang. Deretter leses bare endringer.
  • Du kan utelate enkelte underdatasett. Slå et av på fanen Innstillinger til elementet, så utelates det sammen med alt under. Et utelatt underdatasett som ikke lenger finnes på serveren, merkes som det og kan fjernes fra listen.
  • Underdatasett som ikke kan leses, hoppes over, aldri i stillhet. Kjøringen lister dem, elementet viser hvor mange som ble hoppet over, og kortet Ikke sikkerhetskopiert på oversikten teller hvert av dem som ubeskyttet. Kjøringen sikkerhetskopierer fortsatt alt annet og feiler ikke på grunn av et underdatasett som ble hoppet over. Årsakene står i tabellen med årsakskoder: et datasett som ikke er montert, har canmount=off, et legacy- eller ikke noe monteringspunkt, en krypteringsnøkkel som ikke er lastet, øyeblikksbildetilgang slått av, eller et monteringspunkt BombVault ikke kan se.
  • Et datasett som hoppes over, tar ikke med seg underdatasettene sine. Et datasett med canmount=off som bare inneholder andre datasett, hoppes over (vist som "bare struktur"), og de monterte underdatasettene sikkerhetskopieres. Et kryptert datasett der nøkkelen ikke er lastet, hoppes over sammen med underdatasettene som deler nøkkelen.
  • Underdatasett som er VM-disker eller systemdata, starter avslått i dialogen for å legge til, med årsaken ved siden av bryteren. Legger du til en hel pool, må du bekrefte det i en dialog som lister hva den inneholder.

Volumer

Et volum (zvol) inneholder en virtuell disk i stedet for filer, og et ZFS-element tar aldri sikkerhetskopi av ett.

  • Et volum som en VM bruker, sikkerhetskopieres sammen med den VM-en.
  • Et volum som ingen VM bruker (en iSCSI-extent, en disk du har koblet fra) sikkerhetskopieres ikke av BombVault. Tilleggsvinduet og siden Sikkerhetskopier teller disse volumene og sier det. En senere versjon vil sikkerhetskopiere dem.

Volumer i et elements tre hoppes over og nevnes ved hver kjøring.

Dockers lagring

Med Dockers ZFS-lagringsdriver er hvert bildelag et datasett med legacy-monteringspunkt. Dialogen for å legge til samler dem i én linje per overordnet datasett. Et tre med mer enn 20 slike datasett kan ikke bli et element: Så lenge det finnes et øyeblikksbilde av det, kan ikke Docker fjerne bildelag. Legg i stedet til datasettene under det, for eksempel appdata.

Elementer overlapper aldri

Et datasett kan bare høre til ett element. BombVault avviser et nytt element som ligger inni et eksisterende eller som ville inneholde et. For å slå sammen flere underelementer til ett overordnet element sletter du først underelementene og velger å beholde sikkerhetskopiene deres, og legger så til det overordnede. Hvert datasett beholder historikken under sitt eget navn, så neste sikkerhetskopi fortsetter der de gamle elementene slapp, og leser ikke alt på nytt.

Stoppe containere og kjøre kommandoer rundt øyeblikksbildet

Et øyeblikksbilde av en database som kjører, er som et plutselig strømbrudd: Databasen kommer seg som regel, men den må gjøre det. Hvert element kan gjøre to ting med det, og begge gjelder bare øyeblikket for øyeblikksbildet, ikke hele sikkerhetskopien.

  • Stopp disse containerne for øyeblikksbildet. BombVault stopper containerne på listen, tar øyeblikksbildet og starter dem igjen med en gang. Containere på samme avhengighetsnivå stopper parallelt, de avhengige først, så hele vinduet varer som regel noen få sekunder. Kjøringen viser hvor lenge. Sikkerhetskopien leser så det frosne øyeblikksbildet mens appene allerede kjører igjen. Bare containere som kjørte, stoppes.
  • En kommando før og etter øyeblikksbildet. Den kjører inne i en container du velger, for eksempel for å dumpe en database inn i datasettet rett før øyeblikksbildet uten å stoppe noe. Feiler kommandoen før øyeblikksbildet, feiler sikkerhetskopien, og det tas ikke noe øyeblikksbilde. En kommando etter øyeblikksbildet som feiler, vises på kjøringen, men får ikke sikkerhetskopien til å feile.

Hva som skjer når noe går galt:

  • Kan en container ikke stoppes, starter BombVault dem det allerede har stoppet, og sikkerhetskopien feiler med navnet på containeren. Det faller aldri tilbake på et øyeblikksbilde av apper som kjører.
  • Stoppet venter til en pågående containersikkerhetskopi er ferdig (opptil 30 minutter ved en manuell kjøring, opptil tidsgrensen for sikkerhetskopien ved en planlagt), så de to aldri stopper og starter samme container samtidig.
  • Før den første containeren stopper, skriver BombVault ned hvilke det stopper. Blir BombVault drept inne i vinduet, starter det de containerne igjen neste gang det starter, sender et varsel, og elementet viser en rød merknad for hver container det ikke kunne starte.

De automatiske databasedumpene kjører med containerens egen sikkerhetskopi, ikke med et ZFS-element. En database hvis container bare sikkerhetskopieres via datasettet sitt, får ingen dump, så gi den en kommando her.

En container kan stå på denne listen og samtidig sikkerhetskopieres som container. Dataene lagres da to ganger, i to arkiver, og den fulle sikkerhetskopien stopper den to ganger. Elementet sier det.

Gjenoppretting

Åpne elementet og velg Gjenoppretting, eller velg det på siden Gjenoppretting. Gjenopprettingsvinduet spør etter sikkerhetskopien, deretter Datasett. Som standard er det det øverste datasettet til elementet. Under Hva gjenoppretter du alt eller bare filene og mappene du velger. Hvor til tilbyr:

  • Gjenopprett inn i datasettet. Filer fra sikkerhetskopien skrives inn i datasettets monteringspunkt. Filer med samme navn overskrives, andre blir liggende. Datasettet rulles aldri tilbake eller erstattes. BombVault sjekker at datasettet er montert, synlig og skrivbart, én gang før det starter og igjen rett før det skriver. Der et underdatasett er montert inni det, skrives ingenting: Underdatasettet beholder filene, eieren og tillatelsene sine og gjenopprettes fra sin egen sikkerhetskopi.
  • Til en mappe. Velg en mappe under /mnt. BombVault sjekker at mappen ligger på en montert pool eller deling og at det er nok ledig plass. Dette fungerer uten SSH-forbindelsen og for datasett som ikke lenger finnes.
  • Til et nytt dataset. Gi navn til et datasett som ikke finnes ennå. Vinduet foreslår <dataset>-restored. BombVault oppretter det med ZFS-egenskapene som er lagret i sikkerhetskopien og gjenoppretter inn i det, se Gjenopprette som nytt datasett.

Velger du Alle datasett i denne sikkerhetskopien som datasett, skrives hvert datasett i treet til sin egen undermappe i mappen du velger. Datasett som ble hoppet over i den sikkerhetskopien, navngis. For å gjenopprette fra arkivet til en annen BombVault bruker du Fra en gammel sikkerhetskopimappe på siden Gjenoppretting. Den gjenoppretter alltid til en mappe: alle datasett i én sikkerhetskopi, hvert i sin egen undermappe, eller ett datasett i treet, helt eller med valgte filer.

Elementets liste over containere som skal stoppes, tilbys også ved en gjenoppretting inn i datasettet. Disse containerne forblir stoppet under hele gjenopprettingen, og containersikkerhetskopier venter i mellomtiden.

Sikkerhetsøyeblikksbildet

Før det skriver inn i et datasett, tar BombVault et ZFS-øyeblikksbilde av bare det datasettet, kalt bombvault-prerestore-<time>. Ta først et ZFS-øyeblikksbilde av tilstanden nå er på som standard. Å slå det av krever en ekstra bekreftelse. Kan øyeblikksbildet ikke tas, gjenopprettes ingenting.

BombVault sletter aldri et sikkerhetsøyeblikksbilde av seg selv. Elementet lister dem med alder og størrelse, hvert med handlingen Slett, og advarer når det eldste er mer enn 30 dager gammelt, fordi det holder slettede og endrede data fast i poolen.

For å gå tilbake etter en gjenoppretting kopierer du enkeltfiler fra .zfs/snapshot/bombvault-prerestore-<tid> inne i datasettet. zfs rollback <dataset>@bombvault-prerestore-<tid> virker bare så lenge det er datasettets nyeste øyeblikksbilde. zfs rollback -r sletter alle nyere øyeblikksbilder, også de automatiske.

Gjenopprette som nytt datasett

BombVault lagrer med hver sikkerhetskopi de lokalt satte ZFS-egenskapene til hvert datasett: compression, recordsize, quota, reservation, atime, xattr, acltype, casesensitivity og dine egne brukeregenskaper. Arvede og skrivebeskyttede verdier utelates, fordi de kommer tilbake av seg selv. Sikkerhetskopier fra før BombVault lagret dem, har ingen.

  • Til et nytt datasett kjører zfs create med hver lagrede egenskap. casesensitivity, normalization og utf8only kan bare settes slik. Kvoter og reservasjoner settes først etter filene, så de ikke kan avvise dem. Monteringspunktet utelates så kopien ikke kolliderer med originalen, det samme gjelder canmount, readonly og krypteringen, så gjenopprettingen kan skrive. Et nytt datasett under et kryptert overtar krypteringen. Datasettet over må finnes. Hvis noe feiler etter at det er opprettet, blir det nye datasettet liggende på serveren, fordi BombVault aldri ødelegger et datasett.
  • Gjenopprett inn i datasettet viser de lagrede egenskapene ved siden av gjenopprettingen. Sett også disse egenskapene setter de som et eksisterende datasett fortsatt tar imot, før noen fil skrives. Kvoter og reservasjoner settes først etter filene, så de ikke kan avvise dem. Uten den bryteren beholder datasettet innstillingene sine.

Hva sikkerhetskopien inneholder

I sikkerhetskopien: filene og mappene i hvert sikkerhetskopierte datasett, med eier, tillatelser, tidsstempler og utvidede attributter slik restic lagrer dem, og de lokalt satte ZFS-egenskapene til hvert datasett.

Ikke i sikkerhetskopien:

  • eier og tillatelser for selve den øverste mappen i hvert datasett (alt under den er med). En gjenoppretting inn i datasettet lar den eksisterende øverste mappen være som den er, en gjenoppretting til en mappe oppretter den med tillatelsene 0755,
  • eksisterende ZFS-øyeblikksbilder,
  • underdatasett som ble hoppet over eller utelatt,
  • volumer.

For å gjenopprette til en ny pool oppretter du poolen og gjenoppretter hvert datasett til et nytt datasett. Om NFSv4-ACL-er, slik TrueNAS bruker dem på SMB-datasett, kommer tilbake slik du forventer, er ikke kontrollert ennå, så test en gjenoppretting med dine egne data før du stoler på dem.

Krypterte datasett

Et kryptert datasett sikkerhetskopieres bare mens nøkkelen er lastet. Ellers hoppes det over med en advarsel. Last nøkkelen med zfs load-key og monter datasettet. BombVault leser dataene dekryptert og lagrer dem i restics repository, som er kryptert. Har du slått av kryptering i BombVault, er ikke det repositoryet kryptert.

Replika

En replika er en kopi av datasettene til et element på en andre ZFS-server. BombVault holder den oppdatert med zfs send og zfs receive. Første kjøring sender alt, etter det reiser bare de endrede blokkene. På den andre serveren kan du montere kopien med en gang.

En replika erstatter aldri sikkerhetskopien. Eldre versjoner, enkeltfiler og sjekken kommer fortsatt fra sikkerhetskopiene, og replikaen beholder bare så mange øyeblikksbilder som du stiller inn. En oppdatert replika teller som en kopi utenfor stedet, men et element med replika og uten sikkerhetskopi forblir oransje.

Bare replika, ingen sikkerhetskopi på kortet Replica får hele ZFS-området til å sende replikaer og ikke ta sikkerhetskopier. Den lokale mappen og de eksterne målene beholder bryterne sine, så når du slår det av, sikkerhetskopierer området til dem igjen, og kortet til hvert ZFS-element viser bryteren til området slik den står. Et slikt element venter på sin første replika i stedet for en sikkerhetskopi, Sikkerhetskopier nå tilbys som Replikér nå, og containerne til elementet stoppes og kommandoene kjører rundt øyeblikksbildet som ved en sikkerhetskopi. Replikaene teller for en tidsplan med noen dagers mellomrom, varselet om forsinkelse og dekningen.

Slå den på i kortet Replica på fanen Innstillinger til elementet. Kortet lister hvert datasett og volum med tilstanden, og Replikér nå starter en kjøring. En replikakjøring har sin egen lås, så en lang første overføring aldri holder opp sikkerhetskopiene.

Felt Hva det stiller inn
Replikeres til Målet: en ZFS-server (merket over SSH) eller en paret instans. Legg til ZFS-server setter opp en ny.
Når Etter hver sikkerhetskopi, altså etter elementets sikkerhetskopikjøring, eller Egen plan.
Behold på målet Hvor mange øyeblikksbilder som blir på ZFS-serveren: Kort, Balansert, Lang eller Egne verdier. En paret instans bestemmer dette selv.
Behold på denne serveren Hvor mange av de nyeste replika-øyeblikksbildene som også blir på denne serveren. 0 eller 1 beholder bare det siste.
Bare replika, ingen sikkerhetskopi Hele ZFS-området sender replikaer og tar ingen sikkerhetskopier.

Replica-kortet til et ZFS-element. Replica-kortet til et ZFS-element.

Replikér alt nå, ved siden av sikkerhetskopihandlingene når ZFS-flisen er valgt på siden Sikkerhetskopier, sender replikaen for hvert ZFS-element, ett etter ett. Serveren kjører batchen, så den fortsetter når du forlater siden, og et element som ikke kan replikere, nevnes og hoppes over.

Send til en ZFS-server

Alle maskiner med ZFS og SSH kan ta imot, for eksempel en andre Unraid eller en TrueNAS. BombVault trenger ikke å kjøre der.

  1. Under Innstillinger, Paring, velg Koble til via SSH i ZFS-server uten BombVault, eller velg Legg til ZFS-server i kortet Replica på elementet.
  2. Skriv inn adresse, bruker og port. Dialogen viser BombVaults offentlige nøkkel. Legg den til i brukerens ~/.ssh/authorized_keys på serveren. På Unraid finner du det under Users, root, SSH keys. Avhengig av Display Settings ligger Users i toppmenyen eller under Settings. På TrueNAS redigerer du brukeren under Credentials, Users. Dette er replikanøkkelen. Den er en annen enn nøkkelen til SSH-forbindelsen for VM-er og verten, så legg den til selv om den andre allerede er godkjent.
  3. Test tilkoblingen. Dialogen lister deretter poolene på serveren. Velg en og angi roten, som som standard er <pool>/bombvault-replica.
  4. Velg den nye serveren i kortet Replica på elementet. Serveren har da et eget kort på siden Instanser, og Åpne fører til siden dens.

Med root trengs ingenting mer. En egen bruker trenger disse rettighetene på poolen til målet, som dialogen også viser:

zfs allow <user> receive,create,mount,rollback,destroy,userprop,readonly,canmount <pool>

På kilden trenger samme type bruker disse rettighetene på elementets øverste datasett:

zfs allow <user> send,snapshot,hold,release,bookmark,destroy,mount <dataset>

I denne retningen har BombVault-en som eier elementet også en nøkkel som kan skrive på serveren.

BombVault lagrer vertsnøkkelen serveren viser ved første tilkobling, og avviser senere alle andre. Hvis serveren er installert på nytt, trykk Glem vertsnøkkel på serverens side, så lagrer neste tilkobling den nye nøkkelen.

Når verten til denne serveren selv når ZFS-serveren, sender den zfs send rett inn i sin egen ssh til serveren, med replikanøkkelen og den lagrede vertsnøkkelen, så strømmen ikke går gjennom BombVault. Ellers går strømmen gjennom BombVault.

Sending til en paret instans

En paret BombVault kan ta imot replikaen selv. Ingen får SSH-tilgang til den andre verten, og ingen nøkkel havner i en authorized_keys-fil.

  1. I kortet Replica på elementet velger du den parede instansen som mål, eller slår på rollen ZFS-server på kortet til den instansen på siden Instanser og velger ZFS-elementene der. Kortet viser Venter på godkjenning til den svarer.
  2. På den mottakende instansen åpner du Instanser. Forespørselen vises på kortet til den sendende instansen som et merke, og Detaljer lister den. Velg pool og rot på den serveren og hvor mange øyeblikksbilder som blir, og trykk deretter Tillat eller Avslå.
  3. Etter Tillat sender kilden etter sin egen plan, som for ethvert annet mål.

Den mottakende instansen godtar bare det godkjenningen dekker: elementets datasett, inn i sin egen rot. Den kjører zfs receive selv, og kilden har ingen måte å slette eller rulle tilbake noe der på. Derfor overlever kopien en kilde som noen har tatt over. Den mottakende instansen har sin egen oppbevaring. Kilden foreslår bare en regel når den ber om godkjenning. En slik kilde kan fortsatt sende nye øyeblikksbilder, og med tiden skyver de ut eldre etter regelen, akkurat som alle andre. Et øyeblikksbildenavn som er datert fram i tid etter klokken til den mottakende instansen, teller ikke med i regelen før den tiden er kommet.

Revoke access på den mottakende instansen avslutter godkjenningen når som helst og forteller det til kilden, som da viser at godkjenningen er trukket tilbake og stopper. Det den mottakende instansen allerede har, blir liggende. En avslått forespørsel forblir avslått. Flere datasett, eller en forespørsel etter en tilbaketrekking, spør på nytt.

Den mottakende instansen må svare over HTTPS. Til en vanlig http-adresse sender kilden ingenting, fordi tokenet og dataene ellers ville gått ukryptert over nettet. Hver overføring lar dessuten en tidel av den mottakende poolen stå ledig og stopper før den ville tatt av den, så én kilde kan ikke fylle poolen til den mottakende serveren.

Hvor dataene havner

Hvert datasett havner i <root>/<server>/<pool>/<path>. Servermappen er navnet på kildeinstansen, fastsatt ved første overføring, så to servere med samme poolnavn aldri kommer i veien for hverandre. For eksempel havner cache/appdata fra en server som heter tower i backup/bombvault-replica/tower/cache/appdata.

Når BombVault er satt opp på nytt, avviser målet mappen som denne BombVault-en fylte før. Kortet Replica tilbyr da Overta mappen, og neste replika fortsetter fra kopiene i den. Overta den bare når ingen annen BombVault fortsatt replikerer til den mappen.

Kopien på målet er skrivebeskyttet. Som standard er den ikke montert, så den dekker aldri noe på den serveren. En ZFS-server som er koblet til over SSH, har bryteren Monter skrivebeskyttet på serveren på siden sin: er den på, monterer BombVault kopiene der skrivebeskyttet etter hver kjøring, så du kan lese og kopiere filene deres på målet. Krypterte kopier forblir låst til nøkkelen er lastet, og å slå bryteren av avmonterer ingenting. En paret instans som tar imot replikaen, holder den umontert. ZFS-egenskaper følger med, bortsett fra monteringspunktet og sharenfs og sharesmb. Reservasjonene reservation og refreservation blir også igjen, så kopien tar bare den plassen dataene trenger.

Hva som tas med

Alt elementet sikkerhetskopierer tas med, og volumene under det også, som sikkerhetskopien hopper over. Et underordnet datasett du har slått av i elementet, blir utelatt. Alle datasett i en kjøring kommer fra ett øyeblikksbilde, som i sikkerhetskopien.

En kopi som en annen BombVault replikerer til denne serveren, sendes ikke videre, fordi det ville tynne ut historikken kilden fortsatt trenger. Når treet til et element inneholder en slik kopi, feiler kjøringen for det datasettet og sier hvorfor, til du slår det av i elementet. Et element som selv er en slik kopi, kan ikke replikere i det hele tatt. Å slette et element eller slå av replikaen lar de kopiene og øyeblikksbildene deres være i fred. Når du tar over en kopi, slik det står under Bruke replikaen, regnes den som et vanlig datasett.

Hvor lenge øyeblikksbilder blir liggende

På målet beholder en ny replika 7 daglige og 3 ukentlige øyeblikksbilder. Velg heller Kort, Balansert eller Lang, eller angi Egne verdier. Egne verdier med bare nuller beholder alle øyeblikksbilder, og kortet sier det. Bare øyeblikksbilder som heter bombvault-replica-<14 digits> blir noen gang fjernet der, og aldri det nyeste som begge sider deler.

På kilden beholder BombVault det siste replika-øyeblikksbildet, pluss et bokmerke for hver tilstand det har sendt. Bokmerker koster ingen plass. Neste overføring starter fra dem.

Vil du beholde flere på kilden også, stiller du inn Behold på denne serveren på kortet Replica, for eksempel til 7. Så mange av de nyeste replika-øyeblikksbildene blir da liggende på denne serveren etter hver replika, i tillegg til det målet beholder. 0 eller 1 beholder bare det siste. Det siste har en hold, så grunnlaget for neste overføring ikke blir slettet ved et uhell. De eldre har ingen. Hvert øyeblikksbilde holder på blokkene som endret seg etter det, så alle du beholder, tar plass i poolen. Slår du av replikaen eller bytter til et annet mål, eller sletter du elementet, forsvinner de også fra denne serveren. Øyeblikksbilder av et annet element som ligger under det, blir liggende. Kan ikke verten nås mens du sletter elementet, blir øyeblikksbildene også liggende, og siden sier det. Fjern dem for hånd: zfs release -r bombvault-replica <dataset>@<snapshot>, deretter zfs destroy.

Filene i et beholdt øyeblikksbilde kan du lese eller kopiere med en gang, fra mappen .zfs/snapshot inne i datasettet eller fra en klone, uten å røre datasettet eller replikaen:

ls /mnt/cache/appdata/.zfs/snapshot/bombvault-replica-20261006014100
zfs clone cache/appdata@bombvault-replica-20261006014100 cache/appdata-20261006

En klone tar ingen plass før noe i den endres. Slett den med zfs destroy cache/appdata-20261006 når du er ferdig, for et øyeblikksbilde som har en klone, kan ikke fjernes.

For å gå tilbake til det siste replika-øyeblikksbildet trenger du bare zfs rollback cache/appdata@<siste> her, og ingenting på målet. Ruller du hele datasettet tilbake til et eldre, slettes alle øyeblikksbilder etter det, både på denne serveren og på målet. Det siste har en hold, så fjern holden først, og rull deretter datasettet tilbake her:

zfs release -r bombvault-replica cache/appdata@bombvault-replica-20261008014200
zfs rollback -r cache/appdata@bombvault-replica-20261006014100

Kopien på målet må også tilbake, men ikke alltid til samme øyeblikksbilde, siden målets egen oppbevaring kan ha fjernet det. Kjør replikaen én gang. Den stopper for det datasettet fordi målet har nyere øyeblikksbilder, og kortet Replica og kjøringshistorikken nevner øyeblikksbildet du skal rulle målet tilbake til: det nyeste som begge sider fortsatt deler. Rull kopien tilbake til det på ZFS-serveren, eller på verten til den parede instansen som tar imot replikaen, for eksempel:

zfs rollback -r backup/bombvault-replica/tower/cache/appdata@bombvault-replica-20261005014000

zfs rollback virker på ett datasett, så gjenta tilbakerullingene for hvert underdatasett du også vil ha tilbake. Etter det fortsetter Replikér nå fra det delte øyeblikksbildet.

Krypterte datasett i en replika

Et kryptert datasett sendes raw. Det forblir kryptert på målet, og målet ser aldri nøkkelen. Ta godt vare på nøkkelen: du trenger den for å åpne kopien etter en gjenoppretting, og en replika uten den er uleselig.

Bruke replikaen

Åpne fanen Sikkerhetskopier på elementet og klikk på raden ZFS-replika blant stedene som holder øyeblikksbildene. Arket lister øyeblikksbildene på målet og viser kommandoene med de ekte navnene dine.

For å se på en gammel tilstand kloner du et øyeblikksbilde på målet. En klone tar ingen plass før noe endres, og replikaen blir urørt:

zfs clone backup/bombvault-replica/tower/cache/appdata@bombvault-replica-20261006014100 backup/bombvault-replica/clone-appdata

Hvis kilden svikter, gjør du kopien på målet om til et vanlig, skrivbart datasett:

zfs inherit -r readonly backup/bombvault-replica/tower/cache/appdata && zfs list -rH -o name -t filesystem backup/bombvault-replica/tower/cache/appdata | xargs zfs set canmount=on && zfs mount -a

BombVault slutter etterpå å replikere til det datasettet og de underordnede. Neste kjøring feiler med en årsak, og det du skrev, blir værende. Det samme gjelder alt annet som er skrevet til kopien siden det nyeste øyeblikksbildet: BombVault ruller aldri en kopi tilbake. For å replikere dit igjen flytter du det du trenger, bort fra kopien og sletter den på målet. Neste kjøring sender da alt på nytt.

For å få en tilstand tilbake til kilden trykker du Hent tilbake som nytt datasett i arket. BombVault sender øyeblikksbildet til et nytt datasett ved siden av originalen, med navnet <dataset>-bombvault-restore- pluss et tidsstempel. Originalen blir aldri overskrevet. Et underordnet datasett som er tapt på kilden, kommer også tilbake, så lenge kopien fortsatt har det øyeblikksbildet. Et underordnet datasett som ikke har det, blir utelatt, og kjøringen sier det.

Eksempel: en replika til en andre Unraid-boks

Serveren tower sikkerhetskopierer datasettet cache/appdata som et ZFS-element. En andre Unraid-boks på 192.168.1.20, uten BombVault, har en pool som heter backup og skal ha en kopi du kan lese når som helst.

  1. Åpne Sikkerhetskopier, så cache/appdata, så fanen Innstillinger. Velg Legg til ZFS-server under Replikeres til i kortet Replica.
  2. Skriv inn 192.168.1.20, brukeren root og port 22. Dialogen viser replikanøkkelen. Lim den inn på den andre boksen under Users, root, SSH keys og trykk Apply. Denne nøkkelen er en annen enn Verts-SSH-nøkkelen, så legg den til selv om den andre allerede ligger der.
  3. Test tilkoblingen. Velg poolen backup og behold roten den foreslår, backup/bombvault-replica.
  4. Tilbake på kortet er den nye serveren valgt under Replikeres til. La Når stå på Etter hver sikkerhetskopi, la Behold på målet stå på 7 daglige og 3 ukentlige øyeblikksbilder, og sett Behold på denne serveren til 7.
  5. Trykk Replikér nå. Den første kjøringen sender alt, så 300 GB over en linje på 1 Gbit/s tar minst 40 minutter. Kortet og listen Sikkerhetskopier sier Replikerer, så Replikert med tidspunktet. Senere kjøringer sender bare blokkene som er endret.

Datasettene ligger nå på backup/bombvault-replica/tower/cache/appdata på den andre boksen, skrivebeskyttet. På oversikten teller Off-site for ZFS-området replikaen som en kopi utenfor huset.

For å få tilbake én fil fra forrige tirsdag har du tre veier:

  • På denne serveren, fordi Behold på denne serveren holder sju øyeblikksbilder:

    cp /mnt/cache/appdata/.zfs/snapshot/bombvault-replica-20261103014100/plex/Preferences.xml /mnt/user/restore/
    
  • På den andre boksen, med en klone av et øyeblikksbilde på målet. Fanen Sikkerhetskopier til elementet viser kommandoene med de ekte navnene dine når du klikker på raden ZFS-replika. Fjern klonen med zfs destroy når du er ferdig.

  • Med en montering, ved å slå på Monter skrivebeskyttet på serveren på siden til ZFS-serveren. Etter neste kjøring står kopiene montert og skrivebeskyttet på den andre boksen.

Eldre versjoner enn replikaen beholder, kommer fortsatt fra sikkerhetskopiene, slik neste eksempel viser.

Eksempel: én fil fra en ZFS-sikkerhetskopi

  1. Åpne Gjenoppretting, velg flisen ZFS og klikk på cache/appdata.
  2. Velg sikkerhetskopien, og under Datasett datasettet som har filen.
  3. Under Hva velger du Enkeltfiler og krysser av filen.
  4. Under Hvor til velger du Til en mappe og en mappe under /mnt, for eksempel user/restore. Det trenger ingen SSH-forbindelse og virker også for et datasett som ikke finnes lenger.
  5. Trykk Gjenopprett. Filen havner rett i den mappen, uten stien over seg.

Gjenværende øyeblikksbilder

Øyeblikksbildet av en sikkerhetskopi heter <dataset>@bombvault-<14 sifre>, for eksempel cache/appdata@bombvault-20260924021500 (UTC). BombVault fjerner det rett etter sikkerhetskopien. Mislykkes det, for eksempel fordi datasettet er opptatt eller BombVault ble stoppet, fjerner BombVault det:

  • før neste sikkerhetskopi av det elementet,
  • når BombVault starter, for hvert element, også med området slått av,
  • når du sletter elementet,
  • når du trykker Fjern nå på elementet, som også viser hvor mange som er igjen.

Bare navn som er nøyaktig bombvault- pluss 14 sifre, fjernes. Sikkerhetsøyeblikksbilder, dine egne øyeblikksbilder og automatiske øyeblikksbilder røres aldri. For å fjerne et for hånd:

zfs destroy -r cache/appdata@bombvault-20260924021500

Øyeblikksbildet til en replika heter <dataset>@bombvault-replica-<14 digits> og er ikke en rest. Det blir liggende på kilden til en nyere replikakjøring erstatter det, eller så lenge Behold på denne serveren beholder det, og på målet så lenge oppbevaringen beholder det. Ryddeprosessen rører det aldri, fordi den bare treffer bombvault- etterfulgt av nøyaktig 14 sifre.

Avvik

Et underdatasett som er tømt, endrer nesten ikke totalen for et stort tre, så avviksoppdagelsen følger med på hvert datasett i et element for seg: størrelse, antall filer, nye data og restic-tid har hver sin egen historikk. Den historikken hører til datasettets navn, så den blir værende når treet senere sikkerhetskopieres av et annet element.

Et datasett som forrige kjøring sikkerhetskopierte og som denne kjøringen ikke kunne lese, teller som tømt, så lenge elementets utvalg ikke er endret. Det dekker en nøkkel som ikke er lastet, et datasett som ikke er montert, og et som har forsvunnet fra treet. Et underdatasett du utelukker selv, endrer utvalget, så historikken begynner på nytt i stedet. Så lenge et funn om tapte data er åpent, beholder oppbevaringen de gamle sikkerhetskopiene av akkurat det datasettet og beskjærer resten av treet som vanlig.

Hvert datasett har en egen linje i overvåkingen av elementet, som åpnes med Overvåking på siden Avvik og står på fanen Verifisering til elementet. De åpne funnene vises ved siden av hvert datasett. Lenken i et funn åpner gjenopprettingsvinduet på datasettets siste gode sikkerhetskopi. Om en kjøring fullføres, vurderes for hele elementet, fordi en kjøring lykkes eller feiler som helhet.

Selve kontrollene er beskrevet under Avvik. En assistent som er koblet til via MCP-serveren, kan liste gjenopprettingspunktene til et ZFS-element, starte sikkerhetskopien og lese funnene, men et funn kvitteres på siden Avvik.

Årsakskoder

Elementets side, kjøringshistorikken og varslene nevner et problem med en av disse kodene. De fleste har rettingen ved siden av på siden også.

Kode Betydning Hva du gjør
ssh-missing SSH-forbindelsen er ikke satt opp i denne containeren. Sett opp SSH-forbindelsen som for VM-sikkerhetskopier.
host-placeholder Host SSH: Address er fortsatt eksempelverdien, og host.docker.internal svarte heller ikke. Sett Host SSH: Address til denne serverens LAN-IP.
host-fallback Host SSH: Address er fortsatt eksempelverdien, og host.docker.internal fungerer. Ingenting, eller sett LAN-IP-en.
ssh-unreachable Serveren kan ikke nås over SSH. Sjekk adresse og port, og at SSH er slått på.
ssh-auth Serveren avviste BombVaults nøkkel. Kjør kommandoen under Forbindelse til denne serveren én gang på serveren.
zfs-not-found SSH-verten har ingen zfs-kommando. Pek Host SSH: Address mot maskinen som eier poolene.
zfs-permission SSH-brukeren har ikke lov til å kjøre denne zfs-kommandoen. Bruk root, eller se TrueNAS SCALE.
uri-mismatch LIBVIRT_URI nevner en annen vert eller bruker enn SSH-feltene. Få dem til å stemme, eller tøm SSH-feltene så begge kommer fra URI-en.
zfs-error zfs rapporterte en annen feil. Detaljene viser meldingen.
propagation-missing Nye monteringer på verten når ikke containeren. Sett Access Mode for Host Data til Read/Write - Slave og start BombVault på nytt.
invalid-name Et datasettnavn BombVault ikke godtar. Gi datasettet nytt navn.
name-too-long Et datasett i treet er for langt for et navn på et øyeblikksbilde. Gi det nytt navn, eller legg til et datasett under det som element.
invalid-exclude Et ekskluderingsmønster eller et utelatt underdatasett passer ikke til elementet. Rett oppføringen meldingen nevner. For å utelate et helt underdatasett slår du det av i stedet for å skrive et mønster.
not-found Datasettet finnes ikke på serveren. Fjern elementet, eller opprett datasettet på nytt. Sikkerhetskopiene kan fortsatt gjenopprettes.
not-filesystem Dette er et volum, ikke et filsystem. Se Volumer.
overlaps-item Datasettet overlapper et eksisterende element. Se Elementer overlapper aldri.
docker-storage Treet inneholder Dockers bildelagring. Se Dockers lagring.
nothing-readable Ingen datasett i elementet kan leses akkurat nå. Se på kodene for datasettene som ble hoppet over.
snapshot-failed Øyeblikksbildet kunne ikke opprettes. Detaljene viser meldingen fra zfs.
containers-busy En containersikkerhetskopi kjørte fortsatt da containerne måtte stoppe. Start igjen senere. Planlagte kjøringer venter av seg selv.
consistency-stop-failed En container kunne ikke stoppes, så det ble ikke tatt noe øyeblikksbilde. Sjekk containeren, eller ta den av listen.
pre-snapshot-failed Kommandoen før øyeblikksbildet feilet. Kjøringsdetaljene viser utdataene.
container-unknown En container på listen finnes ikke. Ta den av listen.
container-is-self BombVault kan ikke stoppe sin egen container. Ta den av listen.
leftover-snapshots Øyeblikksbilder BombVault ikke kunne fjerne, ligger fortsatt på serveren. Trykk Fjern nå, se Gjenværende øyeblikksbilder.
zvol Et volum i treet, hoppet over. Se Volumer.
canmount-off Aldri montert (canmount=off), hoppet over. Inneholder det data, monter det eller flytt dataene til et underdatasett.
legacy-mount Legacy-monteringspunkt, hoppet over. Gi det et monteringspunkt under /mnt.
no-mountpoint Ikke noe monteringspunkt, hoppet over. Gi det et monteringspunkt under /mnt.
not-mounted Ikke montert på serveren, hoppet over. Monter det med zfs mount, eller sett canmount=on.
key-not-loaded Kryptert og nøkkelen er ikke lastet, hoppet over. zfs load-key, monter det deretter.
snapdir-disabled Tilgang til øyeblikksbilder er slått av, hoppet over. zfs set snapdir=hidden <dataset>. Mappen .zfs forblir skjult.
not-visible BombVault ser ikke datasettets monteringspunkt. Flytt monteringspunktet under Host Data-stien, eller map det inn i containeren på samme sti med Read/Write - Slave.
shfs-only Datasettet er bare synlig gjennom /mnt/user, som skjuler øyeblikksbilder. Map /mnt, ikke /mnt/user, som Host Data.
snapshot-not-visible Øyeblikksbildet ble opprettet, men dukket ikke opp inne i BombVault. Kjør Test tilgangen til øyeblikksbilder. Se nedenfor.
snapshot-loop Øyeblikksbildet nådde ikke BombVault fordi Host Data ikke sender nye monteringer videre. Sett Access Mode for Host Data til Read/Write - Slave og start BombVault på nytt.
backup-failed restic feilet for dette datasettet. Kjøringsdetaljene viser hvorfor.
not-reached Kjøringen sluttet før dette datasettet. Kjør sikkerhetskopien på nytt.
gone Datasettet er ikke lenger på serveren. Ingenting. Sikkerhetskopiene kan fortsatt gjenopprettes.
read-only-mount BombVault kan bare lese datasettet og kan derfor ikke gjenopprette inn i det. Sett mappingen til Read/Write - Slave, eller gjenopprett til en mappe.
destination-not-mounted Mappen ligger ikke på en montert pool eller deling. Velg en mappe på en pool eller deling.
not-enough-space Ikke nok ledig plass på målet. Frigjør plass, eller velg en annen mappe.
safety-snapshot-failed Sikkerhetsøyeblikksbildet kunne ikke tas, så ingenting ble gjenopprettet. Detaljene viser meldingen fra zfs.
safety-name-too-long Datasettnavnet er for langt for et sikkerhetsøyeblikksbilde. Slå av sikkerhetsøyeblikksbildet, eller gjenopprett til en mappe.
dataset-exists Det finnes allerede et dataset med dette navnet. Velg et nytt navn, eller gjenopprett inn i selve datasettet.
create-failed Det nye datasettet kunne ikke opprettes. Detaljene viser meldingen fra zfs. Sjekk at datasettet over finnes.
new-dataset-not-visible Det nye datasettet ble opprettet, men BombVault ser det ikke, så ingenting ble gjenopprettet. Datasettet blir på serveren. Monter det under Host Data-stien og gjenopprett inn i det.
set-properties-failed De lagrede egenskapene kunne ikke settes, så ingenting ble gjenopprettet. Detaljene viser meldingen fra zfs.
set-limits-failed Filene ble gjenopprettet, men den lagrede kvoten eller reservasjonen kunne ikke settes. Detaljene viser meldingen fra zfs. Sett kvoten eller reservasjonen selv med zfs set.

Sjekke hva containeren ser

Test tilgangen til øyeblikksbilder på fanen Innstillinger til elementet tar et ekte øyeblikksbilde av treet, ser etter det inne i BombVault for hvert datasett og fjerner det igjen. Det er den raskeste måten å bevise hele stien på før den første planlagte kjøringen.

For å se selv kjører du dette på serveren:

docker exec BombVault grep zfs /proc/self/mountinfo

Hver linje er en montering inne i containeren. Linjen for et datasett viser stien inne i containeren (under /host/user) og datasettnavnet. Et felt master:N på den linjen betyr at monteringen mottar monteringene verten lager senere, og det er det tilgang til øyeblikksbilder trenger. Mangler det, setter du Access Mode for Host Data til Read/Write - Slave og starter BombVault på nytt.

TrueNAS SCALE

  • Når LIBVIRT_URI er satt (som for VM-sikkerhetskopier på TrueNAS), henter BombVault SSH-vert, bruker og port for zfs-kommandoene sine fra URI-en, hver av dem som ikke er satt for seg. Uten VM-sikkerhetskopier trenger ingenting å settes: host.docker.internal kan ikke slås opp i en TrueNAS-app, så BombVault når verten gjennom appens standard-gateway, som root på port 22. Sett LIBVIRT_HOST, LIBVIRT_SSH_USER og LIBVIRT_SSH_PORT når du vil ha en annen adresse eller bruker, i appens environment.
  • Legg Verts-SSH-nøkkelen fra Innstillinger, Integrasjoner, Verts-SSH til root under Credentials, Users, og slå på SSH-tjenesten under System, Services. En replika til denne eller en annen TrueNAS trenger i tillegg replikanøkkelen, som er en annen.
  • En annen bruker enn root trenger tillatelser på elementets øverste datasett, som da dekker alle datasett under det:
zfs allow <user> snapshot,destroy,mount <dataset>

Gjenoppretting til et nytt datasett trenger i tillegg create på datasettet over, og å sette lagrede egenskaper trenger rettigheter til de egenskapene.

En SSH-økt uten root på TrueNAS har ikke /usr/sbin i stien. BombVault kaller da /usr/sbin/zfs direkte. - Appens Host Data må være en vertssti over datasettene, for eksempel /mnt/tank, ikke et ixVolume. Med en vertssti sender appen vertens nye monteringer videre til BombVault (rslave), og det trenger tilgang til øyeblikksbilder. Se TrueNAS SCALE for hele oppsettet av appen.