Verwijdering van HQbird 2027
Deze handleiding is voor de beheerder die HQbird 2027 van een server verwijdert.
Het behandelt de Windows-setup hqbird2027-fbNN-setup-<version>.exe en de
Linux-installer hqbird2027-fbNN-linux-<version>.run.
De voorbeelden tonen Firebird 5.0 (fb50). Gebruik voor Firebird 2.5, 3.0 en 4.0
fb25, fb30, fb40 in de bestands-, map- en servicenamen. De
installatie wordt beschreven in
Windows-installatie en
Linux-setup.
HQbird 2024 wordt verwijderd met de vorige instructies.
1. Voordat u begint
- Maak een back-up van elke database (
gbakofnbackup) en kopieer deze naar een andere schijf of server. De verwijdering verwijdert geen databasebestanden, maar een back-up beschermt u tegen een fout. - Stop de applicaties die de databases gebruiken. Op Windows stopt de verwijdering de Firebird die de setup heeft geïnstalleerd.
- Clusterservers: als deze server de clusterconsole RCM draait, verwijder dan eerst het cluster in RCM en ontkoppel de agents (sectie 4).
- HQCenter: de verwijdering verwijdert de serverrecord in uw HQCenter niet. Verwijder de agent daar na de verwijdering, als u niet van plan bent HQbird opnieuw te installeren.
- Licentie: verwijdering met de data verwijdert de licentiestatus van de agent. Bewaar uw licentiebestand als u van plan bent HQbird opnieuw te installeren.
2. Wat wordt verwijderd en wat blijft
| Item | Windows | Linux |
|---|---|---|
| HQbird-agent (service of unit, programma’s) | verwijderd | verwijderd |
| HQbird Monitor (service of unit, firewallregel) | verwijderd | verwijderd |
| Firebird die HQbird 2027 nieuw heeft geïnstalleerd | verwijderd (service, programmabestanden, firewallregel) | blijft |
| Firebird die al bestond en alleen is bijgewerkt | blijft | blijft |
Databasebestanden (*.fdb, *.gdb, *.fbk, *.nbk) |
blijven altijd | blijven altijd |
| Agentconfiguratie, logs, licentiestatus, HQbird Monitor-gegevens | blijven; verwijderd met de data-optie | blijven; verwijderd met --remove-data |
Beveiligingsdatabase en *.conf-bestanden van Firebird |
blijven; verwijderd met de data-optie | blijven |
| Services van een oudere HQbird (2024 en eerder) die de update heeft uitgeschakeld | blijven uit | blijven uit |
De data-optie op Windows verwijdert alleen wat een HQbird 2027-setup heeft gemaakt. De gegevens van een agent die er vóór de eerste HQbird 2027-setup waren, blijven.
3. Windows
Eén vermelding in Apps en onderdelen = één Firebird-regel. Het verwijderprogramma van een regel verwijdert alle instanties van die regel. Voer het uit als administrator.
3.1. Een hele regel verwijderen
- Open Instellingen → Apps → Apps en onderdelen (of Programma’s en onderdelen).
- Selecteer HQbird 2027 (Firebird 5.0) en klik op Verwijderen.
- Bevestig de verwijdering.
- Beantwoord de vraag over de gegevens: Nee behoudt de configuratie en de beveiligingsdatabase, Ja verwijdert ze ook.
- Wacht op de melding dat HQbird is verwijderd.
Herhaal deze stappen voor elke Firebird-regel op de server (één vermelding per regel).
3.2. Eén instantie verwijderen
Gebruik dit wanneer een regel meerdere instanties heeft en u er slechts één verwijdert.
- Open Start → HQbird 2027 (Firebird 5.0) maintenance.
- Selecteer Remove an instance en selecteer de instantie.
- Bevestig en beantwoord vervolgens de vraag over de gegevens.
Wanneer u de laatste instantie verwijdert, wordt HQbird 2027 van deze regel verwijderd.
3.3. Stille verwijdering
# 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 /FORCEDe map van het verwijderprogramma is <HQbird folder>\setup\fb50. Regels die zijn geïnstalleerd door
setups vóór 2027.2.8 hebben deze in
C:\Program Files\IBSurgeon\HQbird 2027\fb50. De exacte map is de
InstallLocation-waarde van de Apps-vermelding:
Get-ItemProperty 'HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\*' | Where-Object DisplayName -like 'HQbird 2027*' | Select-Object DisplayName, InstallLocation, UninstallString3.4. Het resultaat controleren
Get-Service | Where-Object Name -match 'HQbird|Firebird|hqbirdrcm|hqclusternode'
Test-Path 'HKLM:\SOFTWARE\IBSurgeon\HQbird2027\fb50'
Get-NetFirewallRule -DisplayName 'HQbird Monitor*', 'Firebird *' -ErrorAction SilentlyContinueVerwacht: geen HQbird-services van deze regel, en False voor de registersleutel.
Het verwijderprogramma verwijdert de registersleutel pas na een volledige verwijdering. Als
de sleutel er nog is, voer het verwijderprogramma opnieuw uit.
3.5. Wat op de schijf achterblijft
| Map | Inhoud | Handmatig verwijderen? |
|---|---|---|
C:\HQbird\Firebird50\ |
Databasebestanden, en zonder de data-optie de beveiligingsdatabase en *.conf |
Nadat u de databases hebt verplaatst |
C:\HQbird\fbagent-fb50\ |
Agentconfiguratie en logs, wanneer u de gegevens hebt behouden | Ja, als u ze niet nodig hebt |
C:\HQbirdData\ |
Werkgegevens van de agent, HQbird Monitor-gegevens en aanmeldbestand, wanneer u de gegevens hebt behouden | Ja, als u ze niet nodig hebt |
C:\HQbird\hqbirdrcm\ |
RCM-gegevens (verdwijnen alleen met de data-optie) | Ja, nadat het cluster weg is |
C:\ProgramData\fbagent\ |
install.log, resultaat van de laatste setup-run |
Ja |
C:\ProgramData\HQbird\fbagent\ |
SYSDBA-wachtwoordbestand van een stille installatie | Ja |
<Firebird folder>.old_<time> |
Kopie van de oude Firebird-programmamap van een update | Ja, wanneer de update is bevestigd |
De fbmcp-service wordt gedeeld door alle regels van de server. Deze blijft zolang een andere regel hem gebruikt, en wordt verwijderd met de laatste regel.
4. Servers in een cluster
De agent die de RCM draait, bezit de cluster-CA. Wanneer andere agents die RCM gebruiken, wordt de verwijdering geweigerd en wordt er niets gewijzigd.
Aanbevolen volgorde:
- Verwijder het cluster in de RCM-console en ontkoppel de agents.
- Verwijder HQbird van de ledenservers.
- Verwijder HQbird van de server die de RCM draait.
Om de RCM-eigenaar toch te verwijderen:
- Windows, dialoogvenster: het verwijderprogramma vraagt “Remove this instance anyway? The cluster loses its RCM CA.” Antwoord Ja.
- Windows, stil: voeg
/FORCEtoe. Zonder dit blijft de instantie die de RCM draait staan, en noemt het logboek de reden. - Linux: de installer stopt met exitcode 5. Voer hem opnieuw uit met
--force.
Na een geforceerde verwijdering heeft het cluster geen CA: geen nieuwe certificaten en geen
nieuwe leden. Om een andere agent de eigenaar van een nieuwe RCM te maken, voer
fbagent --cluster-init <id> --rcm-takeover daar uit en koppel de leden
opnieuw.
5. Linux
Voer hetzelfde .run-bestand uit dat HQbird heeft geïnstalleerd (of een nieuwer bestand van dezelfde
regel) als root. De voorbeelden gebruiken versie 2027.2.33.
5.1. De agent en HQbird Monitor verwijderen
# 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-dataHet commando stopt en verwijdert de units hqbirdfbagent-fb50 en
hqbirdmonitor-fb50, de programma’s fbagent en hqmonitor, en de
sudoers-regels van de agent. Het sluit de HQbird Monitor-poort die de
installatie heeft geopend in firewalld of ufw.
5.2. Meerdere instanties op één host
Zonder --agent-dir verwijdert de installer de enige agent in
/opt/hqbird. Bij meerdere agents stopt hij met exitcode 1 en vermeldt
hun mappen. Geef de map op:
sudo sh hqbird2027-fb50-linux-2027.2.33.run --uninstall --agent-dir /opt/hqbird/fbagent-fb50-2Voer het commando één keer uit voor elke agent. Het gedeelde HQbird Monitor-aanmeldbestand blijft tot de laatste agent is verwijderd.
5.3. Firebird verwijderen (optioneel, handmatig)
De installer verwijdert Firebird op Linux nooit. Doe dit alleen handmatig nadat u back-ups hebt gemaakt en de databases uit de Firebird-map hebt verplaatst.
Firebird-unitnamen:
| Firebird-map | Regel | Unit |
|---|---|---|
/opt/firebird |
2.5, 4.0, 5.0 | firebird |
/opt/firebird |
3.0 | firebird-superserver |
een andere map, bijvoorbeeld /opt/fb50-2 |
4.0, 5.0 | firebird.opt_fb50-2 |
een andere map, bijvoorbeeld /opt/fb30 |
3.0 | firebird.opt_fb30-superserver |
Voorbeeld voor de 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 $BWaarschuwing: rm -rf verwijdert alles in de map, ook de databases
en de beveiligingsdatabase die erin staan. Controleer eerst de map.
5.4. Het resultaat controleren
systemctl list-unit-files 'hqbird*' 'hqclusternode*' 'firebird*' --no-legend
ls /opt/hqbird /var/lib/hqmonitor 2>/dev/nullVerwacht: geen hqbirdfbagent-fb50- en hqbirdmonitor-fb50-units. De
Firebird-unit staat er nog, tenzij u Firebird handmatig hebt verwijderd.
5.5. Wat op de schijf achterblijft
| Pad | Inhoud | Handmatig verwijderen? |
|---|---|---|
/opt/hqbird/fbagent-fb50/ |
Agentconfiguratie en logs (zonder --remove-data) |
Ja, als u ze niet nodig hebt |
/var/lib/hqmonitor/ |
HQbird Monitor-gegevens (zonder --remove-data) |
Ja, als u ze niet nodig hebt |
/opt/hqbirdrcm/ |
RCM, zolang andere agents van de host deze gebruiken | Nadat het cluster weg is |
/opt/fbagent-update-backup/ |
Firebird-programmabestanden die updates hebben vervangen | Ja, wanneer de updates zijn bevestigd |
/opt/hqbird/fbagent-hqbird-takeover.json |
Status van de oudere HQbird-units vóór de update | Bewaar dit als u van plan bent terug te gaan naar de oudere HQbird |
/opt/firebird (of uw Firebird-map) |
Firebird en zijn databases | Sectie 5.3 |
5.6. Exitcodes van --uninstall
| Code | Betekenis | Wat te doen |
|---|---|---|
| 0 | Verwijderd | — |
| 1 | Geweigerd: meerdere agents op de host, of een verkeerde optie | Voeg --agent-dir toe met een map uit de lijst |
| 5 | Geweigerd: deze agent draait de RCM van de host en andere agents gebruiken deze | Sectie 4 |
6. Een oudere HQbird na de verwijdering
Wanneer HQbird 2027 een oudere HQbird (2024 en eerder) heeft vervangen, heeft de update de services van de oudere HQbird uitgeschakeld. De verwijdering van HQbird 2027 schakelt ze niet weer in. Hun status vóór de update is opgeslagen in:
- Windows:
<HQbird folder>\fbagent-hqbird-takeover.json - Linux:
/opt/hqbird/fbagent-hqbird-takeover.json
Gebruik dit bestand om te zien welke services actief waren, en start ze handmatig als u teruggaat naar de oudere HQbird.
7. Probleemoplossing
| Probleem | Wat te doen |
|---|---|
| Windows: de vermelding in Apps en onderdelen blijft na de verwijdering | Een instantie is niet verwijderd (vaak degene die de RCM draait). Voer het verwijderprogramma opnieuw uit; voor de RCM-eigenaar zie sectie 4 |
| Windows: een algemene fout en een commando van een oud verwijderprogramma | De agent heeft zichzelf bijgewerkt naar 3.1.0 of nieuwer en weigert de RCM-eigenaar te verwijderen. Voeg --force toe aan het getoonde commando, of voer het verwijderprogramma van een nieuwere setup uit |
| Windows: testbuilds 2027.0.1 en 2027.0.2 | Deze gebruikten één vermelding voor alle regels. Verwijder ze met hun eigen verwijderprogramma |
Linux: --uninstall geweigerd, exitcode 1 |
Meerdere agents op de host: voeg --agent-dir toe (sectie 5.2) |
Linux: --uninstall geweigerd, exitcode 5 |
De agent draait de RCM van de host: sectie 4 |
Linux: run as root (sudo sh ...) |
Voer de installer uit met sudo of als root |
Linux: het .run-bestand is kwijt |
Download de installer van dezelfde regel opnieuw; een nieuwere versie van dezelfde regel werkt ook |