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

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.

ComposantRôleWindowsLinux
Firebird, build HQbirdUn 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 fbagentSauvegardes, supervision, maintenance, mises à jour.HQbirdFBAgent-fb50hqbirdfbagent-fb50, utilisateur firebird
HQbird MonitorConsole 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-fb50hqbirdmonitor-fb50
Composants de clusterLes 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 fbmcpAccè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 FirebirdSymboles 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.

Sur le serveur

        


          


          

  1. 1Vérification du serveurdroits, architecture ; sous Linux aussi systemd et le noyau
  2. 2Vérification du kitsha256 avant le déballage ; signatures des fichiers avant l'installation
  3. 3Plance qui a été trouvé et ce qui sera fait
  4. 4Questionsnom du serveur pour HQCenter ; arrêter Firebird ? une autre version ?
  5. 5InstallationFirebird, agent, console, services
  6. 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.

CodeSignification (.run Linux)
0Terminé
1Refusé : serveur, commutateur ou plan. Rien n'a changé
2Échec de l'installation, modifications annulées
3Retour arrière incomplet : le résultat indique quoi vérifier
4Réponse requise : pas de terminal et pas de --yes
5Échec de la vérification du kit : téléchargez-le à nouveau
6Pas de bibliothèques système d'exploitation et pas de dépôt
7Firebird provenant des paquets de la distribution
CodeSignification (setup.exe Windows)
0Installé
1Refusé avant l'installation : commutateur ou fichier incorrect, une version plus récente est installée, pas de droits d'administrateur
4L'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
10Installé, mais la connexion à HQCenter a échoué
Plan dans l'assistant. « Found on this computer » et « Setup will do the following ». En bas : rien ne change tant que vous n'avez pas cliqué sur Install.
Résultat. Ce qui est installé, l'adresse de la console depuis cet ordinateur et depuis un autre, l'emplacement du mot de passe de connexion. Extrait d'une build précoce : les noms du service de l'agent et des dossiers y utilisent le port (-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.

Passer de HQbird 2024 : les tâches FBDataGuard passent à l'agent HQbird 2027, Firebird est mis à jour sur place, les anciens services HQbird sont désactivés
  • Ce qui ne change pasdatabases.conf ou aliases.conf, la base de sécurité, le mot de passe SYSDBA, les bases de données, les sauvegardes et les anciens fichiers HQbird. Dans firebird.conf, seule la ligne MonitoringPlugin = fblwmon est 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.

Ajouter
  • 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 -2 dans 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-port définit l'emplacement explicitement.
Deux instances d'une même version. Le plan voit les deux serveurs Firebird et les deux agents et ne modifie que l'instance sélectionnée.

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.

ImageFirebirdPort FirebirdHQbird Monitor
ghcr.io/ibsurgeon/hqbird2027-fb505.0305023050
ghcr.io/ibsurgeon/hqbird2027-fb404.0305023050
ghcr.io/ibsurgeon/hqbird2027-fb303.0305023050
ghcr.io/ibsurgeon/hqbird2027-fb252.5305023050
  • Premier démarrageCopiez compose.yaml depuis le kit, placez le mot de passe SYSDBA dans un fichier secret, retirez le # des lignes secrets: et exécutez docker compose up -d. Le serveur est prêt lorsque docker compose ps affiche healthy.
  • 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, pas 3051: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 à jour

Agent · 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. agent est la valeur par défaut. all installe aussi Firebird, dans la fenêtre de mise à jour. off ne 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

Auto-mise à jour de l'agent : vérifications, point de restauration, remplacement, prêt en 180 s, 45 s d'exécution ; en cas d'échec : restauration, pause de 30 min, version bloquée après le 2e échec
  • 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.

  1. 1Préparationtéléchargement, signature, build pas plus ancien que le moteur
  2. 2Fenêtrefenêtre quotidienne ; une version obligatoire attend aussi la fenêtre
  3. 3Tâchesgbak, nbackup ou un script SQL est en cours : la tentative est reportée
  4. 4Remplacementles anciens fichiers du moteur sont mis de côté, les configurations restent
  5. 5VérificationFirebird démarre et répond sur son port
  6. 6✓ ou restaurationles anciens fichiers reviennent, le build est bloqué
Ce qui est mis à jourProtectionEn cas d'échec
agent fbagentSignature, plus récent uniquement, prêt en 180 s et 45 s d'exécutionRestauration, pause de 30 minutes ; un second échec bloque la version
HQbird Monitor, cluster, fbmcpSignature, plus récent que l'installé uniquementLa version précédente reste ; les 2 dernières copies sont conservées
FirebirdFenêtre, attente des sauvegardes, vérification après démarrageL'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--uninstall supprime 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-data supprime 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.
Linux, désinstaller une instance (Firebird et les bases de données restent) :
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 →