Installation et mises à jour
Installation sans surprises
Un installateur par version de Firebird. Il détecte Firebird, l'ancien HQbird et les agents sur le serveur, affiche un plan et ne change rien tant que vous n'avez pas dit « Oui ». Ensuite, l'agent se met à jour lui-même, ainsi que la console et Firebird, avec des vérifications et un retour arrière.
- 4 installateurs : Firebird 2.5 · 3.0 · 4.0 · 5.0
- 0 modification avant confirmation du plan
- aucun accès internet nécessaire tout dans un seul fichier
- Windows et Linux assistant, mode silencieux, .run
- retour arrière si une installation ou une mise à jour échoue
setup.exe · .run
Contenu du kit
L'installateur est un seul fichier : hqbird2027-fb50-setup-<version>.exe pour Windows ou hqbird2027-fb50-linux-<version>.run pour Linux. Il contient tout ce dont le serveur a besoin. Rien n'est téléchargé.
Chaque installateur installe une version de Firebird. Choisissez la version sur laquelle tournent vos bases de données. L'installation est effectuée par l'agent contenu dans le kit : il vérifie le serveur, établit un plan et l'exécute.
| Composant | Rôle | Windows | Linux |
|---|---|---|---|
| Firebird, build HQbird | Un nouveau serveur ou une mise à jour sur place. Pour un serveur déjà installé, une ligne est ajoutée à firebird.conf : MonitoringPlugin = fblwmon. Pour un nouveau serveur, l'installateur définit aussi le port. databases.conf, la base de sécurité et le mot de passe SYSDBA ne changent pas. | service FirebirdServer… | /opt/firebird |
| agent fbagent | Sauvegardes, supervision, maintenance, mises à jour. | HQbirdFBAgent-fb50 | hqbirdfbagent-fb50, utilisateur firebird |
| HQbird Monitor | Console web pour ce serveur. Port = 20000 + port Firebird : pour 3050, c'est 23050. Le port est choisi à l'installation et ne change pas ensuite, même si vous changez le port Firebird. | HQbirdMonitor-fb50 | hqbirdmonitor-fb50 |
| Composants de cluster | Les programmes de cluster sont placés sur le serveur mais ne sont pas activés : RCM et la fenêtre d'appairage sont désactivés par défaut. RCM fait du serveur le centre d'un nouveau cluster et ouvre les ports 7443 et 7444. La fenêtre d'appairage ouvre les ports 7450–7459 pendant 24 heures : via elle, le RCM d'un autre serveur peut inviter ce serveur. Vous pouvez aussi activer les deux après l'installation. | page de l'assistant « Replication and cluster setup » ; /RCM, /DISCOVERY | --rcm on, --cluster-pairing on |
| serveur MCP fbmcp | Accès des clients IA à Firebird. Par défaut, uniquement depuis ce serveur. | case à cocher dans l'assistant ou /NOFBMCP | --no-fbmcp |
| Fichiers de débogage Firebird | Symboles pour analyser les plantages de Firebird. | — | oui, --no-debug les désactive |
- WindowsPris en charge : Windows 10 et 11, Windows Server 2016 et versions ultérieures, 64 bits. Droits d'administrateur. L'installateur est signé par IBSurgeon Software : Windows affiche l'éditeur dans l'invite de droits.
- Assistant ou mode silencieuxChaque page de l'assistant est aussi disponible sous forme de commutateur :
/VERYSILENT /YES /LOG=…. Pratique pour les scripts et pour une centaine de serveurs. - Assistant en 8 languesAnglais, portugais (Brésil), allemand, russe, espagnol, polonais, turc, chinois simplifié. Par défaut, la langue de Windows. Commutateur :
/LANG=en|pt_BR|de|ru|es|pl|tr|zh_CN. - Nom du serveurL'assistant demande le nom du nouvel agent ; HQCenter affiche le serveur sous ce nom. Par défaut, le nom de l'ordinateur. Mode silencieux :
/AGENTID=, sous Linux--agent-id. Un agent déjà installé conserve son nom.
- Linuxx86_64, noyau 3.2 ou ultérieur, systemd, root. Ubuntu, Debian, AlmaLinux, Rocky, RHEL, Oracle Linux, openSUSE, RED OS et autres avec apt, dnf, yum ou zypper.
- Serveur sans internetL'installateur récupère quelques bibliothèques du système d'exploitation (libtommath, ICU) depuis le dépôt. S'il n'y a pas de dépôt, il affiche les commandes exactes et ne change rien.
Le kit est vérifié deux fois. Avant le déballage : le sha256 du kit entier. Avant l'installation de Firebird et de l'agent : la signature de chaque fichier. Un téléchargement endommagé arrête l'installation avant toute modification de Firebird, de l'agent ou de la console.
fbagent --install-plan
D'abord le plan, ensuite les modifications
D'abord, l'installateur ne fait que lire : services, registre, dossiers Firebird et HQbird. Ensuite, il affiche ce qu'il a trouvé et ce qu'il va faire. Les modifications commencent après votre « Oui ».
Sélectionnez ce qui se trouve sur le serveur et consultez le plan. Les textes sont raccourcis et traduits ; l'ordre et les décisions sont les mêmes que dans l'installateur Firebird 5.0.
- 1Vérification du serveurdroits, architecture ; sous Linux aussi systemd et le noyau
- 2Vérification du kitsha256 avant le déballage ; signatures des fichiers avant l'installation
- 3Plance qui a été trouvé et ce qui sera fait
- 4Questionsnom du serveur pour HQCenter ; arrêter Firebird ? une autre version ?
- 5InstallationFirebird, agent, console, services
- 6✓ Résultatservices, adresse de la console, identifiant
En cas de problème
Un refus au stade du plan (port utilisé, dossier non vide) ne change rien : l'installateur indique la raison. Dans l'assistant, vous ne pouvez pas quitter une page tant qu'une valeur est incorrecte.
Un échec pendant l'installation, avant le démarrage du service de l'agent : les services reviennent à leur état précédent. L'ancien HQbird, s'il a été arrêté, redémarre.
| Code | Signification (.run Linux) |
|---|---|
| 0 | Terminé |
| 1 | Refusé : serveur, commutateur ou plan. Rien n'a changé |
| 2 | Échec de l'installation, modifications annulées |
| 3 | Retour arrière incomplet : le résultat indique quoi vérifier |
| 4 | Réponse requise : pas de terminal et pas de --yes |
| 5 | Échec de la vérification du kit : téléchargez-le à nouveau |
| 6 | Pas de bibliothèques système d'exploitation et pas de dépôt |
| 7 | Firebird provenant des paquets de la distribution |
| Code | Signification (setup.exe Windows) |
|---|---|
| 0 | Installé |
| 1 | Refusé avant l'installation : commutateur ou fichier incorrect, une version plus récente est installée, pas de droits d'administrateur |
| 4 | L'installateur avait une question, mais il n'y a pas de commutateur /YES |
| 7 | Échec de la vérification du serveur ou de l'installation. La raison figure dans le journal et dans le fichier de résultat |
| 10 | Installé, mais la connexion à HQCenter a échoué |
-p3050) ; les nouvelles installations reçoivent -fb50.FBDataGuard → fbagent
Passer de HQbird 2024
L'installateur détecte l'ancien HQbird et le Firebird qu'il dessert. Ce Firebird est mis à jour sur place, les tâches FBDataGuard passent à l'agent, les anciens services sont arrêtés. Les bases de données, les configurations et les mots de passe sont conservés.
- Ce qui ne change pas
databases.confoualiases.conf, la base de sécurité, le mot de passe SYSDBA, les bases de données, les sauvegardes et les anciens fichiers HQbird. Dansfirebird.conf, seule la ligneMonitoringPlugin = fblwmonest ajoutée, si elle manque. - Copie de l'ancien FirebirdLe dossier du programme de l'ancien Firebird est conservé à côté sous le nom
<folder>.old_<time>. - TâchesSauvegardes gbak et nbackup, sweep, statistiques d'index. L'import s'exécute une fois et passe par la vérification de la nouvelle configuration ; l'ancienne configuration est conservée.
- Anciennes sauvegardesL'agent reprend les sauvegardes des journaux FBDataGuard dans ses propres enregistrements. Les règles de rétention et la restauration les voient de la même manière que les nouvelles. Les noms des niveaux nbackup restent les mêmes.
- Noms des tâchesLe nom de la tâche se termine par le nom de la base de données issu de FBDataGuard, par exemple « Verified backup - MANUAL ». Les tâches de groupe reproduisent l'arborescence des dossiers source.
- Anciens services : trois optionsAutomatique (recommandé) : les désactiver lorsque chaque Firebird desservi par FBDataGuard dispose d'un agent. Tout désactiver :
/DISABLEHQBIRD. Laisser tel quel :/NOHQBIRD. - Retour possibleL'état de chaque service avant sa désactivation est enregistré dans
fbagent-hqbird-takeover.json. Avec ce fichier, l'ancien HQbird peut être réactivé. - LicenceL'ancienne licence HQbird n'est pas transférée. Une période d'essai court jusqu'à l'obtention d'une nouvelle licence ou la connexion à HQCenter.
- Chemin incertainSi l'import ne peut pas développer une substitution dans un chemin FBDataGuard, il le conserve tel quel et laisse la tâche désactivée. Corrigez le chemin et activez la tâche.
Si des tâches sont importées mais que les anciens services tournent encore (par exemple, le serveur a deux serveurs Firebird sous FBDataGuard), les tâches arrivent désactivées. Ainsi, une tâche ne s'exécute pas deux fois.
Ports · dossiers · services
Plusieurs serveurs Firebird sur une même machine
Un agent par Firebird. Une nouvelle instance est installée à côté des autres, sur son propre port, avec son propre agent et sa propre console. Les instances installées ne changent pas.
Ajoutez des serveurs Firebird et voyez quels noms et ports l'installateur choisit.
- Ports par versionLe premier Firebird sur le serveur obtient 3050. Le suivant : 3052 pour 2.5, 3053 pour 3.0, 3054 pour 4.0, 3055 pour 5.0. L'installateur ne prend pas un port déjà utilisé.
- Deuxième instance de la même versionNuméro
-2dans les noms de dossier et de service. Sous Windows, c'est l'option de l'assistant « Installer une autre instance » ; le port est le premier libre dans la plage de la version.
- Mises à jour uniquement au sein d'une version5.0.x → 5.0.y. Passer de 3.0 à 5.0 signifie une seconde instance à côté de la première ; une personne migre les bases de données par sauvegarde et restauration.
- XNET sous WindowsUn Firebird qui n'est pas sur le port 3050 obtient son propre nom
IpcName = FIREBIRD_<port>. Les connexions XNET locales au second serveur fonctionnent. - Une console par agentHQbird Monitor sur 20000 + port Firebird : 23050, 23055. Un seul fichier de connexion pour toutes les instances du serveur.
- Les ports sont fixesLes ports de la console et de l'API locale de l'agent sont écrits à l'installation. Si vous changez le port Firebird plus tard, ils restent les mêmes. L'agent n'accepte pas de ports identiques.
- Cluster : un emplacement par agentChaque agent sur le serveur obtient son propre emplacement de 0 à 9 : port d'appairage 7450 + emplacement, ports de nœud 7051 + emplacement et 7061 + emplacement. Ainsi, deux agents d'un même serveur peuvent rejoindre un cluster. Le commutateur
--pairing-portdéfinit l'emplacement explicitement.
Images · compose · ports
HQbird dans Docker
Il existe une image prête pour chaque version de Firebird. Firebird, l'agent et HQbird Monitor s'exécutent dans le conteneur. L'agent installe le nœud de cluster à l'intérieur du conteneur lui-même lorsque le serveur rejoint un cluster. Il n'installe RCM que lorsque ce serveur est désigné comme RCM du cluster.
| Image | Firebird | Port Firebird | HQbird Monitor |
|---|---|---|---|
ghcr.io/ibsurgeon/hqbird2027-fb50 | 5.0 | 3050 | 23050 |
ghcr.io/ibsurgeon/hqbird2027-fb40 | 4.0 | 3050 | 23050 |
ghcr.io/ibsurgeon/hqbird2027-fb30 | 3.0 | 3050 | 23050 |
ghcr.io/ibsurgeon/hqbird2027-fb25 | 2.5 | 3050 | 23050 |
- Premier démarrageCopiez
compose.yamldepuis le kit, placez le mot de passe SYSDBA dans un fichier secret, retirez le#des lignessecrets:et exécutezdocker compose up -d. Le serveur est prêt lorsquedocker compose psaffichehealthy. - Port FirebirdLa variable
HQBIRD_FB_PORT, 3050 par défaut. HQbird Monitor écoute sur 20000 + ce port. - Signature des imagesLes images sont signées avec l'outil cosign. La clé publique pour la vérification n'est pas encore publiée.
- Plusieurs instances sur un même hôteFirebird sur 3050 + N, HQbird Monitor sur 20000 + port Firebird, nœud de cluster sur 7051 + N. Une seule instance sur l'hôte peut avoir RCM.
- Le même numéro de port à l'extérieur et à l'intérieurPubliez
3051:3051, pas3051:3050. L'agent et le cluster rapportent le port qu'ils voient à l'intérieur du conteneur. - ClusterL'adresse du membre est l'adresse de l'hôte Docker. Publiez le port du nœud et, pour RCM, les ports 7443 et 7444.
Docker publie les ports au-delà d'ufw. Une règle ufw « seulement le port 22 » ne ferme pas les ports du conteneur. Publiez le port sur une seule adresse de l'hôte ou fermez-le avec un pare-feu externe.
Cloud et Docker : paramètres, volumes, ports, mises à jourAgent · console · cluster · Firebird
Mises à jour après l'installation
Après sa connexion à HQCenter, l'agent met à jour lui-même l'agent, HQbird Monitor, les composants du cluster, fbmcp et Firebird. Un serveur sans HQCenter se met également à jour lui-même : l'agent récupère les nouvelles versions depuis le serveur de mises à jour IBSurgeon.
L'agent voit une nouvelle version de lui-même dans HQCenter en moins d'une minute. Les nouvelles versions de HQbird Monitor, fbmcp et Firebird : en moins d'une heure. Chaque mise à jour suit un même schéma : vérifier, enregistrer un point de restauration, remplacer, s'assurer que cela fonctionne. Si cela ne fonctionne pas, restaurer l'ancienne version.
Mises à jour sans HQCenter
- Ce qui se met à jour tout seulL'agent, HQbird Monitor et le serveur MCP. La vérification s'exécute toutes les 6 heures.
- Firebird attend une commandeLe paquet Firebird est téléchargé et attend. L'administrateur l'applique : avec le bouton de la page Mises à jour ou avec la commande
fbagent --firebird-update --apply. - Vous choisissez le modeLe commutateur d'installation
--auto-update all|agent|off, sous Windows/AUTOUPDATE=all|agent|off.agentest la valeur par défaut.allinstalle aussi Firebird, dans la fenêtre de mise à jour.offne vérifie rien.
- Page Mises à jour dans HQbird MonitorAffiche la source des versions de l'agent, le mode et la dernière réponse du serveur, l'état des mises à jour de Firebird, de la console et du serveur MCP. L'administrateur change le mode et applique le paquet Firebird.
- Vérification de la sourceLe serveur de mises à jour est vérifié par rapport à une clé épinglée. La signature de l'éditeur est toujours requise.
- Le cluster passe par le centreUn nœud de cluster et RCM ne se mettent pas à jour de cette manière : HQCenter ou RCM s'en charge.
Auto-mise à jour de l'agent
- Uniquement vers l'avantL'agent n'installe pas une version plus ancienne que la sienne, même obligatoire. La vérification s'exécute avant le téléchargement du premier octet. Ainsi, un faux serveur ne peut pas réintroduire un ancien build vulnérable. L'exception est une ancienne version autorisée dans la configuration propre de l'agent (
allow_downgrade_to). - SignatureLes versions sont signées avec une clé Ed25519 ; la clé publique est intégrée à l'agent. Une signature incorrecte est toujours refusée. Le mode « signé uniquement » s'active dans la configuration propre de l'agent, pas depuis le serveur.
- Restauration manuelleÀ côté de l'agent se trouve un script
rollback_to_version_NNN: il restaure l'agent et la configuration précédents et bloque la version défectueuse. Les deux derniers points de restauration sont conservés ; les plus anciens sont supprimés automatiquement. - Linux : root n'exécute que sa propre copieL'agent s'exécute en tant que
firebird. Le remplacement est effectué par une copie vérifiée dans un dossier où seul root peut écrire.
Mise à jour de Firebird
Firebird n'est mis à jour que dans sa propre ligne et uniquement vers un build plus récent. L'agent peut télécharger et préparer le paquet à tout moment, mais il n'arrête Firebird que dans la fenêtre de mise à jour.
- 1Préparationtéléchargement, signature, build pas plus ancien que le moteur
- 2Fenêtrefenêtre quotidienne ; une version obligatoire attend aussi la fenêtre
- 3Tâchesgbak, nbackup ou un script SQL est en cours : la tentative est reportée
- 4Remplacementles anciens fichiers du moteur sont mis de côté, les configurations restent
- 5VérificationFirebird démarre et répond sur son port
- 6✓ ou restaurationles anciens fichiers reviennent, le build est bloqué
| Ce qui est mis à jour | Protection | En cas d'échec |
|---|---|---|
| agent fbagent | Signature, plus récent uniquement, prêt en 180 s et 45 s d'exécution | Restauration, pause de 30 minutes ; un second échec bloque la version |
| HQbird Monitor, cluster, fbmcp | Signature, plus récent que l'installé uniquement | La version précédente reste ; les 2 dernières copies sont conservées |
| Firebird | Fenêtre, attente des sauvegardes, vérification après démarrage | L'ancien moteur revient, le build est ajouté à la liste de blocage |
Une version bloquée n'est pas réinstallée, mais la version suivante s'installe normalement. Ainsi, le serveur ne boucle pas sur « mise à jour → restauration → mise à jour ».
Dossiers · journaux · désinstallation
Où se trouvent les fichiers et comment désinstaller
Windows
C:\HQbird\ Firebird50\ Firebird 5.0, configurations, base de sécurité fbagent-fb50\ agent et HQbird Monitor agent_config.json configuration de l'agent logs\ bak\ update\ journaux, copies, cache de mise à jour C:\HQbirdData\ données de travail de l'agent et de la console config\access.properties connexion à la console C:\ProgramData\fbagent\ résultat et journal d'installation
Linux
/opt/firebird/ Firebird 5.0 (deuxième ligne : /opt/fb50) /opt/hqbird/ conf/access.properties connexion à la console, 0600 fbagent-fb50/ agent et HQ Monitor agent_config.json configuration de l'agent logs/ bak/ update/ journaux, copies, cache de mise à jour /var/lib/hqmonitor/ données de la console /var/log/fbagent/install.log journal d'installation, sans mots de passe
- La désinstallation ne touche pas à vos bases de donnéesVos bases de données et sauvegardes (
*.fdb,*.gdb,*.fbk,*.nbk) restent toujours. La suppression des données ne supprime que la base de sécurité et les exemples du paquet Firebird. - Windows« Applications » : supprime l'agent, la console, le RCM de cet agent, les règles de pare-feu et le Firebird que cet installateur a installé comme nouveau. Si d'autres agents utilisent le RCM de cet agent, l'assistant demande « Supprimer cette instance quand même ? » ; une désinstallation silencieuse nécessite
/FORCE. Un Firebird mis à jour reste. Les configurations et la base de sécurité ne sont supprimées que si vous sélectionnez « supprimer les données ».
- Linux
--uninstallsupprime les services de l'agent et de la console, le RCM de cet agent, les règles sudoers et les ports que l'installateur a ouverts dans firewalld ou ufw. L'agent quitte d'abord le cluster. Si d'autres agents utilisent son RCM, vous avez besoin du commutateur--force. Firebird reste.--remove-datasupprime aussi la configuration, les journaux et les données de la console. - Ancien HQbirdLa désinstallation de HQbird 2027 ne réactive pas les anciens services : l'administrateur en décide à l'aide du fichier d'état.
sudo sh hqbird2027-fb50-linux-<version>.run --uninstall --agent-dir /opt/hqbird/fbagent-fb50-2
← Retour à la présentation de HQbird 2027 · Santé du serveur →