Kopie zapasowe HQbird
Kopie zapasowe Firebird
Zaplanowane gbak i nbackup, dla jednej bazy danych lub dla wszystkich baz danych w folderze. W przypadku gbak możesz włączyć testowe odtworzenie po każdej kopii zapasowej. Baza danych jest aktualizowana z kopii zapasowej automatycznie, a żadna awaria w trakcie nie pozostawia jej w nieznanym stanie.
- 6 typów zadań kopii zapasowych
- nbackup poziomy 0…4
- zip · gz · zstd z kontrolą archiwum
- S3 bez pliku pośredniego
- testowe odtworzenie
Dwa narzędzia
gbak lub nbackup
HQbird obsługuje oba typy kopii zapasowych Firebird i możesz używać obu dla jednej bazy danych. gbak tworzy kopię logiczną: jest mniejsza niż baza danych, a odtworzenie ją weryfikuje. nbackup kopiuje strony bazy danych: jest szybki, a przyrosty zajmują mało miejsca.
| gbak (zweryfikowana kopia zapasowa) | nbackup (przyrostowa) | |
|---|---|---|
| Co kopiuje | Dane i metadane. Śmieci i stare wersje rekordów nie trafiają do kopii. | Strony pliku bazy danych. Poziom 0 jest pełny; poziomy 1…N zawierają tylko zmienione strony. |
| Rozmiar | Zwykle znacznie mniejszy niż baza danych; dobrze się kompresuje. | Poziom 0 ma rozmiar bazy danych; przyrosty są małe. |
| Odtworzenie | Tworzy nową bazę danych i ponownie buduje indeksy. Dla dużych baz danych trwa to długo. | Scala łańcuch poziomów. Szybko. |
| Kontrola | Testowe odtworzenie po każdej kopii zapasowej, jeśli jest włączone w zadaniu. | Kontrola łańcucha przez GUID. Brak poziomu 0 — agent tworzy go od razu. |
| Do czego używać | Niezawodna kopia, przenoszenie między wersjami i serwerami, Backup-Restore-Replace. | Częste punkty odtworzenia w ciągu dnia bez obciążania serwera. |
Jeśli gbak i nbackup jednej bazy danych muszą rozpocząć się w tej samej minucie, gbak przesuwa się o 15 minut później. Gdy nbackup używa bazy danych, gbak czeka (domyślnie do 60 minut) i nie kończy się niepowodzeniem.
Typy zadań
Zadania pojedyncze i grupowe
Zadanie pojedyncze obejmuje jedną bazę danych i ma własne ustawienia. Używaj go dla głównej bazy danych firmy: własny harmonogram, własny folder, własna retencja.
Zadanie grupowe obejmuje foldery z bazami danych. Jeden zestaw ustawień dla wszystkich baz danych w grupie. W każdym cyklu agent ponownie skanuje foldery według masek, więc nowa baza danych automatycznie trafia do kopii zapasowej, bez zmiany ustawień.
| Jedna baza danych | Wszystkie bazy danych w folderach | |
|---|---|---|
| gbak z kontrolą | vbackup | grpvbackup |
| nbackup z poziomami | nbackup | grpnbackup |
| nbackup dump | nbackup_dump | grpnbackup_dump |
Co obejmuje zadanie grupowe, a co pomija
Agent przechodzi przez foldery i sprawdza każdy plik według masek dołączania i wykluczania. Opcjonalnie sprawdza także minimalny rozmiar i początek pliku. Pliki kopii zapasowych (.fbk, .nbk, .delta, archiwa) nigdy nie trafiają do kopii zapasowej.
Baza danych, która ma własne zadanie pojedyncze, jest automatycznie wykluczana z grupy, nawet jeśli to zadanie jest wyłączone. Grupa gbak nie obejmuje baz danych pojedynczych zadań gbak. Grupa nbackup nie obejmuje baz danych zadań nbackup i dump.
Bazy danych systemowych (nazwy zaczynające się od security i examples) są zawsze pomijane. Podgląd skanowania pokazuje powód każdego pominięcia.
D:\data\ · maska *.fdb
- sales.fdbw grupie
- stock.fdbw grupie
- branch_new.fdb
nowa baza danych: zaczyna od poziomu 0w grupie - erp.fdb
ma własne zadanie pojedynczepomiń - security5.fdb
baza danych systemowapomiń - bck_sales_20261107.fbk
plik kopii zapasowejpomiń - orders.fdb.delta
plik delta nbackuppomiń
- Baza danych usunięta z folderuStaje się „osierocona”. Jej kopie zapasowe są zachowywane według reguły: N dni lub zawsze. Albo od razu trafiają do folderu
_orphanedi są usuwane po 7 dniach. - Baza danych zmieniona nazwąNowa nazwa rozpoczyna nowy łańcuch od poziomu 0. Stare kopie zapasowe są zachowywane według reguły dla osieroconych baz danych.
- Powtarzające się awariePo 5 awariach z rzędu baza danych jest wstrzymywana na 6 godzin, a następnie ponawiana.
- Błąd w jednej bazie danych nie zatrzymuje grupyGrupa kontynuuje z następną bazą danych. To ustawienie „Kontynuuj z następnymi bazami danych po błędzie”; jest domyślnie włączone dla grup gbak, nbackup, dump i sweep.
- Wynik grupy w wierszu zadania„Znaleziono N baz danych · sukces M · błędy X · łączny czas”. Szczegóły zawierają tabelę baz danych z błędem: nazwa, ścieżka i początek tekstu błędu.
- Budżet czasuCykl nie rozpoczyna nowych baz danych, gdy czas się skończy. Dla grup nbackup możesz włączyć kontynuację od następnej bazy danych w następnym cyklu.
- RównoległośćIle baz danych grupy przetwarzać jednocześnie. Wspólny limit dla długich zadań na serwerze: domyślnie nie więcej niż dwa działają jednocześnie.
- Jedna operacja na bazę danychZadania pojedyncze i grupowe, gbak i nbackup widzą wzajemnie swoje blokady.
- Drzewo folderów jak w źródlePole wyboru „Powtórz drzewo folderów źródła”: kopia zapasowa bazy danych
x/y/EMPLOYEE.FDBtrafia do<backup folder>/x/y/EMPLOYEE.FDB/. Bazy danych o tej samej nazwie z różnych folderów nie przeszkadzają sobie nawzajem.
vbackup · grpvbackup
gbak: kopia zapasowa z kontrolą
Przed każdym krokiem agent sprawdza wolne miejsce: na kopię zapasową, na testowe odtworzenie, na archiwum. Jeśli brakuje miejsca na odtworzenie, agent pomija je z powodem no_space, a kopia zapasowa pozostaje. gbak zapisuje do pliku tymczasowego. Plik otrzymuje nazwę .fbk tylko wtedy, gdy rozmiar i log gbak są poprawne. Dzięki temu niekompletna kopia zapasowa z normalną nazwą nigdy nie pojawia się w folderze.
- 1Kontrola miejscana kopię zapasową; ponownie przed odtworzeniem i kompresją
- 2gbakdo tymczasowego
.gbaktmp; na Firebird 5 — na N rdzeniach - 3Kontrolarozmiar i log; następnie nazwa
.fbk - 4Testowe odtworzeniejeśli włączone; osobny plik, nie produkcyjna baza danych
- 5Kompresjaarchiwum rozpakowane i porównane przez SHA-256
- 6✓ Przechowywaniekopiowanie do innego folderu; stare kopie są usuwane
- Czytelne nazwy
bck_sales_20261107_02-00.fbk: początek nazwy bazy danych i czas. Dwie bazy danych w jednym folderze nie zapisują tych samych nazw. - Ostrzeżenie o nakładaniu sięJeśli dwa zadania zapisują pliki o tym samym początku nazwy do jednego folderu, agent i edytor pokazują ostrzeżenie.
- Wynik testowego odtworzeniaok, niepowodzenie, pominięte z powodem lub not_run. Widzisz go w wyniku ostatniego zadania i w inwentarzu. W edytorze każde odtworzenie pokazuje oba polecenia: kopię zapasową i odtworzenie.
- Stara testowa baza danychNowe zadanie rozpoczyna testowe odtworzenie z
-rep: gbak nadpisuje kopię z poprzedniego uruchomienia. Agent najpierw odłącza klientów tej kopii. Jeśli ścieżka testowej bazy danych jest taka sama jak produkcyjnej bazy danych lub bazy danych innego zadania, odtworzenie jest pomijane. - Logi i polecenia gbakOstatnie linie błędu są widoczne w konsoli; można pobrać log. Logi są usuwane razem z ich kopią zapasową. Agent prowadzi historię wykonanych poleceń: do 50 dla każdego kroku zadania, hasła ukryte.
- Przełączniki, które psują sprawdzenie
-Ywysyła wyjście gbak do pliku, ale agent sprawdza kopię zapasową na podstawie tego wyjścia. Dlatego-Yjest niedozwolony. Zadanie strumieniowe nie przyjmuje też-SEw wierszu przywracania. Edytor oznacza te przełączniki. - Limity czasuMiękki: ostrzeżenie. Twardy: gbak jest zatrzymywany.
- Czas gbak według krokuAgent sam dodaje przełącznik
-ST TDRWdo każdej kopii zapasowej i przywracania i pobiera czas gbak z wyjścia. Nie potrzebujesz własnego-STw opcjach zadania: edytor go nie przyjmuje. - Agent ustawia loginPrzełączniki
-user,-password,-fetch_passwordi-trustedsą niedozwolone w opcjach. Testowe przywracanie uruchamia się jako właściciel bazy danych, jeśli właściciel jest zapisany w ustawieniach dostępu do bazy danych. Wiersz przywracania pokazuje, jako który użytkownik zostało uruchomione. - Czytelne komunikatyMiejsce i czas w znanych jednostkach: „8.1 GiB wolne, 11.8 GiB potrzebne”, „przekroczono limit czasu po 60 s”.
nbackup · grpnbackup
nbackup: poziomy i punkty przywracania
Poziom 0 kopiuje całą bazę danych. Poziom 1 kopiuje strony zmienione po ostatnim poziomie 0. Poziom 2 kopiuje zmiany po ostatnim poziomie 1. Aby przywrócić bazę danych do potrzebnego momentu, wystarczą trzy pliki.
Przykładowy harmonogram: poziom 0 raz w tygodniu, poziom 1 każdej nocy, poziom 2 cztery razy dziennie. Daje to 36 punktów przywracania tygodniowo: 1 + 7 + 28. Zachowuje 5 kopii poziomu 0, 7 poziomu 1 i 24 poziomu 2.
- Łańcuch bez lukBrak poziomu 0 — agent tworzy go od razu. Dla innych poziomów to ustawienie „Natychmiast utwórz brakujące niskie poziomy”. Bez niego uruchomienie jest pomijane, dopóki brakuje niższego poziomu.
- Sprawdzenie według GUIDKażdy poziom jest powiązany ze swoim niższym poziomem; obcy plik nie trafia do łańcucha.
- Trzy tryby harmonogramuProsty — według dni i godzin. Zaawansowany — cron dla każdego poziomu, do poziomu 4. Plan — reguły z poziomem, dniami i czasem.
- Zrzut nbackupPełna kopia pliku bazy danych poza łańcuchem poziomów, według własnego harmonogramu.
- Baza danych w stanie deltaJeśli baza danych pozostaje zablokowana po przerwanym nbackup, agent próbuje scalić deltę.
Tryb planu
Plan to zestaw reguł: poziom, dni i czas. Dniami mogą być każdy dzień, dni tygodnia lub dni miesiąca. Jeśli w tej samej minucie pasują dwie reguły, uruchamiany jest niższy poziom. Plan może sam utworzyć poziom 0, gdy ostatni poziom 0 jest starszy niż ustawiona liczba dni. Uruchamia niższy poziom wcześniej niż zaplanowano, gdy przyrosty wzrosną powyżej ustawionego udziału rozmiaru bazy danych. W zadaniu grupowym każda baza danych buduje własny łańcuch poziomów.
Edytor pokazuje plan w kalendarzu na kilka tygodni naprzód: który poziom i kiedy się uruchomi. Jeden przycisk konwertuje prosty lub zaawansowany harmonogram na plan, a możesz to cofnąć przed zapisaniem.
- Retencja według cykliCykl to poziom 0 ze wszystkimi jego przyrostami. Agent zachowuje lub usuwa cały cykl: według liczby cykli, według dni lub według łącznego rozmiaru. Najnowszy pełny cykl nigdy nie jest usuwany. Edytor z góry pokazuje, ile miejsca zajmą kopie zapasowe.
- Status planuOstatnia kopia każdego poziomu, zajęte miejsce i to, co usunie następne czyszczenie. Agent aktualizuje status po każdym uruchomieniu planu.
Kompresja · S3 · przechowywanie
Gdzie przechowywane są kopie zapasowe
Kopia zapasowa może trafić bezpośrednio do S3: gbak lub nbackup zapisuje do strumienia, a strumień trafia do bucketu. Na dysku serwera nie ma pliku pośredniego, więc nie potrzebujesz miejsca na kopię zapasową na serwerze.
Kompresja zip, gz lub zstd działa zarówno dla kopii lokalnych, jak i strumieniowych. Dla kopii lokalnej agent rozpakowuje gotowe archiwum i porównuje je ze źródłem według rozmiaru i SHA-256. Dopiero potem plik źródłowy jest usuwany. Jeśli sprawdzenie się nie powiedzie, nic nie jest usuwane.
- Retencja według liczbygbak: ile plików zachować. nbackup: ile kopii każdego poziomu.
- Kopie w innych miejscachKopia do drugiego folderu lub ścieżki sieciowej. Wysyłanie do S3, FTP lub FTPS — osobnym zadaniem file_sync.
- Własny skrypt po kopii zapasowejDla gbak. Otrzymuje ścieżki do kopii zapasowej, bazy testowej i logów gbak.
- Szyfrowanie archiwumZadanie gbak może zaszyfrować archiwum zip (AES-256) hasłem z kluczy agenta, na dysku i w strumieniu S3. 7-Zip otwiera archiwum. Przywracanie samo znajduje właściwy klucz.
- Przywracanie z archiwumFormat jest wykrywany na podstawie zawartości pliku, lokalnie i z S3.
- Przywracanie z S3Zadanie przywracania czyta kopię zapasową bezpośrednio z bucketu.
- AntywirusWyklucz foldery kopii zapasowych i przywracania ze skanowania w czasie rzeczywistym.
- Ty wybierasz kompresjęNowe zadanie jest tworzone bez kompresji. zstd jest pierwszy na liście formatów. Możesz ustawić własne rozszerzenie pliku dla archiwum dowolnego formatu.
- Przewodnik po Amazon S3Krok po kroku konfiguracja bucketu, kluczy i zadania. Dostępny w języku angielskim i portugalskim.
Amazon S3 · zgodne przechowywanie
Kopie zapasowe do S3
Agent wysyła kopie zapasowe do bucketu w Amazon S3 lub w zgodnym przechowywaniu. Działa to dla zadań gbak i nbackup. Nie potrzebujesz do tego innego programu.
Konfiguracja składa się z trzech części: przygotuj bucket i klucz dostępu, utwórz cel s3 w ustawieniach agenta, włącz wysyłanie w zadaniu kopii zapasowej. Każde zadanie używa jednego z dwóch trybów.
| Kopia pliku | Strumień do S3 | |
|---|---|---|
| Plik na dysku serwera | Tak. Kopia zapasowa jest zapisywana na dysku, a następnie wysyłana. | Nie. Kopia zapasowa trafia bezpośrednio do bucketu. |
| Miejsce na dysku na kopię zapasową | Potrzebne. | Niepotrzebne. |
| Dokąd | S3, FTP, FTPS | Tylko S3 |
| Usuwanie starych kopii w buckecie | Nie. Użyj reguły cyklu życia bucketu. | Tak, według reguły retencji zadania. |
| Niepowodzenie wysyłania | Lokalna kopia zapasowa pozostaje ważna. | Brak kopii zapasowej: w buckecie nie pozostaje żaden obiekt. |
- Jak wybraćKopia pliku: gdy potrzebujesz zarówno kopii lokalnej, jak i kopii w S3. Strumień: gdy dysk serwera jest mały lub S3 jest jedynym miejscem na kopie zapasowe.
- Przywracanie z S3Zadanie przywracania czyta kopię zapasową przesłaną strumieniem bezpośrednio z bucketu: najnowszy obiekt lub wskazany przez ciebie. Agent sprawdza rozmiar i SHA-256 każdego obiektu.
- SzyfrowanieSzyfrowanie bucketu chroni obiekt po stronie przechowywania. Szyfrowanie archiwum w zadaniu chroni plik hasłem, zanim opuści serwer.
- BucketUtrzymuj zablokowany dostęp publiczny. Dodaj regułę, która usuwa niedokończone wysyłania wieloczęściowe po jednym dniu.
- Klucz tylko do kopii zapasowychUtwórz osobnego użytkownika. Przyznaj mu tylko potrzebne prawa: zapis, odczyt i usuwanie obiektów, przerywanie wysyłania i listowanie niedokończonych wysyłań bucketu. Jeśli bucket jest szyfrowany kluczem KMS, potrzebuje też praw do tego klucza. Na serwerze Amazon EC2 możesz pracować bez klucza: agent używa roli IAM serwera.
- SprawdzenieUruchom zadanie przyciskiem Uruchom teraz, sprawdź wynik i wykonaj testowe przywracanie, zanim zaufasz kopii zapasowej.
Częste błędy
| Błąd | Przyczyna | Co zrobić |
|---|---|---|
AccessDenied | Brakuje prawa lub ścieżka w prawach jest inna. | Sprawdź prawa użytkownika. |
SignatureDoesNotMatch | Zły klucz lub spacje w jego wartości. | Skopiuj klucz ponownie. |
PermanentRedirect | Region w ustawieniach nie zgadza się z regionem bucketu. | Popraw region. |
NoSuchBucket | Zła nazwa bucketu. | Popraw nazwę. |
RequestTimeTooSkewed | Zegar serwera jest nieprawidłowy. | Zsynchronizuj zegar z NTP. |
restore.replace_cycle
Backup-Restore-Replace
Cykl odbudowuje produkcyjną bazę danych. Agent tworzy kopię zapasową gbak, przywraca ją do nowego pliku i umieszcza nowy plik w miejscu starego. Nowa baza danych nie ma śmieci, jej indeksy są świeże i zwykle jest znacznie mniejsza. Produkcyjna baza danych jest bezpiecznie odłączana i zmieniana nazwa: agent najpierw przełącza ją w shutdown full, wszystkie połączenia się zamykają, i dopiero wtedy plik otrzymuje nową nazwę.
Domyślnie cykl uruchamia się w sobotę o 02:00; harmonogram można zmienić. Uruchom teraz rozpoczyna cykl natychmiast, ale najpierw prosi o wpisanie nazwy pliku bazy danych. Bazę danych można wskazać ścieżką lub aliasem z databases.conf.
Klienci
Pliki na dysku
Od zamknięcia do podmiany klienci otrzymują „database not found” lub „database shutdown”. Zaplanuj cykl na czas, gdy baza danych może być niedostępna przez czas trwania kopii zapasowej i przywracania. W trybie potoku kopia zapasowa i przywracanie przebiegają jednocześnie, a plik kopii zapasowej nie jest zapisywany.
Cykl nie rozpocznie się, jeśli
- opcja „Zezwól na podmianę” (allow_replace) nie jest włączona w zadaniu;
- baza danych jest w stanie shutdown, zaszyfrowana lub jest repliką;
- baza danych jest bazą zabezpieczeń — własną lub dla innych baz danych;
- obok niej znajdują się pliki niedokończonego cyklu;
- brakuje miejsca na dysku.
Miejsce jest obliczane z góry: plik kopii zapasowej i przywrócona kopia znajdują się na dysku jednocześnie, każdy o rozmiarze zbliżonym do rozmiaru bazy danych. Oryginał jest zmieniany nazwą, a nie kopiowany, więc nie zajmuje miejsca. Jeśli miejsca jest mało, cykl zatrzymuje się przed shutdown: baza danych pozostaje nietknięta, a klienci pracują dalej.
Co pozostaje na dysku
Oryginały. Ostatnie oryginały w stanie shutdown full są przechowywane obok bazy danych — od 1 do 10, domyślnie 1. Nadmiarowe są usuwane na początku następnego cyklu, więc baza danych w stanie sprzed ostatniego cyklu jest zawsze dostępna.
Plik kopii zapasowej jest usuwany po podmianie. Jeśli przywracanie się nie powiodło, plik jest zachowywany jako .restore-failed.fbk do analizy.
Aby wrócić do oryginału: zatrzymaj produkcyjną bazę danych, zmień nazwy plików i uruchom gfix -online dla oryginału.
Gdy cykl zostanie przerwany
Ktoś może zatrzymać agenta, serwer może zostać zrestartowany, może zabraknąć zasilania. Przy normalnym zatrzymaniu usługi przed podmianą agent pozwala gbak zakończyć pracę i wycofuje cykl. W razie awarii, przed każdym krokiem agent zapisuje wykonywaną czynność do pliku intencji. Przy starcie, a następnie co minutę, agent odczytuje te pliki i doprowadza cykl do znanego stanu.
Baza danych wraca do trybu online
Agent przywraca bazę danych do trybu online i przywraca opóźnienie shutdown.
Wycofanie
Kopia pośrednia i niekompletna kopia zapasowa są usuwane, oryginał odzyskuje starą nazwę i przechodzi do trybu online.
Dokończenie
Nowa baza danych pozostaje w produkcji, oryginał jest zachowany w stanie shutdown. Skrypt „po” nie został uruchomiony: uruchom go samodzielnie, jeśli jest to istotne.
Jeśli pliki na dysku nie odpowiadają żadnemu znanemu stanowi, agent niczego nie zmienia, a wynik zadania zaczyna się od „operator needed”. Plik intencji zawiera nazwy wszystkich plików cyklu. Umieść prawidłową bazę danych pod jej ścieżką, a agent samodzielnie dokończy odzyskiwanie.
Własne skrypty przed i po
Skrypt „przed kopią zapasową” uruchamia się przed shutdown. Jeśli zakończy się błędem, cykl zatrzymuje się, a baza danych pozostaje nietknięta. Skrypt „po przywróceniu” uruchamia się po podmianie. Przykład: skopiuj plik kopii zapasowej do archiwum, zanim agent go usunie.
| Zmienna | Przed kopią zapasową | Po przywróceniu |
|---|---|---|
FBAGENT_HOOK_PHASE | pre | post |
FBAGENT_JOB_ID | id zadania | |
FBAGENT_DB_NAME | nazwa w zadaniu: alias lub ścieżka | |
FBAGENT_DB_PATH | plik bazy danych: oryginał, online | ta sama ścieżka: nowa baza danych, online |
FBAGENT_ORIG_PATH | puste | ścieżka do oryginału |
FBAGENT_FBK_PATH | przyszły plik kopii zapasowej; puste w trybie potoku | plik kopii zapasowej, usuwany po skrypcie; puste w trybie potoku |
Inwentarz · raport kondycji
Kontrola: która baza danych nie ma kopii zapasowej
Inwentarz pokazuje wszystkie pliki kopii zapasowych na serwerze, także te utworzone przez inne programy. Agent aktualizuje go po każdej kopii zapasowej, a w pełni co 2 godziny. Obok znajduje się tabela przywracania: testowych i produkcyjnych, za 14 dni.
Każda kopia zapasowa ma kolumnę Zweryfikowana: przywracanie testowe powiodło się, nie powiodło się lub nie zostało uruchomione. Obok znajdują się rozmiar przywróconej bazy danych i czas gbak. Tabela przywracania pokazuje rozmiar bazy danych i czas trwania.
Raport kondycji serwera oznacza bazę danych bez zarejestrowanych kopii zapasowych i podaje przyczynę: zadanie nie powiodło się, wciąż trwa, zostało odroczone lub w folderach nie ma pliku. Przycisk obok znaleziska natychmiast otwiera formularz nowego zadania.