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

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

  1. Faites une sauvegarde de chaque base de données (gbak ou nbackup) 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.
  2. Arrêtez les applications qui utilisent les bases de données. Sous Windows, la suppression arrête le Firebird que l’installateur a installé.
  3. 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).
  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.
  5. 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

  1. Ouvrez Paramètres → Applications → Applications et fonctionnalités (ou Programmes et fonctionnalités).
  2. Sélectionnez HQbird 2027 (Firebird 5.0) et cliquez sur Désinstaller.
  3. Confirmez la suppression.
  4. 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.
  5. 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.

  1. Ouvrez Démarrer → Maintenance de HQbird 2027 (Firebird 5.0).
  2. Sélectionnez Supprimer une instance et sélectionnez l’instance.
  3. 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

Command
# 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 /FORCE

Le 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 :

Command
Get-ItemProperty 'HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\*' | Where-Object DisplayName -like 'HQbird 2027*' | Select-Object DisplayName, InstallLocation, UninstallString

3.4. Vérifier le résultat

Command
Get-Service | Where-Object Name -match 'HQbird|Firebird|hqbirdrcm|hqclusternode'
Test-Path 'HKLM:\SOFTWARE\IBSurgeon\HQbird2027\fb50'
Get-NetFirewallRule -DisplayName 'HQbird Monitor*', 'Firebird *' -ErrorAction SilentlyContinue

Attendu : 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é :

  1. Supprimez le cluster dans la console RCM et dissociez ses agents.
  2. Supprimez HQbird des serveurs membres.
  3. 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

Command
# the agent and HQbird Monitor; Firebird, databases, configuration and logs stay
sudo sh hqbird2027-fb50-linux-2027.2.33.run --uninstall
Command
# 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-data

La 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 :

Command
sudo sh hqbird2027-fb50-linux-2027.2.33.run --uninstall --agent-dir /opt/hqbird/fbagent-fb50-2

Exé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 :

Command
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 $B

Avertissement : 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

Command
systemctl list-unit-files 'hqbird*' 'hqclusternode*' 'firebird*' --no-legend
ls /opt/hqbird /var/lib/hqmonitor 2>/dev/null

Attendu : 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