Cette page a été traduite automatiquement. Lisez l'original en anglais. English

Sauvegardes Firebird

gbak et nbackup planifiés, pour une base de données ou pour toutes les bases d'un dossier. Pour gbak, vous pouvez activer une restauration de test après chaque sauvegarde. Une base de données est mise à jour à partir d'une sauvegarde automatiquement, et aucune défaillance en cours de route ne la laisse dans un état inconnu.

  • 6 types de tâches de sauvegarde
  • nbackup niveaux 0…4
  • zip · gz · zstd avec vérification de l'archive
  • S3 sans fichier intermédiaire
  • test de restauration

Deux outils

gbak ou nbackup

HQbird prend en charge les deux types de sauvegarde Firebird, et vous pouvez utiliser les deux pour une même base de données. gbak effectue une copie logique : elle est plus petite que la base de données, et une restauration la vérifie. nbackup copie les pages de la base de données : c'est rapide, et les incréments prennent peu de place.

gbak (sauvegarde vérifiée)nbackup (incrémentale)
Ce qu'il copieDonnées et métadonnées. Les déchets et les anciennes versions d'enregistrements n'entrent pas dans la copie.Pages du fichier de base de données. Le niveau 0 est complet ; les niveaux 1…N ne contiennent que les pages modifiées.
TailleGénéralement bien plus petite que la base de données ; se compresse bien.Le niveau 0 correspond à la taille de la base de données ; les incréments sont petits.
RestaurationCrée une nouvelle base de données et reconstruit les index. Pour les grandes bases de données, cela prend beaucoup de temps.Fusionne la chaîne des niveaux. Rapide.
VérificationRestauration de test après chaque sauvegarde, si elle est activée dans la tâche.Vérification de la chaîne par GUID. Pas de niveau 0 — l'agent le crée immédiatement.
À utiliser pourUne copie fiable, le passage entre versions et serveurs, Backup-Restore-Replace.Des points de restauration fréquents pendant la journée sans charge sur le serveur.

Si gbak et nbackup d'une même base de données doivent démarrer à la même minute, gbak est décalé de 15 minutes plus tard. Pendant que nbackup utilise la base de données, gbak attend (jusqu'à 60 minutes par défaut) et n'échoue pas.

Types de tâches

Tâches individuelles et de groupe

Une tâche individuelle couvre une base de données et possède ses propres paramètres. Utilisez-la pour la base de données principale de l'entreprise : sa propre planification, son propre dossier, sa propre rétention.

Une tâche de groupe couvre des dossiers contenant des bases de données. Un seul jeu de paramètres pour toutes les bases du groupe. À chaque cycle, l'agent rescane les dossiers selon les masques, de sorte qu'une nouvelle base de données entre automatiquement dans la sauvegarde, sans modification des paramètres.

Une base de donnéesToutes les bases des dossiers
gbak avec vérificationvbackupgrpvbackup
nbackup avec niveauxnbackupgrpnbackup
nbackup dumpnbackup_dumpgrpnbackup_dump

Ce qu'une tâche de groupe prend et ce qu'elle ignore

L'agent parcourt les dossiers et vérifie chaque fichier par rapport aux masques d'inclusion et d'exclusion. En option, il vérifie aussi la taille minimale et le début du fichier. Les fichiers de sauvegarde (.fbk, .nbk, .delta, archives) n'entrent jamais dans la sauvegarde.

Une base de données qui possède sa propre tâche individuelle est automatiquement exclue du groupe, même si cette tâche est désactivée. Un groupe gbak ne prend pas les bases de données des tâches gbak individuelles. Un groupe nbackup ne prend pas les bases de données des tâches nbackup et dump.

Les bases de données système (noms commençant par security et examples) sont toujours ignorées. L'aperçu du scan montre la raison de chaque exclusion.

D:\data\ · masque *.fdb

  1. sales.fdbdans le groupe
  2. stock.fdbdans le groupe
  3. branch_new.fdb
    nouvelle base de données : commence par le niveau 0
    dans le groupe
  4. erp.fdb
    possède sa propre tâche individuelle
    ignorer
  5. security5.fdb
    base de données système
    ignorer
  6. bck_sales_20261107.fbk
    fichier de sauvegarde
    ignorer
  7. orders.fdb.delta
    fichier delta nbackup
    ignorer
  • Base de données retirée du dossierElle devient « orpheline ». Ses sauvegardes sont conservées selon une règle : N jours ou toujours. Ou elles vont immédiatement dans le dossier _orphaned et sont supprimées après 7 jours.
  • Base de données renomméeLe nouveau nom démarre une nouvelle chaîne à partir du niveau 0. Les anciennes sauvegardes sont conservées selon la règle pour les bases de données orphelines.
  • Échecs répétésAprès 5 échecs consécutifs, la base de données est mise en pause pendant 6 heures, puis réessayée.
  • Une erreur dans une base de données n'arrête pas le groupeLe groupe continue avec la base de données suivante. C'est le paramètre « Continuer avec les bases de données suivantes après une erreur » ; il est activé par défaut pour les groupes gbak, nbackup, dump et sweep.
  • Résultat du groupe dans la ligne de la tâche« N bases de données trouvées · M réussies · X erreurs · temps total ». Les détails contiennent un tableau des bases de données en erreur : nom, chemin et début du texte de l'erreur.
  • Budget de tempsUn cycle ne démarre pas de nouvelles bases de données lorsque le temps est écoulé. Pour les groupes nbackup, vous pouvez activer la continuation à partir de la base de données suivante au cycle suivant.
  • ParallélismeCombien de bases de données du groupe traiter en même temps. Une limite commune pour les tâches longues sur le serveur : par défaut, pas plus de deux ne s'exécutent simultanément.
  • Une opération par base de donnéesLes tâches individuelles et de groupe, gbak et nbackup voient les verrous les unes des autres.
  • Arborescence des dossiers comme dans la sourceLa case « Reproduire l'arborescence du dossier source » : la sauvegarde de la base de données x/y/EMPLOYEE.FDB va dans <backup folder>/x/y/EMPLOYEE.FDB/. Les bases de données portant le même nom dans des dossiers différents ne se gênent pas mutuellement.
Tâches dans HQ Monitor. Six types de sauvegarde et l'inventaire. Les tâches de restauration sont dans un groupe séparé : vous devez les autoriser explicitement, car elles modifient les bases de données.

vbackup · grpvbackup

gbak : sauvegarde avec vérification

Avant chaque étape, l'agent vérifie l'espace libre : pour la sauvegarde, pour la restauration de test, pour l'archive. S'il n'y a pas assez d'espace pour la restauration, l'agent l'ignore avec la raison no_space, et la sauvegarde est conservée. gbak écrit dans un fichier temporaire. Le fichier ne reçoit le nom .fbk que si la taille et le journal gbak sont corrects. Ainsi, une sauvegarde incomplète portant un nom normal n'apparaît jamais dans le dossier.

  1. 1Vérification de l'espacepour la sauvegarde ; à nouveau avant la restauration et la compression
  2. 2gbakvers un fichier temporaire .gbaktmp ; sur Firebird 5 — sur N cœurs
  3. 3Vérificationtaille et journal ; puis le nom .fbk
  4. 4Restauration de testsi activée ; un fichier séparé, pas la base de données de production
  5. 5Compressionarchive décompressée et comparée par SHA-256
  6. 6✓ Stockagecopie vers un autre dossier ; les anciennes copies sont supprimées
Formulaire de tâche gbak. Planification avec indication du fuseau horaire, dossier et nom de sauvegarde, options gbak sur une ligne, délais d'attente et facteurs de calcul d'espace.
  • Noms clairsbck_sales_20261107_02-00.fbk : le début du nom de la base de données et l'heure. Deux bases de données dans un même dossier n'écrivent pas les mêmes noms.
  • Avertissement de chevauchementSi deux tâches écrivent des fichiers dont le début du nom est identique dans un même dossier, l'agent et l'éditeur affichent un avertissement.
  • Résultat de la restauration de testok, failed, skipped avec une raison, ou not_run. Vous le voyez dans le dernier résultat de la tâche et dans l'inventaire. Dans l'éditeur, chaque restauration affiche les deux commandes : sauvegarde et restauration.
  • Ancienne base de données de testUne nouvelle tâche démarre la restauration de test avec -rep : gbak écrase la copie de l'exécution précédente. L'agent déconnecte d'abord les clients de cette copie. Si le chemin de la base de données de test est identique à celui de la base de production ou de la base d'une autre tâche, la restauration est ignorée.
  • Journaux et commandes gbakLes dernières lignes d'erreur sont visibles dans la console ; vous pouvez télécharger le journal. Les journaux sont supprimés en même temps que leur sauvegarde. L'agent conserve un historique des commandes exécutées : jusqu'à 50 pour chaque étape de tâche, mots de passe masqués.
  • Commutateurs qui cassent la vérification-Y envoie la sortie de gbak vers un fichier, mais l'agent vérifie la sauvegarde à partir de cette sortie. Donc -Y n'est pas autorisé. Une tâche en streaming n'accepte pas non plus -SE dans la ligne de restauration. L'éditeur signale ces commutateurs.
  • Délais d'attenteDoux : un avertissement. Strict : gbak est arrêté.
  • Temps gbak par étapeL'agent ajoute lui-même le commutateur -ST TDRW à chaque sauvegarde et restauration et prend le temps gbak depuis la sortie. Vous n'avez pas besoin de votre propre -ST dans les options de la tâche : l'éditeur ne l'accepte pas.
  • L'agent définit l'identifiant de connexionLes commutateurs -user, -password, -fetch_password et -trusted ne sont pas autorisés dans les options. La restauration de test s'exécute en tant que propriétaire de la base de données, si le propriétaire est enregistré dans les paramètres d'accès à la base de données. La ligne de restauration indique sous quel nom d'utilisateur elle s'est exécutée.
  • Messages clairsEspace et temps dans des unités familières : « 8,1 GiB libres, 11,8 GiB nécessaires », « délai dépassé après 60 s ».

nbackup · grpnbackup

nbackup : niveaux et points de restauration

Le niveau 0 copie toute la base de données. Le niveau 1 copie les pages modifiées depuis le dernier niveau 0. Le niveau 2 copie les modifications depuis le dernier niveau 1. Pour restaurer la base de données au moment voulu, trois fichiers suffisent.

Exemple de planification : niveau 0 une fois par semaine, niveau 1 chaque nuit, niveau 2 quatre fois par jour. Cela donne 36 points de restauration par semaine : 1 + 7 + 28. Elle conserve 5 copies du niveau 0, 7 du niveau 1 et 24 du niveau 2.

Semaine nbackup : niveau 0 le dimanche, niveau 1 chaque nuit, niveau 2 quatre fois par jour ; une restauration prend un fichier de chaque niveau
niveau 0 niveau 1 niveau 2 fichiers pour la restauration
  • Chaîne sans lacunesPas de niveau 0 — l'agent le crée aussitôt. Pour les autres niveaux, c'est le paramètre « Créer immédiatement les niveaux inférieurs manquants ». Sans cela, l'exécution est ignorée tant que le niveau inférieur manque.
  • Vérification par GUIDChaque niveau est lié à son niveau inférieur ; un fichier étranger n'entre pas dans la chaîne.
  • Trois modes de planificationSimple — par jours et heures. Avancé — cron pour chaque niveau, jusqu'au niveau 4. Plan — règles avec un niveau, des jours et une heure.
  • nbackup dumpUne copie complète du fichier de base de données en dehors de la chaîne de niveaux, selon sa propre planification.
  • Base de données en état deltaSi la base de données reste verrouillée après un nbackup interrompu, l'agent tente de fusionner le delta.

Mode plan

Un plan est un ensemble de règles : niveau, jours et heure. Les jours peuvent être tous les jours, des jours de la semaine ou des jours du mois. Si deux règles correspondent à la même minute, le niveau inférieur s'exécute. Le plan peut créer un niveau 0 de lui-même lorsque le dernier niveau 0 est plus ancien qu'un nombre de jours défini. Il exécute un niveau inférieur plus tôt que prévu lorsque les incréments dépassent une part définie de la taille de la base de données. Dans une tâche de groupe, chaque base de données construit sa propre chaîne de niveaux.

L'éditeur affiche le plan dans un calendrier sur plusieurs semaines à l'avance : quel niveau s'exécute et quand. Un bouton convertit une planification simple ou avancée en plan, et vous pouvez annuler cette conversion avant d'enregistrer.

  • Rétention par cyclesUn cycle est un niveau 0 avec tous ses incréments. L'agent conserve ou supprime un cycle entier : par nombre de cycles, par jours ou par taille totale. Le cycle complet le plus récent n'est jamais supprimé. L'éditeur montre à l'avance l'espace que prendront les sauvegardes.
  • État du planLa dernière copie de chaque niveau, l'espace utilisé et ce que le prochain nettoyage supprimera. L'agent met à jour l'état après chaque exécution du plan.

Compression · S3 · stockage

Où sont stockées les sauvegardes

Une sauvegarde peut aller directement vers S3 : gbak ou nbackup écrit dans un flux, et le flux va vers le bucket. Il n'y a pas de fichier intermédiaire sur le disque du serveur, donc vous n'avez pas besoin d'espace pour la sauvegarde sur le serveur.

La compression zip, gz ou zstd fonctionne pour les sauvegardes locales et en streaming. Pour une sauvegarde locale, l'agent décompresse l'archive terminée et la compare à la source par taille et SHA-256. Ce n'est qu'ensuite que le fichier source est supprimé. Si la vérification échoue, rien n'est supprimé.

  • Rétention par nombregbak : combien de fichiers conserver. nbackup : combien de copies de chaque niveau.
  • Copies vers d'autres emplacementsUne copie vers un second dossier ou un chemin réseau. Envoi vers S3, FTP ou FTPS — avec une tâche file_sync séparée.
  • Votre propre script après la sauvegardePour gbak. Il reçoit les chemins de la sauvegarde, de la base de données de test et des journaux gbak.
  • Chiffrement de l'archiveUne tâche gbak peut chiffrer l'archive zip (AES-256) avec un mot de passe issu des clés de l'agent, sur disque et dans le flux S3. 7-Zip ouvre l'archive. Une restauration trouve la bonne clé d'elle-même.
  • Restauration depuis une archiveLe format est détecté à partir du contenu du fichier, localement et depuis S3.
  • Restauration depuis S3Une tâche de restauration lit la sauvegarde directement depuis le bucket.
  • AntivirusExcluez les dossiers de sauvegarde et de restauration de l'analyse en temps réel.
  • Vous choisissez la compressionUne nouvelle tâche est créée sans compression. zstd est en tête de la liste des formats. Vous pouvez définir votre propre extension de fichier pour une archive de n'importe quel format.
  • Guide Amazon S3Configuration pas à pas du bucket, des clés et de la tâche. Disponible en anglais et en portugais.

Amazon S3 · stockage compatible

Sauvegardes vers S3

L'agent envoie les sauvegardes vers un bucket dans Amazon S3 ou dans un stockage compatible. Cela fonctionne pour les tâches gbak et nbackup. Vous n'avez pas besoin d'un autre programme pour cela.

La configuration comporte trois parties : préparer un bucket et une clé d'accès, créer une cible s3 dans les paramètres de l'agent, activer l'envoi dans la tâche de sauvegarde. Chaque tâche utilise l'un des deux modes.

Copie de fichierFlux vers S3
Fichier sur le disque du serveurOui. La sauvegarde est écrite sur le disque, puis envoyée.Non. La sauvegarde va directement vers le bucket.
Espace disque pour la sauvegardeNécessaire.Non nécessaire.
DestinationS3, FTP, FTPSS3 uniquement
Suppression des anciennes copies dans le bucketNon. Utilisez une règle de cycle de vie du bucket.Oui, selon la règle de rétention de la tâche.
Échec de l'envoiLa sauvegarde locale reste valide.Pas de sauvegarde : aucun objet ne reste dans le bucket.
  • Comment choisirCopie de fichier : lorsque vous avez besoin à la fois d'une copie locale et d'une copie dans S3. Flux : lorsque le disque du serveur est petit ou que S3 est le seul emplacement pour les sauvegardes.
  • Restauration depuis S3Une tâche de restauration lit une sauvegarde en streaming directement depuis le bucket : l'objet le plus récent ou celui que vous nommez. L'agent vérifie la taille et le SHA-256 de chaque objet.
  • ChiffrementLe chiffrement du bucket protège l'objet côté stockage. Le chiffrement de l'archive dans la tâche protège le fichier avec un mot de passe avant qu'il ne quitte le serveur.
  • BucketGardez l'accès public bloqué. Ajoutez une règle qui supprime les envois multipart inachevés après un jour.
  • Une clé uniquement pour les sauvegardesCréez un utilisateur séparé. Donnez-lui uniquement les droits nécessaires : écrire, lire et supprimer des objets, interrompre un envoi et lister les envois inachevés du bucket. Si le bucket est chiffré avec une clé KMS, il a aussi besoin de droits sur cette clé. Sur un serveur Amazon EC2, vous pouvez travailler sans clé : l'agent utilise le rôle IAM du serveur.
  • VérificationLancez la tâche avec le bouton Exécuter maintenant, examinez le résultat et faites une restauration de test avant de vous fier à la sauvegarde.

Erreurs courantes

ErreurCauseQue faire
AccessDeniedUn droit manque, ou le chemin dans les droits est différent.Vérifiez les droits de l'utilisateur.
SignatureDoesNotMatchMauvaise clé, ou espaces dans sa valeur.Copiez à nouveau la clé.
PermanentRedirectLa région dans les paramètres ne correspond pas à la région du bucket.Corrigez la région.
NoSuchBucketNom de bucket incorrect.Corrigez le nom.
RequestTimeTooSkewedL'horloge du serveur est incorrecte.Synchronisez l'horloge avec NTP.

restore.replace_cycle

Backup-Restore-Replace

Le cycle reconstruit la base de données de production. L'agent effectue une sauvegarde gbak, la restaure dans un nouveau fichier et met le nouveau fichier à la place de l'ancien. La nouvelle base de données n'a pas de déchets, ses index sont neufs et elle est généralement bien plus petite. La base de données de production est déconnectée et renommée en toute sécurité : l'agent la met d'abord en shutdown full, toutes les connexions se ferment, et ce n'est qu'ensuite que le fichier reçoit un nouveau nom.

Par défaut, le cycle s'exécute le samedi à 02:00 ; vous pouvez modifier la planification. Exécuter maintenant démarre le cycle immédiatement, mais vous demande d'abord de saisir le nom du fichier de base de données. La base de données peut être définie par un chemin ou par un alias depuis databases.conf.

    Clients

    connect sales.fdb

    Fichiers sur le disque

    De l'arrêt au remplacement, les clients reçoivent « database not found » ou « database shutdown ». Planifiez le cycle à un moment où la base de données peut être indisponible pendant la durée d'une sauvegarde plus une restauration. En mode pipe, la sauvegarde et la restauration s'exécutent en même temps, et aucun fichier de sauvegarde n'est écrit.

    Le cycle ne démarre pas si

    • « Allow replace » (allow_replace) n'est pas activé dans la tâche ;
    • la base de données est en arrêt, chiffrée ou est une réplique ;
    • la base de données est une base de sécurité, la sienne ou celle d'autres bases de données ;
    • des fichiers d'un cycle inachevé se trouvent à côté ;
    • l'espace disque est insuffisant.

    L'espace est calculé à l'avance : le fichier de sauvegarde et la copie restaurée sont sur le disque en même temps, chacun environ de la taille de la base de données. L'original est renommé, pas copié, il n'occupe donc aucun espace. Si l'espace est faible, le cycle s'arrête avant l'arrêt : la base de données n'est pas touchée et les clients continuent de travailler.

    Ce qui reste sur le disque

    Originaux. Les derniers originaux en arrêt complet sont conservés à côté de la base de données, de 1 à 10, 1 par défaut. Les supplémentaires sont supprimés au début du cycle suivant, ainsi la base de données dans son état avant le dernier cycle est toujours présente.

    Le fichier de sauvegarde est supprimé après le remplacement. Si la restauration a échoué, le fichier est conservé sous .restore-failed.fbk pour analyse.

    Pour revenir à l'original : arrêtez la base de données de production, renommez les fichiers et exécutez gfix -online pour l'original.

    Lorsque le cycle est interrompu

    Quelqu'un peut arrêter l'agent, le serveur peut redémarrer, une panne de courant peut survenir. Lors d'un arrêt normal du service avant le remplacement, l'agent laisse gbak se terminer et annule le cycle. En cas de défaillance, avant chaque étape l'agent écrit ce qu'il fait dans un fichier d'intention. Au démarrage puis toutes les minutes, l'agent lit ces fichiers et amène le cycle à un état connu.

    Avant le renommage

    La base de données revient en ligne

    L'agent remet la base de données en ligne et restaure le délai d'arrêt.

    Avant le remplacement

    Annulation

    La copie intermédiaire et la sauvegarde incomplète sont supprimées, l'original retrouve son ancien nom et passe en ligne.

    Après le remplacement

    Achèvement

    La nouvelle base de données reste en production, l'original est conservé en arrêt. Le script « after » n'a pas été exécuté : exécutez-le vous-même si c'est important.

    Si les fichiers sur le disque ne correspondent à aucun état connu, l'agent ne modifie rien, et le résultat de la tâche commence par « operator needed ». Le fichier d'intention liste les noms de tous les fichiers du cycle. Placez la base de données correcte à son chemin, et l'agent termine la récupération par lui-même.

    Vos propres scripts avant et après

    Le script « before backup » s'exécute avant l'arrêt. S'il se termine par une erreur, le cycle s'arrête et la base de données n'est pas touchée. Le script « after restore » s'exécute après le remplacement. Exemple : copier le fichier de sauvegarde dans une archive avant que l'agent ne le supprime.

    VariableAvant la sauvegardeAprès la restauration
    FBAGENT_HOOK_PHASEprepost
    FBAGENT_JOB_IDid de la tâche
    FBAGENT_DB_NAMEnom dans la tâche : alias ou chemin
    FBAGENT_DB_PATHfichier de base de données : original, en lignemême chemin : nouvelle base de données, en ligne
    FBAGENT_ORIG_PATHvidechemin vers l'original
    FBAGENT_FBK_PATHfutur fichier de sauvegarde ; vide en mode pipefichier de sauvegarde, supprimé après le script ; vide en mode pipe

    Inventaire · rapport de santé

    Contrôle : quelle base de données n'a pas de sauvegarde

    L'inventaire affiche tous les fichiers de sauvegarde sur le serveur, y compris ceux réalisés par d'autres programmes. L'agent le met à jour après chaque sauvegarde et intégralement toutes les 2 heures. À côté se trouve un tableau des restaurations : test et production, sur 14 jours.

    Chaque sauvegarde a une colonne Vérifié : la restauration de test a réussi, échoué ou n'a pas été exécutée. À côté se trouvent la taille de la base de données restaurée et le temps gbak. Le tableau des restaurations indique la taille de la base de données et la durée.

    Le rapport de santé du serveur signale une base de données sans sauvegardes enregistrées et en explique la raison : la tâche a échoué, est toujours en cours, est reportée, ou il n'y a aucun fichier dans les dossiers. Un bouton à côté du constat ouvre immédiatement le formulaire pour une nouvelle tâche.

    Inventaire. La restauration de test de chaque copie échoue, et vous le voyez immédiatement. Les fichiers sans tâche propre sont marqués ORPHANED.
    Constats dans le rapport. « No backups for the database » : ajoutez une tâche nbackup ou gbak en un clic.

    ← Retour à la présentation de HQbird 2027