Maintenance du serveur HQbird
Maintenance sans équipes de nuit
Le sweep, la validation de la base de données, le recalcul des statistiques d'index, vos scripts SQL et les mises à jour de Firebird s'exécutent la nuit selon un planning. Le group sweep, les scripts SQL et les mises à jour de Firebird ne démarrent que dans leur propre fenêtre. L'agent ne gêne ni les sauvegardes ni les utilisateurs. En cas de problème, l'agent rétablit lui-même l'état précédent.
- 4 tâches de maintenance
- 1 opération lourde par base de données
- 2 tâches lourdes par serveur
- 03:30–04:00 fenêtre de mise à jour de Firebird
- annulation automatique si la vérification échoue
Planning par défaut
Nuit du serveur
La maintenance s'exécute la nuit, chaque tâche à son propre horaire. Voici les horaires et fenêtres par défaut. Vous les modifiez dans l'éditeur de configuration de l'agent.
Le sweep, la validation gfix, le recalcul des index et les scripts SQL sont désactivés par défaut : vous les activez pour vos bases de données. Les horaires utilisent le fuseau horaire de l'agent.
La nuit du dimanche s'exécute dans cet ordre : validation gfix à 02:30, sweep à 03:00, recalcul des index à 04:00. D'abord la vérification, puis le ramassage des versions obsolètes, puis les statistiques sur les données actives.
sweep · gfix · index · SQL
Quatre tâches de maintenance
Chaque tâche est une commande Firebird normale. L'agent ajoute ce qu'un DBA fait habituellement à la main : un planning, une fenêtre, un verrou de base de données, un journal et une raison d'erreur claire.
| Tâche | Ce qu'elle fait | Quelles bases de données | Par défaut |
|---|---|---|---|
| Sweep | gfix -sweep : supprime les anciennes versions d'enregistrements. | Liste explicite de bases de données | Dim 03:00 |
| Group sweep | Le même sweep pour toutes les bases de données des dossiers. Masques, exclusions, profondeur d'analyse. | Dossiers, masque *.fdb | 00:15–01:15 |
| Validation gfix | gfix -v -full : vérifie chaque page de la base de données. | Liste explicite uniquement | Dim 02:30 |
| Recalcul des index | SET STATISTICS pour les index utilisateur. Détecte aussi les index inactifs. | Liste de bases de données | Dim 04:00 |
| Scripts SQL | Vos DDL et DML depuis le dossier des scripts entrants ou depuis la file d'attente. | Une base de données par script | 03:00–04:00 |
- Transactions longues avant le sweepEn option, l'agent déconnecte les connexions dont les transactions ont plus de 5 heures (le seuil est configurable). Il ne touche pas à gbak, gfix, gstat et fbsvcmgr.
- Le groupe ne s'arrête pasUne erreur sur une base de données n'arrête pas l'analyse des autres bases de données.
- Une raison claireFirebird 3 et versions ultérieures n'autorisent pas la validation d'une base de données avec des utilisateurs connectés. L'agent le dit exactement, au lieu d'afficher seulement un code d'erreur.
- SQL : l'agent ajoute COMMITDDL : COMMIT après chaque instruction, DML : après chaque 100 instructions.
SET BAIL ON: la première erreur arrête le script. - Le SQL dangereux ne s'exécute pas
DROP DATABASE, utilisateurs et rôles,GRANTetREVOKE,ALTER DATABASE: un tel script est mis en quarantaine dans son intégralité. - Journal d'exécutionQuelle commande, quand et avec quel résultat. Pour le sweep et la validation gfix, l'agent conserve un historique des commandes : jusqu'à 50 par tâche, les deux dernières sont visibles dans l'éditeur. Le mot de passe n'apparaît jamais dans le journal.
Fenêtres · verrous · emplacements
Si le serveur est occupé, la tâche attend ou ignore la base de données
Avant un démarrage, l'agent vérifie plusieurs conditions. Si une condition n'est pas remplie, la tâche attend ou ignore la base de données. Elle n'interrompt pas les autres travaux.
Activez les conditions à gauche et voyez ce que l'agent fait avec la base de données sales.fdb pendant un group sweep de son dossier.
| Règle | Ce qui compte | Ce que fait l'agent |
|---|---|---|
| Fenêtre de maintenance | Group sweep 00:15–01:15, scripts SQL 03:00–04:00, test de performance sam 22:00 — dim 06:00. | En dehors de la fenêtre, la tâche ne démarre pas. S'il reste moins d'une minute dans la fenêtre, elle ne démarre pas non plus. |
| Une opération lourde par base de données | Sauvegarde, sweep, validation, recalcul des index, restauration et script SQL prennent un verrou de base de données. | Une sauvegarde attend jusqu'à 60 minutes que la base de données se libère. Le sweep, la validation et le recalcul des index ignorent une base de données occupée jusqu'à la prochaine exécution planifiée. Exécuter maintenant attend et réessaie. |
| Pas plus de 2 tâches lourdes par serveur | Sauvegardes, restaurations, sweep, validations, recalcul des index, scripts SQL, gstat complet, le test. Le travail lourd de l'agent lui-même prend aussi un emplacement : traitement des traces et des journaux. | Une troisième tâche attend un emplacement libre. Vous modifiez le nombre dans les paramètres ; la nouvelle valeur prend effet après un redémarrage de l'agent. |
Fichier .delta | Il y a un fichier .delta à côté de la base de données : nbackup tient la base de données. | Le sweep ignore une telle base de données. |
| Une erreur dans une base de données d'un groupe | Le sweep d'une base de données du groupe s'est terminé par une erreur. | Le group sweep continue avec la base de données suivante. Si la continuation est désactivée, seule cette tâche s'arrête. Les bases de données en erreur sont nommées dans le résultat de la tâche. |
Si une sauvegarde gbak et un nbackup de la même base de données tombent sur la même minute, la sauvegarde gbak est décalée de 15 minutes plus tard. Un démarrage manuel avec Exécuter maintenant n'est pas décalé.
Un bouton
Exécuter maintenant : le lancer tout de suite
Besoin d'une sauvegarde avant une mise à jour logicielle, ou d'un sweep tout de suite ? Le bouton « Exécuter maintenant » sur la ligne de la tâche lance la tâche une fois. Le planning ne change pas.
Exécuter maintenant est disponible pour les sauvegardes, les restaurations, le sweep, le recalcul des index et la validation gfix. Vous pouvez aussi exécuter une tâche désactivée une fois : elle reste ensuite désactivée. L'agent vérifie les mêmes conditions que pour une exécution planifiée et indique ce qu'il attend.
- Vous voyez ce qu'il attendLa base de données est occupée par une autre opération, la tâche attend sa fenêtre, l'espace disque est faible.
- AnnulerTant qu'une exécution est en file d'attente ou en attente, vous pouvez l'annuler. Une tâche qui a démarré n'est pas annulée.
- Une demande vit 60 minutesSi l'agent ne l'a pas prise pendant ce temps, l'exécution est considérée comme expirée, pas perdue.
- Vous voyez quelle base de données s'exécuteraLa fenêtre d'exécution commence par le champ de la base de données. Pour une tâche de groupe, ce sont des cases à cocher pour les bases de données et la ligne « N sur M sélectionnées ».
- Rapport de performance sur demandeExécuter maintenant construit un rapport pour n'importe quelle plage jusqu'à 24 heures, avec des filtres par base de données, durée et programme. C'est la même exécution que le bouton « Construire le rapport… » sur la page de rapport.
- Localement et depuis le centreLa console locale va directement à l'agent. Depuis le centre, la demande passe par goafts. L'agent la prend à la prochaine synchronisation, en environ une minute.
- Le remplacement de base de données est séparéRestauration avec remplacement et cycle sauvegarde-restauration-remplacement : vous devez saisir le nom du fichier de base de données et disposer d'une autorisation distincte. Le démarrage à distance de telles tâches est désactivé sur le serveur par défaut.
- Juste après EnregistrerExécuter maintenant attend que l'agent accepte la nouvelle configuration, puis démarre la tâche.
Mise à jour du moteur
Une nouvelle build Firebird est une opération de nuit ordinaire
L’agent télécharge lui-même une nouvelle build Firebird, attend la fenêtre de maintenance, l’installe et la vérifie. Si la vérification échoue, l’agent rétablit la version précédente et ne réinstalle plus cette build.
- Fenêtre03:30–04:00 par défaut. En dehors de la fenêtre, la build téléchargée attend l’ouverture de la fenêtre. Si la mise à jour est reportée dans la fenêtre, l’agent réessaie dans 10 minutes. L’agent trouve une nouvelle build dans le centre en environ une heure.
- Jobs qui ne doivent pas être interrompusSi gbak, nbackup, une restauration ou un script SQL est en cours, la mise à jour attend la vérification suivante. Sweep, la validation gfix et gstat ne la bloquent pas : ils peuvent être répétés.
- Un moteur à la foisSur un serveur avec plusieurs instances Firebird, une seule est mise à jour à la fois.
- Espace et fichiers verrouillésL’espace libre et les fichiers détenus par un autre programme sont vérifiés avant l’arrêt de Firebird. Si un fichier ne peut pas être remplacé, Firebird ne s’arrête pas.
- Vos fichiers restentL’agent ne remplace que les fichiers de distribution. firebird.conf, databases.conf, replication.conf, la base de sécurité, les UDF et les plugins tiers restent. Seuls les paramètres obligatoires manquants sont ajoutés à firebird.conf.
- RollbackLes fichiers remplacés sont conservés dans la sauvegarde de mise à jour. Un rollback les rétablit. Les 2 dernières sauvegardes sont conservées.
- Blocage de versionUne build qui a été annulée par rollback, automatiquement ou manuellement, est bloquée. Une commande supprime le blocage.
- Mise à jour inachevéeSi le processus s’est arrêté en cours de route, une nouvelle mise à jour ne démarre pas tant que l’administrateur n’a pas annulé ou terminé la précédente.
L’agent ne met pas à jour Firebird installé depuis les paquets du système d’exploitation (apt, dnf) : le gestionnaire de paquets possède les fichiers. La procédure pour migrer un tel serveur vers HQbird est décrite ci-dessous.
Test · databases.conf · migration
Outils d’administration
Test de performance du serveur
Une fois par semaine, l’agent exécute le test IBSurgeon : INSERT, UPDATE et DELETE sur un million de lignes dans une base temporaire. L’historique des tests montre comment le serveur fonctionnait avant et après un changement de matériel, de disque ou de paramètres.
Le test charge le disque, il ne s’exécute donc que dans sa propre fenêtre. Firebird supprime lui-même la base temporaire. Si l’agent a planté pendant le test, le fichier est supprimé au démarrage suivant.
| Fenêtre | sam. 22:00 — dim. 06:00 |
|---|---|
| Démarrage | dim. 01:00 |
| Lignes | 1 000 000 |
| Espace disque libre | environ 7,2 Gio, sinon le test ne démarre pas |
| Historique | 30 dernières exécutions |
| En même temps | un test ; une seconde exécution est ignorée |
Utilisateurs Firebird : Security.fdb/Users
Une page de paramètres distincte affiche les bases de sécurité du serveur : celle partagée, celles privées et celles intégrées à une base de données. Des libellés signalent un problème : pas de login pour la lecture, la liste ne s’est pas actualisée, l’entrée est obsolète.
Le bouton Créer un utilisateur crée un utilisateur Firebird via l’agent. Dans la fenêtre : nom, mot de passe deux fois, plugin issu du paramètre UserManager, les indicateurs « actif » et « administrateur ». Les droits d’administrateur sont confirmés dans une seconde étape. Avant l’exécution, vous voyez le texte de la commande, avec le mot de passe masqué.
La création fonctionne avec l’agent local et ne fonctionne pas pour Firebird 2.5.
Éditeur databases.conf
Le fichier est affiché sous forme de liste de chemins de bases de données. Chaque chemin a ses alias et un bloc de paramètres. La liste des paramètres ne contient que ceux que cette version de Firebird accepte pour une base de données unique. La valeur issue de firebird.conf est affichée à côté.
Un alias répété et un second bloc pour le même chemin sont des erreurs : vous ne pouvez pas enregistrer un tel fichier. Une faute de frappe dans un nom de paramètre donne lieu à une indication. À l’enregistrement, l’agent vérifie à nouveau le fichier et conserve une copie du fichier précédent à côté. Si le fichier a changé pendant votre édition, l’agent refuse, et votre texte reste dans l’éditeur. Les modifications dans le formulaire ne touchent pas aux commentaires du fichier. Chaque enregistrement est inscrit dans le journal d’audit.
Depuis le centre, le fichier est livré via goafts. L’agent l’applique en environ une minute et rapporte le résultat : accepté ou rejeté.
Migration vers HQbird et modifications des paramètres
FBDataGuard
Les anciens paramètres HQbird sont repris automatiquement
Au premier démarrage, l’agent trouve la configuration FBDataGuard et reprend les jobs de sauvegarde, de sweep et de statistiques d’index. L’import s’exécute une seule fois. Par défaut, les jobs arrivent désactivés. Si l’installateur désactive FBDataGuard, il active les jobs que FBDataGuard exécutait et qui ont été importés sans avertissements. Le serveur n’est donc pas laissé sans sauvegardes. Les autres jobs restent désactivés : vérifiez-les et activez-les vous-même. L’agent reprend les anciennes sauvegardes des journaux FBDataGuard dans ses propres enregistrements : la rétention et la restauration les voient.
apt · dnf
Firebird depuis les paquets du système d’exploitation
L’installateur détecte Firebird issu des paquets et s’arrête sans rien modifier. Il affiche les commandes qui suppriment le paquet et conservent la base de sécurité, databases.conf et les bases de données. Ensuite, l’installateur installe HQbird et reprend les utilisateurs et alias de l’ancien serveur. Testé pour Firebird 2.5, 3.0, 4.0 et 5.0.
sans redémarrage
Nouveaux paramètres, avec vérification
L’agent vérifie la nouvelle configuration, fait une copie de l’ancienne et applique la nouvelle sans redémarrage. Si la nouvelle ne se charge pas, l’agent rétablit la précédente. La plupart des paramètres s’appliquent sans redémarrage. Un redémarrage est nécessaire pour le dossier de données, le journal de l’agent, l’API locale, la connexion au centre, Prometheus, le cluster, les limites de charge et le fuseau horaire de l’agent. L’agent indique quelles modifications attendent un redémarrage.
← Retour à la présentation de HQbird 2027 · Les sauvegardes en détail → · Santé du serveur →