Datové sady ZFS¶
Datové sady ZFS jsou položky v seznamu Zálohy, stejně jako kontejnery a VM. Položka je jedna datová sada spolu se všemi datovými sadami pod ní. Pro každou zálohu pořídí BombVault jediný snímek ZFS celého stromu, takže každá datová sada v něm je zachycena ve stejném okamžiku. Poté z tohoto snímku přečte soubory každé datové sady, uloží je pomocí resticu stejně jako složku a snímek hned potom odstraní. Zálohy jsou deduplikované, každou z nich můžeš procházet a lze obnovit jednotlivé soubory.
Záloha nikdy neposílá proud do restic a nikdy nevrací datovou sadu do dřívějšího stavu. BombVault ničí jen snímky, které sám vytvořil. Volitelná replika je jediné místo, které používá zfs send: kopíruje datové sady na druhý server ZFS a zálohy se nedotýká.
Požadavky¶
- Spojení SSH s tímto serverem. Datové sady ZFS používají stejný klíč, hostitele a uživatele jako zálohy VM. Pokud zálohy VM už fungují, funguje i tohle. Jinak postupuj podle průvodce Záloha VM přes SSH. Pole šablony se jmenují Host SSH: Address, Host SSH: Port a Host SSH: User.
- Příkaz
zfsna tomto hostiteli. Unraid 6.12 a novější a TrueNAS SCALE ho mají. - Host Data namapované jako
/mnts Access Mode Read/Write - Slave. To je výchozí hodnota šablony. Snímek datové sady se ve složce.zfs/snapshotdatové sady objeví až po spuštění BombVaultu, takže kontejner musí dostávat připojení, která hostitel vytvoří později. - Datové sady připojené pod
/mnt. Na Unraidu jsou pooly pod/mnt/<pool>, takže to už platí.
Sekci zapneš v Nastavení, Obecné (Datové sady ZFS). Připojení ZFS k tomuto serveru pod Více na stránce Zálohy pak otevře Spojení s tímto serverem. Otestuje spojení SSH, uvede uživatele a hostitele, ke kterým se připojuje, a řekne, co chybí, když něco chybí. Když spojení nefunguje, seznam Záloh to oznámí s Zobrazit připojení a stejný výsledek ukazuje karta Integrace hostitele v Přehledu.
Položky a podřízené datové sady¶
Na stránce Zálohy zvol Přidat a pak Datová sada ZFS. Seznam pochází ze serveru. Vyber datovou sadu, která je nejvýše z toho, co chceš zálohovat, například cache/appdata, a položka pokryje ji i každou datovou sadu pod ní.
- Nové podřízené datové sady se přidávají samy. Datová sada vytvořená později pod položkou se zálohuje při dalším běhu a ten ji uvede jako novou. Její první záloha ji jednou přečte celou. Potom se čtou jen změny.
- Jednotlivé podřízené sady můžeš vynechat. Vypni jednu na záložce Nastavení položky a bude vynechána i se vším pod ní. Vynechaná podřízená sada, která už na serveru neexistuje, je tak označena a lze ji ze seznamu odebrat.
- Podřízené sady, které nelze přečíst, se přeskakují, nikdy potichu. Běh je vypíše, položka ukáže, kolik jich bylo přeskočeno, a karta Nezálohováno v Přehledu počítá každou z nich jako nechráněnou. Běh přesto zálohuje vše ostatní a kvůli přeskočené sadě neselže. Důvody jsou v tabulce kódů důvodů: datová sada, která není připojená, má
canmount=off, přípojný bodlegacynebo žádný, nenačtený šifrovací klíč, vypnutý přístup ke snímkům nebo přípojný bod, který BombVault nevidí. - Přeskočená datová sada nestrhne své podřízené sady s sebou. Datová sada s
canmount=off, která obsahuje jen jiné datové sady, se přeskočí (zobrazí se jako "jen struktura") a její připojené podřízené sady se zálohují. Šifrovaná datová sada s nenačteným klíčem se přeskočí spolu s podřízenými sadami, které sdílejí její klíč. - Podřízené sady, které jsou disky VM nebo systémová data, začínají vypnuté v dialogu přidání, s důvodem vedle přepínače. Přidání celého poolu vyžaduje potvrzení, které vypíše, co obsahuje.
Svazky¶
Svazek (zvol) obsahuje virtuální disk místo souborů a položka ZFS ho nikdy nezálohuje.
- Svazek, který používá VM, se zálohuje s touto VM.
- Svazek, který nepoužívá žádná VM (iSCSI extent, odpojený disk), BombVault nezálohuje. Okno přidání a stránka Zálohy takové svazky spočítají a uvedou to. Pozdější verze je bude zálohovat.
Svazky ve stromu položky se při každém běhu přeskočí a uvedou.
Úložiště Dockeru¶
S úložným ovladačem ZFS v Dockeru je každá vrstva obrazu datovou sadou s přípojným bodem legacy. Dialog přidání je sloučí do jednoho řádku na rodiče. Strom, který obsahuje víc než 20 takových datových sad, se nemůže stát položkou: dokud existuje jeho snímek, Docker nemůže odstraňovat vrstvy obrazů. Přidej místo toho datové sady pod ním, například appdata.
Položky se nikdy nepřekrývají¶
Datová sada může patřit jen k jedné položce. BombVault odmítne novou položku, která leží uvnitř existující nebo by nějakou obsahovala. Chceš-li sloučit několik podřízených položek do jedné nadřazené, nejprve podřízené položky smaž se zachováním jejich záloh a pak přidej nadřazenou. Každá datová sada si ponechává historii pod svým jménem, takže další záloha pokračuje tam, kde staré položky skončily, a nečte všechno znovu.
Zastavení kontejnerů a příkazy kolem snímku¶
Snímek běžící databáze je jako náhlý výpadek proudu: databáze se obvykle zotaví, ale musí to udělat. Každá položka s tím může udělat dvě věci a obě se týkají jen okamžiku snímku, ne celé zálohy.
- Zastavit tyto kontejnery kvůli snímku. BombVault zastaví uvedené kontejnery, pořídí snímek a hned je znovu spustí. Kontejnery na stejné úrovni závislostí se zastavují souběžně, závislé nejdřív, takže celé okno obvykle trvá pár sekund. Běh ukáže, jak dlouho. Záloha pak čte zmrazený snímek, zatímco aplikace už zase běží. Zastavují se jen kontejnery, které běžely.
- Příkaz před snímkem a po něm. Běží uvnitř kontejneru podle tvého výběru, například aby těsně před snímkem vypsal databázi do datové sady, aniž by cokoli zastavil. Selže-li příkaz před snímkem, záloha selže a žádný snímek se nepořídí. Selhání příkazu po snímku se ukáže u běhu, ale zálohu neshodí.
Co se stane, když se něco pokazí:
- Nelze-li kontejner zastavit, BombVault spustí ty, které už zastavil, a záloha selže s názvem kontejneru. Nikdy se nespokojí se snímkem běžících aplikací.
- Zastavení počká, až doběhne probíhající záloha kontejneru (až 30 minut u ručního běhu, až do časového limitu zálohy u plánovaného), aby oba nikdy současně nezastavovaly a nespouštěly stejný kontejner.
- Než se zastaví první kontejner, BombVault si zapíše, které zastavuje. Pokud je BombVault během okna ukončen, při příštím spuštění tyto kontejnery znovu spustí, pošle oznámení a položka ukáže červenou poznámku u každého kontejneru, který se nepodařilo spustit.
Automatické výpisy databází běží s vlastní zálohou kontejneru, ne s položkou ZFS. Databáze, jejíž kontejner se zálohuje jen přes jeho datovou sadu, výpis nedostane, takže jí zde zadej příkaz.
Kontejner může být na tomto seznamu a zároveň se zálohovat jako kontejner. Jeho data se pak ukládají dvakrát, do dvou repozitářů, a úplná záloha ho zastaví dvakrát. Položka na to upozorní.
Obnova¶
Otevři položku a zvol Obnovit, nebo ji vyber na stránce Obnova. Okno obnovy se zeptá na zálohu a pak na Datová sada. Výchozí je nejvyšší datová sada položky. Pod Co obnovíš všechno, nebo jen soubory a složky, které vybereš. Kam nabízí:
- Obnovit do datové sady. Soubory ze zálohy se zapíší do přípojného bodu datové sady. Soubory se stejným názvem se přepíšou, ostatní zůstanou. Datová sada se nikdy nevrací do dřívějšího stavu ani nenahrazuje. BombVault zkontroluje, že je datová sada připojená, viditelná a zapisovatelná, jednou před začátkem a znovu těsně před zápisem. Tam, kde je uvnitř připojená podřízená sada, se nic nezapisuje: ta si ponechá své soubory, vlastníka a oprávnění a obnoví se ze své vlastní zálohy.
- Do složky. Vyber složku pod
/mnt. BombVault zkontroluje, že složka leží na připojeném poolu nebo sdílené složce a že je dost volného místa. Funguje to bez spojení SSH i pro datové sady, které už neexistují. - Do nové datové sady. Zadej datovou sadu, která ještě neexistuje. Okno navrhne
<dataset>-restored. BombVault ji vytvoří s vlastnostmi ZFS uloženými v záloze a obnoví do ní, viz Obnova jako nová datová sada.
Když jako datovou sadu zvolíš Všechny datové sady této zálohy, zapíše se každá datová sada stromu do vlastní podsložky vybrané složky. Datové sady, které byly v této záloze přeskočeny, se uvedou. Pro obnovu z repozitáře jiného BombVaultu použij Ze staré složky se zálohami na stránce Obnova. Vždy obnovuje do složky: všechny datové sady jedné zálohy, každou do vlastní podsložky, nebo jednu datovou sadu stromu, celou nebo vybrané soubory.
Seznam kontejnerů k zastavení z položky se nabízí i pro obnovu do datové sady. Tyto kontejnery zůstanou zastavené po celou dobu obnovy a zálohy kontejnerů mezitím čekají.
Bezpečnostní snímek¶
Než BombVault zapíše do datové sady, pořídí snímek ZFS jen této datové sady s názvem bombvault-prerestore-<čas>. Nejdřív si nechat ZFS snímek současného stavu je ve výchozím stavu zapnuto. Jeho vypnutí vyžaduje druhé potvrzení. Nelze-li snímek pořídit, nic se neobnoví.
BombVault bezpečnostní snímek nikdy sám nesmaže. Položka je vypíše s jejich stářím a velikostí, každý s akcí Smazat, a varuje, když je nejstarší starší než 30 dní, protože drží v poolu smazaná a změněná data.
Chceš-li se po obnově vrátit, zkopíruj jednotlivé soubory z .zfs/snapshot/bombvault-prerestore-<čas> uvnitř datové sady. zfs rollback <dataset>@bombvault-prerestore-<čas> funguje jen, dokud je to nejnovější snímek této datové sady. zfs rollback -r smaže každý novější snímek včetně automatických.
Obnova jako nová datová sada¶
BombVault s každou zálohou uloží lokálně nastavené vlastnosti ZFS každé datové sady: compression, recordsize, quota, reservation, atime, xattr, acltype, casesensitivity a tvoje vlastní uživatelské vlastnosti. Zděděné hodnoty a hodnoty jen pro čtení se vynechají, protože se vrátí samy. Zálohy z doby, kdy je BombVault ještě neukládal, žádné nemají.
- Do nové datové sady spustí
zfs createse všemi uloženými vlastnostmi. casesensitivity, normalization a utf8only jde nastavit jen takto. Kvóty a rezervace se nastaví až po souborech, aby je nemohly odmítnout. Přípojný bod se vynechá, aby kopie nekolidovala s originálem, stejně jakocanmount,readonlya šifrování, aby obnova mohla zapisovat. Nová datová sada pod šifrovanou převezme její šifrování. Nadřazená datová sada musí existovat. Když po vytvoření něco selže, nová datová sada zůstane na serveru, protože BombVault nikdy datovou sadu neničí. - Obnovit do datové sady ukáže uložené vlastnosti vedle obnovy. Nastavit i tyto vlastnosti nastaví ty, které existující datová sada ještě přijme, dřív než se zapíše jakýkoli soubor. Kvóty a rezervace se nastaví až po souborech, aby je nemohly odmítnout. Bez tohoto přepínače si datová sada ponechá své nastavení.
Co záloha obsahuje¶
V záloze: soubory a složky každé zálohované datové sady, s vlastníkem, oprávněními, časovými razítky a rozšířenými atributy tak, jak je restic ukládá a lokálně nastavené vlastnosti ZFS každé datové sady.
Není v záloze:
- vlastník a oprávnění samotné nejvyšší složky každé datové sady (vše pod ní je zahrnuto). Obnova do datové sady nechá existující nejvyšší složku, jak je, obnova do složky ji vytvoří s oprávněními
0755, - existující snímky ZFS,
- podřízené sady, které byly přeskočeny nebo vynechány,
- svazky.
Pro obnovu na nový pool vytvoř pool a obnov každou datovou sadu do nové datové sady. Zda se ACL NFSv4, jak je TrueNAS používá na datových sadách SMB, vrátí tak, jak čekáš, zatím nebylo ověřeno, proto si obnovu vyzkoušej na vlastních datech, než se na to spolehneš.
Šifrované datové sady¶
Šifrovaná datová sada se zálohuje, jen dokud je její klíč načtený. Jinak se přeskočí s varováním. Načti klíč pomocí zfs load-key a datovou sadu připoj. BombVault čte data dešifrovaná a ukládá je do repozitáře resticu, který je šifrovaný. Pokud jsi šifrování v BombVaultu vypnuli, tento repozitář šifrovaný není.
Replika¶
Replika je kopie datových sad položky na druhém serveru ZFS. BombVault ji udržuje aktuální pomocí zfs send a zfs receive. První běh pošle všechno, potom putují jen změněné bloky. Na druhém serveru můžeš kopii hned připojit.
Replika nikdy nenahrazuje zálohu. Starší verze, jednotlivé soubory i kontrola se dál berou ze záloh a replika drží jen tolik snímků, kolik nastavíš. Aktuální replika se počítá jako kopie mimo lokalitu, ale položka s replikou a bez zálohy zůstává oranžová.
Jen replika, bez zálohy na kartě Replika způsobí, že celá sekce ZFS posílá repliky a nedělá zálohy. Vlastní složka a cíle mimo lokalitu si nechají své přepínače, takže po vypnutí se sekce do nich zase zálohuje, a karta každé položky ZFS ukazuje přepínač sekce tak, jak stojí. Taková položka čeká místo zálohy na svou první repliku, Zálohovat nyní se u ní nabízí jako Replikovat teď a kolem snímku se zastaví její kontejnery a spustí její příkazy jako u zálohy. Její repliky se počítají pro plán jednou za několik dní, upozornění na zpoždění i pokrytí.
Zapneš ji na kartě Replika na záložce Nastavení položky. Karta vypisuje každou datovou sadu a každý svazek s jeho stavem a Replikovat teď spustí běh. Běh repliky má vlastní zámek, takže dlouhý první přenos nikdy nezdrží zálohy.
| Pole | Co nastavuje |
|---|---|
| Replikuje na | Cíl: server ZFS (označený přes SSH) nebo spárovaná instance. Přidat server ZFS založí nový. |
| Kdy | Po každé záloze, tedy po záložním běhu položky, nebo Vlastní plán. |
| Ponechat na cíli | Kolik snímků zůstane na serveru ZFS: Krátké, Vyvážené, Dlouhé nebo Vlastní hodnoty. Spárovaná instance to rozhoduje sama. |
| Ponechat na tomto serveru | Kolik nejnovějších snímků repliky zůstane i na tomto serveru. 0 nebo 1 drží jen ten poslední. |
| Jen replika, bez zálohy | Celá sekce ZFS posílá repliky a nedělá zálohy. |

Replikovat vše teď, vedle akcí zálohy, když je na stránce Zálohy vybraná dlaždice ZFS, pošle repliku každé položky ZFS, jednu po druhé. Dávku spouští server, takže pokračuje, i když stránku opustíš, a položka, která replikovat nemůže, se jmenovitě uvede a přeskočí.
Odeslání na server ZFS¶
Přijímat může každý stroj se ZFS a SSH, například druhý Unraid nebo TrueNAS. BombVault tam běžet nemusí.
- V Nastavení, Párování zvol Připojit přes SSH v Server ZFS bez BombVault, nebo Přidat server ZFS na kartě Replika položky.
- Zadej adresu, uživatele a port. Dialog ukáže veřejný klíč BombVaultu. Přidej ho do
~/.ssh/authorized_keysuživatele na serveru. V Unraidu je to v Users, root, SSH keys. Podle Display Settings je Users v horním menu nebo v Settings. Na TrueNAS uprav uživatele v Credentials, Users. Toto je klíč repliky. Liší se od klíče spojení SSH pro virtuální stroje a hostitele, takže ho přidejte, i když je ten druhý už povolený. - Otestuj spojení. Dialog pak vypíše pooly serveru. Vyber jeden a nastav kořen, který je ve výchozím stavu
<pool>/bombvault-replica. - Vyber nový server na kartě Replika položky. Server pak má na stránce Instance vlastní kartu a Otevřít vede na jeho stránku.
S rootem není potřeba nic dalšího. Vlastní uživatel potřebuje tato oprávnění na poolu cíle, která dialog také ukazuje:
Na zdroji potřebuje stejný druh uživatele tato oprávnění na nejvyšší datové sadě položky:
V tomto směru drží BombVault, který položku vlastní, také klíč, který může na server zapisovat.
BombVault si při prvním připojení uloží klíč hostitele, který server ukáže, a jiný později odmítne. Pokud byl server přeinstalován, stiskni na stránce serveru Zapomenout klíč hostitele a příští připojení uloží nový klíč.
Když hostitel tohoto serveru dosáhne na server ZFS sám, pošle zfs send rovnou do vlastního ssh k tomu serveru, s klíčem repliky a uloženým klíčem hostitele, takže proud neprochází BombVaultem. Jinak jde proud přes BombVault.
Odeslání spárované instanci¶
Spárovaný BombVault umí repliku přijmout sám. Nikdo nedostane přístup SSH k druhému hostiteli a do souboru authorized_keys se nepřidává žádný klíč.
- Na kartě Replika položky vyber jako cíl spárovanou instanci, nebo na kartě té instance na stránce Instance zapni roli Server ZFS a vyber tam položky ZFS. Karta ukazuje Čeká na schválení, dokud neodpoví.
- Na přijímající instanci otevři Instance. Žádost se ukáže na kartě odesílající instance jako odznak a vypisují ji její Podrobnosti. Vyber pool a kořen na tom serveru a kolik snímků zůstane, potom stiskni Povolit nebo Odmítnout.
- Po Povolit zdroj odesílá podle vlastního plánu, jako u každého jiného cíle.
Přijímající instance přijme jen to, co schválení pokrývá: datové sady položky, do vlastního kořene. Příkaz zfs receive spouští sama a zdroj tam nemůže nic smazat ani vrátit zpět. Kopie tedy přežije i zdroj, který někdo převzal. Přijímající instance si drží vlastní uchovávání. Zdroj při žádosti jen navrhne pravidlo. Takový zdroj může dál posílat nové snímky a ty časem podle pravidla vytlačí starší jako jakékoli jiné. Snímek, jehož jméno nese pozdější datum, než ukazují hodiny přijímající instance, se do pravidla nepočítá, dokud ten čas nenastane.
Odebrat přístup na přijímající instanci kdykoli ukončí schválení a oznámí to zdroji, který pak zobrazí, že schválení bylo odvoláno, a přestane odesílat. Co přijímající instance už má, tam zůstane. Zamítnutá žádost zůstává zamítnutá. Další datové sady nebo žádost po odvolání se ptají znovu.
Přijímající instance musí odpovídat přes HTTPS. Na prostou adresu http zdroj nic neposílá, protože token a data by šly po síti nešifrované. Každý přenos navíc nechává desetinu přijímajícího poolu volnou a skončí dřív, než by ji začal zabírat, takže jeden zdroj nemůže zaplnit pool přijímajícího serveru.
Kam data přijdou¶
Každá datová sada skončí v <root>/<server>/<pool>/<path>. Složka serveru je název zdrojové instance, ustálený při prvním přenosu, takže si dva servery se stejným názvem poolu nikdy nepřekážejí. Například cache/appdata serveru s názvem tower skončí v backup/bombvault-replica/tower/cache/appdata.
Po novém nastavení BombVaultu cíl odmítne složku, kterou tento BombVault dřív naplnil. Karta Replika pak nabídne Převzít složku a další replika naváže na kopie v ní. Převezmi ji jen tehdy, když do této složky nereplikuje žádný jiný BombVault.
Kopie na cíli je jen pro čtení. Ve výchozím stavu není připojená, takže nikdy nic na tom serveru nepřekryje. Server ZFS připojený přes SSH má na své stránce přepínač Připojit na serveru jen pro čtení: když je zapnutý, BombVault po každém běhu kopie na něm připojí jen pro čtení, takže jejich soubory můžeš na cíli číst a kopírovat. Šifrované kopie zůstávají zamčené, dokud se nenačte jejich klíč, a vypnutí přepínače nic neodpojí. Spárovaná instance, která repliku přijímá, ji drží nepřipojenou. Vlastnosti ZFS putují s ní, kromě přípojného bodu, sharenfs a sharesmb. Rezervace reservation a refreservation také zůstávají, kopie tak zabere jen místo, které potřebují její data.
Co se zahrnuje¶
Zahrnuje se všechno, co položka zálohuje, a také svazky pod ní, které záloha přeskakuje. Podřízená datová sada, kterou jsi v položce vypnul, zůstane venku. Všechny datové sady jednoho běhu pocházejí z jednoho snímku, stejně jako u zálohy.
Kopie, kterou na tento server replikuje jiný BombVault, se dál neposílá, protože by to prořídilo historii, kterou její zdroj ještě potřebuje. Když strom položky takovou kopii obsahuje, běh pro tu datovou sadu selže a řekne proč, dokud ji v položce nevypneš. Položka, která sama je takovou kopií, nemůže replikovat vůbec. Smazání položky nebo vypnutí její repliky nechá tyto kopie a jejich snímky na pokoji. Jakmile kopii převezmeš, jak je popsáno v Použití repliky, počítá se jako běžná datová sada.
Jak dlouho snímky zůstávají¶
Na cíli drží nová replika 7 denních a 3 týdenní snímky. Místo toho vyber Krátké, Vyvážené nebo Dlouhé, nebo nastav Vlastní hodnoty. Vlastní hodnoty samé nuly ponechají každý snímek a karta to řekne. Odstraňují se tam jen snímky pojmenované bombvault-replica-<14 digits>, a nikdy ne nejnovější, který mají obě strany společný.
Na zdroji drží BombVault poslední snímek repliky a k tomu záložku pro každý odeslaný stav. Záložky nezabírají místo. Další přenos od nich vychází.
Chceš-li i na zdroji držet víc, nastav na kartě Replika Ponechat na tomto serveru, třeba na 7. Tolik nejnovějších snímků repliky pak po každé replice zůstane na tomto serveru, vedle toho, co drží cíl. 0 nebo 1 ponechá jen poslední. Poslední nese hold, aby se základ dalšího přenosu omylem nesmazal. Starší ho nemají. Každý snímek drží bloky, které se po něm změnily, takže každý, který ponecháš, zabírá místo v poolu. Když repliku vypneš nebo přepneš na jiný cíl, nebo položku smažeš, zmizí z tohoto serveru i ony. Snímky jiné položky vnořené pod ní zůstanou. Pokud hostitel při mazání položky není dosažitelný, snímky zůstanou také a stránka to řekne. Odstraň je ručně: zfs release -r bombvault-replica <dataset>@<snapshot>, potom zfs destroy.
Soubory ponechaného snímku můžeš hned číst nebo kopírovat, ze složky .zfs/snapshot uvnitř datové sady nebo z klonu, bez zásahu do datové sady nebo repliky:
ls /mnt/cache/appdata/.zfs/snapshot/bombvault-replica-20261006014100
zfs clone cache/appdata@bombvault-replica-20261006014100 cache/appdata-20261006
Klon nezabírá místo, dokud se v něm něco nezmění. Až skončíš, smaž ho pomocí zfs destroy cache/appdata-20261006, protože snímek, který má klon, nejde odstranit.
K poslednímu snímku repliky se tady vrátíš jen pomocí zfs rollback cache/appdata@<poslední> a na cíli nemusíš dělat nic. Vrácení celé datové sady ke staršímu snímku smaže každý snímek po něm, na tomto serveru i na cíli. Poslední nese hold, takže ho nejdřív sundej a pak tady datovou sadu vrať zpět:
zfs release -r bombvault-replica cache/appdata@bombvault-replica-20261008014200
zfs rollback -r cache/appdata@bombvault-replica-20261006014100
Kopii na cíli je potřeba vrátit také, ale ne vždy na stejný snímek, protože ho vlastní uchovávání cíle už mohlo odstranit. Spusť repliku jednou. U této datové sady se zastaví, protože cíl má novější snímky, a karta Replika a historie běhů uvedou snímek, na který je třeba cíl vrátit: nejnovější, který mají obě strany ještě společný. Vrať na něj kopii na serveru ZFS, nebo na hostiteli spárované instance, která repliku přijímá, například:
zfs rollback působí na jednu datovou sadu, takže návraty zopakuj pro každou podřízenou datovou sadu, kterou chceš mít také zpátky. Potom Replikovat teď naváže na společný snímek.
Šifrované datové sady v replice¶
Šifrovaná datová sada se posílá surově. Na cíli zůstává šifrovaná a cíl klíč nikdy nevidí. Klíč dobře uschovej: potřebuješ ho k otevření kopie po obnově a replika bez něj je nečitelná.
Použití repliky¶
Otevři záložku Zálohy položky a klikni na řádek Replika ZFS mezi místy, která drží její snímky. List vypíše snímky na cíli a ukáže příkazy s tvými skutečnými názvy.
Chceš-li se podívat na starý stav, naklonuj snímek na cíli. Klon nezabírá místo, dokud se něco nezmění, a replika zůstane nedotčená:
zfs clone backup/bombvault-replica/tower/cache/appdata@bombvault-replica-20261006014100 backup/bombvault-replica/clone-appdata
Pokud zdroj selže, změň kopii na cíli na normální zapisovatelnou datovou sadu:
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 pak do této datové sady a jejích podřízených přestane replikovat. Další běh selže s důvodem a to, co jsi zapsal, zůstane. Totéž platí pro cokoli jiného zapsaného do kopie od jejího nejnovějšího snímku: BombVault kopii nikdy nevrací zpět. Chceš-li tam znovu replikovat, přesuň z kopie, co potřebuješ, a na cíli ji smaž. Další běh pak pošle všechno znovu.
Chceš-li stav vrátit na zdroj, stiskni v listu Vrátit jako novou datovou sadu. BombVault pošle snímek do nové datové sady vedle originálu, pojmenované <dataset>-bombvault-restore- plus časové razítko. Originál nikdy nepřepisuje. Podřízená datová sada, která se na zdroji ztratila, se vrátí také, pokud kopie ten snímek ještě drží. Podřízená sada, která ho nedrží, se vynechá a běh to řekne.
Příklad: replika na druhý Unraid¶
Server tower zálohuje datovou sadu cache/appdata jako položku ZFS. Druhý Unraid na 192.168.1.20, bez BombVaultu, má pool backup a má držet kopii, kterou si můžeš kdykoli přečíst.
- Otevři Zálohy, pak
cache/appdataa její záložku Nastavení. V kartě Replika zvol pod Replikuje na Přidat server ZFS. - Zadej
192.168.1.20, uživateleroota port22. Dialog ukáže klíč repliky. Na druhém stroji ho vlož pod Users, root, SSH keys a stiskni Apply. Tento klíč se liší od klíče SSH k hostiteli, takže ho přidej, i když tam ten druhý už je. - Otestuj připojení. Vyber pool
backupa ponech kořen, který navrhne,backup/bombvault-replica. - Zpátky na kartě je nový server vybraný pod Replikuje na. Nech Kdy na Po každé záloze, nech Ponechat na cíli na jeho 7 denních a 3 týdenních snímcích a nastav Ponechat na tomto serveru na
7. - Stiskni Replikovat teď. První běh posílá všechno, takže 300 GB po lince 1 Gbit/s trvá aspoň 40 minut. Karta a seznam Záloh říkají Replikuje se, pak Replikováno s časem. Další běhy posílají jen změněné bloky.
Datové sady teď leží na druhém stroji v backup/bombvault-replica/tower/cache/appdata, jen pro čtení. Na přehledu Mimo lokalitu u sekce ZFS počítá repliku jako kopii mimo lokalitu.
Chceš-li dostat jeden soubor z minulého úterý, máš tři cesty:
-
Na tomto serveru, protože Ponechat na tomto serveru drží sedm snímků:
-
Na druhém stroji, pomocí klonu snímku na cíli. Záložka Zálohy položky ukáže příkazy s tvými skutečnými jmény, když klikneš na řádek Replika ZFS. Až skončíš, klon odstraň pomocí
zfs destroy. - Přes připojení, zapnutím Připojit na serveru jen pro čtení na stránce serveru ZFS. Po dalším běhu kopie stojí na druhém stroji připojené jen pro čtení.
Verze starší, než replika drží, se pořád berou ze záloh, jak ukazuje další příklad.
Příklad: jeden soubor ze zálohy ZFS¶
- Otevři Obnova, vyber dlaždici ZFS a klikni na
cache/appdata. - Vyber zálohu a pod Datová sada datovou sadu, která soubor drží.
- V kroku Co zvol Jednotlivé soubory a soubor zaškrtni.
- V kroku Kam zvol Do složky a vyber složku pod
/mnt, třebauser/restore. Nepotřebuje to spojení SSH a funguje to i pro datovou sadu, která už neexistuje. - Stiskni Obnova. Soubor skončí přímo v té složce, bez cesty nad ním.
Zbylé snímky¶
Snímek zálohy se jmenuje <dataset>@bombvault-<14 číslic>, například cache/appdata@bombvault-20260924021500 (UTC). BombVault ho odstraní hned po záloze. Pokud se to nepovede, například protože je datová sada zaneprázdněná nebo byl BombVault zastaven, odstraní ho BombVault:
- před další zálohou této položky,
- při spuštění BombVaultu, pro každou položku, i s vypnutou sekcí,
- když položku smažeš,
- když u položky stiskneš Odstranit teď, kde je také vidět, kolik jich zbývá.
Odstraňují se jen názvy, které přesně odpovídají bombvault- plus 14 číslic. Bezpečnostních snímků, tvých vlastních snímků a automatických snímků se to nikdy nedotkne. Chceš-li jeden odstranit ručně:
Snímek repliky se jmenuje <dataset>@bombvault-replica-<14 digits> a není zbytkem. Zůstává na zdroji, dokud ho nenahradí novější běh repliky nebo dokud ho drží Ponechat na tomto serveru, a na cíli, dokud ho uchovávání drží. Úklid se ho nikdy nedotkne, protože odpovídá jen bombvault- následovanému přesně 14 číslicemi.
Anomálie¶
Podřízená sada, která byla vyprázdněna, sotva změní součet velkého stromu, a proto detekce anomálií sleduje každou datovou sadu položky zvlášť: velikost, počet souborů, nová data a doba resticu mají každá vlastní historii. Tato historie patří ke jménu datové sady, takže zůstane, i když strom později zálohuje jiná položka.
Datová sada, kterou předchozí běh zálohoval a kterou tento běh nemohl přečíst, se počítá jako vyprázdněná, pokud se výběr položky nezměnil. To pokrývá nenačtený klíč, nepřipojenou datovou sadu i sadu, která ze stromu zmizela. Podřízená sada, kterou sám vyloučíš, mění výběr, takže její historie začne znovu. Dokud je otevřené zjištění o ztracených datech, uchovávání ponechá staré zálohy právě této datové sady a zbytek stromu pročistí jako obvykle.
Každá datová sada má vlastní řádek ve sledování položky, které se otevře přes Sledování na stránce Anomálie a je na záložce Ověření položky. Otevřená zjištění se ukazují u každé datové sady. Odkaz ve zjištění otevře okno obnovy u poslední dobré zálohy datové sady. Zda běh doběhne, se posuzuje pro celou položku, protože běh uspěje nebo selže jako celek.
Samotné kontroly popisuje Anomálie. Asistent připojený přes server MCP může vypsat body obnovy položky ZFS, spustit její zálohu a číst zjištění, ale potvrzení zjištění probíhá na stránce Anomálie.
Kódy důvodů¶
Stránka položky, historie běhů a oznámení pojmenují problém jedním z těchto kódů. U většiny je řešení uvedeno i vedle na stránce.
| Kód | Význam | Co dělat |
|---|---|---|
ssh-missing |
Spojení SSH není v tomto kontejneru nastavené. | Nastav spojení SSH jako pro zálohy VM. |
host-placeholder |
Host SSH: Address je stále vzorová hodnota a host.docker.internal také neodpověděl. |
Nastav Host SSH: Address na IP adresu LAN tohoto serveru. |
host-fallback |
Host SSH: Address je stále vzorová hodnota a host.docker.internal funguje. |
Nic, nebo nastav IP adresu LAN. |
ssh-unreachable |
Server není přes SSH dosažitelný. | Zkontroluj adresu a port a zda je SSH zapnuté. |
ssh-auth |
Server odmítl klíč BombVaultu. | Spusť jednou na serveru příkaz zobrazený pod Spojení s tímto serverem. |
zfs-not-found |
Hostitel SSH nemá příkaz zfs. |
Nasměruj Host SSH: Address na stroj, kterému pooly patří. |
zfs-permission |
Uživatel SSH nesmí spustit tento příkaz zfs. | Použij root, nebo viz TrueNAS SCALE. |
uri-mismatch |
LIBVIRT_URI uvádí jiného hostitele nebo uživatele než pole SSH. |
Sjednoť je, nebo pole SSH vyprázdni, aby obojí pocházelo z URI. |
zfs-error |
zfs nahlásil jinou chybu. | Podrobnosti ukazují jeho zprávu. |
propagation-missing |
Nová připojení na hostiteli nedorazí do kontejneru. | Nastav Access Mode u Host Data na Read/Write - Slave a restartuj BombVault. |
invalid-name |
Název datové sady, který BombVault nepřijímá. | Přejmenuj datovou sadu. |
name-too-long |
Datová sada ve stromu je na název snímku příliš dlouhá. | Přejmenuj ji, nebo přidej jako položku datovou sadu pod ní. |
invalid-exclude |
Vzor vyloučení nebo vynechaná podřízená sada k položce nepasuje. | Oprav záznam, který zpráva uvádí. Chceš-li vynechat celou podřízenou sadu, vypni ji místo psaní vzoru. |
not-found |
Datová sada na serveru neexistuje. | Odeber položku, nebo datovou sadu vytvoř znovu. Její zálohy zůstávají obnovitelné. |
not-filesystem |
Toto je svazek, ne souborový systém. | Viz Svazky. |
overlaps-item |
Datová sada se překrývá s existující položkou. | Viz Položky se nikdy nepřekrývají. |
docker-storage |
Strom obsahuje úložiště obrazů Dockeru. | Viz Úložiště Dockeru. |
nothing-readable |
Žádnou datovou sadu položky teď nelze přečíst. | Podívej se na kódy přeskočených datových sad. |
snapshot-failed |
Snímek nešlo vytvořit. | Podrobnosti ukazují zprávu zfs. |
containers-busy |
Když se měly kontejnery zastavit, ještě běžela záloha kontejneru. | Spusť znovu později. Plánované běhy počkají samy. |
consistency-stop-failed |
Kontejner nešlo zastavit, takže se snímek nepořídil. | Zkontroluj kontejner, nebo ho odeber ze seznamu. |
pre-snapshot-failed |
Příkaz před snímkem selhal. | Podrobnosti běhu ukazují jeho výstup. |
container-unknown |
Uvedený kontejner neexistuje. | Odeber ho ze seznamu. |
container-is-self |
BombVault nemůže zastavit svůj vlastní kontejner. | Odeber ho ze seznamu. |
leftover-snapshots |
Na serveru jsou stále snímky, které BombVault nemohl odstranit. | Stiskni Odstranit teď, viz Zbylé snímky. |
zvol |
Svazek ve stromu, přeskočen. | Viz Svazky. |
canmount-off |
Nikdy nepřipojeno (canmount=off), přeskočeno. |
Pokud obsahuje data, připoj ho nebo data přesuň do podřízené sady. |
legacy-mount |
Přípojný bod legacy, přeskočeno. | Dej mu přípojný bod pod /mnt. |
no-mountpoint |
Bez přípojného bodu, přeskočeno. | Dej mu přípojný bod pod /mnt. |
not-mounted |
Na serveru nepřipojeno, přeskočeno. | Připoj ho pomocí zfs mount, nebo nastav canmount=on. |
key-not-loaded |
Šifrováno a klíč není načtený, přeskočeno. | zfs load-key, pak ho připoj. |
snapdir-disabled |
Přístup ke snímkům je vypnutý, přeskočeno. | zfs set snapdir=hidden <dataset>. Složka .zfs zůstane skrytá. |
not-visible |
BombVault nevidí přípojný bod datové sady. | Přesuň přípojný bod pod cestu Host Data, nebo ho namapuj do kontejneru na stejnou cestu s Read/Write - Slave. |
shfs-only |
Datová sada je vidět jen přes /mnt/user, které skrývá snímky. |
Jako Host Data namapuj /mnt, ne /mnt/user. |
snapshot-not-visible |
Snímek byl vytvořen, ale v BombVaultu se neobjevil. | Spusť Vyzkoušet přístup ke snímkům. Viz níže. |
snapshot-loop |
Snímek nedorazil do BombVaultu, protože Host Data nepropouští nová připojení. | Nastav Access Mode u Host Data na Read/Write - Slave a restartuj BombVault. |
backup-failed |
restic pro tuto datovou sadu selhal. | Podrobnosti běhu ukazují proč. |
not-reached |
Běh skončil před touto datovou sadou. | Spusť zálohu znovu. |
gone |
Datová sada už na serveru není. | Nic. Její zálohy zůstávají obnovitelné. |
read-only-mount |
BombVault může datovou sadu jen číst, takže do ní nemůže obnovovat. | Nastav mapování na Read/Write - Slave, nebo obnov do složky. |
destination-not-mounted |
Složka neleží na připojeném poolu ani sdílené složce. | Vyber složku na poolu nebo sdílené složce. |
not-enough-space |
V cíli není dost volného místa. | Uvolni místo, nebo vyber jinou složku. |
safety-snapshot-failed |
Bezpečnostní snímek nešel pořídit, takže se nic neobnovilo. | Podrobnosti ukazují zprávu zfs. |
safety-name-too-long |
Název datové sady je na bezpečnostní snímek příliš dlouhý. | Vypni bezpečnostní snímek, nebo obnov do složky. |
dataset-exists |
Datová sada s tímto názvem už existuje. | Zvol nový název, nebo obnov přímo do datové sady. |
create-failed |
Novou datovou sadu se nepodařilo vytvořit. | Podrobnosti ukazují zprávu zfs. Zkontroluj, že nadřazená datová sada existuje. |
new-dataset-not-visible |
Nová datová sada byla vytvořena, ale BombVault ji nevidí, takže se nic neobnovilo. | Datová sada zůstává na serveru. Připoj ji pod cestu Host Data a obnov do ní. |
set-properties-failed |
Uložené vlastnosti se nepodařilo nastavit, takže se nic neobnovilo. | Podrobnosti ukazují zprávu zfs. |
set-limits-failed |
Soubory se obnovily, ale uloženou kvótu nebo rezervaci se nepodařilo nastavit. | Podrobnosti ukazují zprávu zfs. Nastav kvótu nebo rezervaci sám pomocí zfs set. |
Kontrola toho, co kontejner vidí¶
Vyzkoušet přístup ke snímkům na záložce Nastavení položky pořídí skutečný snímek jejího stromu, hledá ho v BombVaultu pro každou datovou sadu a zase ho odstraní. Je to nejrychlejší způsob, jak ověřit celou cestu před prvním plánovaným během.
Chceš-li se podívat sám, spusť na serveru:
Každý řádek je jedno připojení uvnitř kontejneru. Řádek datové sady ukazuje její cestu v kontejneru (pod /host/user) a název datové sady. Pole master:N na tomto řádku znamená, že připojení dostává připojení, která hostitel vytvoří později, a to přístup ke snímkům potřebuje. Pokud chybí, nastav Access Mode u Host Data na Read/Write - Slave a restartuj BombVault.
TrueNAS SCALE¶
- Když je nastavena
LIBVIRT_URI(jako pro zálohy VM na TrueNAS), BombVault vezme hostitele, uživatele a port SSH pro své příkazy zfs z URI, každý, který není nastaven samostatně. Bez záloh VM není třeba nic nastavovat:host.docker.internalse v aplikaci TrueNAS nepřeloží, takže BombVault dosáhne na hostitele přes výchozí bránu aplikace, jako root na portu 22.LIBVIRT_HOST,LIBVIRT_SSH_USERaLIBVIRT_SSH_PORTnastav, když chceš jinou adresu nebo uživatele, venvironmentaplikace. - Přidej klíč SSH k hostiteli z Nastavení, Integrace, SSH k hostiteli uživateli root v Credentials, Users a zapni službu SSH v System, Services. Replika na tento nebo jiný TrueNAS potřebuje navíc klíč repliky, který je jiný.
- Uživatel jiný než root potřebuje oprávnění k nejvyšší datové sadě položky, která pak pokrývají každou datovou sadu pod ní:
Obnova do nové datové sady navíc potřebuje create na nadřazené datové sadě a nastavení uložených vlastností potřebuje oprávnění k těmto vlastnostem.
Relace SSH bez roota na TrueNAS nemá v cestě /usr/sbin. BombVault pak volá přímo /usr/sbin/zfs.
- Host Data aplikace musí být cesta hostitele nad datovými sadami, například /mnt/tank, ne ixVolume. S cestou hostitele předává aplikace nová připojení hostitele do BombVaultu (rslave), a to přístup ke snímkům potřebuje. Celé nastavení aplikace popisuje TrueNAS SCALE.