HQbird 2027 pour Linux : guide d'installation
Ce guide est destiné à l’administrateur qui installe HQbird 2027 sur un serveur Linux avec l’installateur hors ligne hqbird2027-fbNN-linux-<version>.run. Il couvre une nouvelle installation, la mise à jour d’un HQbird plus ancien et d’une version antérieure de HQbird 2027, les commandes de maintenance, la connexion à votre HQCenter, l’installation non assistée (par script), et l’emplacement des fichiers après l’installation.
Les exemples montrent l’installateur pour Firebird 5.0 sur Ubuntu 24.04. Les installateurs pour Firebird 2.5, 3.0 et 4.0 fonctionnent de la même manière ; seuls la version, le port par défaut et les noms de dossiers diffèrent. L’installation sous Windows est décrite dans Installation sous Windows.
Sommaire
- 1. Ce que l’installateur installe
- 2. L’installation en un coup d’œil
- 3. Nouvelle installation
- 4. Après l’installation
- 5. Mise à jour d’un HQbird plus ancien (2024 et antérieur)
- 6. Mise à jour de HQbird 2027 vers une nouvelle version
- 7. Commandes de maintenance
- 8. Rattacher à votre HQCenter
- 9. Installation sans surveillance et scripts
- 10. Dépannage
1. Ce que l’installateur installe
Un fichier .run = une ligne Firebird. Choisissez l’installateur de la version de Firebird qu’utilisent vos bases de données :
| Installateur | Firebird qu’il installe ou met à jour | Premier Firebird sur l’hôte | Taille |
|---|---|---|---|
hqbird2027-fb50-linux-<version>.run |
Firebird 5.0 (build HQbird) | /opt/firebird, port 3050 |
environ 250 Mo |
hqbird2027-fb40-linux-<version>.run |
Firebird 4.0 (build HQbird) | /opt/firebird, port 3050 |
environ 220 Mo |
hqbird2027-fb30-linux-<version>.run |
Firebird 3.0 (build HQbird) | /opt/firebird, port 3050 |
environ 130 Mo |
hqbird2027-fb25-linux-<version>.run |
Firebird 2.5 (build HQbird) | /opt/firebird, port 3050 |
environ 80 Mo |
Chaque installateur contient, et installe sans Internet :
- Firebird (le build HQbird de cette ligne) : un nouveau serveur, ou une mise à jour sur place du Firebird de cette ligne déjà présent sur l’hôte. Vos fichiers
firebird.conf,databases.conf(aliases.confpour 2.5), la base de données de sécurité et le mot de passe SYSDBA sont conservés. - Fichiers de débogage Firebird (symboles pour l’analyse des plantages), installés dans le dossier Firebird.
--no-debugles ignore. - Agent HQbird (
fbagent) : l’unité systemdhqbirdfbagent-fb50, exécutée sous l’utilisateurfirebird, qui effectue les sauvegardes, la surveillance, les tâches de maintenance et les mises à jour. Le nom se termine par la ligne Firebird (-fb25…-fb50) ; une seconde instance de la ligne porte-fb50-2. - HQ Monitor : la console web de cette instance HQbird, unité
hqbirdmonitor-fb50, adressehttp://<server>:<20000 + Firebird port>/(pour Firebird sur le port 3050 :http://localhost:23050/). - Composants de cluster : la console de cluster RCM (
hqbirdrcm) et le nœud de cluster (hqclusternode) sont copiés dans le cache de l’agent. Les kits avec agent (fbagent) 3.1.0 et ultérieurs ne créent aucun cluster par défaut : pas de RCM, pas de fenêtre d’appairage, pas de port de cluster dans le pare-feu. Deux questions (ou--rcm on,--cluster-pairing on) les activent (« Suivant : cluster » à la section 3). Avec RCM, il est installé dans/opt/hqbirdrcmet s’exécute comme unitéhqbirdrcm; le résumé affiche son adresse sur la ligneRCM:. Le nœud reçoit son unité (par exemplehqclusternode-master-p3050) lorsque vous liez l’hôte dans RCM. Les kits à partir de 2027.2.19 avec un agent plus ancien installent RCM sur chaque serveur (--rcm offle laisse dans le cache) et ouvrent la fenêtre d’appairage. Les kits antérieurs à 2027.2.19 ne font que copier les deux composants dans le cache de l’agent : il n’y a ni unitéhqbirdrcmni ligneRCM:.
Les instances installées avant 2027.2.9 ont le port Firebird dans les noms de l’agent : dossier /opt/hqbird/fbagent-p3050, unités hqbirdfbagent-p3050 et hqbirdmonitor-p3050. Une mise à jour ne change pas ces noms. Seules les nouvelles instances reçoivent les noms -fb<NN>, de sorte qu’un hôte peut avoir les deux formes.
Prérequis : x86_64, noyau 3.2 ou plus récent, systemd ; un Linux avec apt, dnf/yum ou zypper (Ubuntu, Debian, AlmaLinux, Rocky, RHEL, Oracle Linux, openSUSE, RED OS et autres) ; root. Environ 300 Mo libres dans /var/tmp pendant l’installation (un dossier où les programmes peuvent s’exécuter ; voir --tmpdir). Quelques bibliothèques du système d’exploitation (libtommath, ICU) sont prises dans le dépôt de la distribution ; un serveur sans Internet reçoit les commandes exactes pour les préparer (section 9).
Non pris en charge : un Firebird installé à partir des paquets de la distribution (firebird3.0-server, rpm firebird). L’installateur s’arrête avant de modifier quoi que ce soit (code de sortie 7) ; supprimez d’abord les paquets (conservez une sauvegarde gbak de vos bases de données) ou utilisez l’installateur en ligne avec --import-firebird.
Plusieurs lignes Firebird sur un même serveur : chaque ligne a son propre installateur. Le premier Firebird sur l’hôte va dans /opt/firebird ; une seconde ligne va dans /opt/fb<NN> (/opt/fb50, /opt/fb40, /opt/fb30) sur le port de sa ligne : 3053 pour 3.0, 3054 pour 4.0, 3055 pour 5.0. Lorsque ce port est utilisé, l’installateur s’arrête et demande --port N. Plusieurs instances d’une même ligne (un second Firebird 5.0 sur un autre port) sont installées avec --fb-root <new folder> --port <port> (section 7). Firebird 2.5 n’a qu’une seule instance, dans /opt/firebird ; pour un second serveur à côté, utilisez une autre ligne (par exemple Firebird 5.0 dans /opt/fb50).
Un runbook pas à pas pour deux instances sur les ports 3050 et 3051, pour chaque ligne, avec des commandes à copier-coller, se trouve dans hqbird2027-linux-two-instances-runbook.ru.md (russe) et hqbird2027-linux-two-instances-runbook.pt.md (portugais).
Essai : sans licence, l’agent fonctionne en essai de 7 jours. L’e-mail d’essai (--email) le prolonge à 30 jours. Un fichier de licence (--license) ou la connexion à votre HQCenter (section 8) remplace l’essai.
Mises à jour : à partir du kit 2027.2.31 (agent 3.3.0), un serveur qui n’est rattaché à aucun HQCenter vérifie le serveur de mises à jour du fournisseur. Par défaut, l’agent, HQ Monitor et fbmcp se mettent à jour d’eux-mêmes, et un nouveau paquet Firebird est téléchargé et vous attend. --auto-update all|agent|off ou la ligne Updates de l’interface texte modifie cela (« Mises à jour sans HQCenter » à la section 4). Un serveur rattaché à un HQCenter reçoit ses mises à jour depuis ce HQCenter.
2. L’installation en un coup d’œil
La vérification du serveur et l’installation elle-même sont effectuées par l’agent HQbird que transporte l’installateur (fbagent --install-plan, fbagent --setup-install). Rien n’est téléchargé, hormis les paquets du système d’exploitation manquants. Rien n’est modifié avant la confirmation du plan : les paquets du système d’exploitation sont installés après la confirmation. Dans un terminal, les kits postérieurs à 2027.2.30 ouvrent l’interface texte (étape 3 de la section 3) ; --no-tui exécute l’installateur simple, qui pose ses questions sous forme de lignes de texte. Sans terminal et sans --yes, l’installateur s’arrête à la confirmation avec le code de sortie 4. Si l’installation échoue avant le démarrage de l’unité de l’agent, l’agent restaure les unités dans l’état où elles étaient auparavant (code de sortie 2 ; code 3 lorsque la restauration n’a pas été complète, le résumé indique quoi vérifier).
3. Nouvelle installation
Étape 1 : Télécharger l’installateur et le vérifier
KIT=hqbird2027-fb50-linux-2027.2.9.run
curl -fL -O https://ib-aid.com/download/hqbird/v2027/$KIT -O https://ib-aid.com/download/hqbird/v2027/$KIT.sha256
sha256sum -c $KIT.sha256Les autres lignes ont les mêmes noms avec fb40, fb30, fb25. Attendu : hqbird2027-fb50-linux-2027.2.9.run: OK. Un serveur sans Internet : téléchargez les deux fichiers sur un PC avec les mêmes liens et copiez-les sur le serveur (scp, une clé USB, un partage).
L’installateur vérifie également sa propre charge utile avant de décompresser quoi que ce soit : un téléchargement tronqué ou endommagé s’arrête avec le code de sortie 5 (« téléchargez-le à nouveau »).
Étape 2 : Vérifier l’hôte sans le modifier (facultatif)
sudo sh hqbird2027-fb50-linux-2027.2.9.run --check--check exécute la vérification de l’hôte, signale les bibliothèques du système d’exploitation manquantes (et les commandes pour les obtenir sur un serveur sans Internet), affiche ce que l’agent a trouvé et ce qu’il ferait, puis quitte. Rien n’est installé.
Étape 3 : Exécuter l’installateur
sudo sh hqbird2027-fb50-linux-2027.2.9.runLes kits postérieurs à 2027.2.30 ouvrent l’interface texte lorsque vous les démarrez dans un terminal : des pages plein écran avec le plan et les paramètres. Les kits jusqu’à 2027.2.30, et les cas décrits dans « L’installateur simple » ci-dessous, posent leurs questions sous forme de lignes de texte. Les deux effectuent la même installation avec les mêmes options.
L’interface texte
L’installateur vérifie l’hôte, se décompresse, lit le plan et affiche la première page. Rien sur l’hôte n’est modifié tant que vous n’avez pas lancé l’installation sur la page Install.
HQbird 2027 setup <version> | Firebird 5.0 (5.0.5.1917)
Plan M1: New Firebird and HQbird agent
Firebird: new /opt/firebird (unit firebird, port 3050)
Agent: new, in /opt/hqbird/fbagent-fb50
OS packages to install: libtommath1 (see Plan details)
Language English (auto)
Firebird folder automatic (/opt/firebird)
Firebird port automatic (3050)
Agent id automatic (srv1261114-fb50)
SYSDBA password generated (for a new Firebird)
HQ Monitor port automatic, login admin
License not now (add it later in HQ Monitor)
HQCenter not attached
Cluster RCM off, discovery mode off
Components debug files: yes, fbmcp: yes
Updates HQbird only (recommended)
> Install
Plan details
About plans
Quit
Up/Down: move Enter: change or start Esc: quitLes premières lignes constituent le plan pour les paramètres actuels : son code et ce que l’installateur fera avec Firebird et l’agent. Un plan impossible est en rouge, avec la raison, et le curseur se place sur le paramètre qui le corrige. Après chaque modification, l’installateur relit le plan.
| Touche | Ce qu’elle fait |
|---|---|
| Haut, Bas | Déplacer le curseur (aussi k, j) |
| Entrée | Ouvrir le paramètre sous le curseur, sélectionner un élément, accepter une valeur saisie |
| Espace | Activer ou désactiver un composant (page Components) |
| Échap | Revenir à la page précédente ; sur la première page : quitter l’installateur (il demande d’abord) |
| Ctrl+C | Arrêter immédiatement l’installateur (code de sortie 2). Rien n’a été modifié avant la page Install |
Sur une page où vous saisissez une valeur (un dossier, un port, une adresse), Entrée l’accepte et une valeur vide signifie « automatique ». Échap ne quitte pas une telle page.
| Paramètre | Ce que vous choisissez | Équivalent de l’option |
|---|---|---|
| Language | Anglais, russe, portugais brésilien, allemand ; les pages changent immédiatement | --lang |
| Firebird folder | Le dossier d’un nouveau Firebird, ou du Firebird à mettre à jour. Firebird 2.5 n’a qu’un seul dossier, donc son installateur n’a pas cette ligne | --fb-root |
| Firebird port | Le port TCP de Firebird | --port |
| Agent id | Automatique, le nom d’hôte, le nom d’hôte et l’instance, ou votre propre valeur. Uniquement pour un nouvel agent : un agent installé conserve son id, et la ligne n’est pas affichée | --agent-id |
| SYSDBA password | Pour un nouveau Firebird : généré, ou le vôtre | --sysdba-pass-file |
| HQ Monitor | Le port et l’identifiant de connexion de la console web | --hqmonitor-port, --hqmonitor-login, --hqmonitor-password-file |
| License | Pas maintenant, un essai de 30 jours par e-mail (adresse, avis de confidentialité, zone), ou un fichier de licence | --email --accept-privacy --trial-zone, --license |
| HQCenter | Le fichier attach.json de votre HQCenter |
--attach |
| Cluster | Le gestionnaire de cluster RCM (id de cluster, mot de passe admin), le mode découverte, le port d’appairage | --rcm, --cluster-id, --rcm-password-file, --cluster-pairing, --pairing-port |
| Components | Fichiers de débogage Firebird ; fbmcp et les adresses de son mode distant | --no-debug, --no-fbmcp, --fbmcp-allow-from |
| Mises à jour | HQbird uniquement (l’agent, HQ Monitor et fbmcp se mettent à jour eux-mêmes, un nouveau Firebird vous attend), HQbird et Firebird (Firebird se met également à jour tout seul, la nuit de 03:30 à 04:00, avec un redémarrage de Firebird), ou Désactivé. Kits à partir de 2027.2.31 ; uniquement pour un nouvel agent sans fichier attach.json : un HQCenter contrôle les mises à jour d’un agent rattaché | --auto-update |
Les options de la ligne de commande sont les valeurs avec lesquelles les pages démarrent :
sudo sh hqbird2027-fb50-linux-<ver>.run --rcm on --port 3055 ouvre la
première page avec RCM activé et le port 3055.
Les quatre lignes sous les paramètres :
- Installer affiche le plan en entier, puis demande
Start the install now?avec le curseur sur Non. Les questions du plan (un ancien HQbird, un Firebird en cours d’exécution à arrêter) sont sur la même page : Oui y répond toutes. Après Oui, les pages se ferment, et l’installation affiche son journal et le résumé sur l’écran normal, comme dans l’installateur simple ci-dessous. - Détails du plan montre ce que signifie le code du plan, ce que l’installateur a trouvé sur l’hôte, les avertissements et les paquets OS qu’il va installer.
- À propos des plans liste tous les codes (M1 … M17). Entrée sur un code l’explique.
Un
*marque le code du plan actuel. - Quitter quitte l’installateur (code de sortie 1). Rien n’a été modifié.
L’installateur simple
L’installateur simple s’exécute lorsque l’une de ces conditions est vraie :
- l’option
--no-tui, ou la variableHQBIRD_NO_TUI=1; --yes,--check,--uninstall,--extract,--plan-help,--help;- stdin ou stdout n’est pas un terminal : un script,
ssh host 'command'sans terminal, ou un pipe tel que... 2>&1 | tee install.log; TERMvautdumbou n’est pas défini ;- la fenêtre est plus petite que 80 colonnes sur 24 lignes (dans
tmuxavec sa ligne d’état, un terminal 80x24 a 23 lignes : agrandissez la fenêtre, ou utilisez--no-tui) ; - bash sur l’hôte est antérieur à 4.4 (RHEL 7, CentOS 7) ;
- le kit est 2027.2.30 ou antérieur.
Pour la fenêtre et pour bash, la première ligne de la sortie indique pourquoi les pages ne se sont pas ouvertes.
Une exécution typique de l’installateur simple sur un serveur sans Firebird :
[install] HQbird 2027 setup 2027.2.9, Firebird 5.0 (5.0.5.1916)
[install] host: Ubuntu 24.04.5 LTS, kernel 6.8.0-142-generic
[install] checking the payload (sha256) ...
[install] unpacking into /var/tmp/hqbird2027.k3Qf1x ...
[install] OS libraries missing: libtommath.so.1 (packages: libtommath1)
[install] plan M1: Firebird new /opt/firebird (unit firebird, port 3050)
[install] agent new in /opt/hqbird/fbagent-fb50 (unit hqbirdfbagent-fb50), HQ Monitor hqbirdmonitor-fb50
[install] OS packages to install: libtommath1
[install] Install as planned? Yes/No y
[install] installing from the package repository: libtommath1
[install] OS libraries: installed
[install] installing (fbagent --setup-install; log /var/log/fbagent/install.log) ...
...
Done: agent hqbirdfbagent-fb50 in /opt/hqbird/fbagent-fb50, Firebird 5.0.5.1916 in /opt/firebird (port 3050).
HQ Monitor: http://localhost:23050/ (login admin; password in /opt/hqbird/conf/access.properties)
[install] done. Uninstall: sudo sh hqbird2027-fb50-linux-2027.2.9.run --uninstallCet exemple provient du kit 2027.2.9. À partir du kit 2027.2.19, le résumé contient aussi
les lignes RCM: et Pairing: de la console de cluster (« Suivant : cluster »
ci-dessous). Avec l’agent 3.1.0 et ultérieur et aucun cluster choisi, elles sont :
RCM: off; turn it on in HQbird Monitor or with fbagent --cluster-init <id>
Pairing: off; turn it on in HQbird Monitor or with fbagent --cluster-pairing on (port 7450)Ce que signifient les lignes :
- host : la distribution et le noyau ; l’installateur refuse un hôte qui n’est pas x86_64, n’a pas systemd, ou exécute un noyau antérieur à 3.2.
- OS libraries : ce dont le Firebird de cette ligne a besoin de l’OS
(section 9). Le plan liste les paquets manquants (
OS packages to install) ; après la confirmation, l’installateur les prend depuis le dépôt de la distribution. Sans dépôt, il s’arrête avec le code de sortie 6 et affiche les commandes. - plan : ce que l’agent a trouvé (lignes
found Firebird ...,HQbird: ...) et ce qu’il va faire :Firebird new(un nouveau serveur),update(le Firebird de cette ligne est mis à jour sur place), ou un refus avec la raison (code de sortie 1, rien n’a changé). - Install as planned? Yes/No : la dernière question avant que quoi que ce soit ne soit
modifié. Répondez
y. Lorsque le plan a ses propres questions (un ancien HQbird, une autre version), elles viennent à la place (section 5). Sans terminal, passez--yes; sinon l’installateur s’arrête avec le code de sortie 4. - Questions de cluster (agent 3.1.0 et ultérieur) :
Install the cluster manager (RCM) on this host and make a new cluster? [y/N]etTurn on discovery mode for 24 hours (an RCM on the network may invite this agent into its cluster; port 7450)? [y/N]. La valeur par défaut est Non. La première n’est posée que lorsque l’hôte n’a pas de RCM et que l’agent n’est dans aucun cluster ; la seconde ne l’est pas lorsque l’agent est dans un cluster ou exécute le RCM.--yeset une exécution sans terminal répondent Non (pas de code de sortie 4). - HQ Monitor : l’adresse et l’identifiant. Une nouvelle installation reçoit
l’identifiant
admin; son mot de passe généré se trouve dans/opt/hqbird/conf/access.properties(mode 0600, lisible parrootet l’agent uniquement). Toutes les instances HQbird 2027 de l’hôte partagent ce fichier. Modifiez le mot de passe dans HQ Monitor.
Le mot de passe SYSDBA d’un nouveau Firebird est généré et enregistré dans
/root/fbagent-install-sysdba.txt (mode 0600) : une ligne de commentaire, puis la ligne
SYSDBA_PASS=<password>. Un autre Firebird installé plus tard sur le même hôte
reçoit le même mot de passe depuis ce fichier. Pour définir le vôtre, passez
--sysdba-pass-file <file> (première ligne du fichier) ou --sysdba-pass <password>.
Langue de l’installateur
Les kits postérieurs à 2027.2.30 parlent quatre langues : anglais, russe (ru),
portugais brésilien (pt-BR) et allemand (de). L’installateur choisit la
langue dans cet ordre :
- l’option
--lang en|ru|pt-BR|de; - la variable
HQBIRD_LANG; - la locale de la console (
LC_ALL, puisLC_MESSAGES, puisLANG), lorsqu’il s’agit d’une locale UTF-8 ; - l’anglais.
La deuxième ligne de la sortie indique quelle langue est utilisée et comment la changer. Cette ligne est toujours en anglais :
[install] Language: Русский (auto). Use --lang en to change.Remarques :
- PuTTY n’envoie pas
LANGau serveur. La locale du serveur compte, la langue est donc souvent l’anglais. Utilisez--lang. - Avec
--yes, et sans terminal, la langue automatique est l’anglais : les scripts lisent cette sortie.--langfonctionne toujours dans ce cas. - L’installateur a besoin d’une locale UTF-8 sur l’hôte pour les autres langues
(
C.UTF-8ouen_US.UTF-8). Il en définit une pour lui-même. Sans cela, il parle anglais. - Dans l’interface texte, la ligne Language de la première page change la langue immédiatement. Le terminal doit afficher l’UTF-8 (PuTTY : Window, Translation, Remote character set UTF-8, qui est sa valeur par défaut).
- L’anglais reste : les lignes de progression de l’installation elle-même, le résumé
Done:,/var/log/fbagent/install.log, et les avertissements du scan de l’hôte.
Le code du plan
Le plan a un code : M1, M2, … Il nomme le cas que l’installateur a trouvé
sur l’hôte. L’installateur affiche ce que signifie le code :
[install] plan M1: New Firebird and HQbird agent
[install] This host has no Firebird and no older HQbird. Setup installs a new Firebird and a new HQbird agent.
[install] plan M1: Firebird new /opt/firebird (unit firebird, port 3050)--plan-help affiche tous les codes et quitte. Il ne change rien. Dans
l’interface texte, la première page affiche le code et son titre, « Plan details »
affiche le texte, et « About plans » liste tous les codes.
| Code | Ce que l’installateur a trouvé | Firebird | Agent | Ancien HQbird |
|---|---|---|---|---|
| M1 | rien | nouveau | nouveau | — |
| M2 | Firebird de cette ligne, aucun ancien HQbird | mise à jour | nouveau | — |
| M3 | Firebird d’une autre ligne, aucun ancien HQbird | nouveau, port 305N | nouveau | — |
| M4 | ancien HQbird qui sert le Firebird de cette ligne | mise à jour | nouveau | arrêté, ses tâches importées comme activées |
| M5 | ancien HQbird d’une autre ligne ; un Firebird de cette ligne est présent | mise à jour, après une question | nouveau | continue de fonctionner |
| M6 | ancien HQbird d’une autre ligne ; aucun Firebird de cette ligne | nouveau, après une question | nouveau | continue de fonctionner |
| M7 | ancien HQbird sans Firebird local d’une version connue | mise à jour ou nouveau | nouveau | continue de fonctionner, un avertissement |
| M8 | un agent HQbird 2027 pour un autre Firebird | mise à jour ou nouveau | nouveau, à côté du premier | non modifié |
| M9 | comme M8, et un ancien HQbird sert cette ligne | mise à jour | nouveau, à côté du premier | arrêté, ses tâches importées comme activées |
| M10 | un agent sert déjà ce Firebird (exécution répétée) | mise à jour | sur place | arrêté lorsqu’il s’exécute |
| M11 | --fb-root est un Firebird de cette ligne |
mise à jour | nouveau ou sur place | comme ci-dessus |
| M13 | --fb-root est un dossier vide ou nouveau |
nouveau dans ce dossier | nouveau | comme ci-dessus |
Codes d’un refus (code de sortie 1, rien n’a changé) : M12 le dossier contient un
Firebird que l’installateur ne peut pas mettre à jour (une autre ligne, une version qu’il ne peut pas
lire, un service désactivé) ; M14 le dossier n’est pas vide et ne contient aucun
Firebird ; M16 plusieurs serveurs Firebird de cette ligne, indiquez --fb-root ;
M17 Firebird 2.5 fonctionne uniquement dans /opt/firebird. M15 est le
kit agent uniquement : Firebird n’est pas installé et pas mis à jour.
L’identifiant de l’agent
L’identifiant de l’agent nomme l’agent dans HQCenter, dans la licence et dans le cluster. Il est défini uniquement lors de la première installation :
- Par défaut : nom d’hôte + date + instance, par exemple
srv1261114-fb50. --agent-id IDdonne votre propre identifiant (1-128 lettres, chiffres,.,_ou-; le premier caractère une lettre ou un chiffre).- L’installateur refuse un identifiant qu’un autre agent de l’hôte possède.
- Dans l’interface texte, la page Agent id propose l’identifiant automatique, le nom d’hôte, le nom d’hôte avec l’instance, et votre propre valeur, et liste les identifiants que l’hôte possède déjà.
- Un agent installé conserve son identifiant. Une exécution répétée l’affiche dans le plan
(
id srv1 (kept)), l’interface texte n’a alors pas de ligne Agent id, et--agent-idn’y produit qu’un avertissement. Un nouvel agent dans un dossier qu’une installation antérieure a laissé avec sa configuration conserve aussi l’identifiant de cette configuration.
Étape 4 : Vérifier le résultat
systemctl status firebird hqbirdfbagent-fb50 hqbirdmonitor-fb50 --no-pager
ss -ltnp | grep -E ':3050|:23050'
ISC_PASSWORD="$(sed -n 's/^SYSDBA_PASS=//p' /root/fbagent-install-sysdba.txt)" \
/opt/firebird/bin/isql -user SYSDBA localhost/3050:/opt/firebird/examples/empbuild/employee.fdbUtilisez le chemin complet de la base de données d’exemple : il fonctionne pour chaque ligne et aussi
après une mise à jour, tandis que le databases.conf conservé d’une installation antérieure peut
ne pas avoir d’alias employee (une nouvelle installation de 2027.2.3 l’a).
Ouvrez http://<server>:23050/ dans un navigateur et connectez-vous en tant que admin avec le
mot de passe de /opt/hqbird/conf/access.properties. Le port Firebird et
le port HQ Monitor sont ouverts dans firewalld (zone public) lorsqu’il s’exécute,
sinon dans ufw lorsqu’il est actif ; avec un autre pare-feu, ouvrez-les vous-même.
Les ports de cluster ne sont ouverts que pour une option de cluster : 7443, 7444 et le port
de nœud avec --rcm on ; le port de nœud et le port d’appairage avec
--cluster-pairing on. Sans pare-feu actif, l’installateur affiche une
ligne avec les ports qu’il n’a pas ouverts. Un port qui était ouvert avant
l’installation est laissé tel quel.
Suivant : cluster
Pour répliquer vos bases de données d’un serveur maître vers un serveur réplica, reliez
les deux serveurs dans la console de cluster RCM. Avec l’agent 3.1.0 et ultérieur,
installez RCM uniquement sur le maître (--rcm on, ou répondez y) et activez le
mode découverte sur le réplica (--cluster-pairing on). Le mode découverte ouvre
la fenêtre d’appairage pendant 24 heures : le port d’appairage du slot de l’agent (7450
pour la première instance, 7451 pour la seconde, jusqu’à 7459) est ouvert dans le
pare-feu, et le RCM peut inviter l’agent. Un hôte a un seul RCM (ports 7443
et 7444) ; l’agent qui l’a créé l’exécute et n’ouvre aucune fenêtre d’appairage.
Ensuite, sans l’installateur : HQ Monitor → Clusters → Cluster on this
server, ou fbagent --cluster-init <id> et fbagent --cluster-pairing on. Les kits à partir de 2027.2.19 avec un agent plus ancien démarrent RCM sur chaque serveur et
affichent son adresse dans la ligne RCM: du résumé ; une installation antérieure à
2027.2.19 obtient RCM lorsque vous la mettez à jour avec un kit plus récent (section 6). Le
guide du cluster (pour le kit 2027.2.33) va
pas à pas de deux nouveaux serveurs à une réplique fonctionnelle, avec captures d’écran :
Guide du cluster Linux
(également en russe et
portugais). Les mêmes étapes en
commandes uniquement :
hqbird2027-linux-cluster-runbook.md
(hqbird2027-linux-cluster-runbook.ru.md,
hqbird2027-linux-cluster-runbook.pt.md).
4. Après l’installation
Unités
| Unité | Quoi | Exécuté en tant que |
|---|---|---|
firebird (2.5, 4.0, 5.0 dans /opt/firebird) ; firebird-superserver (3.0 dans /opt/firebird) ; pour un autre dossier, le nom du dossier avec / → _ : firebird.opt_fb50, firebird.opt_fb40-2 (4.0, 5.0 dans /opt/fb50, /opt/fb40-2), firebird.opt_fb30-superserver (3.0 dans /opt/fb30) |
Serveur Firebird | firebird |
hqbirdfbagent-fb50 (deuxième instance hqbirdfbagent-fb50-2 ; avant 2027.2.9 hqbirdfbagent-p<port Firebird>) |
Agent HQbird | firebird |
hqbirdmonitor-fb50 (hqbirdmonitor-fb50-2 ; avant 2027.2.9 hqbirdmonitor-p<port Firebird>) |
HQ Monitor | firebird |
Les trois sont activées et démarrent au boot. journalctl -u hqbirdfbagent-fb50
affiche le journal de l’unité de l’agent. Firebird 3.0 possède également les unités
firebird-classic.socket et [email protected]
(firebird.opt_fb30-classic.* dans un autre dossier), et Firebird 2.5 possède
firebird.socket : elles restent inactive, c’est normal. Le processus Firebird 2.5
est fb_smp_server (SuperClassic).
Où se trouvent les fichiers
L’exemple est la première instance Firebird 5.0 dans /opt/firebird sur le port
3050. Une deuxième instance de la ligne a -2 dans les noms d’agent
(fbagent-fb50-2, hqbirdfbagent-fb50-2, hqbirdmonitor-fb50-2).
Les instances installées avant 2027.2.9 ont le port dans ces noms
(fbagent-p3050, hqbirdfbagent-p3050, hqbirdmonitor-p3050).
/opt/firebird/ Firebird 5.0 server: bin/, lib/, plugins/, firebird.conf,
databases.conf, security5.fdb, *.debug files (symbols)
/opt/fb50/ a Firebird 5.0 next to another line (/opt/fb40, /opt/fb30)
/opt/hqbird/ root of the HQbird agents
conf/access.properties HQ Monitor sign-in, shared by all instances of the host (0600)
fbagent-fb50/ HQbird agent of this Firebird
fbagent the agent (unit hqbirdfbagent-fb50)
hqmonitor HQ Monitor (unit hqbirdmonitor-fb50)
agent_config.json agent configuration (encrypted secrets: config_secret.key)
config.properties HQ Monitor configuration
hqbird2027-firebird.json the Firebird this installer installed
hqbird2027-hqmonitor-firewall.json the HQ Monitor port this installer opened in firewalld or ufw
conf/ trace and job settings
logs/ agent log (firebird-agent_<date>.jsonl), license_state.json;
journal.log and server_status.json after the first checks
bak/ backups of the configuration
outcoming/ status reports for HQCenter
update/ update cache: hqmonitor/, hqclusternode/, hqbirdrcm/
certs/ certificates after the attach to HQCenter
fbagent-hqbird-takeover.json state of the older HQbird units before the takeover (section 5)
/opt/hqbirdrcm/ the cluster console RCM (unit hqbirdrcm, owner firebird):
with agent 3.1.0 only after --rcm on (or HQ Monitor);
kits 2027.2.19+ with an older agent: unless --rcm off
/opt/hqclusternode/ the cluster node (owner firebird), empty until the host is
linked in RCM or HQCenter adds it to a cluster
/var/lib/hqmonitor/<server id>/ HQ Monitor data
/var/log/fbagent/install.log log of the installer's steps (passwords are hidden)
/root/fbagent-install-sysdba.txt SYSDBA password of a new Firebird (root only, 0600)
/etc/sysctl.d/90-hqbird-firebird.conf kernel settings for Firebird (vm.max_map_count), only when
the system value is lower (Ubuntu 24.04 needs none)
/etc/sudoers.d/ the agent's sudoers rules for its root helpers (updates, HQ Monitor)L’installateur ne conserve rien dans /var/tmp : son dossier de travail
/var/tmp/hqbird2027.XXXXXX est supprimé à la fin, également après une erreur.
Journaux
| Journal | Où |
|---|---|
| Installateur | le terminal ; /var/log/fbagent/install.log |
| Agent | /opt/hqbird/fbagent-fb50/logs/firebird-agent_<date>.jsonl, journal.log ; journalctl -u hqbirdfbagent-fb50 |
| HQ Monitor | journalctl -u hqbirdmonitor-fb50 ; journal d’audit /opt/hqbird/fbagent-fb50/hqmonitor_audit.log |
| Firebird | /opt/firebird/firebird.log |
Mises à jour sans HQCenter
À partir du kit 2027.2.31 (agent 3.3.0), un agent qui n’est rattaché à aucun HQCenter
prend les nouvelles versions depuis le serveur de mise à jour du fournisseur. Le mode de mise à jour est la
clé update.mode de agent_config.json :
| Mode | Ce qui se met à jour tout seul |
|---|---|
agent (par défaut) |
L’agent, HQ Monitor et fbmcp. Un nouveau paquet Firebird est téléchargé et attend l’administrateur |
all |
La même chose, et Firebird aussi, dans sa fenêtre d’application (la nuit de 03:30 à 04:00 ; la mise à jour redémarre Firebird) |
off |
Rien : l’agent ne fait aucune vérification de mise à jour. Pour mettre à jour, exécutez l’installateur d’une nouvelle version (section 6) |
- À l’installation : la ligne Updates de l’interface texte, ou
--auto-update all|agent|off. Sans elles, l’installateur ne change pas le mode. - Plus tard : la page Updates de HQ Monitor, ou de nouveau l’installateur avec
--auto-update <mode>. - L’état :
sudo /opt/hqbird/fbagent-fb50/fbagent --update-status(ajoutez--jsonpour un script). Il affiche la source de version, la zone et la dernière réponse du serveur de mise à jour.
L’agent ouvre des connexions HTTPS sortantes uniquement vers ces adresses. Aucun port entrant n’est nécessaire.
| Objet | Adresse |
|---|---|
| Mises à jour, zone EU | liceu.ibsurgeon.com:9443 |
| Mises à jour, zone BR | licbr.ibsurgeon.com:9443 |
| Mises à jour, zone RU | licru.ibsurgeon.com:20943 |
| Licence d’essai | trialeu.ibsurgeon.com:9443, trialbr.ibsurgeon.com:19443, trialru.ibsurgeon.com:23943 |
Un serveur rattaché à un HQCenter n’utilise pas les adresses de mise à jour : il prend ses mises à jour depuis ce HQCenter (section 8).
Notifications
À partir du kit 2027.2.33 (agent 3.4.0), l’agent envoie des messages sur les problèmes
du serveur à un bot Telegram qui vous est propre, à un webhook ou par e-mail (SMTP). L'
installateur ne définit aucun canal, et rien n’est envoyé tant que vous n’en ajoutez pas un : HQ
Monitor → Servers → Notifications. Pour tester un canal depuis la
ligne de commande : sudo -u firebird /opt/hqbird/fbagent-fb50/fbagent --notify-test <channel> ; --notify-history affiche les dernières livraisons.
5. Mise à jour d’un HQbird plus ancien (2024 et antérieur)
L’installateur trouve un HQbird (FBDataGuard) installé dans /opt/hqbird et
ses unités, ainsi que les serveurs Firebird qu’il gère. Il suit ensuite les mêmes
règles que les scripts d’installation HQbird :
Ce que vous voyez sur le terminal :
[install] found Firebird 5.0.5.1878: /opt/firebird, port 3050, unit firebird, no agent
[install] plan M4: Firebird update /opt/firebird (unit firebird, port 3050)
[install] agent new in /opt/hqbird/fbagent-fb50 (unit hqbirdfbagent-fb50), HQ Monitor hqbirdmonitor-fb50
[install] HQbird services to turn off: hqbird
[install] Firebird 5.0.5.1878: unit firebird, port 3050, 0 TCP connections
[install] Confirm to stop running Firebird 5.0.5.1878? Yes/No y- Le plan nomme le Firebird qui est mis à jour ;
--fb-rootet--portne peuvent pas le déplacer (son unité est prise). - La question Confirm to stop running Firebird? est posée lorsque
le moteur doit être arrêté ; la ligne précédente affiche les connexions ouvertes.
Another versionest demandée lorsque l’ancien HQbird gère un Firebird d’une autre version (mettez à jour celui-là, ou un nouveau à côté).--yesrépond Oui à toutes les questions ; sans terminal et sans--yes, l’installateur s’arrête avec le code de sortie 4 et ne change rien. --disable-hqbirddésactive les anciennes unités HQbird dans tous les cas ;--no-hqbirdlaisse l’ancien HQbird tranquille (il continue de fonctionner à côté de HQbird 2027).- Le mot de passe SYSDBA n’est pas demandé : l’agent le prend depuis l’ancien HQbird.
- HQ Monitor utilise la connexion de l’ancien HQbird : son fichier
/opt/hqbird/conf/access.propertiesest conservé, connectez-vous donc avec l’identifiant et le mot de passe que vous utilisiez auparavant. L’installateur attribue le fichier àfirebirdavec le mode 0600 (l’ancien HQbird le laissait lisible par tous les utilisateurs). La connexion invité de l’ancien HQbird (access.guest-login) n’est pas utilisée par HQ Monitor.
Ce qui est conservé : firebird.conf, databases.conf / aliases.conf, la
base de données de sécurité, le mot de passe SYSDBA, les bases de données, les sauvegardes et les
fichiers de l’ancien HQbird. La mise à jour remplace les fichiers programme Firebird
sur place ; les fichiers remplacés sont conservés dans
/opt/fbagent-update-backup/<folder name>-<id>/<time>_<old version>_to_<new version>/
(les deux mises à jour les plus récentes restent). Les tâches HQbird (sauvegardes, sweeps, supervision)
sont importées dans le nouvel agent. La licence HQbird de l’ancien HQbird n’est
pas transférée : le nouvel agent fonctionne en version d’essai jusqu’à ce qu’une licence soit installée
ou que le serveur soit rattaché à votre HQCenter.
À partir du kit 2027.2.33 (agent 3.4.0), l’import de la configuration de l’ancien HQbird fait deux choses de plus :
- Il enregistre les bases de données de l’ancien HQbird dans le fichier d’alias
Firebird (
databases.conf, oualiases.confpour 2.5) sous forme de lignesname = path. L’ancien fichier est d’abord copié. Une base de données est omise lorsque son chemin est déjà dans le fichier, ou lorsque son fichier n’existe pas. Un fichier avec une directiveincluden’est pas modifié. - Il supprime les anciens journaux de supervision de l’ancien HQbird : le contenu
des dossiers
mon/outcomingetmon/outtracede son dossier de sortie (les dossiers restent). Rien n’est supprimé tant qu’un service de l’ancien HQbird fonctionne. La suppression est irréversible : si vous avez besoin de ces journaux, copiez-les avant l’installation.
Les deux sont activés par défaut. Les clés hqbird_import.register_databases et
hqbird_import.clean_mon_logs de agent_config.json (toutes deux dans l'
éditeur de configuration de HQ Monitor) les désactivent pour un import ultérieur ; l’installateur
n’a aucune option pour elles.
L’état des anciennes unités HQbird avant la reprise est enregistré dans
/opt/hqbird/fbagent-hqbird-takeover.json. --uninstall ne les réactive pas.
Forme non interactive :
sudo sh hqbird2027-fb50-linux-2027.2.9.run --yes --disable-hqbird6. Mise à jour de HQbird 2027 vers une nouvelle version
Un installateur plus récent de la même ligne, exécuté sur un hôte avec HQbird 2027, met à jour l’instance installée sur place : Firebird, les fichiers de débogage, l’agent et HQ Monitor. La configuration, les bases de données, l’état d’essai ou de licence, le port HQ Monitor et la connexion sont conservés.
sudo sh hqbird2027-fb50-linux-2027.2.9.runDans l’interface texte, la première page affiche Plan M10: Update of an installed HQbird 2027, l’agent avec son id (kept), et aucune ligne Agent id ; Install
lance la mise à jour. L’installateur simple affiche :
[install] HQbird 2027 setup 2027.2.9, Firebird 5.0 (5.0.5.1916)
[install] found Firebird 5.0.5.1880: /opt/firebird, port 3050, unit firebird, agent hqbirdfbagent-p3050
[install] plan M10: Firebird update /opt/firebird (unit firebird, port 3050)
[install] agent in_place in /opt/hqbird/fbagent-p3050 (unit hqbirdfbagent-p3050), HQ Monitor hqbirdmonitor-p3050
[install] Firebird 5.0.5.1880: unit firebird, port 3050, 2 TCP connections
[install] Confirm to stop running Firebird 5.0.5.1880? Yes/No y
...
Firebird updated: 5.0.5.1880 -> 5.0.5.1916
HQ Monitor updated 1.31.0 -> 1.33.0 (...)
Done: agent hqbirdfbagent-p3050 in /opt/hqbird/fbagent-p3050, Firebird 5.0.5.1916 in /opt/firebird (port 3050).Une mise à jour ne change pas les noms du dossier de l’agent et des unités :
l’instance de cet exemple a été installée avant 2027.2.9 et conserve
fbagent-p3050.
Lorsque la version de Firebird de l’installateur est celle déjà installée (par
exemple Firebird 2.5.9.27194 dans chaque HQbird 2027 pour 2.5), seuls l’agent
et HQ Monitor sont mis à jour : Firebird n’est pas arrêté et il n’y a pas de
question Confirm to stop.
Le fichier databases.conf conservé d’une instance installée par un HQbird 2027
plus ancien peut ne pas avoir d’alias employee ; connectez-vous à la base
d’exemple par son chemin complet (section 3, étape 4). Sur Firebird 3.0, une
mise à jour depuis 2027.2.0 laisse
/opt/firebird/examples/empbuild/employee.fdb avec le mode 0444, et Firebird
ne peut pas l’ouvrir (no permission for read-write access) ; si vous avez
besoin de la base d’exemple : sudo chmod 660 /opt/firebird/examples/empbuild/employee.fdb.
Vos propres bases ne sont pas touchées.
- Avec plusieurs instances de la ligne, nommez celle à mettre à jour :
--fb-root /opt/fb50-2 --port 3056. - Une nouvelle exécution du même installateur sur la version installée est une réparation : les fichiers programme et les unités sont réécrits, les données restent.
- Après la connexion à un HQCenter (section 8), l’agent, HQ Monitor, Firebird et les composants du cluster sont mis à jour depuis le catalogue HQCenter ; un nouvel installateur n’est alors pas nécessaire.
- Un serveur rattaché à aucun HQCenter avec l’agent 3.3.0 ou ultérieur (kits à partir de
2027.2.31) met à jour l’agent, HQ Monitor et fbmcp par lui-même, sauf si le
mode de mise à jour est
off(« Mises à jour sans HQCenter » dans la section 4). Une installation faite avant 2027.2.31 obtient cela après une mise à jour avec un installateur plus récent. Une mise à jour avec l’installateur conserve le mode de mise à jour ;--auto-update <mode>le change.
7. Commandes de maintenance
Chaque action de maintenance est une exécution de l’installateur avec des options, ou une
commande de l’agent dans le dossier de l’agent. Dans un terminal, une exécution sans --yes ouvre
l’interface texte avec ces options déjà définies (kits après 2027.2.30) :
vérifiez le plan sur la première page, puis choisissez Install.
| Action | Commande |
|---|---|
| Une autre instance de cette ligne | sudo sh hqbird2027-fb50-linux-<ver>.run --fb-root /opt/fb50-2 --port 3056 |
| Réparation / mise à jour | sudo sh hqbird2027-fb50-linux-<ver>.run (avec plusieurs instances : --fb-root <folder> --port <port>) |
| Rattacher à HQCenter | sudo sh hqbird2027-fb50-linux-<ver>.run --attach attach.json pendant l’installation, ou plus tard cd /opt/hqbird/fbagent-fb50 && sudo ./fbagent --attach --file /path/attach.json |
| Envoyer l’e-mail d’essai | cd /opt/hqbird/fbagent-fb50 && sudo -u firebird ./fbagent --trial-email [email protected] --accept-privacy |
| Confirmer le code d’essai reçu par e-mail | cd /opt/hqbird/fbagent-fb50 && sudo -u firebird ./fbagent --trial-confirm <code> (ou dans HQ Monitor) |
| Installer un fichier de licence | --license <file> pendant l’installation, ou cd /opt/hqbird/fbagent-fb50 && sudo -u firebird ./fbagent --license-install /path/license.json |
| État de l’installation | sudo /opt/hqbird/fbagent-fb50/fbagent --install-state --json |
| État des mises à jour (sans HQCenter) | sudo /opt/hqbird/fbagent-fb50/fbagent --update-status |
| Changer le mode de mise à jour (sans HQCenter) | HQ Monitor, la page Updates ; ou sudo sh hqbird2027-fb50-linux-<ver>.run --auto-update all|agent|off |
| Désinstaller | sudo sh hqbird2027-fb50-linux-<ver>.run --uninstall [--remove-data] [--force] [--agent-dir /opt/hqbird/fbagent-fb50] |
Une autre instance
sudo sh hqbird2027-fb50-linux-2027.2.9.run --fb-root /opt/fb50-2 --port 3056Le nouveau Firebird va dans /opt/fb50-2 (un dossier nouveau ou vide), unité
firebird.opt_fb50-2, avec son propre agent (/opt/hqbird/fbagent-fb50-2, unité
hqbirdfbagent-fb50-2) et son propre HQ Monitor (http://localhost:23056/,
unité hqbirdmonitor-fb50-2). L’agent reçoit le plus petit numéro libre de la
ligne : fb50-2 pour la deuxième instance, y compris à côté d’un agent installé
avant 2027.2.9 (fbagent-p3050). Le fichier d’identification HQ Monitor
/opt/hqbird/conf/access.properties est partagé par les instances de l’hôte :
une nouvelle instance sans --hqmonitor-login conserve l’identification existante, et
--hqmonitor-login/--hqmonitor-password-file sur n’importe quelle instance modifient
l’identification de toutes (l’ancien fichier est conservé sous
access.properties.bak-<time>). Firebird 2.5 ne prend pas en charge une seconde
instance : l’installateur s’arrête avec refused (M17): Firebird 2.5 works only in /opt/firebird, not in <folder> (code de sortie 1, rien n’a changé). Installez un
Firebird d’une autre ligne à côté, par exemple
sudo sh hqbird2027-fb50-linux-<ver>.run --fb-root /opt/fb50 --port 3051.
Désinstallation
La désinstallation sous Windows et Linux, les serveurs dans un cluster et ce qui reste sur le disque sont décrits en détail dans le guide de désinstallation. En bref :
# the agent and HQ Monitor of this instance; Firebird, the databases, configs and logs stay
sudo sh hqbird2027-fb50-linux-2027.2.9.run --uninstall
# the same, and the agent's configuration, logs, license state and HQ Monitor data too
sudo sh hqbird2027-fb50-linux-2027.2.9.run --uninstall --remove-dataSans --agent-dir, l’installateur supprime l’unique agent dans
/opt/hqbird. Avec plusieurs agents sur l’hôte, il s’arrête (code de sortie 1),
liste leurs dossiers et demande --agent-dir :
sudo sh hqbird2027-fb50-linux-2027.2.9.run --uninstall --agent-dir /opt/hqbird/fbagent-fb50-2--uninstall arrête et supprime les unités de l’agent et de son HQ Monitor
(hqbirdfbagent-fb50, hqbirdmonitor-fb50), les règles sudoers de l’agent et de ses programmes
(fbagent, hqmonitor), et ferme le port HQ Monitor que
l’installation a ouvert dans firewalld ou ufw. Le dossier de l’agent reste avec la configuration et
les logs ; --remove-data supprime aussi le dossier et les données HQ Monitor dans
/var/lib/hqmonitor/. Firebird reste installé (unité, dossier programme,
bases) ; les anciennes unités HQbird qui étaient désactivées restent désactivées.
Avec plusieurs agents sur l’hôte, le fichier d’identification HQ Monitor partagé reste
jusqu’à la suppression du dernier agent.
Si l’agent exécute le RCM de l’hôte et que d’autres agents utilisent ce RCM,
--uninstall refuse avec le code de sortie 5 et ne change rien :
this agent runs the RCM of the host, and other agents use it: remove the cluster in the RCM console, or run again with --force. --force supprime
l’agent malgré tout ; le cluster perd alors son CA (pas de nouveaux certificats, pas de nouveaux
membres). L’unité RCM reste tant que d’autres agents de l’hôte l’utilisent. Pour faire
d’un autre agent le propriétaire d’un nouveau RCM lorsque l’ancien propriétaire a disparu :
fbagent --cluster-init <id> --rcm-takeover (un nouveau CA : reliez les membres
à nouveau).
L’indication à la fin d’une installation (Uninstall: sudo sh ... --uninstall)
n’a pas de --agent-dir : avec plusieurs instances, ajoutez-le comme indiqué ci-dessus.
Pour supprimer aussi le Firebird d’une instance (l’installateur ne le fait pas ;
faites d’abord des sauvegardes gbak de ses bases), par exemple le Firebird dans
/opt/fb50-2 :
B=/opt/fb50-2
U=firebird.$(echo ${B#/} | tr / _) # /opt/fb50-2 -> firebird.opt_fb50-2
systemctl list-unit-files "$U*" # the units that will be removed
sudo systemctl disable --now $(systemctl list-unit-files "$U*" --no-legend | awk '$1 !~ /@/ {print $1}')
sudo rm -f /usr/lib/systemd/system/$U* /etc/systemd/system/$U*
sudo systemctl daemon-reload
sudo rm -rf $B8. Rattacher à votre HQCenter
HQCenter est le serveur central de votre entreprise qui gère les agents HQbird : licences, configuration, mises à jour, vue d’ensemble des sauvegardes. Sans HQCenter, l’agent fonctionne seul avec les versions de l’installateur et le fichier d’essai ou de licence.
- Dans le panneau d’administration HQCenter, ouvrez Tokens
(
https://<hqcenter>:8443/admin/tokens). Dans le formulaire Install script, choisissez la licence (ou aucune), le mode, le nombre de serveurs et la validité (1 à 365 jours) ; les champs plateforme et Firebird ne sont pas utilisés. Cliquez sur Download connection file et enregistrezattach.json. Le fichier contient un jeton secret : conservez-le en sécurité (chmod 600), supprimez-le après usage et révoquez le jeton dans la liste de la même page. Le formulaire n’est affiché que lorsqueadmin_panel.install_script_urlest défini. - Copiez
attach.jsonsur le serveur. - Rattachez de l’une des deux manières :
# during the installation
sudo sh hqbird2027-fb50-linux-2027.2.9.run --yes --attach /root/attach.json
# later, for an installed agent
cd /opt/hqbird/fbagent-fb50 && sudo ./fbagent --attach --file /root/attach.jsonAvec un jeton ordinaire, la commande attend que l’administrateur HQCenter approuve la demande (jusqu’à 30 minutes). Avec un jeton de licence, l’agent est rattaché immédiatement et obtient la licence. Après le rattachement, l’essai se termine lorsque HQCenter donne une licence à l’agent ; l’agent, HQ Monitor, Firebird et les composants du cluster sont alors mis à jour depuis le catalogue HQCenter. Un rattachement échoué pendant l’installation n’annule pas l’installation : le résumé le dit, et la commande ci-dessus le répète.
Prérequis : HQCenter (goafts) 1.15.0 ou ultérieur (les versions plus anciennes n’ont pas de bouton de fichier de connexion) ; le serveur atteint le port bootstrap de HQCenter une fois pour le rattachement, puis le port des agents (443 par défaut). HQCenter peut être sans Internet. Un second rattachement du même serveur au même HQCenter nécessite l’approbation de l’administrateur même avec un jeton de licence.
9. Installation sans surveillance et scripts
Chaque option fonctionne aussi au terminal. Une exécution sans surveillance nécessite --yes
(répond aux questions du plan ; sans terminal et sans --yes
l’installateur s’arrête avec le code de sortie 4). --yes n’ouvre jamais l’interface
texte. Un script qui lance l’installateur dans un terminal et répond lui-même à ses
questions (par exemple avec expect) doit ajouter --no-tui ou définir
HQBIRD_NO_TUI=1 : les kits après 2027.2.30 y ouvrent les pages. Le code de sortie indique le résultat ; les
détails sont sur le terminal et dans /var/log/fbagent/install.log.
Options
| Option | Signification | Par défaut |
|---|---|---|
--fb-root DIR |
Dossier du nouveau Firebird (nouveau ou vide) ; ou le dossier du Firebird à mettre à jour | /opt/firebird, puis /opt/fb<NN> |
--port N |
Port Firebird | 3050 pour le premier Firebird ; pour une autre ligne, le port de la ligne (3053 pour 3.0, 3054 pour 4.0, 3055 pour 5.0) |
--sysdba-pass-file F, --sysdba-pass P |
Mot de passe SYSDBA d’un nouveau Firebird (première ligne de F ; P est écrit dans un fichier 0600) |
généré, enregistré dans /root/fbagent-install-sysdba.txt ; un autre Firebird sur l’hôte prend le mot de passe dans ce fichier |
--agent-id ID |
agent.id du nouvel agent ; uniquement à la première installation, un agent installé conserve son id (« L’id de l’agent » dans la section 3) |
nom d’hôte + date + instance |
--hqmonitor-port N |
Port HQ Monitor | 20000 + port Firebird |
--hqmonitor-login L --hqmonitor-password-file F |
Identification HQ Monitor, partagée par toutes les instances de l’hôte : fournie sur une instance, elle change l’identification de toutes | admin + mot de passe généré ; une mise à jour ou une autre instance conserve l’identification existante |
--email ADDR --accept-privacy [--trial-zone RU|EU|BR] |
E-mail d’essai (30 jours) ; l’adresse est envoyée au serveur d’essai du fournisseur | aucun |
--auto-update all|agent|off |
Mises à jour d’un serveur rattaché à aucun HQCenter (kits à partir de 2027.2.31) : agent = l’agent, HQ Monitor et fbmcp se mettent à jour par eux-mêmes, un paquet Firebird vous attend ; all = Firebird aussi, dans sa fenêtre ; off = aucune vérification de mise à jour (« Mises à jour sans HQCenter » dans la section 4) |
le mode n’est pas changé ; un nouvel agent a agent |
| --license F | Fichier de licence à installer | aucun |
| --attach F | Se rattacher à votre HQCenter (attach.json) | aucun |
| --no-hqbird, --disable-hqbird | Laisser l’ancien HQbird tranquille / désactiver toutes ses unités | automatique |
| --no-debug | Ne pas installer les fichiers de débogage de Firebird | installés |
| --no-fbmcp | Ne pas installer fbmcp (le serveur MCP pour les clients IA) et ne pas modifier le fbmcp de cet hôte | installé |
| --fbmcp-allow-from A,B | Activer le mode distant de fbmcp pour ces adresses d’administration (IP ou CIDR) | local uniquement |
| --fbmcp-port N, --fbmcp-dns NAME,..., --fbmcp-ip ADDR | Le port distant de fbmcp ; des noms supplémentaires pour son certificat ; l’adresse pour le certificat et l’écouteur | port 8650 |
| --rcm on\|off | Installer la console de cluster RCM sur cet hôte et créer un nouveau cluster (agent 3.1.0 et ultérieur) | demandé ; Non |
| --rcm-password-file F | Mot de passe administrateur RCM avec --rcm on (première ligne de F) | généré, affiché à la fin |
| --cluster-id ID | Identifiant du cluster avec --rcm on | le nom de l’hôte |
| --cluster-pairing on\|off | Mode découverte : la fenêtre d’appairage pendant 24 heures, un RCM peut inviter cet agent | demandé ; Non |
| --rcm-allow A,B,... | Seuls ces RCM peuvent inviter cet hôte en mode découverte (IP, CIDR ou nom d’hôte) | n’importe quel RCM |
| --pairing-port N | Port d’appairage 7450–7459 d’un nouvel agent ; il choisit l’emplacement (ports de nœud 7051+k, 7061+k). Une configuration ultérieure conserve l’emplacement | le premier emplacement libre |
| --cluster-node on\|off | Placer le service de nœud de cluster dans le cache de l’agent | on |
| --yes | Répondre Oui aux questions du plan (Non aux questions de cluster) | demander |
| --check | Uniquement les vérifications, les bibliothèques et le plan ; rien n’est modifié | — |
| --plan-help | Afficher la signification des codes du plan (M1, M2, …) et quitter | — |
| --no-tui | L’installateur simple, sans l’interface texte ; également la variable HQBIRD_NO_TUI=1 (« L’installateur simple » à la section 3) | l’interface texte dans un terminal |
| --lang en\|ru\|pt-BR\|de | Langue de l’installateur ; également la variable HQBIRD_LANG (« Langue de l’installateur » à la section 3) | la locale UTF-8 de la console, sinon l’anglais |
| --tmpdir DIR | Décompresser ici (un dossier où les programmes peuvent s’exécuter) | /var/tmp |
| --extract DIR | Décompresser uniquement la charge utile dans DIR/payload et quitter | — |
| --uninstall [--remove-data] [--force] [--agent-dir DIR] | Supprimer l’agent et HQ Monitor (Firebird reste) ; --force supprime aussi l’agent qui exécute le RCM de l’hôte alors que d’autres agents l’utilisent | — |
Les options peuvent être écrites --port 3055 ou --port=3055. Les chemins relatifs
sont comptés depuis le dossier courant.
Exemples
Nouvelle installation avec les valeurs par défaut :
sudo sh hqbird2027-fb50-linux-2027.2.9.run --yes
echo "exit code $?"Nouvelle installation dans un dossier et un port choisis, avec un mot de passe SYSDBA depuis un fichier et une connexion HQ Monitor :
umask 077
printf '%s\n' 'S3cret-Sysdba' > /root/sysdba.txt
printf '%s\n' 'S3cret-Monitor' > /root/hqm.txt
sudo sh hqbird2027-fb50-linux-2027.2.9.run --yes \
--fb-root /opt/firebird --port 3050 \
--sysdba-pass-file /root/sysdba.txt \
--hqmonitor-port 24000 --hqmonitor-login ops --hqmonitor-password-file /root/hqm.txt
rm -f /root/sysdba.txt /root/hqm.txtNouvelle installation avec l’e-mail d’essai, un fichier de licence et le fichier attach :
sudo sh hqbird2027-fb50-linux-2027.2.9.run --yes \
--email [email protected] --accept-privacy --trial-zone EU \
--license /root/hqbird-license.json \
--attach /root/attach.jsonMise à jour d’un ancien HQbird, toutes les unités de l’ancien HQbird désactivées :
sudo sh hqbird2027-fb50-linux-2027.2.9.run --yes --disable-hqbirdMise à jour de HQbird 2027 vers une nouvelle version (une instance ; avec plusieurs, ajoutez
--fb-root et --port) :
sudo sh hqbird2027-fb50-linux-2027.2.9.run --yesUne seconde instance Firebird 5.0 sur le port 3056 :
sudo sh hqbird2027-fb50-linux-2027.2.9.run --yes --fb-root /opt/fb50-2 --port 3056Suppression :
sudo sh hqbird2027-fb50-linux-2027.2.9.run --uninstall
sudo sh hqbird2027-fb50-linux-2027.2.9.run --uninstall --remove-dataUn script qui s’arrête en cas d’échec de l’installation :
#!/bin/sh
set -e
sh hqbird2027-fb50-linux-2027.2.9.run --yes || {
rc=$?
echo "HQbird setup failed with code $rc, see /var/log/fbagent/install.log" >&2
exit $rc
}
echo "HQbird 2027 installed"Serveur sans Internet : bibliothèques de l’OS
Le Firebird d’une ligne a besoin de ces bibliothèques de l’OS (en plus de glibc) :
| Ligne | Paquets (Debian/Ubuntu) | Paquets (famille RHEL) |
|---|---|---|
| 5.0 | libtommath1, libicu<NN>, libgssapi-krb5-2 |
libtommath (EPEL), libicu, krb5-libs |
| 4.0 | libtommath1, libicu<NN> |
libtommath (EPEL), libicu |
| 3.0 | libtommath1, libicu<NN> |
libtommath (EPEL), libicu |
| 2.5 | généralement rien (libstdc++6 est dans le système de base) |
généralement rien |
Les kits après 2027.2.30 des lignes 3.0, 4.0 et 5.0 ont aussi besoin du programme
colrm, que le script d’installation de Firebird utilise : paquet bsdextrautils
(bsdmainutils sur les anciens Debian et Ubuntu). Un Debian minimal n’en a aucun ; la
famille RHEL l’a dans util-linux, qui est toujours présent.
Lorsqu’un paquet manque et que le dépôt n’est pas joignable, l’installateur s’arrête avec le code de sortie 6 et rien n’est modifié :
[install] ERROR: no access to the package repository, or a package is not there; nothing was changed.
[install] Missing: libtommath1
[install] Install them, then run this file again:
[install] apt-get install -y libtommath1
[install] On a server without internet: on a PC with the same Ubuntu 24.04.5 LTS
[install] apt-get download libtommath1
[install] copy the .deb files here and run: apt-get install -y ./*.debSur la famille RHEL, libtommath est dans EPEL : avec un dépôt joignable,
l’installateur ajoute epel-release lui-même. Sans dépôt, les commandes sont dnf install -y epel-release, dnf download --resolve <packages> et dnf install -y ./*.rpm. --check affiche
la même liste à l’avance, afin que les paquets puissent être préparés avant la
fenêtre d’installation.
Codes de sortie
| Code | Signification | Modifications sur l’hôte |
|---|---|---|
| 0 | Terminé (les avertissements concernant l’e-mail d’essai, l’attach ou la licence figurent dans le résumé) | oui |
| 1 | Refusé : l’hôte, une option, un fichier ou le plan (la raison est affichée). Aussi : Quitter dans l’interface texte | aucune |
| 2 | L’installation a échoué et a été annulée. Aussi : l’installateur a été arrêté par un signal (Ctrl+C) | annulée ; aucune si arrêté avant l’installation |
| 3 | L’installation a échoué et l’annulation n’était pas complète (le résumé indique quoi vérifier) | partielle |
| 4 | Une question du plan n’a pas été confirmée (pas de terminal, pas de --yes). |
aucune |
| 5 | La charge utile n’a pas passé la vérification (sha256, signatures) : téléchargez à nouveau le fichier. Avec --uninstall : refusé, l’agent exécute le RCM de l’hôte et d’autres agents l’utilisent (section 7) |
aucune |
| 6 | Des bibliothèques de l’OS manquent et le dépôt de paquets n’est pas joignable | aucune |
| 7 | Un Firebird issu des paquets de la distribution est installé | aucune |
10. Dépannage
| Problème | Que faire |
|---|---|
run as root (sudo sh ...) |
Exécutez l’installateur avec sudo ou en tant que root |
| Les pages de l’interface texte ne s’ouvrent pas | La première ligne indique pourquoi : needs a window of 80x24 or larger (agrandissez la fenêtre ; tmux avec une ligne d’état prend une ligne) ou needs bash 4.4 or newer. L’installateur simple qui s’exécute alors réalise la même installation |
| Caractères erronés ou lignes cassées sur les pages | Réglez le terminal en UTF-8, ou exécutez avec --lang en ; --no-tui lance l’installateur simple |
/var/tmp is mounted noexec |
Relancez avec --tmpdir /root (tout dossier où les programmes peuvent s’exécuter) |
is damaged or cut (code de sortie 5) |
Copiez à nouveau le fichier .run et comparez son sha256sum avec la valeur publiée |
| Code de sortie 6, bibliothèques manquantes | Préparez les paquets comme indiqué (section 9), puis relancez l’installateur |
| Code de sortie 7, Firebird issu des paquets de la distro | Supprimez les paquets (apt-get remove firebird3.0-server, conservez une sauvegarde gbak) ou utilisez l’installateur en ligne avec --import-firebird |
refused (M17): Firebird 2.5 works only in /opt/firebird |
Un second Firebird 2.5 n’est pas possible ; installez une autre ligne à côté (section 7) |
--uninstall refusé (code de sortie 1) avec plusieurs agents |
Ajoutez --agent-dir avec un dossier de la liste, par exemple --agent-dir /opt/hqbird/fbagent-fb50-2 |
--uninstall refusé (code de sortie 5) : this agent runs the RCM of the host |
Supprimez d’abord le cluster dans la console RCM, ou relancez avec --force (section 7) |
no permission for read-write access sur employee.fdb après une mise à jour (3.0) |
sudo chmod 660 /opt/firebird/examples/empbuild/employee.fdb (section 6) |
refused (M14): the folder is not empty |
Choisissez un dossier vide ou nouveau avec --fb-root, ou nommez le Firebird à mettre à jour |
| Code de sortie 2 ou 3 | Lisez /var/log/fbagent/install.log ; les unités sont revenues à leur état avant l’exécution (code 2) ou nécessitent une vérification (code 3) |
| HQ Monitor ne s’ouvre pas | systemctl status hqbirdmonitor-fb50 (hqbirdmonitor-p<port> avant 2027.2.9) ; vérifiez que rien d’autre n’écoute sur le port ; ouvrez le port dans le pare-feu ; --hqmonitor-port pour un autre port |
| Mot de passe HQ Monitor perdu | Relancez l’installateur (réparation) avec --hqmonitor-login admin --hqmonitor-password-file <file> ; l’ancien /opt/hqbird/conf/access.properties est conservé sous access.properties.bak-<time>. La nouvelle connexion vaut pour toutes les instances de l’hôte |
| L’e-mail d’essai n’a pas été envoyé (pas de réseau) | Envoyez-le plus tard : cd /opt/hqbird/fbagent-fb50 && sudo -u firebird ./fbagent --trial-email <address> --accept-privacy |
| SELinux (AlmaLinux, RHEL) | Pris en charge en mode enforcing : l’installateur restaure les contextes des fichiers qu’il écrit ; rien à faire |