Backup di HQbird
Backup Firebird
gbak e nbackup pianificati, per un singolo database o per tutti i database di una cartella. Per gbak, puoi attivare un ripristino di prova dopo ogni backup. Un database viene aggiornato da un backup automaticamente, e nessun errore a metà lo lascia in uno stato sconosciuto.
- 6 tipi di job di backup
- nbackup livelli 0…4
- zip · gz · zstd con verifica dell'archivio
- S3 senza file intermedio
- ripristino di prova
Due strumenti
gbak o nbackup
HQbird supporta entrambi i tipi di backup di Firebird, e puoi usarli entrambi per un singolo database. gbak crea una copia logica: è più piccola del database, e un ripristino la verifica. nbackup copia le pagine del database: è veloce, e gli incrementi occupano poco spazio.
| gbak (backup verificato) | nbackup (incrementale) | |
|---|---|---|
| Cosa copia | Dati e metadati. I record obsoleti e le vecchie versioni dei record non finiscono nella copia. | Pagine del file del database. Il livello 0 è completo; i livelli 1…N contengono solo le pagine modificate. |
| Dimensione | Di solito molto più piccola del database; si comprime bene. | Il livello 0 ha la dimensione del database; gli incrementi sono piccoli. |
| Ripristino | Crea un nuovo database e ricostruisce gli indici. Per database grandi richiede molto tempo. | Unisce la catena dei livelli. Veloce. |
| Verifica | Ripristino di prova dopo ogni backup, se è attivo nel job. | Verifica della catena tramite GUID. Nessun livello 0 — l'agente lo crea subito. |
| Usalo per | Una copia affidabile, il passaggio tra versioni e server, Backup-Restore-Replace. | Punti di ripristino frequenti durante il giorno senza carico sul server. |
Se gbak e nbackup di un database devono partire nello stesso minuto, gbak viene spostato 15 minuti più tardi. Mentre nbackup usa il database, gbak attende (fino a 60 minuti per impostazione predefinita) e non fallisce.
Tipi di job
Job singoli e di gruppo
Un job singolo copre un database e ha le proprie impostazioni. Usalo per il database principale dell'azienda: la sua pianificazione, la sua cartella, la sua conservazione.
Un job di gruppo copre cartelle con database. Un unico insieme di impostazioni per tutti i database del gruppo. In ogni ciclo, l'agente analizza di nuovo le cartelle tramite maschere, così un nuovo database entra automaticamente nel backup, senza modificare le impostazioni.
| Un database | Tutti i database nelle cartelle | |
|---|---|---|
| gbak con verifica | vbackup | grpvbackup |
| nbackup con livelli | nbackup | grpnbackup |
| nbackup dump | nbackup_dump | grpnbackup_dump |
Cosa prende un job di gruppo e cosa salta
L'agente percorre le cartelle e controlla ogni file rispetto alle maschere di inclusione ed esclusione. Facoltativamente, controlla anche la dimensione minima e l'inizio del file. I file di backup (.fbk, .nbk, .delta, archivi) non finiscono mai nel backup.
Un database che ha un proprio job singolo è escluso automaticamente dal gruppo, anche se quel job è disattivato. Un gruppo gbak non prende i database dei job gbak singoli. Un gruppo nbackup non prende i database dei job nbackup e dump.
I database di sistema (nomi che iniziano con security ed examples) vengono sempre saltati. L'anteprima della scansione mostra il motivo di ogni esclusione.
D:\data\ · maschera *.fdb
- sales.fdbnel gruppo
- stock.fdbnel gruppo
- branch_new.fdb
nuovo database: parte dal livello 0nel gruppo - erp.fdb
ha un proprio job singolosalta - security5.fdb
database di sistemasalta - bck_sales_20261107.fbk
file di backupsalta - orders.fdb.delta
file delta di nbackupsalta
- Database rimosso dalla cartellaDiventa “orfano”. I suoi backup sono conservati secondo una regola: N giorni o sempre. Oppure vanno subito nella cartella
_orphanede vengono eliminati dopo 7 giorni. - Database rinominatoIl nuovo nome avvia una nuova catena dal livello 0. I vecchi backup sono conservati secondo la regola per i database orfani.
- Errori ripetutiDopo 5 errori consecutivi, il database viene messo in pausa per 6 ore e poi ritentato.
- Un errore in un database non ferma il gruppoIl gruppo continua con il database successivo. Questa è l'impostazione “Continua con i database successivi dopo un errore”; è attiva per impostazione predefinita per i gruppi gbak, nbackup, dump e sweep.
- Esito del gruppo nella riga del job“Trovati N database · riusciti M · errori X · tempo totale”. I dettagli contengono una tabella dei database con errore: nome, percorso e l'inizio del testo dell'errore.
- Budget di tempoUn ciclo non avvia nuovi database quando il tempo è scaduto. Per i gruppi nbackup, puoi attivare la continuazione dal database successivo nel ciclo seguente.
- ParallelismoQuanti database del gruppo elaborare contemporaneamente. Un limite comune per le attività lunghe sul server: per impostazione predefinita, non più di due in esecuzione contemporaneamente.
- Un'operazione per databaseI job singoli e di gruppo, gbak e nbackup vedono i lock reciproci.
- Albero delle cartelle come nella sorgenteLa casella “Ripeti l'albero delle cartelle di origine”: il backup del database
x/y/EMPLOYEE.FDBva in<backup folder>/x/y/EMPLOYEE.FDB/. I database con lo stesso nome da cartelle diverse non si ostacolano a vicenda.
vbackup · grpvbackup
gbak: backup con verifica
Prima di ogni passo, l'agente controlla lo spazio libero: per il backup, per il ripristino di prova, per l'archivio. Se non c'è spazio sufficiente per il ripristino, l'agente lo salta con il motivo no_space, e il backup resta. gbak scrive in un file temporaneo. Il file riceve il nome .fbk solo se la dimensione e il log di gbak sono corretti. Così un backup incompleto con un nome normale non appare mai nella cartella.
- 1Controllo spazioper il backup; di nuovo prima del ripristino e della compressione
- 2gbakin un file temporaneo
.gbaktmp; su Firebird 5 — su N core - 3Verificadimensione e log; poi il nome
.fbk - 4Ripristino di provase attivo; un file separato, non il database di produzione
- 5Compressionearchivio decompresso e confrontato tramite SHA-256
- 6✓ Archiviazionecopia in un'altra cartella; le vecchie copie vengono eliminate
- Nomi chiari
bck_sales_20261107_02-00.fbk: l'inizio del nome del database e l'ora. Due database in una cartella non scrivono gli stessi nomi. - Avviso di sovrapposizioneSe due job scrivono file con lo stesso inizio del nome in una cartella, l'agente e l'editor mostrano un avviso.
- Esito del ripristino di provaok, failed, skipped con un motivo, o not_run. Lo vedi nell'ultimo esito del job e nell'inventario. Nell'editor, ogni ripristino mostra entrambi i comandi: backup e ripristino.
- Vecchio database di provaUn nuovo job avvia il ripristino di prova con
-rep: gbak sovrascrive la copia dell'esecuzione precedente. Prima l'agente disconnette i client di questa copia. Se il percorso del database di prova è lo stesso del database di produzione o del database di un altro job, il ripristino viene saltato. - Log e comandi di gbakLe ultime righe di errore sono visibili nella console; puoi scaricare il log. I log vengono eliminati insieme al loro backup. L'agente conserva una cronologia dei comandi eseguiti: fino a 50 per ogni passo del job, con le password nascoste.
- Opzioni che interrompono il controllo
-Yinvia l'output di gbak a un file, ma l'agente controlla il backup tramite questo output. Quindi-Ynon è consentito. Un job in streaming non accetta-SEnemmeno nella riga di restore. L'editor segnala queste opzioni. - TimeoutSoft: un avviso. Hard: gbak viene fermato.
- Tempo di gbak per passoL'agente stesso aggiunge l'opzione
-ST TDRWa ogni backup e restore e ricava il tempo di gbak dall'output. Non serve un tuo-STnelle opzioni del job: l'editor non lo accetta. - L'agente imposta il loginLe opzioni
-user,-password,-fetch_passworde-trustednon sono consentite nelle opzioni. Il restore di test viene eseguito come proprietario del database, se il proprietario è registrato nelle impostazioni di accesso al database. La riga di restore mostra con quale nome utente è stato eseguito. - Messaggi chiariSpazio e tempo in unità familiari: “8.1 GiB liberi, 11.8 GiB necessari”, “timeout dopo 60 s”.
nbackup · grpnbackup
nbackup: livelli e punti di ripristino
Il livello 0 copia l'intero database. Il livello 1 copia le pagine modificate dopo l'ultimo livello 0. Il livello 2 copia le modifiche dopo l'ultimo livello 1. Per ripristinare il database al momento che ti serve bastano tre file.
Esempio di pianificazione: livello 0 una volta a settimana, livello 1 ogni notte, livello 2 quattro volte al giorno. Questo dà 36 punti di ripristino a settimana: 1 + 7 + 28. Mantiene 5 copie del livello 0, 7 del livello 1 e 24 del livello 2.
- Catena senza interruzioniNessun livello 0 — l'agente lo crea subito. Per gli altri livelli, questa è l'impostazione “Crea subito i livelli inferiori mancanti”. Senza di essa, l'esecuzione viene saltata finché manca il livello inferiore.
- Controllo tramite GUIDOgni livello è legato al suo livello inferiore; un file estraneo non entra nella catena.
- Tre modalità di pianificazioneSemplice — per giorni e ore. Avanzata — cron per ogni livello, fino al livello 4. Piano — regole con livello, giorni e ora.
- nbackup dumpUna copia completa del file del database al di fuori della catena dei livelli, con una pianificazione propria.
- Database in stato deltaSe il database resta bloccato dopo un nbackup interrotto, l'agente prova a unire il delta.
Modalità Piano
Un piano è un insieme di regole: livello, giorni e ora. I giorni possono essere ogni giorno, giorni della settimana o giorni del mese. Se due regole coincidono nello stesso minuto, viene eseguito il livello inferiore. Il piano può creare da solo un livello 0 quando l'ultimo livello 0 è più vecchio di un numero di giorni impostato. Esegue un livello inferiore prima del previsto quando gli incrementi superano una quota impostata della dimensione del database. In un job di gruppo, ogni database costruisce la propria catena di livelli.
L'editor mostra il piano in un calendario con diverse settimane di anticipo: quale livello viene eseguito e quando. Un pulsante converte una pianificazione semplice o avanzata in un piano, e puoi annullare questa operazione prima di salvare.
- Conservazione per cicliUn ciclo è un livello 0 con tutti i suoi incrementi. L'agente conserva o elimina un intero ciclo: per numero di cicli, per giorni o per dimensione totale. Il ciclo completo più recente non viene mai eliminato. L'editor mostra in anticipo quanto spazio occuperanno i backup.
- Stato del pianoL'ultima copia di ogni livello, lo spazio utilizzato e cosa eliminerà la prossima pulizia. L'agente aggiorna lo stato dopo ogni esecuzione del piano.
Compressione · S3 · archiviazione
Dove vengono archiviati i backup
Un backup può andare direttamente su S3: gbak o nbackup scrive in uno stream, e lo stream va nel bucket. Non c'è un file intermedio sul disco del server, quindi non serve spazio per il backup sul server.
La compressione zip, gz o zstd funziona sia per i backup locali sia per quelli in streaming. Per un backup locale, l'agente decomprime l'archivio finito e lo confronta con la sorgente per dimensione e SHA-256. Solo dopo il file sorgente viene eliminato. Se il controllo fallisce, non viene eliminato nulla.
- Conservazione per numerogbak: quanti file conservare. nbackup: quante copie di ogni livello.
- Copie in altri luoghiUna copia in una seconda cartella o in un percorso di rete. Upload su S3, FTP o FTPS — con un job file_sync separato.
- Il tuo script dopo il backupPer gbak. Riceve i percorsi del backup, del database di test e dei log di gbak.
- Crittografia dell'archivioUn job gbak può crittografare l'archivio zip (AES-256) con una password dalle chiavi dell'agente, su disco e nello stream S3. 7-Zip apre l'archivio. Un restore trova da solo la chiave corretta.
- Restore da un archivioIl formato viene rilevato dal contenuto del file, in locale e da S3.
- Restore da S3Un job di restore legge il backup direttamente dal bucket.
- AntivirusEscludi le cartelle di backup e restore dalla scansione in tempo reale.
- Scegli tu la compressioneUn nuovo job viene creato senza compressione. zstd è il primo nell'elenco dei formati. Puoi impostare la tua estensione di file per un archivio di qualsiasi formato.
- Guida ad Amazon S3Configurazione passo passo del bucket, delle chiavi e del job. Disponibile in inglese e portoghese.
Amazon S3 · archiviazione compatibile
Backup su S3
L'agente invia i backup a un bucket in Amazon S3 o in un'archiviazione compatibile. Funziona per i job gbak e nbackup. Non serve un altro programma per questo.
La configurazione ha tre parti: preparare un bucket e una chiave di accesso, creare un target s3 nelle impostazioni dell'agente, attivare l'upload nel job di backup. Ogni job usa una di due modalità.
| Copia su file | Stream su S3 | |
|---|---|---|
| File sul disco del server | Sì. Il backup viene scritto su disco, poi inviato. | No. Il backup va direttamente nel bucket. |
| Spazio su disco per il backup | Necessario. | Non necessario. |
| Destinazione | S3, FTP, FTPS | Solo S3 |
| Eliminazione delle vecchie copie nel bucket | No. Usa una regola di lifecycle del bucket. | Sì, secondo la regola di conservazione del job. |
| Errore di upload | Il backup locale resta valido. | Nessun backup: nessun oggetto resta nel bucket. |
- Come scegliereCopia su file: quando ti servono sia una copia locale sia una copia su S3. Stream: quando il disco del server è piccolo o S3 è l'unico posto per i backup.
- Restore da S3Un job di restore legge un backup in streaming direttamente dal bucket: l'oggetto più recente o quello che indichi. L'agente controlla dimensione e SHA-256 di ogni oggetto.
- CrittografiaLa crittografia del bucket protegge l'oggetto sul lato dell'archiviazione. La crittografia dell'archivio nel job protegge il file con una password prima che lasci il server.
- BucketMantieni bloccato l'accesso pubblico. Aggiungi una regola che elimina gli upload multipart non completati dopo un giorno.
- Una chiave solo per i backupCrea un utente separato. Concedigli solo i diritti necessari: scrivere, leggere ed eliminare oggetti, interrompere un upload ed elencare gli upload non completati del bucket. Se il bucket è crittografato con una chiave KMS, servono anche i diritti su questa chiave. Su un server Amazon EC2 puoi lavorare senza chiave: l'agente usa il ruolo IAM del server.
- ControlloAvvia il job con il pulsante Esegui ora, guarda il risultato e fai un restore di test prima di affidarti al backup.
Errori comuni
| Errore | Causa | Cosa fare |
|---|---|---|
AccessDenied | Manca un diritto, oppure il percorso nei diritti è diverso. | Controlla i diritti dell'utente. |
SignatureDoesNotMatch | Chiave errata, o spazi nel suo valore. | Copia di nuovo la chiave. |
PermanentRedirect | La regione nelle impostazioni non corrisponde alla regione del bucket. | Correggi la regione. |
NoSuchBucket | Nome del bucket errato. | Correggi il nome. |
RequestTimeTooSkewed | L'orologio del server è errato. | Sincronizza l'orologio con NTP. |
restore.replace_cycle
Backup-Restore-Replace
Il ciclo ricostruisce il database di produzione. L'agente esegue un backup gbak, lo ripristina in un nuovo file e mette il nuovo file al posto del vecchio. Il nuovo database non ha garbage, i suoi indici sono nuovi e di solito è molto più piccolo. Il database di produzione viene disconnesso e rinominato in modo sicuro: l'agente lo mette prima in shutdown full, tutte le connessioni si chiudono, e solo allora il file riceve un nuovo nome.
Per impostazione predefinita, il ciclo viene eseguito il sabato alle 02:00; è possibile modificare la pianificazione. Esegui ora avvia subito il ciclo, ma prima chiede di digitare il nome del file del database. Il database può essere impostato tramite un percorso o tramite un alias da databases.conf.
Client
File su disco
Dallo shutdown alla sostituzione, i client ricevono “database not found” o “database shutdown”. Pianifica il ciclo in un momento in cui il database può essere non disponibile per un backup più un ripristino. In modalità pipe, il backup e il ripristino vengono eseguiti contemporaneamente e non viene scritto alcun file di backup.
Il ciclo non si avvia se
- “Consenti sostituzione” (allow_replace) non è attivo nel job;
- il database è in shutdown, cifrato o è una replica;
- il database è un security DB, proprio o per altri database;
- accanto ad esso ci sono file di un ciclo non completato;
- non c'è spazio su disco sufficiente.
Lo spazio viene calcolato in anticipo: il file di backup e la copia ripristinata sono sul disco contemporaneamente, ciascuno all'incirca della dimensione del database. L'originale viene rinominato, non copiato, quindi non occupa spazio. Se lo spazio è insufficiente, il ciclo si ferma prima dello shutdown: il database non viene toccato e i client continuano a lavorare.
Cosa rimane sul disco
Gli originali. Gli ultimi originali in shutdown full vengono conservati accanto al database, da 1 a 10, 1 per impostazione predefinita. Quelli in eccesso vengono eliminati all'inizio del ciclo successivo, così il database nello stato precedente all'ultimo ciclo è sempre presente.
Il file di backup viene eliminato dopo la sostituzione. Se il ripristino non è riuscito, il file viene conservato come .restore-failed.fbk per l'analisi.
Per tornare all'originale: ferma il database di produzione, rinomina i file ed esegui gfix -online per l'originale.
Quando il ciclo viene interrotto
Qualcuno può fermare l'agente, il server può riavviarsi, può mancare la corrente. In un normale arresto del servizio prima della sostituzione, l'agente lascia che gbak termini e annulla il ciclo. In caso di guasto, prima di ogni passaggio l'agente scrive ciò che fa in un file di intent. All'avvio e poi ogni minuto, l'agente legge questi file e porta il ciclo a uno stato noto.
Il database torna online
L'agente riporta il database online e ripristina il ritardo di shutdown.
Rollback
La copia intermedia e il backup incompleto vengono eliminati, l'originale riprende il suo vecchio nome e torna online.
Completamento
Il nuovo database rimane in produzione, l'originale viene conservato in shutdown. Lo script “after” non è stato eseguito: eseguilo tu stesso se è importante.
Se i file sul disco non corrispondono a nessuno stato noto, l'agente non modifica nulla e l'esito del job inizia con “operator needed”. Il file di intent elenca i nomi di tutti i file del ciclo. Metti il database corretto al suo percorso e l'agente completa il recupero da solo.
I tuoi script prima e dopo
Lo script “prima del backup” viene eseguito prima dello shutdown. Se termina con un errore, il ciclo si ferma e il database non viene toccato. Lo script “dopo il ripristino” viene eseguito dopo la sostituzione. Esempio: copia il file di backup in un archivio prima che l'agente lo elimini.
| Variabile | Prima del backup | Dopo il ripristino |
|---|---|---|
FBAGENT_HOOK_PHASE | pre | post |
FBAGENT_JOB_ID | id del job | |
FBAGENT_DB_NAME | nome nel job: alias o percorso | |
FBAGENT_DB_PATH | file del database: originale, online | stesso percorso: nuovo database, online |
FBAGENT_ORIG_PATH | vuoto | percorso dell'originale |
FBAGENT_FBK_PATH | file di backup futuro; vuoto in modalità pipe | file di backup, eliminato dopo lo script; vuoto in modalità pipe |
Inventario · report di integrità
Controllo: quale database non ha backup
L'inventario mostra tutti i file di backup sul server, anche quelli creati da altri programmi. L'agente lo aggiorna dopo ogni backup e completamente ogni 2 ore. Accanto c'è una tabella dei ripristini: di test e di produzione, per 14 giorni.
Ogni backup ha una colonna Verificato: il ripristino di test è riuscito, fallito o non è stato eseguito. Accanto ci sono la dimensione del database ripristinato e il tempo di gbak. La tabella dei ripristini mostra la dimensione del database e la durata.
Il report di integrità del server segnala un database senza backup registrati e ne indica il motivo: il job è fallito, è ancora in esecuzione, è posticipato, oppure non c'è alcun file nelle cartelle. Un pulsante accanto alla segnalazione apre subito il modulo per un nuovo job.