Suppression de HQbird 2027
Ce guide est destiné à l’administrateur qui supprime HQbird 2027 d’un serveur.
Il couvre l’installateur Windows hqbird2027-fbNN-setup-<version>.exe et
l’installateur Linux hqbird2027-fbNN-linux-<version>.run.
Les exemples montrent Firebird 5.0 (fb50). Pour Firebird 2.5, 3.0 et 4.0, utilisez
fb25, fb30, fb40 dans les noms de fichiers, de dossiers et de services.
L’installation est décrite dans
Installation Windows et
Installation Linux.
HQbird 2024 est supprimé avec les instructions précédentes.
1. Avant de commencer
- Faites une sauvegarde de chaque base de données (
gbakounbackup) et copiez-la sur un autre disque ou serveur. La suppression ne supprime pas les fichiers de base de données, mais une sauvegarde vous protège d’une erreur. - Arrêtez les applications qui utilisent les bases de données. Sous Windows, la suppression arrête le Firebird que l’installateur a installé.
- Serveurs en cluster : si ce serveur exécute la console de cluster RCM, supprimez d’abord le cluster dans RCM et dissociez ses agents (section 4).
- HQCenter : la suppression ne supprime pas l’enregistrement du serveur dans votre HQCenter. Supprimez-y l’agent après la suppression, si vous ne prévoyez pas de réinstaller HQbird.
- Licence : la suppression avec les données supprime l’état de licence de l’agent. Conservez votre fichier de licence si vous prévoyez de réinstaller HQbird.
2. Ce qui est supprimé et ce qui reste
| Élément | Windows | Linux |
|---|---|---|
| Agent HQbird (service ou unité, programmes) | supprimé | supprimé |
| HQbird Monitor (service ou unité, règle de pare-feu) | supprimé | supprimé |
| Firebird que HQbird 2027 a installé à neuf | supprimé (service, fichiers de programme, règle de pare-feu) | reste |
| Firebird qui existait avant et a seulement été mis à jour | reste | reste |
Fichiers de base de données (*.fdb, *.gdb, *.fbk, *.nbk) |
restent toujours | restent toujours |
| Configuration de l’agent, journaux, état de licence, données de HQbird Monitor | restent ; supprimés avec l’option de données | restent ; supprimés avec --remove-data |
Base de données de sécurité et fichiers *.conf de Firebird |
restent ; supprimés avec l’option de données | restent |
| Services d’un HQbird plus ancien (2024 et antérieur) que la mise à jour a désactivés | restent désactivés | restent désactivés |
L’option de données sous Windows ne supprime que ce qu’une installation HQbird 2027 a créé. Les données d’un agent qui existait avant la première installation de HQbird 2027 restent.
3. Windows
Une entrée dans Applications et fonctionnalités = une ligne Firebird. Le désinstallateur d’une ligne supprime toutes les instances de cette ligne. Exécutez-le en tant qu’administrateur.
3.1. Supprimer une ligne entière
- Ouvrez Paramètres → Applications → Applications et fonctionnalités (ou Programmes et fonctionnalités).
- Sélectionnez HQbird 2027 (Firebird 5.0) et cliquez sur Désinstaller.
- Confirmez la suppression.
- Répondez à la question sur les données : Non conserve la configuration et la base de données de sécurité, Oui les supprime également.
- Attendez le message indiquant que HQbird a été supprimé.
Répétez ces étapes pour chaque ligne Firebird sur le serveur (une entrée par ligne).
3.2. Supprimer une instance
Utilisez cette procédure lorsqu’une ligne a plusieurs instances et que vous n’en supprimez qu’une.
- Ouvrez Démarrer → Maintenance de HQbird 2027 (Firebird 5.0).
- Sélectionnez Supprimer une instance et sélectionnez l’instance.
- Confirmez, puis répondez à la question sur les données.
Lorsque vous supprimez la dernière instance, HQbird 2027 de cette ligne est supprimé.
3.3. Suppression silencieuse
# programs and services; databases, configs and the security database stay
& 'C:\HQbird\setup\fb50\unins000.exe' /VERYSILENT
# the same, and the agent data, HQbird Monitor data, the security database and *.conf too
& 'C:\HQbird\setup\fb50\unins000.exe' /VERYSILENT /REMOVEDATA
# remove also an instance that runs the RCM of a cluster (section 4)
& 'C:\HQbird\setup\fb50\unins000.exe' /VERYSILENT /FORCELe dossier du désinstallateur est <HQbird folder>\setup\fb50. Les lignes installées par
des installateurs antérieurs à 2027.2.8 l’ont dans
C:\Program Files\IBSurgeon\HQbird 2027\fb50. Le dossier exact est la
valeur InstallLocation de l’entrée Applications :
Get-ItemProperty 'HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\*' | Where-Object DisplayName -like 'HQbird 2027*' | Select-Object DisplayName, InstallLocation, UninstallString3.4. Vérifier le résultat
Get-Service | Where-Object Name -match 'HQbird|Firebird|hqbirdrcm|hqclusternode'
Test-Path 'HKLM:\SOFTWARE\IBSurgeon\HQbird2027\fb50'
Get-NetFirewallRule -DisplayName 'HQbird Monitor*', 'Firebird *' -ErrorAction SilentlyContinueAttendu : aucun service HQbird de cette ligne, et False pour la clé de registre.
Le désinstallateur ne supprime la clé de registre qu’après une suppression complète. Si
la clé est toujours présente, exécutez à nouveau le désinstallateur.
3.5. Ce qui reste sur le disque
| Dossier | Contenu | Supprimer manuellement ? |
|---|---|---|
C:\HQbird\Firebird50\ |
Fichiers de base de données et, sans l’option de données, la base de données de sécurité et *.conf |
Après avoir déplacé les bases de données |
C:\HQbird\fbagent-fb50\ |
Configuration et journaux de l’agent, si vous avez conservé les données | Oui, si vous n’en avez pas besoin |
C:\HQbirdData\ |
Données de travail de l’agent, données de HQbird Monitor et fichier de connexion, si vous avez conservé les données | Oui, si vous n’en avez pas besoin |
C:\HQbird\hqbirdrcm\ |
Données RCM (partent uniquement avec l’option de données) | Oui, une fois le cluster supprimé |
C:\ProgramData\fbagent\ |
install.log, résultat de la dernière exécution de l’installateur |
Oui |
C:\ProgramData\HQbird\fbagent\ |
Fichier de mot de passe SYSDBA d’une installation silencieuse | Oui |
<Firebird folder>.old_<time> |
Copie de l’ancien dossier de programme Firebird issue d’une mise à jour | Oui, lorsque la mise à jour est confirmée |
Le service fbmcp est partagé par toutes les lignes du serveur. Il reste tant qu’une autre ligne l’utilise, et il est supprimé avec la dernière ligne.
4. Serveurs dans un cluster
L’agent qui exécute le RCM détient l’autorité de certification (CA) du cluster. Lorsque d’autres agents utilisent ce RCM, la suppression est refusée et rien n’est modifié.
Ordre recommandé :
- Supprimez le cluster dans la console RCM et dissociez ses agents.
- Supprimez HQbird des serveurs membres.
- Supprimez HQbird du serveur qui exécute le RCM.
Pour supprimer malgré tout le propriétaire du RCM :
- Windows, boîte de dialogue : le désinstallateur demande « Supprimer cette instance malgré tout ? Le cluster perd son CA RCM. » Répondez Oui.
- Windows, silencieux : ajoutez
/FORCE. Sans cela, l’instance qui exécute le RCM reste, et le journal en indique la raison. - Linux : l’installateur s’arrête avec le code de sortie 5. Exécutez-le à nouveau avec
--force.
Après une suppression forcée, le cluster n’a plus de CA : aucun nouveau certificat et aucun
nouveau membre. Pour faire d’un autre agent le propriétaire d’un nouveau RCM, exécutez-y
fbagent --cluster-init <id> --rcm-takeover et associez à nouveau les membres.
5. Linux
Exécutez le même fichier .run qui a installé HQbird (ou un plus récent de la même
ligne) en tant que root. Les exemples utilisent la version 2027.2.33.
5.1. Supprimer l’agent et HQbird Monitor
# the agent and HQbird Monitor; Firebird, databases, configuration and logs stay
sudo sh hqbird2027-fb50-linux-2027.2.33.run --uninstall# the same, and the agent folder (configuration, logs, license state) and HQbird Monitor data too
sudo sh hqbird2027-fb50-linux-2027.2.33.run --uninstall --remove-dataLa commande arrête et supprime les unités hqbirdfbagent-fb50 et
hqbirdmonitor-fb50, les programmes fbagent et hqmonitor, et les
règles sudoers de l’agent. Elle ferme le port de HQbird Monitor que
l’installation avait ouvert dans firewalld ou ufw.
5.2. Plusieurs instances sur un même hôte
Sans --agent-dir, l’installateur supprime l’unique agent dans
/opt/hqbird. Avec plusieurs agents, il s’arrête avec le code de sortie 1 et liste
leurs dossiers. Nommez le dossier :
sudo sh hqbird2027-fb50-linux-2027.2.33.run --uninstall --agent-dir /opt/hqbird/fbagent-fb50-2Exécutez la commande une fois pour chaque agent. Le fichier de connexion partagé de HQbird Monitor reste jusqu’à la suppression du dernier agent.
5.3. Supprimer Firebird (facultatif, manuellement)
L’installateur ne supprime jamais Firebird sous Linux. Faites-le manuellement uniquement après avoir effectué des sauvegardes et déplacé les bases de données hors du dossier Firebird.
Noms des unités Firebird :
| Dossier Firebird | Ligne | Unité |
|---|---|---|
/opt/firebird |
2.5, 4.0, 5.0 | firebird |
/opt/firebird |
3.0 | firebird-superserver |
un autre dossier, par exemple /opt/fb50-2 |
4.0, 5.0 | firebird.opt_fb50-2 |
un autre dossier, par exemple /opt/fb30 |
3.0 | firebird.opt_fb30-superserver |
Exemple pour 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 $BAvertissement : rm -rf supprime tout dans le dossier, y compris les bases de données
et la base de données de sécurité qui s’y trouvent. Vérifiez d’abord le dossier.
5.4. Vérifier le résultat
systemctl list-unit-files 'hqbird*' 'hqclusternode*' 'firebird*' --no-legend
ls /opt/hqbird /var/lib/hqmonitor 2>/dev/nullAttendu : aucune unité hqbirdfbagent-fb50 et hqbirdmonitor-fb50. L’unité
Firebird est toujours présente, sauf si vous avez supprimé Firebird manuellement.
5.5. Ce qui reste sur le disque
| Chemin | Contenu | Supprimer manuellement ? |
|---|---|---|
/opt/hqbird/fbagent-fb50/ |
Configuration et journaux de l’agent (sans --remove-data) |
Oui, si vous n’en avez pas besoin |
/var/lib/hqmonitor/ |
Données de HQbird Monitor (sans --remove-data) |
Oui, si vous n’en avez pas besoin |
/opt/hqbirdrcm/ |
RCM, tant que d’autres agents de l’hôte l’utilisent | Une fois le cluster supprimé |
/opt/fbagent-update-backup/ |
Fichiers de programme Firebird remplacés par les mises à jour | Oui, lorsque les mises à jour sont confirmées |
/opt/hqbird/fbagent-hqbird-takeover.json |
État des unités HQbird plus anciennes avant la mise à jour | Conservez-le si vous prévoyez de revenir à l’ancien HQbird |
/opt/firebird (ou votre dossier Firebird) |
Firebird et ses bases de données | Section 5.3 |
5.6. Codes de sortie de --uninstall
| Code | Signification | Que faire |
|---|---|---|
| 0 | Supprimé | — |
| 1 | Refusé : plusieurs agents sur l’hôte, ou option incorrecte | Ajoutez --agent-dir avec un dossier de la liste |
| 5 | Refusé : cet agent exécute le RCM de l’hôte et d’autres agents l’utilisent | Section 4 |
6. Un HQbird plus ancien après la suppression
Lorsque HQbird 2027 a remplacé un HQbird plus ancien (2024 et antérieur), la mise à jour a désactivé les services de l’ancien HQbird. La suppression de HQbird 2027 ne les réactive pas. Leur état avant la mise à jour est enregistré dans :
- Windows :
<HQbird folder>\fbagent-hqbird-takeover.json - Linux :
/opt/hqbird/fbagent-hqbird-takeover.json
Utilisez ce fichier pour voir quels services étaient actifs, et démarrez-les manuellement si vous revenez à l’ancien HQbird.
7. Dépannage
| Problème | Que faire |
|---|---|
| Windows : l’entrée dans Applications et fonctionnalités reste après la suppression | Une instance n’a pas été supprimée (souvent celle qui exécute le RCM). Exécutez à nouveau le désinstallateur ; pour le propriétaire du RCM, voir la section 4 |
| Windows : une erreur générale et une commande d’un ancien désinstallateur | L’agent s’est mis à jour vers 3.1.0 ou une version plus récente et refuse de supprimer le propriétaire du RCM. Ajoutez --force à la commande affichée, ou exécutez le désinstallateur d’un installateur plus récent |
| Windows : versions de test 2027.0.1 et 2027.0.2 | Elles utilisaient une seule entrée pour toutes les lignes. Supprimez-les avec leur propre désinstallateur |
Linux : --uninstall refusé, code de sortie 1 |
Plusieurs agents sur l’hôte : ajoutez --agent-dir (section 5.2) |
Linux : --uninstall refusé, code de sortie 5 |
L’agent exécute le RCM de l’hôte : section 4 |
Linux : run as root (sudo sh ...) |
Exécutez l’installateur avec sudo ou en tant que root |
Linux : le fichier .run est perdu |
Téléchargez à nouveau l’installateur de la même ligne ; une version plus récente de la même ligne fonctionne aussi |