Deze pagina is automatisch vertaald. Lees het Engelse origineel. English

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

  1. Maak een back-up van elke database (gbak of nbackup) en kopieer deze naar een andere schijf of server. De verwijdering verwijdert geen databasebestanden, maar een back-up beschermt u tegen een fout.
  2. Stop de applicaties die de databases gebruiken. Op Windows stopt de verwijdering de Firebird die de setup heeft geïnstalleerd.
  3. Clusterservers: als deze server de clusterconsole RCM draait, verwijder dan eerst het cluster in RCM en ontkoppel de agents (sectie 4).
  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.
  5. 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

  1. Open Instellingen → Apps → Apps en onderdelen (of Programma’s en onderdelen).
  2. Selecteer HQbird 2027 (Firebird 5.0) en klik op Verwijderen.
  3. Bevestig de verwijdering.
  4. Beantwoord de vraag over de gegevens: Nee behoudt de configuratie en de beveiligingsdatabase, Ja verwijdert ze ook.
  5. 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.

  1. Open Start → HQbird 2027 (Firebird 5.0) maintenance.
  2. Selecteer Remove an instance en selecteer de instantie.
  3. 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

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

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

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

3.4. Het resultaat controleren

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

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

  1. Verwijder het cluster in de RCM-console en ontkoppel de agents.
  2. Verwijder HQbird van de ledenservers.
  3. 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 /FORCE toe. 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

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

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

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

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

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

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

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

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