HQbird 2027 Entfernung
Diese Anleitung richtet sich an den Administrator, der HQbird 2027 von einem Server entfernt.
Sie behandelt das Windows-Setup hqbird2027-fbNN-setup-<version>.exe und den
Linux-Installer hqbird2027-fbNN-linux-<version>.run.
Die Beispiele zeigen Firebird 5.0 (fb50). Für Firebird 2.5, 3.0 und 4.0 verwenden Sie
fb25, fb30, fb40 in den Datei-, Ordner- und Dienstnamen. Die
Installation ist beschrieben in
Windows-Installation und
Linux-Setup.
HQbird 2024 wird mit den vorherigen Anweisungen entfernt.
1. Bevor Sie beginnen
- Erstellen Sie eine Sicherung jeder Datenbank (
gbakodernbackup) und kopieren Sie sie auf eine andere Festplatte oder einen anderen Server. Die Entfernung löscht keine Datenbankdateien, aber eine Sicherung schützt Sie vor einem Fehler. - Stoppen Sie die Anwendungen, die die Datenbanken verwenden. Unter Windows stoppt die Entfernung die Firebird-Instanz, die das Setup installiert hat.
- Clusterserver: Wenn dieser Server die Clusterkonsole RCM ausführt, löschen Sie zuerst den Cluster in RCM und trennen Sie seine Agents (Abschnitt 4).
- HQCenter: Die Entfernung löscht nicht den Servereintrag in Ihrem HQCenter. Entfernen Sie den Agent dort nach der Entfernung, wenn Sie nicht planen, HQbird erneut zu installieren.
- Lizenz: Die Entfernung mit den Daten löscht den Lizenzstatus des Agents. Bewahren Sie Ihre Lizenzdatei auf, wenn Sie planen, HQbird erneut zu installieren.
2. Was entfernt wird und was bleibt
| Element | Windows | Linux |
|---|---|---|
| HQbird Agent (Dienst oder Unit, Programme) | entfernt | entfernt |
| HQbird Monitor (Dienst oder Unit, Firewall-Regel) | entfernt | entfernt |
| Firebird, das HQbird 2027 neu installiert hat | entfernt (Dienst, Programmdateien, Firewall-Regel) | bleibt |
| Firebird, das bereits vorhanden war und nur aktualisiert wurde | bleibt | bleibt |
Datenbankdateien (*.fdb, *.gdb, *.fbk, *.nbk) |
bleiben immer | bleiben immer |
| Agent-Konfiguration, Logs, Lizenzstatus, HQbird Monitor-Daten | bleiben; entfernt mit der Datenoption | bleiben; entfernt mit --remove-data |
Sicherheitsdatenbank und *.conf-Dateien von Firebird |
bleiben; entfernt mit der Datenoption | bleiben |
| Dienste eines älteren HQbird (2024 und früher), die das Update deaktiviert hat | bleiben deaktiviert | bleiben deaktiviert |
Die Datenoption unter Windows entfernt nur das, was ein HQbird 2027-Setup erstellt hat. Die Daten eines Agents, der vor dem ersten HQbird 2027-Setup vorhanden war, bleiben.
3. Windows
Ein Eintrag in Apps & Features = eine Firebird-Linie. Der Uninstaller einer Linie entfernt alle Instanzen dieser Linie. Führen Sie ihn als Administrator aus.
3.1. Eine ganze Linie entfernen
- Öffnen Sie Einstellungen → Apps → Apps & Features (oder Programme und Features).
- Wählen Sie HQbird 2027 (Firebird 5.0) und klicken Sie auf Deinstallieren.
- Bestätigen Sie die Entfernung.
- Beantworten Sie die Frage zu den Daten: Nein behält die Konfiguration und die Sicherheitsdatenbank, Ja entfernt sie ebenfalls.
- Warten Sie auf die Meldung, dass HQbird entfernt wurde.
Wiederholen Sie diese Schritte für jede Firebird-Linie auf dem Server (ein Eintrag pro Linie).
3.2. Eine Instanz entfernen
Verwenden Sie dies, wenn eine Linie mehrere Instanzen hat und Sie nur eine entfernen.
- Öffnen Sie Start → HQbird 2027 (Firebird 5.0) Wartung.
- Wählen Sie Eine Instanz entfernen und wählen Sie die Instanz.
- Bestätigen Sie, und beantworten Sie dann die Frage zu den Daten.
Wenn Sie die letzte Instanz entfernen, wird HQbird 2027 dieser Linie entfernt.
3.3. Stille Entfernung
# 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 /FORCEDer Uninstaller-Ordner ist <HQbird folder>\setup\fb50. Linien, die von
Setups vor 2027.2.8 installiert wurden, haben ihn in
C:\Program Files\IBSurgeon\HQbird 2027\fb50. Der genaue Ordner ist der
InstallLocation-Wert des Apps-Eintrags:
Get-ItemProperty 'HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\*' | Where-Object DisplayName -like 'HQbird 2027*' | Select-Object DisplayName, InstallLocation, UninstallString3.4. Das Ergebnis prüfen
Get-Service | Where-Object Name -match 'HQbird|Firebird|hqbirdrcm|hqclusternode'
Test-Path 'HKLM:\SOFTWARE\IBSurgeon\HQbird2027\fb50'
Get-NetFirewallRule -DisplayName 'HQbird Monitor*', 'Firebird *' -ErrorAction SilentlyContinueErwartet: keine HQbird-Dienste dieser Linie und False für den Registrierungsschlüssel.
Der Uninstaller löscht den Registrierungsschlüssel erst nach einer vollständigen Entfernung. Wenn
der Schlüssel noch vorhanden ist, führen Sie den Uninstaller erneut aus.
3.5. Was auf der Festplatte verbleibt
| Ordner | Inhalt | Von Hand löschen? |
|---|---|---|
C:\HQbird\Firebird50\ |
Datenbankdateien und, ohne die Datenoption, die Sicherheitsdatenbank und *.conf |
Nachdem Sie die Datenbanken verschoben haben |
C:\HQbird\fbagent-fb50\ |
Agent-Konfiguration und Logs, wenn Sie die Daten behalten haben | Ja, wenn Sie sie nicht benötigen |
C:\HQbirdData\ |
Agent-Arbeitsdaten, HQbird Monitor-Daten und Anmeldedatei, wenn Sie die Daten behalten haben | Ja, wenn Sie sie nicht benötigen |
C:\HQbird\hqbirdrcm\ |
RCM-Daten (gehen nur mit der Datenoption) | Ja, nachdem der Cluster entfernt ist |
C:\ProgramData\fbagent\ |
install.log, Ergebnis des letzten Setup-Laufs |
Ja |
C:\ProgramData\HQbird\fbagent\ |
SYSDBA-Passwortdatei einer stillen Installation | Ja |
<Firebird folder>.old_<time> |
Kopie des alten Firebird-Programmordners aus einem Update | Ja, wenn das Update bestätigt ist |
Der fbmcp-Dienst wird von allen Linien des Servers gemeinsam genutzt. Er bleibt, solange eine andere Linie ihn verwendet, und wird mit der letzten Linie entfernt.
4. Server in einem Cluster
Der Agent, der das RCM ausführt, hält die Cluster-CA. Wenn andere Agents dieses RCM verwenden, wird die Entfernung verweigert und nichts geändert.
Empfohlene Reihenfolge:
- Löschen Sie den Cluster in der RCM-Konsole und trennen Sie seine Agents.
- Entfernen Sie HQbird von den Mitgliedsservern.
- Entfernen Sie HQbird von dem Server, der das RCM ausführt.
Um den RCM-Inhaber trotzdem zu entfernen:
- Windows, Dialog: Der Uninstaller fragt „Diese Instanz trotzdem entfernen? Der Cluster verliert seine RCM-CA." Antworten Sie Ja.
- Windows, still: Fügen Sie
/FORCEhinzu. Ohne dies bleibt die Instanz, die das RCM ausführt, bestehen, und das Log nennt den Grund. - Linux: Der Installer stoppt mit Exit-Code 5. Führen Sie ihn erneut mit
--forceaus.
Nach einer erzwungenen Entfernung hat der Cluster keine CA: keine neuen Zertifikate und keine
neuen Mitglieder. Um einen anderen Agent zum Inhaber eines neuen RCM zu machen, führen Sie dort
fbagent --cluster-init <id> --rcm-takeover aus und verknüpfen Sie die Mitglieder
erneut.
5. Linux
Führen Sie dieselbe .run-Datei aus, die HQbird installiert hat (oder eine neuere derselben
Linie) als root. Die Beispiele verwenden Version 2027.2.33.
5.1. Den Agent und HQbird Monitor entfernen
# 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-dataDer Befehl stoppt und entfernt die Units hqbirdfbagent-fb50 und
hqbirdmonitor-fb50, die Programme fbagent und hqmonitor sowie die
sudoers-Regeln des Agents. Er schließt den HQbird Monitor-Port, den die
Installation in firewalld oder ufw geöffnet hat.
5.2. Mehrere Instanzen auf einem Host
Ohne --agent-dir entfernt der Installer den einzigen Agent in
/opt/hqbird. Bei mehreren Agents stoppt er mit Exit-Code 1 und listet
deren Ordner auf. Benennen Sie den Ordner:
sudo sh hqbird2027-fb50-linux-2027.2.33.run --uninstall --agent-dir /opt/hqbird/fbagent-fb50-2Führen Sie den Befehl einmal für jeden Agent aus. Die gemeinsame HQbird Monitor-Anmeldedatei bleibt, bis der letzte Agent entfernt ist.
5.3. Firebird entfernen (optional, von Hand)
Der Installer entfernt Firebird unter Linux niemals. Tun Sie dies nur von Hand, nachdem Sie Sicherungen erstellt und die Datenbanken aus dem Firebird-Ordner verschoben haben.
Firebird-Unit-Namen:
| Firebird-Ordner | Linie | Unit |
|---|---|---|
/opt/firebird |
2.5, 4.0, 5.0 | firebird |
/opt/firebird |
3.0 | firebird-superserver |
ein anderer Ordner, zum Beispiel /opt/fb50-2 |
4.0, 5.0 | firebird.opt_fb50-2 |
ein anderer Ordner, zum Beispiel /opt/fb30 |
3.0 | firebird.opt_fb30-superserver |
Beispiel für das Firebird in /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 $BWarnung: rm -rf löscht alles im Ordner, auch die Datenbanken
und die Sicherheitsdatenbank, die sich darin befinden. Prüfen Sie zuerst den Ordner.
5.4. Das Ergebnis prüfen
systemctl list-unit-files 'hqbird*' 'hqclusternode*' 'firebird*' --no-legend
ls /opt/hqbird /var/lib/hqmonitor 2>/dev/nullErwartet: keine Units hqbirdfbagent-fb50 und hqbirdmonitor-fb50. Die
Firebird-Unit ist weiterhin vorhanden, es sei denn, Sie haben Firebird von Hand entfernt.
5.5. Was auf der Festplatte verbleibt
| Pfad | Inhalt | Von Hand löschen? |
|---|---|---|
/opt/hqbird/fbagent-fb50/ |
Agent-Konfiguration und Logs (ohne --remove-data) |
Ja, wenn Sie sie nicht benötigen |
/var/lib/hqmonitor/ |
HQbird Monitor-Daten (ohne --remove-data) |
Ja, wenn Sie sie nicht benötigen |
/opt/hqbirdrcm/ |
RCM, solange andere Agents des Hosts es verwenden | Nachdem der Cluster entfernt ist |
/opt/fbagent-update-backup/ |
Firebird-Programmdateien, die Updates ersetzt haben | Ja, wenn die Updates bestätigt sind |
/opt/hqbird/fbagent-hqbird-takeover.json |
Status der älteren HQbird-Units vor dem Update | Behalten Sie sie, wenn Sie planen, zum älteren HQbird zurückzukehren |
/opt/firebird (oder Ihr Firebird-Ordner) |
Firebird und seine Datenbanken | Abschnitt 5.3 |
5.6. Exit-Codes von --uninstall
| Code | Bedeutung | Was zu tun ist |
|---|---|---|
| 0 | Entfernt | — |
| 1 | Verweigert: mehrere Agents auf dem Host oder eine falsche Option | Fügen Sie --agent-dir mit einem Ordner aus der Liste hinzu |
| 5 | Verweigert: Dieser Agent führt das RCM des Hosts aus und andere Agents verwenden es | Abschnitt 4 |
6. Ein älterer HQbird nach der Entfernung
Wenn HQbird 2027 einen älteren HQbird (2024 und früher) ersetzt hat, hat das Update die Dienste des älteren HQbird deaktiviert. Die Entfernung von HQbird 2027 aktiviert sie nicht wieder. Ihr Status vor dem Update ist gespeichert in:
- Windows:
<HQbird folder>\fbagent-hqbird-takeover.json - Linux:
/opt/hqbird/fbagent-hqbird-takeover.json
Verwenden Sie diese Datei, um zu sehen, welche Dienste aktiv waren, und starten Sie sie von Hand, wenn Sie zum älteren HQbird zurückkehren.
7. Fehlerbehebung
| Problem | Was zu tun ist |
|---|---|
| Windows: Der Eintrag in Apps & Features bleibt nach der Entfernung bestehen | Eine Instanz wurde nicht entfernt (oft diejenige, die das RCM ausführt). Führen Sie den Uninstaller erneut aus; zum RCM-Inhaber siehe Abschnitt 4 |
| Windows: ein allgemeiner Fehler und ein Befehl von einem alten Uninstaller | Der Agent hat sich selbst auf 3.1.0 oder neuer aktualisiert und verweigert die Entfernung des RCM-Inhabers. Fügen Sie --force zum angezeigten Befehl hinzu oder führen Sie den Uninstaller eines neueren Setups aus |
| Windows: Test-Builds 2027.0.1 und 2027.0.2 | Sie verwendeten einen Eintrag für alle Linien. Entfernen Sie sie mit ihrem eigenen Uninstaller |
Linux: --uninstall verweigert, Exit-Code 1 |
Mehrere Agents auf dem Host: Fügen Sie --agent-dir hinzu (Abschnitt 5.2) |
Linux: --uninstall verweigert, Exit-Code 5 |
Der Agent führt das RCM des Hosts aus: Abschnitt 4 |
Linux: run as root (sudo sh ...) |
Führen Sie den Installer mit sudo oder als root aus |
Linux: Die .run-Datei ist verloren |
Laden Sie den Installer derselben Linie erneut herunter; eine neuere Version derselben Linie funktioniert ebenfalls |