Zálohy HQbird
Zálohy Firebird
Plánované gbak a nbackup, pro jednu databázi nebo pro všechny databáze ve složce. U gbak můžete po každé záloze zapnout testovací obnovu. Databáze se ze zálohy aktualizuje automaticky a žádné selhání v průběhu nezanechá databázi v neznámém stavu.
- 6 typů úloh zálohování
- nbackup úrovně 0…4
- zip · gz · zstd s kontrolou archivu
- S3 bez mezilehlého souboru
- testovací obnova
Dva nástroje
gbak nebo nbackup
HQbird podporuje oba typy záloh Firebird a pro jednu databázi můžete použít oba. gbak vytváří logickou kopii: je menší než databáze a obnova ji ověří. nbackup kopíruje stránky databáze: je rychlý a přírůstky zabírají málo místa.
| gbak (ověřená záloha) | nbackup (přírůstkový) | |
|---|---|---|
| Co kopíruje | Data a metadata. Odpad a staré verze záznamů se do kopie nedostanou. | Stránky databázového souboru. Úroveň 0 je plná; úrovně 1…N obsahují pouze změněné stránky. |
| Velikost | Obvykle mnohem menší než databáze; dobře se komprimuje. | Úroveň 0 má velikost databáze; přírůstky jsou malé. |
| Obnova | Vytvoří novou databázi a znovu sestaví indexy. U velkých databází to trvá dlouho. | Slučuje řetězec úrovní. Rychlé. |
| Kontrola | Testovací obnova po každé záloze, pokud je v úloze zapnutá. | Kontrola řetězce podle GUID. Žádná úroveň 0 — agent ji vytvoří okamžitě. |
| Použijte pro | Spolehlivou kopii, přesun mezi verzemi a servery, Backup-Restore-Replace. | Časté body obnovy během dne bez zátěže serveru. |
Pokud musí gbak a nbackup jedné databáze začít ve stejné minutě, gbak se posune o 15 minut později. Zatímco nbackup používá databázi, gbak čeká (ve výchozím nastavení až 60 minut) a neselže.
Typy úloh
Jednotlivé a skupinové úlohy
Jednotlivá úloha pokrývá jednu databázi a má vlastní nastavení. Použijte ji pro hlavní firemní databázi: vlastní plán, vlastní složku, vlastní uchovávání.
Skupinová úloha pokrývá složky s databázemi. Jedno nastavení pro všechny databáze skupiny. V každém cyklu agent znovu prochází složky podle masek, takže nová databáze se do zálohy dostane automaticky, bez změny nastavení.
| Jedna databáze | Všechny databáze ve složkách | |
|---|---|---|
| gbak s kontrolou | vbackup | grpvbackup |
| nbackup s úrovněmi | nbackup | grpnbackup |
| nbackup dump | nbackup_dump | grpnbackup_dump |
Co skupinová úloha zahrne a co přeskočí
Agent prochází složky a kontroluje každý soubor proti maskám zahrnutí a vyloučení. Volitelně kontroluje také minimální velikost a začátek souboru. Záložní soubory (.fbk, .nbk, .delta, archivy) se do zálohy nikdy nedostanou.
Databáze, která má vlastní jednotlivou úlohu, je ze skupiny automaticky vyloučena, i když je tato úloha vypnutá. Skupina gbak nezahrnuje databáze jednotlivých úloh gbak. Skupina nbackup nezahrnuje databáze úloh nbackup a dump.
Systémové databáze (názvy začínající na security a examples) se vždy přeskakují. Náhled skenování ukazuje důvod každého přeskočení.
D:\data\ · maska *.fdb
- sales.fdbve skupině
- stock.fdbve skupině
- branch_new.fdb
nová databáze: začíná úrovní 0ve skupině - erp.fdb
má vlastní jednotlivou úlohupřeskočit - security5.fdb
systémová databázepřeskočit - bck_sales_20261107.fbk
záložní souborpřeskočit - orders.fdb.delta
delta soubor nbackuppřeskočit
- Databáze odstraněna ze složkyStane se „osiřelou“. Její zálohy se uchovávají podle pravidla: N dní nebo vždy. Nebo se okamžitě přesunou do složky
_orphaneda po 7 dnech se smažou. - Databáze přejmenovánaNový název začíná nový řetězec od úrovně 0. Staré zálohy se uchovávají podle pravidla pro osiřelé databáze.
- Opakovaná selháníPo 5 selháních v řadě se databáze pozastaví na 6 hodin a poté se zkusí znovu.
- Chyba v jedné databázi nezastaví skupinuSkupina pokračuje další databází. Toto je nastavení „Pokračovat dalšími databázemi po chybě“; ve výchozím nastavení je zapnuto pro skupiny gbak, nbackup, dump a sweep.
- Výsledek skupiny v řádku úlohy„Nalezeno N databází · úspěšných M · chyb X · celkový čas“. Podrobnosti obsahují tabulku databází s chybou: název, cestu a začátek textu chyby.
- Časový rozpočetCyklus nespouští nové databáze, když vyprší čas. U skupin nbackup můžete zapnout pokračování od další databáze v následujícím cyklu.
- ParalelismusKolik databází skupiny zpracovávat současně. Společný limit pro dlouhé úlohy na serveru: ve výchozím nastavení běží současně nejvýše dvě.
- Jedna operace na databáziJednotlivé a skupinové úlohy, gbak a nbackup navzájem vidí své zámky.
- Strom složek jako ve zdrojiZaškrtávací políčko „Opakovat strom zdrojových složek“: záloha databáze
x/y/EMPLOYEE.FDBjde do<backup folder>/x/y/EMPLOYEE.FDB/. Databáze se stejným názvem z různých složek si navzájem nepřekážejí.
vbackup · grpvbackup
gbak: záloha s kontrolou
Před každým krokem agent zkontroluje volné místo: pro zálohu, pro testovací obnovu, pro archiv. Pokud není dost místa pro obnovu, agent ji přeskočí s důvodem no_space a záloha zůstane. gbak zapisuje do dočasného souboru. Soubor dostane název .fbk pouze tehdy, pokud jsou velikost a log gbak v pořádku. Neúplná záloha s normálním názvem se tedy ve složce nikdy neobjeví.
- 1Kontrola místapro zálohu; znovu před obnovou a kompresí
- 2gbakdo dočasného
.gbaktmp; na Firebird 5 — na N jádrech - 3Kontrolavelikost a log; poté název
.fbk - 4Testovací obnovapokud je zapnuta; samostatný soubor, ne produkční databáze
- 5Kompresearchiv rozbalen a porovnán pomocí SHA-256
- 6✓ Úložištěkopie do jiné složky; staré kopie se smažou
- Přehledné názvy
bck_sales_20261107_02-00.fbk: začátek názvu databáze a čas. Dvě databáze ve stejné složce nezapisují stejné názvy. - Upozornění na překrytíPokud dvě úlohy zapisují soubory se stejným začátkem názvu do jedné složky, agent i editor zobrazí upozornění.
- Výsledek testovací obnovyok, failed, skipped s důvodem nebo not_run. Vidíte jej ve výsledku poslední úlohy a v inventáři. V editoru každá obnova zobrazuje oba příkazy: zálohu a obnovu.
- Stará testovací databázeNová úloha spouští testovací obnovu s
-rep: gbak přepíše kopii z předchozího běhu. Agent nejprve odpojí klienty této kopie. Pokud je cesta testovací databáze stejná jako produkční databáze nebo databáze jiné úlohy, obnova se přeskočí. - Protokoly a příkazy gbakPoslední řádky s chybami jsou viditelné v konzoli; protokol si můžete stáhnout. Protokoly se mažou společně s jejich zálohou. Agent uchovává historii spuštěných příkazů: až 50 pro každý krok úlohy, hesla skrytá.
- Přepínače, které narušují kontrolu
-Yposílá výstup gbak do souboru, ale agent kontroluje zálohu podle tohoto výstupu. Proto-Ynení povolen. Streamovací úloha nepřijímá-SEani v řádku pro obnovu. Editor tyto přepínače označí. - Časové limityMěkký: varování. Tvrdý: gbak je zastaven.
- Čas gbak podle krokuAgent sám přidává přepínač
-ST TDRWke každé záloze a obnově a bere čas gbak z výstupu. Ve volbách úlohy nepotřebujete vlastní-ST: editor jej nepřijímá. - Přihlášení nastavuje agentPřepínače
-user,-password,-fetch_passworda-trustednejsou ve volbách povoleny. Testovací obnova běží jako vlastník databáze, pokud je vlastník zaznamenán v nastavení přístupu k databázi. Řádek obnovy ukazuje, pod jakým uživatelským jménem běžela. - Srozumitelné zprávyMísto a čas ve známých jednotkách: „8,1 GiB volných, 11,8 GiB potřeba“, „vypršel časový limit po 60 s“.
nbackup · grpnbackup
nbackup: úrovně a body obnovy
Úroveň 0 kopíruje celou databázi. Úroveň 1 kopíruje stránky změněné po poslední úrovni 0. Úroveň 2 kopíruje změny po poslední úrovni 1. K obnovení databáze do okamžiku, který potřebujete, stačí tři soubory.
Příklad plánu: úroveň 0 jednou týdně, úroveň 1 každou noc, úroveň 2 čtyřikrát denně. To dává 36 bodů obnovy za týden: 1 + 7 + 28. Uchovává se 5 kopií úrovně 0, 7 kopií úrovně 1 a 24 kopií úrovně 2.
- Řetěz bez mezerŽádná úroveň 0 — agent ji vytvoří okamžitě. U ostatních úrovní toto řídí nastavení „Immediately create missing low levels“. Bez něj se spuštění přeskočí, dokud nižší úroveň chybí.
- Kontrola podle GUIDKaždá úroveň je vázána na svou nižší úroveň; cizí soubor se do řetězu nedostane.
- Tři režimy plánováníJednoduchý — podle dnů a hodin. Pokročilý — cron pro každou úroveň, až do úrovně 4. Plán — pravidla s úrovní, dny a časem.
- nbackup dumpÚplná kopie databázového souboru mimo řetěz úrovní, podle vlastního plánu.
- Databáze ve stavu deltaPokud databáze zůstane po přerušeném nbackup uzamčena, agent se pokusí sloučit deltu.
Režim plánu
Plán je sada pravidel: úroveň, dny a čas. Dny mohou být každý den, dny v týdnu nebo dny v měsíci. Pokud se ve stejné minutě shodují dvě pravidla, spustí se nižší úroveň. Plán může sám vytvořit úroveň 0, když je poslední úroveň 0 starší než nastavený počet dní. Spustí nižší úroveň dříve, než je naplánováno, když přírůstky vzrostou nad nastavený podíl velikosti databáze. V grupové úloze si každá databáze vytváří vlastní řetěz úrovní.
Editor zobrazuje plán v kalendáři několik týdnů dopředu: která úroveň běží a kdy. Jedno tlačítko převede jednoduchý nebo pokročilý plán na plán a před uložením to můžete vrátit zpět.
- Uchovávání podle cyklůCyklus je úroveň 0 se všemi jejími přírůstky. Agent uchovává nebo maže celý cyklus: podle počtu cyklů, podle dnů nebo podle celkové velikosti. Nejnovější úplný cyklus se nikdy nemaže. Editor předem ukazuje, kolik místa zálohy zaberou.
- Stav plánuPoslední kopie každé úrovně, využité místo a co příští úklid smaže. Agent aktualizuje stav po každém spuštění plánu.
Compression · S3 · storage
Kde jsou zálohy uloženy
Záloha může jít přímo do S3: gbak nebo nbackup zapisuje do streamu a stream jde do bucketu. Na disku serveru není žádný meziprodukt, takže na serveru nepotřebujete místo pro zálohu.
Komprese zip, gz nebo zstd funguje pro lokální i streamovací zálohy. U lokální zálohy agent rozbalí hotový archiv a porovná jej se zdrojem podle velikosti a SHA-256. Teprve poté se zdrojový soubor smaže. Pokud kontrola selže, nic se nesmaže.
- Uchovávání podle počtugbak: kolik souborů uchovat. nbackup: kolik kopií každé úrovně.
- Kopie na jiná místaKopie do druhé složky nebo na síťovou cestu. Nahrání do S3, FTP nebo FTPS — pomocí samostatné úlohy file_sync.
- Vlastní skript po zálozePro gbak. Dostane cesty k záloze, testovací databázi a protokolům gbak.
- Šifrování archivuÚloha gbak může šifrovat archiv zip (AES-256) heslem z klíčů agenta, na disku i ve streamu S3. Archiv otevře 7-Zip. Obnova najde správný klíč sama.
- Obnova z archivuFormát se rozpozná podle obsahu souboru, lokálně i ze S3.
- Obnova ze S3Úloha obnovy čte zálohu přímo z bucketu.
- AntivirusVylučte složky záloh a obnov z kontroly v reálném čase.
- Kompresi volíte vyNová úloha se vytváří bez komprese. zstd je první v seznamu formátů. Pro archiv libovolného formátu si můžete nastavit vlastní příponu souboru.
- Průvodce Amazon S3Krok za krokem nastavení bucketu, klíčů a úlohy. K dispozici v angličtině a portugalštině.
Amazon S3 · kompatibilní úložiště
Zálohy do S3
Agent posílá zálohy do bucketu v Amazon S3 nebo v kompatibilním úložišti. Funguje to pro úlohy gbak i nbackup. Nepotřebujete k tomu další program.
Nastavení má tři části: připravte bucket a přístupový klíč, vytvořte cíl s3 v nastavení agenta, zapněte nahrávání v úloze zálohy. Každá úloha používá jeden ze dvou režimů.
| Kopie souboru | Stream do S3 | |
|---|---|---|
| Soubor na disku serveru | Ano. Záloha se zapíše na disk a poté se odešle. | Ne. Záloha jde přímo do bucketu. |
| Místo na disku pro zálohu | Potřeba. | Není potřeba. |
| Kam | S3, FTP, FTPS | Pouze S3 |
| Mazání starých kopií v bucketu | Ne. Použijte pravidlo životního cyklu bucketu. | Ano, podle pravidla uchovávání úlohy. |
| Selhání nahrání | Lokální záloha zůstává platná. | Žádná záloha: v bucketu nezůstane žádný objekt. |
- Jak vybratKopie souboru: když potřebujete lokální kopii i kopii v S3. Stream: když je disk serveru malý nebo je S3 jediným místem pro zálohy.
- Obnova ze S3Úloha obnovy čte streamovanou zálohu přímo z bucketu: nejnovější objekt nebo ten, který určíte. Agent kontroluje velikost a SHA-256 každého objektu.
- ŠifrováníŠifrování bucketu chrání objekt na straně úložiště. Šifrování archivu v úloze chrání soubor heslem ještě předtím, než opustí server.
- BucketPonechte veřejný přístup zablokovaný. Přidejte pravidlo, které po jednom dni smaže nedokončená multipart nahrávání.
- Klíč pouze pro zálohyVytvořte samostatného uživatele. Dejte mu jen práva, která potřebuje: zapisovat, číst a mazat objekty, přerušit nahrávání a vypisovat nedokončená nahrávání bucketu. Pokud je bucket šifrován klíčem KMS, potřebuje také práva k tomuto klíči. Na serveru Amazon EC2 můžete pracovat bez klíče: agent použije IAM roli serveru.
- KontrolaSpusťte úlohu tlačítkem Run now, podívejte se na výsledek a předtím, než se na zálohu spolehnete, proveďte testovací obnovu.
Časté chyby
| Chyba | Příčina | Co dělat |
|---|---|---|
AccessDenied | Chybí právo nebo se cesta v právech liší. | Zkontrolujte práva uživatele. |
SignatureDoesNotMatch | Špatný klíč nebo mezery v jeho hodnotě. | Zkopírujte klíč znovu. |
PermanentRedirect | Region v nastavení neodpovídá regionu bucketu. | Opravte region. |
NoSuchBucket | Špatný název bucketu. | Opravte název. |
RequestTimeTooSkewed | Hodiny serveru jsou špatně. | Synchronizujte hodiny s NTP. |
restore.replace_cycle
Backup-Restore-Replace
Cyklus znovu sestaví produkční databázi. Agent vytvoří zálohu gbak, obnoví ji do nového souboru a nový soubor umístí na místo starého. Nová databáze nemá žádný odpad, její indexy jsou čerstvé a obvykle je mnohem menší. Produkční databáze je odpojena a bezpečně přejmenována: agent ji nejprve uvede do shutdown full, všechny připojení se uzavřou a teprve poté soubor dostane nový název.
Ve výchozím nastavení běží cyklus v sobotu ve 02:00; rozvrh můžete změnit. Spustit nyní spustí cyklus okamžitě, ale nejprve vás vyzve k zadání názvu souboru databáze. Databázi lze zadat cestou nebo aliasem z databases.conf.
Klienti
Soubory na disku
Od vypnutí po nahrazení dostávají klienti „database not found“ nebo „database shutdown“. Naplánujte cyklus na dobu, kdy může být databáze nedostupná po dobu zálohy plus obnovy. V režimu pipe běží záloha a obnova současně a žádný záložní soubor se nezapisuje.
Cyklus se nespustí, pokud
- „Allow replace“ (allow_replace) není v úloze zapnuto;
- databáze je ve stavu shutdown, šifrovaná nebo je replikou;
- databáze je bezpečnostní DB, vlastní nebo pro jiné databáze;
- vedle ní jsou soubory nedokončeného cyklu;
- není dostatek místa na disku.
Místo se vypočítává předem: záložní soubor a obnovená kopie jsou na disku současně, každý přibližně o velikosti databáze. Originál se přejmenovává, nekopíruje, takže nezabírá žádné místo. Pokud je místa málo, cyklus se zastaví před vypnutím: databáze zůstane nedotčena a klienti dál pracují.
Co zůstává na disku
Originály. Poslední originály ve stavu shutdown full jsou uchovávány vedle databáze, od 1 do 10, ve výchozím nastavení 1. Přebytečné se smažou na začátku dalšího cyklu, takže databáze ve stavu před posledním cyklem je vždy k dispozici.
Záložní soubor se po nahrazení smaže. Pokud obnova selhala, soubor se uchová jako .restore-failed.fbk pro analýzu.
Návrat k originálu: zastavte produkční databázi, přejmenujte soubory a spusťte gfix -online pro originál.
Když je cyklus přerušen
Někdo může zastavit agenta, server se může restartovat, může vypadnout napájení. Při běžném zastavení služby před nahrazením agent nechá gbak dokončit a cyklus vrátí zpět. Pro případ selhání agent před každým krokem zapíše, co dělá, do souboru záměru. Při startu a poté každou minutu agent tyto soubory čte a uvádí cyklus do známého stavu.
Databáze se vrátí do online stavu
Agent uvede databázi do online stavu a obnoví zpoždění vypnutí.
Vrácení zpět
Mezilehlá kopie a neúplná záloha se smažou, originál získá své staré jméno a přejde do online stavu.
Dokončení
Nová databáze zůstává v produkci, originál je uchován ve stavu shutdown. Skript „after“ se nespustil: spusťte jej sami, pokud je to důležité.
Pokud soubory na disku neodpovídají žádnému známému stavu, agent nic nemění a výsledek úlohy začíná „operator needed“. Soubor záměru uvádí názvy všech souborů cyklu. Umístěte správnou databázi na její cestu a agent dokončí obnovu sám.
Vaše vlastní skripty před a po
Skript „before backup“ se spouští před vypnutím. Pokud skončí chybou, cyklus se zastaví a databáze zůstane nedotčena. Skript „after restore“ se spouští po nahrazení. Příklad: zkopírujte záložní soubor do archivu dříve, než jej agent smaže.
| Proměnná | Před zálohou | Po obnově |
|---|---|---|
FBAGENT_HOOK_PHASE | pre | post |
FBAGENT_JOB_ID | id úlohy | |
FBAGENT_DB_NAME | název v úloze: alias nebo cesta | |
FBAGENT_DB_PATH | soubor databáze: originál, online | stejná cesta: nová databáze, online |
FBAGENT_ORIG_PATH | prázdné | cesta k originálu |
FBAGENT_FBK_PATH | budoucí záložní soubor; prázdné v režimu pipe | záložní soubor, smazán po skriptu; prázdné v režimu pipe |
Inventář · zpráva o stavu
Kontrola: která databáze nemá zálohu
Inventář zobrazuje všechny záložní soubory na serveru, i ty vytvořené jinými programy. Agent jej aktualizuje po každé záloze a kompletně každé 2 hodiny. Vedle něj je tabulka obnov: testovacích a produkčních, za 14 dní.
Každá záloha má sloupec Ověřeno: testovací obnova prošla, selhala nebo neproběhla. Vedle je velikost obnovené databáze a čas gbak. Tabulka obnov zobrazuje velikost databáze a trvání.
Zpráva o stavu serveru označí databázi bez registrovaných záloh a uvede důvod: úloha selhala, stále běží, je odložena nebo ve složkách není žádný soubor. Tlačítko vedle zjištění okamžitě otevře formulář pro novou úlohu.