Ce document liste les changements de HQbird 2027, du plus récent au plus ancien. Chaque partie commence par le numéro de la version et sa date. Une nouvelle version ajoute sa partie en haut ; les parties en dessous restent telles qu’elles étaient.

  • 2027.2.34 et suivantes : une partie pour chaque version.
  • 2027.2.33 : l’ensemble de HQbird 2027 à cette version, comparé à HQbird 2024.
  • Les notes de chaque kit, de 2027.2.8 à 2027.2.33, se trouvent dans hqbird2027-whats-new-2027.2.8-2027.2.33.md sur le site de téléchargement.

Installateurs : Téléchargement de HQbird 2027.

Téléchargements : https://ib-aid.com/download/hqbird/v2027/ (installateur Windows .exe et .run Linux pour Firebird 2.5, 3.0, 4.0 et 5.0 ; SHA256SUMS contient les sommes de contrôle). Images Docker : ghcr.io/ibsurgeon/hqbird2027-fb25, -fb30, -fb40, -fb50.


2027.2.35 (2026-11-18)

Versions

Composant Version Modifié
Agent HQbird (fbagent, enroll) 3.6.0 oui
HQbird Monitor 1.59.0 oui
Éditeur de configuration (dans HQbird Monitor) 1.63.0 oui
HQbird RCM 2027.5.13 oui
Nœud HQCluster 2027.5.13 oui
fbmcp (serveur MCP pour Firebird) 2027.2.24 non
Firebird 2.5.9.27194, 3.0.15.33893, 4.0.8.3332, 5.0.5.1917 non

Cluster : réinitialisation après une sauvegarde et une restauration d’une base maître

  • Une sauvegarde et une restauration (gbak) d’une base maître lui donnent un nouveau GUID, et ses réplicas ne peuvent plus appliquer son journal de réplication. Le nœud le voit en quelques secondes, suspend l’envoi vers chaque réplica (raison master_db_replaced) et met le maître à l’état NEEDS_REINIT, comme auparavant.
  • Nouveau : RCM décide ce qu’il faut faire ensuite, selon le paramètre auto_reinit.on_master_restore dans rcm.json (aussi sur la page Paramètres) :
    • auto : RCM réinitialise de lui-même chaque réplica de la base, après une attente de 300 secondes (auto_reinit.master_restore_settle_sec) ;
    • window : RCM les réinitialise dans sa fenêtre de réinitialisation automatique ;
    • propose : RCM ne lance rien et attend un opérateur.
  • Sans ce paramètre, rien ne change : window lorsque la réinitialisation automatique est activée, propose lorsqu’elle est désactivée.
  • La ligne de la base maître sur la page Bases de données indique ce qui s’est passé et ce que fait RCM. Le nouveau bouton Réinitialiser tous les réplicas maintenant lance la réinitialisation de tous les réplicas, l’un après l’autre. Reporter retient la réinitialisation.
  • Le nœud réagit à tout remplacement du fichier de la base : une restauration faite à la main, ou le cycle de sauvegarde-restauration de l’agent. Vérifié sur Firebird 2.5, 3.0 et 5.0. L’alerte master_db_replaced va aux canaux de notification de RCM.

Cluster : la réplication de HQbird 2024 (FBDataGuard) passe à RCM

  • Sur un serveur mis à jour depuis HQbird 2024, l’agent lit les paramètres de réplication de FBDataGuard (rôles, dossiers du journal de réplication et de l’archive, cibles des réplicas) et les donne à RCM.
  • RCM lie de lui-même les hôtes des réplicas. Un hôte qu’il ne peut pas lier est montré comme candidat sur la page Lier les hôtes.
  • RCM reprend ensuite la réplication des bases telle quelle. Il ne réinitialise aucun réplica, ne redémarre pas Firebird et ne supprime pas de fichiers. Il attend tant que FBDataGuard tourne encore.
  • La page Paramètres → Importer depuis FBDataGuard montre l’état de l’import et le répète. La ligne de commande a hqbirdrcm dg-import status et hqbirdrcm dg-import retry.
  • Le nœud lit les blocs que FBDataGuard a écrits dans replication.conf et les segments de journal qu’il a renommés en .uploaded.
  • L’import a été testé sur des serveurs Linux.

RCM : la page Bases de données

  • La ligne d’une base maître dont la publication est activée montre combien de tables sont dans la publication et combien l’opérateur en a retirées, par exemple publication on · tables: 118 · taken out: 2.

Installateurs : le premier mot de passe de RCM

  • Après une installation avec RCM, l’installateur Linux affiche sur le terminal le mot de passe généré de rcmadmin, avec le chemin de son fichier. L’installateur Windows l’affiche sur la page de résultat.
  • Le mot de passe n’est affiché que sur un terminal. Il n’est pas écrit dans un journal, un pipe ou le fichier de résultat de l’installation.

HQbird Monitor : l’heure de la plage de temps

  • Les champs d’heure de la plage de temps (tableau de bord, pages de base de données, Journaux, Erreurs) sont deux champs de saisie, heures et minutes, à la place des listes. Les flèches haut et bas changent une valeur de 1, : passe des heures aux minutes, et une courte liste propose des pas de 15 minutes.

Éditeur de configuration dans HQbird Monitor

  • Un horodatage est l’heure exacte. Son âge (« il y a 23 min ») est dans l’infobulle.
  • Le panneau de résultat d’une tâche de sauvegarde a une ligne Taille : le fichier de sauvegarde de l’exécution, et la base de données que sa restauration de test a construite.
  • Les pages de configuration de l’agent tiennent sur un téléphone et sur un écran de 1280 px de large : la rangée d’onglets passe à la ligne, Paramètres affiche ses entrées sur une seule ligne qui défile, et les tableaux Tâches et Sauvegardes ne défilent plus sur le côté à 1280 px.

Corrections

  • HQbird 3.0 sur un serveur mis à jour depuis HQbird 2024 ne démarrait pas après la configuration du cluster (“Incorrect version of replication config file”) : Firebird chargeait l’ancienne copie du plugin de réplication depuis le dossier plugins. La copie est maintenant conservée hors de ce dossier.
  • Le nœud applique un changement de limits.rescan_interval_sec sans redémarrage.

Mise à niveau

  • Installez ou mettez à jour avec l’installateur Windows 2027.2.35 ou le .run Linux. Un serveur avec les mises à jour automatiques prend de lui-même l’agent 3.6.0 et HQbird Monitor 1.59.0.
  • Dans un cluster, mettez à jour RCM avant les nœuds, ou en même temps. RCM 2027.5.13 fonctionne avec des nœuds plus anciens ; l’import depuis FBDataGuard a besoin de nœuds 2027.5.13.
  • Un cycle planifié de sauvegarde-restauration sur une base maître d’un cluster : réglez auto_reinit.on_master_restore sur auto. Sinon, les réplicas ne reçoivent aucun changement après le cycle tant qu’un opérateur n’a pas lancé la réinitialisation.
  • Docker : récupérez l’image 2027.2.35 et démarrez un nouveau conteneur sur les mêmes volumes.

2027.2.34 (2026-11-17)

Versions

Composant Version Modifié
Agent HQbird (fbagent, enroll) 3.5.0 oui
HQbird Monitor 1.58.0 oui
Éditeur de configuration (dans HQbird Monitor) 1.62.0 oui
fbmcp (serveur MCP pour Firebird) 2027.2.24 non
HQbird RCM 2027.5.12 non
Nœud HQCluster 2027.5.12 non
Firebird 2.5.9.27194, 3.0.15.33893, 4.0.8.3332, 5.0.5.1917 non

Le journal d’une tâche gbak est conservé en entier

  • Auparavant, l’agent retirait le milieu d’un journal gbak de plus de 16 MiB. Désormais, le journal de chaque phase d’une tâche de sauvegarde ou de restauration est une seule archive .log.zip avec tout ce que gbak a affiché.
  • À côté de l’archive, l’agent conserve un petit fichier texte avec les 100 dernières lignes de la sortie et des erreurs.
  • Dans l’éditeur de configuration, Télécharger le journal enregistre l’archive. Le nouveau bouton Dernières lignes, dans la ligne de journal d’une tâche et dans l’historique des restaurations, montre la fin du journal sans téléchargement.
  • Une archive de plus de 30 MB n’est pas envoyée à HQCenter. Sa ligne indique conservé sur le serveur uniquement, et Télécharger le journal affiche le chemin de l’archive sur le serveur. Les dernières lignes sont tout de même envoyées.
  • Les journaux écrits par les versions antérieures (.log.gz) sont conservés et se téléchargent comme auparavant.

HQbird Monitor sur un téléphone

  • Sur un écran de 768 px de large ou moins, l’en-tête tient sur une seule ligne : la flèche de retour, le nom du serveur et un bouton de menu. Le bouton ouvre le menu du serveur, Paramètres, la langue et Déconnexion dans un panneau. Auparavant, l’en-tête occupait trois lignes et montrait quatre des sept éléments du menu.
  • La plage de temps est un seul bouton. Il ouvre la date, l’intervalle et les préréglages dans un panneau. Les filtres Inclure et Exclure de Journaux, Erreurs et Conflits se replient sous un bouton Filtres.
  • Sur un écran de 600 px de large ou moins, les serveurs, les bases de données du tableau de bord, les erreurs et les enregistrements de journal sont des cartes. Rien ne défile sur le côté.
  • Les boutons et les champs font au moins 44 px de haut, et le texte d’un champ fait 16 px, afin que Safari sur iPhone ne zoome pas la page lorsque vous touchez un champ.

Pages de base de données dans HQbird Monitor

  • Une page de base de données conserve le menu du serveur : Journaux, Configurations, Erreurs, Conflits, Perf Report, Tâches et Sauvegardes sont à un clic. Auparavant, les éléments de la base prenaient la place du menu du serveur.
  • Les éléments de la base (Base de données, Métriques, Versions des clients, Statistiques, Rapport de performance) sont sur une ligne sous l’en-tête. La ligne commence par le libellé DB et le nom de la base, et elle reste en place lorsque vous faites défiler.
  • Cliquez sur le nom de la base pour voir les bases du serveur : le nom, le chemin et la taille de chacune. Une autre base s’ouvre sur la même page, le même jour et la même plage de temps. À partir de 8 bases, la liste a un champ de recherche.
  • Perf Report montre la ligne d’une base tant que cette base est choisie dans la liste Base de données.
  • Le logo d’une page de base n’est plus un lien vers le tableau de bord ; le nom du serveur l’est.
  • Le guide de l’utilisateur (anglais et portugais du Brésil) est mis à jour, avec de nouvelles images.

Installateur Linux

  • ALT Linux. Sur un ALT 11 propre, les kits pour Firebird 3.0, 4.0 et 5.0 s’arrêtaient avec le code 6, parce que l’installateur demandait des noms de paquets Debian. L’installateur connaît maintenant ALT Linux et installe les bons paquets.
  • sudo pour un seul groupe. Sur un système où seul un groupe peut exécuter sudo (ALT Linux : le groupe wheel), l’installation revenait en arrière. L’installateur ajoute maintenant le compte de l’agent à ce groupe et l’indique. Il s’arrête, en donnant la raison, lorsque ce groupe peut exécuter toutes les commandes sans mot de passe ou lorsque seul root peut exécuter sudo.
  • Une installation échouée ne laisse rien. L’annulation arrête maintenant un service Firebird qui tournait depuis le dossier retiré et tenait le port, et elle supprime le dossier de l’agent ainsi que son fichier sudoers. L’essai suivant part de zéro.
  • SELinux. Sur AlmaLinux 8, HQbird Monitor n’était pas installé : son fichier d’unité avait un mauvais label SELinux. L’installateur pose maintenant le label.

Images Docker

  • Un routeur de cluster (HAProxy) démarre maintenant dans le conteneur. Auparavant, le service du routeur ne démarrait pas dans l’image.
  • Un nouveau conteneur sur les volumes d’un ancien, avec un routeur dessus, ne reste plus bloqué dans une boucle de redémarrage.

Corrections

  • HQbird Monitor sur un téléphone : les éléments Tâches et Sauvegardes s’affichaient pour un serveur dont l’agent n’a pas d’éditeur de configuration.

Mise à niveau

  • Installez ou mettez à jour avec l’installateur Windows 2027.2.34 ou le .run Linux. Un serveur avec les mises à jour automatiques prend de lui-même l’agent 3.5.0 et HQbird Monitor 1.58.0.
  • Un HQCenter a besoin de HQbird Monitor 1.58.0 pour télécharger les nouveaux journaux .log.zip de ses agents. Mettez à jour le HQCenter avant les agents, ou en même temps.
  • Un proxy devant HQbird Monitor qui filtre les types de contenu des réponses doit autoriser application/zip sur api/joblog.
  • Docker : récupérez l’image 2027.2.34 et démarrez un nouveau conteneur sur les mêmes volumes.

2027.2.33 (2026-11-16) : HQbird 2027 comparé à HQbird 2024

État du code source au 2026-11-16. Le kit publié était 2027.2.33 (2026-11-16). Cette partie donne la vue d’ensemble par rapport à HQbird 2024.

1. Résumé

  • L’outil Java FBDataGuard est remplacé. Son travail est maintenant fait par un service, fbagent, et par une console web, HQbird Monitor.
  • Nouveau : HQbird Cluster. Un gestionnaire de cluster (RCM) et un nœud sur chaque serveur donnent la configuration des réplicas depuis une page web, le switchover, le failover et le rejoin.
  • Nouveau : HQCenter. Votre propre serveur central pour de nombreux serveurs HQbird : une seule console, la distribution de configuration, les mises à jour, les licences, la surveillance des problèmes.
  • Nouveau : fbmcp. Un serveur MCP qui permet à un assistant IA de travailler comme DBA Firebird. Les changements critiques exigent l’approbation d’une personne extérieure au client IA.
  • Nouveaux installateurs. Un installateur hors ligne par version majeure de Firebird, pour Windows (.exe) et Linux (.run), avec plusieurs versions majeures de Firebird et plusieurs instances sur un même serveur. Images Docker pour chaque version majeure.
  • Nouvelles licences. Fichiers de licence signés, un essai sans inscription pendant 7 jours, zones de licence EU / RU / BR.
  • Mises à jour automatiques de l’agent, de HQbird Monitor, de fbmcp, des programmes du cluster et de Firebird, avec vérification des signatures et retour arrière.
  • Moteur. Index NGRAM, vues matérialisées, CREATE INDEX CONCURRENTLY, CREATE TABLE AS SELECT, options de trace avancées, une limite de connexions par base de données, connexion Active Directory sous Linux.

2. Composants : 2024 et 2027

HQbird 2024 HQbird 2027
FBDataGuard (Java, console web sur le port 8082) fbagent (service) + HQbird Monitor (console web) + éditeur de configuration dans le Monitor
Advanced Monitoring Viewer (AMV), outils de bureau Pages de HQbird Monitor : tableau de bord, rapport de performance, erreurs, conflits, statistiques
Réplication réglée à la main ou dans FBDataGuard, failover manuel HQbird Cluster : RCM + nœud, switchover, failover, routeurs
Pas de serveur central HQCenter (Linux) pour un parc de serveurs
Pas d’outils d’IA fbmcp, un serveur MCP avec environ 120 outils
Un installateur Windows avec des composants, un script Linux Un installateur hors ligne par version majeure de Firebird, .exe et .run, images Docker
Activation par e-mail et mot de passe Fichier de licence signé, essai, zones de licence
Alertes par e-mail depuis FBDataGuard E-mail depuis la surveillance d’état de HQCenter ; Telegram, webhooks et e-mail depuis l’agent

3. Versions

Composant Version dans le kit 2027.2.33
Firebird (builds HQbird) 2.5.9.27194, 3.0.15.33893, 4.0.8.3332, 5.0.5.1917
fbagent 3.4.0
HQbird Monitor 1.57.0
Éditeur de configuration (dans le Monitor) 1.61.0
HQbird RCM / nœud de cluster 2027.5.12
fbmcp 2027.2.24
HQCenter (goafts, site stack) 1.22.0
fblogspacker (dans fbagent) 1.5.12

4. Moteur Firebird (builds HQbird)

Les builds HQbird de Firebird ont des fonctionnalités au niveau du serveur (plugins et modifications du cœur) que vanilla Firebird de la même version ne possède pas. Le tableau montre chaque fonctionnalité et les versions majeures de Firebird qui l’ont. La source est la page Améliorations de HQbird 2027 au niveau du serveur.

Fonctionnalité Ce qu’elle apporte Paramètre Versions majeures
Index NGRAM Recherche de sous-chaîne indexée (LIKE '%search%') pour VARCHAR et les BLOB de texte - 5.0
Vues matérialisées CREATE MATERIALIZED VIEW, pour la BI et les requêtes complexes. Utilise l’insertion en masse - 5.0
Table résultat d’une requête CREATE TABLE AS SELECT. Utilise l’insertion en masse - 5.0
Création d’index sous charge CREATE INDEX ... CONCURRENTLY : la table reste disponible - 5.0
Tables MON$ plus rapides Désactive la collecte des données qui ne sont pas nécessaires FillMonCompiledStatements, FillMonStatements, FillMonCallStack 5.0
Migration facile vers 5.0 Les littéraux de l’ancien style sont reconnus ; COUNT(*) est décrit comme INT pour les anciennes applications LegacyTimeLiterals, LegacyIntForCount 5.0
Authentification GSSAPI/SSPI Plugin gssauth pour Active Directory ; serveurs et clients Windows et Linux - 5.0
Pas de journalisation des erreurs INET Les erreurs réseau ne sont pas écrites dans firebird.log DisableLogNetIOErrors 5.0
Surveillance allégée Suivi de l’état du serveur sans charge MonitoringPlugin 2.5, 3.0, 4.0, 5.0
Limite de connexions à une base de données Protection contre les pics de connexions WarnCountAttachments, MaxCountAttachments 3.0, 4.0, 5.0
Options de trace avancées Suivi des conflits (interblocages) et des modifications (par exemple, un audit des changements) - 3.0, 4.0, 5.0
Substitution de requête à la volée Le serveur remplace le texte de la requête. Le nouveau texte est visible dans la trace et dans MON$ SqlSubstDirectory 2.5, 3.0, 4.0, 5.0
Cache de BLOB dans l’espace temporaire Les BLOB sont 15-200% plus rapides BlobTempSpace 2.5, 3.0, 4.0, 5.0
Journal des requêtes à grand tri Le texte de la requête est écrit dans firebird.log TempSpaceLogThreshold 2.5, 3.0, 4.0, 5.0
Sources de données externes : MySQL et ODBC EXECUTE STATEMENT ... ON EXTERNAL vers MySQL et ODBC - 3.0, 4.0, 5.0
Streaming / CDC (Kafka, RabbitMQ, JSON, Mongo) Envoie les INSERT/UPDATE/DELETE des tables choisies, à partir de la réplication. Sur demande - 4.0, 5.0
Recherche plein texte (Lucene) UDR open source, et un plugin fondé sur le streaming - 3.0, 4.0, 5.0
Auto-correction des paramètres de cache Corrige les mauvaises valeurs de DefaultDbCachePages dans firebird.conf / databases.conf DefaultDbCachePages, MinDbCachePages, MaxDbCachePages 4.0, 5.0
Masquage de la version HQbird Définit si l’API Firebird renvoie la chaîne de version HQbird HQbirdVersionString 2.5, 3.0, 4.0, 5.0
Chiffrement de base de données (plugin) AES-256, surcoût de 4-20%. Sur demande - 3.0, 4.0, 5.0
Optimiseur de JOIN Les jointures internes implicites deviennent explicites LeftJoinConversion 3.0, 4.0
Cache des requêtes préparées Les requêtes préparées restent dans la mémoire de la connexion DSQLCacheSize 3.0, 4.0
Sauvegarde, restauration, sweep et création d’index multithread Sauvegarde et sweep jusqu’à 4-6x plus rapides, restauration 2-4x plus rapide (8 cœurs, SSD) - 2.5, 3.0, 4.0
Réplication native Plugin ; les enregistrements sans PK/UK peuvent être exclus - 2.5, 3.0
Optimiseur des grands tris Plan refetch SortDataStorageThreshold 2.5, 3.0
Lecture parallèle des données make_dbkey() et un snapshot partagé - 2.5, 3.0
Pool de connexions externes Requêtes externes parallèles vers Firebird ExtConnPoolSize, ExtConnPoolLifeTime 2.5, 3.0
Sauvegardes vers Amazon S3 (plugin) Sur demande - non indiqué

5. fbagent : l’agent qui remplace FBDataGuard

Un agent sert une instance Firebird. Plusieurs agents peuvent tourner sur un même hôte. L’agent fonctionne avec Firebird 2.5, 3.0, 4.0 et 5.0 sous Windows et Linux.

5.1 Sauvegardes

  • Sauvegarde vérifiée (gbak) pour une base de données ou un groupe de bases dans des dossiers, avec une restauration de test facultative.
  • nbackup incrémental, niveaux 0 à 4, en mode simple, avancé ou de groupe.
  • Mode plan de nbackup : des règles donnent le niveau, les jours et l’heure. L’éditeur montre un calendrier et une prévision de stockage. La rétention conserve un niveau 0 avec ses incréments.
  • Cycle sauvegarde-restauration : sauvegarde, restauration et échange de la base en service, avec retour arrière après un plantage.
  • Tâches de restauration depuis .fbk ou .nbk, en local ou depuis S3.
  • Compression : deflate, zip, gz, zstd.
  • Chiffrement : archives zip AES-256 avec séquestre de la clé.
  • Cloud : sauvegarde en flux vers S3 sans fichier local ; copie vers S3 et FTP/FTPS.
  • Inventaire des sauvegardes : un enregistrement de chaque fichier de sauvegarde et de chaque restauration, avec la taille, l’heure et le résultat de la vérification.
  • Historique des commandes : jusqu’à 50 lancements par tâche, avec les journaux gbak.

5.2 Maintenance

  • Sweep, statistiques d’index, validation gfix, scripts SQL avec une fenêtre d’exécution, suivi des métadonnées.
  • Une planification cron et une fenêtre d’exécution pour chaque tâche.
  • Exécuter maintenant pour les tâches importantes : en local, ou à distance par HQCenter, avec la progression et l’annulation.
  • Un test de vitesse de disque dans une fenêtre de nuit.

5.3 Contrôles de santé

  • État du serveur environ toutes les 10 minutes. Chaque constat a un niveau, une ligne de preuve et une indication. L’état montre les tendances (par exemple, le temps avant qu’un disque soit plein) et nomme la transaction ou le programme à l’origine d’un problème.
  • Métriques de l’hôte : CPU et mémoire par programme, latence du disque et IOPS par disque, quel service utilise le disque, bases de données dans le cache de l’OS.
  • Limites Linux : TasksMax, NPROC, NOFILE, OOM kills.
  • Espace disque : planchers d’espace libre et détection d’un remplissage rapide.
  • Journaux : firebird.log et replication.log sont classés par signature, par exemple une corruption probable.
  • État de la base depuis la page d’en-tête : arrêt, verrou nbackup, réplica, lecture seule.
  • Mode Firebird : SuperServer, SuperClassic ou Classic, avec un constat lorsqu’un changement de mode attend un redémarrage.
  • Prometheus /metrics, point d’accès avec un jeton.
  • Un garde-fou de ressources limite le CPU et la mémoire de l’agent lui-même. Il ne met jamais une sauvegarde en pause.

5.4 Performance

  • Trace continue avec un watchdog.
  • Rapport de performance par fenêtre de temps : classements par durée, fréquence, temps total, fetches, lectures et écritures ; plans, procédures, déclencheurs ; qui a exécuté une requête, quand et depuis où ; exécutions en échec.
  • Rapport de performance à la demande pour une plage et une base choisies.
  • Conflits de verrou et interblocages avec le SQL des deux côtés.
  • Erreurs de trace par classe, avec l’application cliente et l’adresse.
  • Surveillance allégée par le plugin fblwmon.

5.5 Configuration

  • L’agent recharge sa configuration sans redémarrage : validation, copie de sauvegarde, et retour arrière en cas d’erreur.
  • Éditeur de databases.conf (aliases.conf sur 2.5) : contrôles selon la version du moteur, une copie de sauvegarde avant l’enregistrement, les commentaires sont conservés.
  • Utilisateurs : la liste des utilisateurs d’une base de sécurité, et Créer un utilisateur.
  • Distribution de configuration depuis HQCenter, avec un état pour chaque changement : envoyé, appliqué, rejeté, dérive.

5.6 Envoi des journaux (fblogspacker)

  • L’agent n’envoie à HQCenter que les données nouvelles : la nouvelle fin de firebird.log et de replication.log, les fichiers de trace et de surveillance par minute, les métriques, l’état du serveur.
  • Les archives ont un plafond de taille (120 MiB par défaut). Les gros fichiers partent en morceaux.
  • Les sauvegardes et les bases de données ne sont jamais envoyées.

6. HQbird Monitor : la nouvelle console web

Une console par instance Firebird (port 20000 + le port Firebird, par exemple 23050), ou une console centrale pour tous les serveurs d’un HQCenter.

  • Serveurs : tous les serveurs avec l’état, la version et le mode Firebird, la version de l’agent, la licence, et de petits graphiques.
  • Tableau de bord : CPU, mémoire, connexions ; CPU par programme ; qui utilise le disque et la mémoire ; fichiers temporaires ; espace disque, latence et vitesse ; un tableau des bases avec des badges d’état. Un clic sur une minute montre cette minute.
  • Rapport de santé du serveur : une matrice de 18 systèmes sur 24 heures, 7 jours ou 14 jours ; une chronologie des problèmes ; constats par domaine ; tableaux pour les disques, les transactions, la réplication, les erreurs, les requêtes et les sauvegardes. Des boutons d’action ouvrent la correction dans l’éditeur.
  • Page de base de données : graphiques de surveillance, d’E/S et de transactions ; principales requêtes et connexions pour une minute choisie.
  • Perf Report : 10 classements, exécutions par heure, une comparaison de deux fenêtres, un historique de 30 jours d’une requête, un rapport à la demande.
  • Erreurs et conflits : erreurs de trace avec export CSV ; conflits de verrou et interblocages par minute.
  • Statistiques : analyse gstat avec recommandations, tendances et prévisions, export Excel et JSON.
  • Journaux et configurations : firebird.log et replication.log par jour, avec des filtres ; l’historique des changements des fichiers .conf.
  • Tâches, sauvegardes, activité : l’éditeur de configuration intégré et l’inventaire des sauvegardes.
  • Licences, mises à jour, utilisateurs, clusters, paramètres.
  • Page Notifications (le bouton est sur la page Serveurs) : qui envoie (l’agent, le HQCenter, les deux ou personne), les canaux, les messages de test, l’identifiant de conversation d’un bot Telegram, les 50 derniers envois. La page ne montre jamais un jeton, une URL ou un mot de passe enregistré.
  • Langues : anglais, russe, allemand, portugais du Brésil, espagnol.
  • Accès : une seule connexion ou plusieurs utilisateurs avec une liste de serveurs et un rôle d’administrateur ; un journal d’audit ; thèmes clair, sombre et contraste élevé ; un mode démo qui masque les noms et les littéraux SQL. Cela fonctionne sans Internet.

7. HQbird Cluster : RCM et nœud

HQbird 2024 avait la réplication, mais pas de gestionnaire de cluster. HQbird 2027 en ajoute un.

  • Parties. Un nœud à côté de chaque instance Firebird, et un RCM par cluster, avec une console web (HTTPS, port 7444), une ligne de commande et une API.
  • La réplication est asynchrone. Firebird 4.0 et 5.0 utilisent la réplication native. HQbird 2.5 et 3.0 utilisent le plugin de réplication.
  • Un cluster sans HQCenter. fbagent --cluster-init crée le RCM et le premier administrateur. La page Lier les hôtes joint les autres serveurs avec un jeton à usage unique. Le cluster est arrêté par défaut ; vous l’activez à l’installation ou depuis HQbird Monitor.
  • Configuration des réplicas depuis la console : inscrire une base, définir la publication, initialiser. La copie est faite avec nbackup. Réinitialisation en douceur attend les longues transactions d’écriture. Le nœud n’écrase jamais une base en service.
  • Reprise des bases qui répliquent déjà depuis une configuration faite à la main.
  • Plusieurs réplicas d’un même maître.
  • États et retard pour chaque base (à jour, en retard, à réinitialiser, et d’autres), chacun avec une raison.
  • Vérification : une comparaison du nombre de lignes entre le maître et le réplica, à la demande ou selon une planification.
  • Services : une base logique sur plusieurs hôtes.
    • Switchover sans perte de données, puis l’ancien maître revient comme réplica.
    • Failover manuel lorsque l’hôte maître est perdu, avec un rapport de perte de données.
    • Failover automatique par service, arrêté par défaut. Il exige des routeurs.
    • Routeurs (HAProxy, Linux) donnent aux clients une adresse stable.
  • Console : 6 langues, un rôle de lecteur seul, un journal d’audit, des alertes avec un guide d’exploitation pour chaque code.
  • Canaux d’alerte (Telegram, webhooks, e-mail) pour les problèmes de gravité warn et au-dessus. La page Alertes a un bouton Test pour chaque canal.
  • Sécurité : TLS mutuel sous une autorité de certification du cluster, renouvellement automatique des certificats, versions signées.

Limites : pas de réplication synchrone par le cluster ; seules les tables avec une clé primaire ou unique sont publiées ; au plus 3 hôtes par cluster selon la licence ; un RCM par cluster ; routeurs sous Linux seulement. Le switchover a été testé en laboratoire sur Firebird 5.0 sous Linux.

Guides : guide du cluster, guide d’exploitation du cluster.

8. HQCenter : un serveur central pour de nombreux serveurs HQbird

  • Ce que c’est. Un serveur Linux dans votre réseau. Les agents s’y inscrivent et y envoient leurs données. Il a un HQbird Monitor central et un panneau d’administration.
  • Installation par une seule commande sur Ubuntu 22.04 / 24.04 / 26.04 ou AlmaLinux 9 / 10. Un réseau fermé est pris en charge : installation depuis un paquet que vous apportez.
  • Inscription : l’agent crée sa propre clé. Un opérateur l’approuve, ou un jeton de licence l’approuve tant qu’il reste des sièges libres. Tout le trafic des agents utilise le TLS mutuel.
  • Tableau du parc : versions de l’agent et de Firebird, dernier contact, canal de publication.
  • Distribution de configuration vers les agents, avec historique et restauration. Lancez maintenant les tâches importantes sur n’importe quel serveur.
  • Mises à jour du parc : l’agent, HQbird Monitor, les programmes du cluster et Firebird viennent du catalogue HQCenter. Les signatures de l’éditeur sont vérifiées.
  • HQCenter se met à jour lui-même depuis une pile signée, avec des contrôles et un retour arrière automatique. Le propriétaire peut le désactiver.
  • Surveillance d’état : problèmes nouveaux, aggravés et clos de tous les serveurs, avec e-mail et un rapport hebdomadaire. Canaux Telegram, webhook et SMTP, heures de silence et événements « serveur silencieux ».
  • Licences : téléversement, attribution aux agents, nombre de sièges.
  • Audit des requêtes : qui a changé quoi sur un serveur.
  • API avec des jetons à périmètre limité ; métriques Prometheus et un tableau de bord Grafana pour HQCenter lui-même.
  • Panneau d’administration en 4 langues : anglais, portugais du Brésil, russe, allemand.

Guide : site-install.md.

9. fbmcp : outils Firebird pour les assistants IA

  • Un serveur MCP sur l’hôte de la base. Un client IA (par exemple Claude Desktop ou Claude Code) s’en sert pour inspecter et administrer Firebird 2.5 à 5.0.
  • Environ 120 outils : requêtes avec plan et statistiques, schéma, sessions, conseils d’index, gstat, tendances ; sauvegarde, restauration de test, validation, sweep ; DDL et migrations ; utilisateurs et droits ; trace ; firebird.conf ; un planificateur ; environ 30 outils pour fbagent (état, rapports, tâches, licence, mises à jour) ; le cluster (lier, inscrire, réinitialiser, vérifier, switchover, failover).
  • Sécurité par niveaux :
    • La lecture n’exige pas d’approbation. Elle s’exécute dans une transaction en lecture seule.
    • Un changement ordinaire est confirmé dans le client IA avec un jeton à usage unique.
    • Un changement à fort impact n’est approuvé qu’en dehors du client IA (une fenêtre dans la zone de notification sous Windows, ou une commande sur le serveur). Il exige aussi une fenêtre de maintenance ouverte et une sauvegarde vérifiée de moins de 24 heures.
    • La suppression d’une base de données est désactivée.
  • Chaque décision va dans un journal d’audit.
  • Les installateurs HQbird installent fbmcp par défaut, pour un usage local seulement. L’usage à distance exige HTTPS et une clé d’API.

10. Installateurs

Windows

  • Quatre installateurs, un par version majeure de Firebird (fb25, fb30, fb40, fb50). Chacun est hors ligne : tous les fichiers sont dedans.
  • Chaque installateur installe Firebird, fbagent, HQbird Monitor et fbmcp. Les programmes du cluster sont copiés et restent arrêtés jusqu’à ce que vous les activiez.
  • Plusieurs versions majeures de Firebird sur un même serveur, et plusieurs instances d’une même version majeure.
  • Pages de l’assistant pour l’essai, un fichier de licence, la connexion à HQCenter et les mises à jour automatiques.
  • Installation silencieuse avec une option pour chaque page.
  • 8 langues d’assistant : anglais, portugais du Brésil, allemand, russe, espagnol, polonais, turc, chinois simplifié.
  • L’installateur et le programme de désinstallation ont une signature Authenticode.
  • La désinstallation retire une instance ou toutes. Les bases de données sont toujours conservées.

Guide : Guide d’installation de HQbird sous Windows.

Linux

  • Un fichier .run hors ligne par version majeure de Firebird. Seuls les paquets manquants du système d’exploitation sont téléchargés.
  • Hôtes : x86_64 avec systemd et apt, dnf/yum ou zypper (Ubuntu, Debian, AlmaLinux, Rocky, RHEL, Oracle Linux, openSUSE, RED OS). SELinux en mode enforcing fonctionne.
  • Interface texte en plein écran par défaut, en anglais, russe, portugais du Brésil et allemand. --no-tui donne le mode texte simple.
  • Plusieurs instances sur un même hôte (Firebird 2.5 : une seule instance).
  • Installation sans intervention avec --yes et des options.

Guide : Guide d’installation de HQbird sous Linux.

Docker

  • Images publiques ghcr.io/ibsurgeon/hqbird2027-fb25, -fb30, -fb40, -fb50. Un conteneur contient une instance avec tous les composants.
  • Les images sont signées avec cosign.
  • Rôle de cluster HQBIRD_CLUSTER_ROLE=master|replica avec des fichiers compose.
  • Les dossiers de l’image sont fermés aux autres utilisateurs, et un nouveau conteneur conserve le compte RCM.

Guide : Guide Docker.

11. Licences et essai

  • Fichiers de licence signés. L’agent vérifie la signature de l’éditeur. La licence n’arrête jamais une base de données.
  • Essai : 7 jours sans étape réseau. Un e-mail professionnel et un code à 6 chiffres le prolongent jusqu’à 30 jours.
  • Zones de licence EU, RU et BR, chacune avec ses propres clés.
  • Hors ligne : un fichier de licence à l’installation ; l’installateur Windows peut créer un fichier de demande de licence.
  • Avec HQCenter : les licences sont téléversées une fois et attribuées aux agents.
  • Une nouvelle licence arrive d’elle-même. Un agent qui a obtenu sa licence par une demande d’essai interroge le serveur de licences de l’éditeur une fois par heure. Il installe la licence que le serveur a pour lui : un essai plus long, une licence payante créée à partir de l’essai, ou la période suivante d’un abonnement. Rien n’est à faire sur le serveur. Les serveurs de licences de l’éditeur commencent à fournir ces licences progressivement.
  • Une demande d’essai peut aussi être envoyée après les 30 jours de l’essai : l’adresse e-mail peut appartenir à un client qui a une licence.

12. Mises à jour automatiques

  • L’agent se met à jour lui-même. Il vérifie la signature de l’éditeur, refuse une version plus ancienne et peut revenir en arrière.
  • L’agent met à jour HQbird Monitor, fbmcp, les programmes du cluster et Firebird. Une mise à jour de Firebird comporte une sauvegarde, une fenêtre d’application, un contrôle de santé et un rétablissement.
  • Avec HQCenter : les mises à jour viennent du catalogue HQCenter selon le canal de publication.
  • Sans HQCenter : les mises à jour viennent de la zone de l’éditeur. Modes : all, agent (Firebird attend l’administrateur), off. La page Mises à jour de HQbird Monitor montre l’état.

13. Alertes et notifications

  • La surveillance d’état de HQCenter envoie un e-mail au sujet des problèmes du parc. La console du cluster montre les alertes.
  • L’agent envoie ses propres messages sur les problèmes du serveur : quand un problème est nouveau, quand il s’aggrave et quand il a disparu. Tous les changements d’un même contrôle d’état vont dans un seul message.
  • Les canaux sont un bot Telegram à vous, des webhooks (Slack, Teams, Discord, Mattermost, Rocket.Chat, ntfy) et l’e-mail (SMTP), avec un filtre de gravité et des heures de silence. Vous pouvez avoir plusieurs canaux. Rien n’est envoyé tant que vous n’ajoutez pas un canal.
  • Résumé quotidien : un message par jour avec les problèmes ouverts (notify.daily_summary, arrêté par défaut).
  • Avec plusieurs agents sur une même machine, un seul d’entre eux envoie les problèmes de la machine elle-même (disque, mémoire).
  • Deux commandes de l’agent : --notify-history [N] affiche les derniers envois, --notify-test <channel> envoie un message de test.
  • L’agent n’envoie rien tant que sa licence ne l’y autorise pas.
  • Bot Telegram HQbird : un serveur ou un HQCenter avec une licence valide relie une conversation avec un code à usage unique. Aucun bot personnel n’est nécessaire. Les serveurs de l’éditeur ne proposent pas encore ce service ; en attendant, utilisez votre propre bot Telegram, un webhook ou l’e-mail.
  • RCM envoie les alertes du cluster vers les mêmes types de canaux (notify.channels dans rcm.json).

14. Sécurité

  • TLS mutuel pour les agents, HQCenter et le cluster.
  • Versions signées : l’agent refuse une mise à jour sans signature valide de l’éditeur.
  • Authenticode sur les installateurs et les programmes Windows ; cosign sur les images Docker.
  • Chiffrement AES-256 des archives de sauvegarde.
  • Les secrets restent hors des lignes de commande et des instantanés de configuration.
  • Un journal d’audit des requêtes sur l’agent ; des journaux d’audit dans HQbird Monitor, HQCenter, RCM et fbmcp.
  • Les commandes à distance peuvent être désactivées sur un serveur (--remote-commands off).

15. Mise à niveau depuis HQbird 2024

  • L’installateur 2027 trouve HQbird 2024, met Firebird à jour sur place et conserve l’ancien dossier comme copie.
  • Les tâches de FBDataGuard sont importées une fois, au premier démarrage : gbak, nbackup (niveaux 0 à 4), sauvegarde de groupe, sweep et statistiques d’index. L’agent poursuit les jeux de sauvegarde existants.
  • Non importés : réplication, trace, transfert de fichiers, sauvegarde cloud, restauration, validation. Réglez-les de nouveau dans l’éditeur.
  • La licence 2024 n’est pas transférée. Le nouvel agent démarre en mode essai. Installez une licence 2027.
  • Retirés : la console FBDataGuard sur le port 8082, AMV, la sauvegarde VSS, le serveur FTP, l’envoi SFTP.
  • Scripts de l’installateur 2024 : les options qui ont un équivalent 2027 sont acceptées. Les autres options sont refusées avec un message qui nomme le remplacement.
  • L’import inscrit les bases de données de FBDataGuard dans le fichier d’alias de Firebird (databases.conf, ou aliases.conf sur Firebird 2.5). L’ancien fichier est d’abord copié. Une base est laissée de côté lorsque son chemin est déjà dans le fichier ou que son fichier n’existe pas. Un fichier avec une directive include n’est pas modifié.
  • L’import retire les anciens journaux de surveillance de FBDataGuard (les dossiers mon\outcoming et mon\outtrace). Rien n’est retiré tant qu’un service de l’ancien HQbird tourne. Le retrait ne peut pas être annulé.
  • Les deux sont activés par défaut. Pour les désactiver, mettez hqbird_import.register_databases ou hqbird_import.clean_mon_logs à false, ou utilisez --no-register-databases et --no-clean-mon-logs avec --import-hqbird-config.