HQbird-back-ups
Back-ups Firebird
Geplande gbak en nbackup, voor één database of voor alle databases in een map. Voor gbak kunt u na elke back-up een testrestore inschakelen. Een database wordt automatisch bijgewerkt vanuit een back-up, en een storing halverwege laat hem nooit in een onbekende staat achter.
- 6 soorten back-uptaken
- nbackup niveaus 0…4
- zip · gz · zstd met archiefcontrole
- S3 zonder tussenliggend bestand
- testrestore
Twee hulpmiddelen
gbak of nbackup
HQbird ondersteunt beide Firebird-back-uptypes, en u kunt beide voor één database gebruiken. gbak maakt een logische kopie: die is kleiner dan de database, en een restore controleert hem. nbackup kopieert databasepagina's: het is snel, en incrementals nemen weinig ruimte in beslag.
| gbak (geverifieerde back-up) | nbackup (incrementeel) | |
|---|---|---|
| Wat het kopieert | Gegevens en metadata. Afval en oude recordversies komen niet in de kopie terecht. | Pagina's van het databasebestand. Niveau 0 is volledig; niveaus 1…N bevatten alleen gewijzigde pagina's. |
| Grootte | Meestal veel kleiner dan de database; comprimeert goed. | Niveau 0 is de grootte van de database; incrementals zijn klein. |
| Restore | Maakt een nieuwe database aan en bouwt de indexen opnieuw op. Voor grote databases duurt dit lang. | Voegt de keten van niveaus samen. Snel. |
| Controle | Testrestore na elke back-up, als dat in de taak is ingeschakeld. | Ketencontrole via GUID. Geen niveau 0 — de agent maakt het direct aan. |
| Gebruik het voor | Een betrouwbare kopie, verplaatsen tussen versies en servers, Backup-Restore-Replace. | Frequente herstelpunten gedurende de dag zonder belasting van de server. |
Als gbak en nbackup van één database in dezelfde minuut moeten starten, verschuift gbak 15 minuten later. Terwijl nbackup de database gebruikt, wacht gbak (standaard tot 60 minuten) en faalt niet.
Soorten taken
Individuele en groepstaken
Een individuele taak dekt één database en heeft eigen instellingen. Gebruik deze voor de hoofd-database van het bedrijf: een eigen schema, een eigen map, een eigen retentie.
Een groepstaak dekt mappen met databases. Eén set instellingen voor alle databases van de groep. In elke cyclus scant de agent de mappen opnieuw op maskers, zodat een nieuwe database automatisch in de back-up terechtkomt, zonder wijziging van de instellingen.
| Eén database | Alle databases in mappen | |
|---|---|---|
| gbak met controle | vbackup | grpvbackup |
| nbackup met niveaus | nbackup | grpnbackup |
| nbackup-dump | nbackup_dump | grpnbackup_dump |
Wat een groepstaak meeneemt en wat hij overslaat
De agent doorloopt de mappen en controleert elk bestand tegen include- en exclude-maskers. Optioneel controleert hij ook de minimale grootte en het begin van het bestand. Back-upbestanden (.fbk, .nbk, .delta, archieven) komen nooit in de back-up terecht.
Een database met een eigen individuele taak wordt automatisch uitgesloten van de groep, zelfs als die taak uit staat. Een gbak-groep neemt geen databases van individuele gbak-taken op. Een nbackup-groep neemt geen databases van nbackup- en dump-taken op.
Systeemdatabases (namen die beginnen met security en examples) worden altijd overgeslagen. De scanpreview toont de reden voor elke overslag.
D:\data\ · masker *.fdb
- sales.fdbin groep
- stock.fdbin groep
- branch_new.fdb
nieuwe database: begint met niveau 0in groep - erp.fdb
heeft een eigen individuele taakoverslaan - security5.fdb
systeemdatabaseoverslaan - bck_sales_20261107.fbk
back-upbestandoverslaan - orders.fdb.delta
nbackup-deltabestandoverslaan
- Database verwijderd uit de mapDeze wordt “verweesd”. De back-ups worden bewaard volgens een regel: N dagen of altijd. Of ze gaan direct naar de map
_orphaneden worden na 7 dagen verwijderd. - Database hernoemdDe nieuwe naam begint een nieuwe keten vanaf niveau 0. Oude back-ups worden bewaard volgens de regel voor verweesde databases.
- Herhaalde foutenNa 5 fouten op rij wordt de database 6 uur gepauzeerd en daarna opnieuw geprobeerd.
- Een fout in één database stopt de groep nietDe groep gaat verder met de volgende database. Dit is de instelling “Doorgaan met de volgende databases na een fout”; deze staat standaard aan voor gbak-, nbackup-, dump- en sweep-groepen.
- Groepsresultaat in de taakrij“N databases gevonden · M geslaagd · X fouten · totale tijd”. De details bevatten een tabel met databases met een fout: naam, pad en het begin van de fouttekst.
- TijdsbudgetEen cyclus start geen nieuwe databases meer wanneer de tijd om is. Voor nbackup-groepen kunt u doorgaan vanaf de volgende database in de volgende cyclus inschakelen.
- ParallelismeHoeveel databases van de groep tegelijkertijd worden verwerkt. Een algemene limiet voor langdurige taken op de server: standaard worden er niet meer dan twee tegelijk uitgevoerd.
- Eén bewerking per databaseIndividuele en groepstaken, gbak en nbackup zien elkaars locks.
- Mapstructuur zoals in de bronHet selectievakje “De bronmapstructuur herhalen”: de back-up van de database
x/y/EMPLOYEE.FDBgaat naar<back-upmap>/x/y/EMPLOYEE.FDB/. Databases met dezelfde naam uit verschillende mappen staan elkaar niet in de weg.
vbackup · grpvbackup
gbak: back-up met controle
Voor elke stap controleert de agent de vrije ruimte: voor de back-up, voor de testrestore, voor het archief. Als er niet genoeg ruimte is voor de restore, slaat de agent deze over met de reden no_space, en de back-up blijft behouden. gbak schrijft naar een tijdelijk bestand. Het bestand krijgt pas de naam .fbk als de grootte en het gbak-logboek correct zijn. Zo verschijnt er nooit een onvolledige back-up met een normale naam in de map.
- 1Ruimtecontrolevoor de back-up; opnieuw voor restore en compressie
- 2gbaknaar een tijdelijk
.gbaktmp; op Firebird 5 — op N cores - 3Controlegrootte en logboek; daarna de naam
.fbk - 4Testrestoreindien aan; een apart bestand, niet de productiedatabase
- 5Compressiearchief uitgepakt en vergeleken via SHA-256
- 6✓ Opslagkopiëren naar een andere map; oude kopieën worden verwijderd
- Duidelijke namen
bck_sales_20261107_02-00.fbk: het begin van de databasenaam en de tijd. Twee databases in één map schrijven niet dezelfde namen. - Waarschuwing bij overlapAls twee taken bestanden met dezelfde naamstart naar één map schrijven, tonen de agent en de editor een waarschuwing.
- Resultaat van de testrestoreok, mislukt, overgeslagen met een reden, of not_run. U ziet het in het laatste taakresultaat en in de inventaris. In de editor toont elke restore beide opdrachten: back-up en restore.
- Oude testdatabaseEen nieuwe taak start de testrestore met
-rep: gbak overschrijft de kopie van de vorige uitvoering. De agent verbreekt eerst de verbindingen van de clients van deze kopie. Als het pad van de testdatabase hetzelfde is als de productiedatabase of de database van een andere taak, wordt de restore overgeslagen. - gbak-logs en -opdrachtenDe laatste foutregels zijn zichtbaar in de console; u kunt het log downloaden. Logs worden samen met hun back-up verwijderd. De agent houdt een geschiedenis bij van uitgevoerde opdrachten: tot 50 per taakstap, wachtwoorden verborgen.
- Switches die de controle breken
-Ystuurt de gbak-uitvoer naar een bestand, maar de agent controleert de back-up aan de hand van deze uitvoer. Daarom is-Yniet toegestaan. Een streaming-taak accepteert ook geen-SEin de restore-regel. De editor markeert deze switches. - Time-outsZacht: een waarschuwing. Hard: gbak wordt gestopt.
- gbak-tijd per stapDe agent voegt zelf de switch
-ST TDRWtoe aan elke back-up en restore en haalt de gbak-tijd uit de uitvoer. U hebt geen eigen-STnodig in de taakopties: de editor accepteert die niet. - De agent stelt de login inDe switches
-user,-password,-fetch_passworden-trustedzijn niet toegestaan in de opties. De testrestore wordt uitgevoerd als de database-eigenaar, als de eigenaar is vastgelegd in de instellingen voor databasetoegang. De restore-regel toont onder welke gebruikersnaam deze is uitgevoerd. - Duidelijke meldingenRuimte en tijd in bekende eenheden: “8.1 GiB vrij, 11.8 GiB nodig”, “time-out na 60 s”.
nbackup · grpnbackup
nbackup: niveaus en herstelpunten
Niveau 0 kopieert de hele database. Niveau 1 kopieert pagina's die zijn gewijzigd na het laatste niveau 0. Niveau 2 kopieert wijzigingen na het laatste niveau 1. Om de database naar het gewenste moment te herstellen, zijn drie bestanden genoeg.
Voorbeeldschema: niveau 0 één keer per week, niveau 1 elke nacht, niveau 2 vier keer per dag. Dit geeft 36 herstelpunten per week: 1 + 7 + 28. Er worden 5 kopieën van niveau 0, 7 van niveau 1 en 24 van niveau 2 bewaard.
- Keten zonder gatenGeen niveau 0 — de agent maakt het meteen aan. Voor andere niveaus is dit de instelling “Ontbrekende lagere niveaus onmiddellijk aanmaken”. Zonder deze instelling wordt de uitvoering overgeslagen zolang het lagere niveau ontbreekt.
- Controle via GUIDElk niveau is gebonden aan zijn lagere niveau; een vreemd bestand komt niet in de keten terecht.
- Drie schemamodiEenvoudig — op dagen en uren. Geavanceerd — cron voor elk niveau, tot niveau 4. Plan — regels met een niveau, dagen en tijd.
- nbackup-dumpEen volledige kopie van het databasebestand buiten de niveauketen, volgens een eigen schema.
- Database in delta-statusAls de database vergrendeld blijft na een onderbroken nbackup, probeert de agent de delta samen te voegen.
Planmodus
Een plan is een set regels: niveau, dagen en tijd. Dagen kunnen elke dag, dagen van de week of dagen van de maand zijn. Als twee regels in dezelfde minuut overeenkomen, wordt het lagere niveau uitgevoerd. Het plan kan zelf een niveau 0 aanmaken wanneer het laatste niveau 0 ouder is dan een ingesteld aantal dagen. Het voert een lager niveau eerder uit dan gepland wanneer de incrementen groeien boven een ingesteld aandeel van de databasegrootte. In een groepstaak bouwt elke database zijn eigen niveauketen op.
De editor toont het plan in een kalender voor meerdere weken vooruit: welk niveau wanneer wordt uitgevoerd. Met één knop converteert u een eenvoudig of geavanceerd schema naar een plan, en u kunt dit ongedaan maken voordat u opslaat.
- Bewaring per cycliEen cyclus is een niveau 0 met al zijn incrementen. De agent bewaart of verwijdert een hele cyclus: op basis van het aantal cycli, dagen of totale grootte. De nieuwste volledige cyclus wordt nooit verwijderd. De editor toont vooraf hoeveel ruimte de back-ups innemen.
- PlanstatusDe laatste kopie van elk niveau, de gebruikte ruimte en wat de volgende opschoning zal verwijderen. De agent werkt de status bij na elke planuitvoering.
Compressie · S3 · opslag
Waar back-ups worden opgeslagen
Een back-up kan rechtstreeks naar S3 gaan: gbak of nbackup schrijft naar een stream, en de stream gaat naar de bucket. Er is geen tussenliggend bestand op de serverdisk, dus u hebt geen ruimte nodig voor de back-up op de server.
zip-, gz- of zstd-compressie werkt voor zowel lokale als streaming back-ups. Voor een lokale back-up pakt de agent het voltooide archief uit en vergelijkt het met de bron op grootte en SHA-256. Pas daarna wordt het bronbestand verwijderd. Als de controle mislukt, wordt niets verwijderd.
- Bewaring op aantalgbak: hoeveel bestanden te bewaren. nbackup: hoeveel kopieën van elk niveau.
- Kopieën naar andere locatiesEen kopie naar een tweede map of een netwerkpad. Upload naar S3, FTP of FTPS — met een aparte file_sync-taak.
- Uw eigen script na de back-upVoor gbak. Het krijgt de paden naar de back-up, de testdatabase en de gbak-logs.
- ArchiefversleutelingEen gbak-taak kan het zip-archief versleutelen (AES-256) met een wachtwoord uit de agentsleutels, op schijf en in de S3-stream. 7-Zip opent het archief. Een restore vindt zelf de juiste sleutel.
- Restore uit een archiefHet formaat wordt bepaald aan de hand van de bestandsinhoud, lokaal en vanuit S3.
- Restore vanuit S3Een restore-taak leest de back-up rechtstreeks uit de bucket.
- AntivirusSluit de back-up- en restore-mappen uit van realtime-scans.
- U kiest de compressieEen nieuwe taak wordt aangemaakt zonder compressie. zstd staat bovenaan de lijst met formaten. U kunt een eigen bestandsextensie instellen voor een archief van elk formaat.
- Amazon S3-handleidingStapsgewijze configuratie van de bucket, de sleutels en de taak. Beschikbaar in het Engels en Portugees.
Amazon S3 · compatibele opslag
Back-ups naar S3
De agent stuurt back-ups naar een bucket in Amazon S3 of in compatibele opslag. Dit werkt voor gbak- en nbackup-taken. U hebt hiervoor geen ander programma nodig.
De configuratie bestaat uit drie delen: een bucket en een toegangssleutel voorbereiden, een s3-doel aanmaken in de agentinstellingen, upload inschakelen in de back-uptaak. Elke taak gebruikt een van twee modi.
| Bestandskopie | Stream naar S3 | |
|---|---|---|
| Bestand op de serverdisk | Ja. De back-up wordt naar schijf geschreven en vervolgens verzonden. | Nee. De back-up gaat rechtstreeks naar de bucket. |
| Schijfruimte voor de back-up | Nodig. | Niet nodig. |
| Naar waar | S3, FTP, FTPS | Alleen S3 |
| Verwijdering van oude kopieën in de bucket | Nee. Gebruik een lifecycle-regel voor de bucket. | Ja, volgens de bewaringsregel van de taak. |
| Uploadfout | De lokale back-up blijft geldig. | Geen back-up: er blijft geen object in de bucket achter. |
- Hoe te kiezenBestandskopie: wanneer u zowel een lokale kopie als een kopie in S3 nodig hebt. Stream: wanneer de serverdisk klein is of S3 de enige plek voor back-ups is.
- Restore vanuit S3Een restore-taak leest een gestreamde back-up rechtstreeks uit de bucket: het nieuwste object of het object dat u opgeeft. De agent controleert de grootte en SHA-256 van elk object.
- VersleutelingBucketversleuteling beschermt het object aan de opslagzijde. Archiefversleuteling in de taak beschermt het bestand met een wachtwoord voordat het de server verlaat.
- BucketHoud openbare toegang geblokkeerd. Voeg een regel toe die onvoltooide multipart-uploads na één dag verwijdert.
- Een sleutel alleen voor back-upsMaak een aparte gebruiker aan. Geef deze alleen de rechten die nodig zijn: objecten schrijven, lezen en verwijderen, een upload afbreken en de onvoltooide uploads van de bucket opvragen. Als de bucket is versleuteld met een KMS-sleutel, zijn ook rechten op deze sleutel nodig. Op een Amazon EC2-server kunt u zonder sleutel werken: de agent gebruikt de IAM-rol van de server.
- ControleStart de taak met de knop Nu uitvoeren, bekijk het resultaat en doe een testrestore voordat u op de back-up vertrouwt.
Veelvoorkomende fouten
| Fout | Oorzaak | Wat te doen |
|---|---|---|
AccessDenied | Een recht ontbreekt, of het pad in de rechten is anders. | Controleer de gebruikersrechten. |
SignatureDoesNotMatch | Verkeerde sleutel, of spaties in de waarde. | Kopieer de sleutel opnieuw. |
PermanentRedirect | De regio in de instellingen komt niet overeen met de bucketregio. | Corrigeer de regio. |
NoSuchBucket | Verkeerde bucketnaam. | Corrigeer de naam. |
RequestTimeTooSkewed | De serverklok is onjuist. | Synchroniseer de klok met NTP. |
restore.replace_cycle
Backup-Restore-Replace
De cyclus bouwt de productiedatabase opnieuw op. De agent maakt een gbak-back-up, herstelt deze naar een nieuw bestand en plaatst het nieuwe bestand in de plaats van het oude. De nieuwe database bevat geen garbage, de indexen zijn vers en hij is meestal veel kleiner. De productiedatabase wordt veilig losgekoppeld en hernoemd: de agent zet deze eerst in shutdown full, alle verbindingen worden gesloten en pas dan krijgt het bestand een nieuwe naam.
Standaard draait de cyclus op zaterdag om 02:00; je kunt het schema wijzigen. Nu uitvoeren start de cyclus onmiddellijk, maar vraagt je eerst de bestandsnaam van de database te typen. De database kan worden ingesteld via een pad of via een alias uit databases.conf.
Clients
Bestanden op schijf
Vanaf het afsluiten tot het vervangen krijgen clients “database not found” of “database shutdown”. Plan de cyclus op een moment waarop de database onbeschikbaar mag zijn voor een back-up plus een herstel. In pipe-modus lopen de back-up en het herstel tegelijkertijd en wordt er geen back-upbestand geschreven.
De cyclus start niet als
- “Allow replace” (allow_replace) niet aan staat in de job;
- de database in shutdown is, versleuteld is of een replica is;
- de database een security-DB is, van zichzelf of voor andere databases;
- bestanden van een onvoltooide cyclus ernaast staan;
- er niet genoeg schijfruimte is.
Ruimte wordt vooraf berekend: het back-upbestand en de herstelde kopie staan tegelijkertijd op schijf, elk ongeveer zo groot als de database. Het origineel wordt hernoemd, niet gekopieerd, dus het neemt geen ruimte in. Als de ruimte krap is, stopt de cyclus vóór het afsluiten: de database wordt niet aangeraakt en clients blijven werken.
Wat op schijf blijft
Originelen. De laatste originelen in shutdown full worden naast de database bewaard, van 1 tot 10, standaard 1. Extra exemplaren worden aan het begin van de volgende cyclus verwijderd, zodat de database in de staat van vóór de laatste cyclus altijd aanwezig is.
Het back-upbestand wordt na het vervangen verwijderd. Als het herstel is mislukt, wordt het bestand bewaard als .restore-failed.fbk voor analyse.
Om terug te gaan naar het origineel: stop de productiedatabase, hernoem de bestanden en voer gfix -online uit voor het origineel.
Wanneer de cyclus wordt onderbroken
Iemand kan de agent stoppen, de server kan opnieuw opstarten, de stroom kan uitvallen. Bij een normale service-stop vóór het vervangen laat de agent gbak voltooien en draait de cyclus terug. Voor het geval van een storing schrijft de agent vóór elke stap wat hij doet naar een intent-bestand. Bij het starten en daarna elke minuut leest de agent deze bestanden en brengt de cyclus naar een bekende staat.
De database komt weer online
De agent zet de database online en herstelt de shutdown-vertraging.
Rollback
De tussentijdse kopie en de onvolledige back-up worden verwijderd, het origineel krijgt zijn oude naam terug en gaat online.
Voltooiing
De nieuwe database blijft in productie, het origineel wordt in shutdown bewaard. Het “after”-script is niet uitgevoerd: voer het zelf uit als het belangrijk is.
Als de bestanden op schijf niet overeenkomen met een bekende staat, wijzigt de agent niets en begint de uitkomst van de job met “operator needed”. Het intent-bestand vermeldt de namen van alle cyclusbestanden. Zet de juiste database op zijn pad, en de agent voltooit het herstel zelf.
Je eigen scripts vóór en na
Het “before backup”-script wordt uitgevoerd vóór het afsluiten. Als het eindigt met een fout, stopt de cyclus en wordt de database niet aangeraakt. Het “after restore”-script wordt uitgevoerd na het vervangen. Voorbeeld: kopieer het back-upbestand naar een archief voordat de agent het verwijdert.
| Variabele | Vóór back-up | Na herstel |
|---|---|---|
FBAGENT_HOOK_PHASE | pre | post |
FBAGENT_JOB_ID | job-id | |
FBAGENT_DB_NAME | naam in de job: alias of pad | |
FBAGENT_DB_PATH | databasebestand: origineel, online | zelfde pad: nieuwe database, online |
FBAGENT_ORIG_PATH | leeg | pad naar het origineel |
FBAGENT_FBK_PATH | toekomstig back-upbestand; leeg in pipe-modus | back-upbestand, verwijderd na het script; leeg in pipe-modus |
Inventaris · gezondheidsrapport
Controle: welke database heeft geen back-up
De inventaris toont alle back-upbestanden op de server, ook die van andere programma's. De agent werkt deze bij na elke back-up en volledig elke 2 uur. Daarnaast staat een tabel met herstellingen: test en productie, voor 14 dagen.
Elke back-up heeft een kolom Verified: het testherstel is geslaagd, mislukt of niet uitgevoerd. Daarnaast staan de grootte van de herstelde database en de gbak-tijd. De hersteltabel toont de databasegrootte en de duur.
Het gezondheidsrapport van de server markeert een database zonder geregistreerde back-ups en vermeldt waarom: de job is mislukt, draait nog, is uitgesteld, of er is geen bestand in de mappen. Een knop naast de bevinding opent direct het formulier voor een nieuwe job.