Installatie en updates
Installatie zonder verrassingen
Eén installer per Firebird-lijn. Hij vindt Firebird, oude HQbird en agents op de server, toont een plan en wijzigt niets tot je "Ja" zegt. Daarna werkt de agent zichzelf, de console en Firebird zelfstandig bij, met controles en rollback.
- 4 installers: Firebird 2.5 · 3.0 · 4.0 · 5.0
- 0 wijzigingen voordat je het plan bevestigt
- geen internet nodig alles in één bestand
- Windows en Linux wizard, stille modus, .run
- rollback als een installatie of update mislukt
setup.exe · .run
Wat er in de kit zit
De installer is één bestand: hqbird2027-fb50-setup-<version>.exe voor Windows of hqbird2027-fb50-linux-<version>.run voor Linux. Het bevat alles wat de server nodig heeft. Er wordt niets gedownload.
Elke installer installeert één Firebird-lijn. Kies de lijn waarop je databases draaien. De installatie wordt uitgevoerd door de agent in de kit: die controleert de server, stelt een plan op en voert het uit.
| Component | Wat het doet | Windows | Linux |
|---|---|---|---|
| Firebird, HQbird-build | Een nieuwe server of een in-place update. Voor een server die al is geïnstalleerd, wordt één regel toegevoegd aan firebird.conf: MonitoringPlugin = fblwmon. Voor een nieuwe server stelt de installer ook de poort in. databases.conf, de security-DB en het SYSDBA-wachtwoord veranderen niet. | service FirebirdServer… | /opt/firebird |
| fbagent-agent | Back-ups, monitoring, onderhoud, updates. | HQbirdFBAgent-fb50 | hqbirdfbagent-fb50, gebruiker firebird |
| HQbird Monitor | Webconsole voor deze server. Poort = 20000 + Firebird-poort: voor 3050 is dat 23050. De poort wordt bij de installatie gekozen en verandert daarna niet meer, ook niet als je de Firebird-poort wijzigt. | HQbirdMonitor-fb50 | hqbirdmonitor-fb50 |
| Clustercomponenten | De clusterprogramma's worden op de server geplaatst maar niet ingeschakeld: RCM en het pairing-venster staan standaard uit. RCM maakt van de server het centrum van een nieuw cluster en opent poorten 7443 en 7444. Het pairing-venster opent poort 7450–7459 gedurende 24 uur: daardoor kan de RCM van een andere server deze server uitnodigen. Je kunt beide ook na de installatie inschakelen. | wizardpagina "Replication and cluster setup"; /RCM, /DISCOVERY | --rcm on, --cluster-pairing on |
| fbmcp MCP-server | Toegang voor AI-clients tot Firebird. Standaard alleen vanaf deze server. | selectievakje in de wizard of /NOFBMCP | --no-fbmcp |
| Firebird-debugbestanden | Symbolen om Firebird-crashes te analyseren. | — | ja, --no-debug schakelt dit uit |
- WindowsOndersteund: Windows 10 en 11, Windows Server 2016 en later, 64-bit. Administratorrechten. De installer is ondertekend door IBSurgeon Software: Windows toont de uitgever in de rechtenprompt.
- Wizard of stille modusElke wizardpagina is ook beschikbaar als schakelaar:
/VERYSILENT /YES /LOG=…. Handig voor scripts en voor honderd servers. - Wizard in 8 talenEngels, Portugees (Brazilië), Duits, Russisch, Spaans, Pools, Turks, Vereenvoudigd Chinees. De standaard is de Windows-taal. Schakelaar:
/LANG=en|pt_BR|de|ru|es|pl|tr|zh_CN. - ServernaamDe wizard vraagt om de naam van de nieuwe agent; HQCenter toont de server onder deze naam. De standaard is de computernaam. Stille modus:
/AGENTID=, op Linux--agent-id. Een agent die al is geïnstalleerd, behoudt zijn naam.
- Linuxx86_64, kernel 3.2 of later, systemd, root. Ubuntu, Debian, AlmaLinux, Rocky, RHEL, Oracle Linux, openSUSE, RED OS en andere met apt, dnf, yum of zypper.
- Server zonder internetDe installer haalt een paar OS-bibliotheken (libtommath, ICU) uit de repository. Als er geen repository is, drukt hij de exacte commando's af en wijzigt niets.
De kit wordt twee keer gecontroleerd. Vóór het uitpakken: de sha256 van de hele kit. Vóór Firebird en de agent worden geïnstalleerd: de handtekening van elk bestand. Een beschadigde download stopt de installatie voordat er iets aan Firebird, de agent of de console wordt gewijzigd.
fbagent --install-plan
Eerst het plan, dan de wijzigingen
Eerst leest de installer alleen: services, het register, Firebird- en HQbird-mappen. Daarna toont hij wat hij heeft gevonden en wat hij gaat doen. Wijzigingen beginnen pas nadat je "Ja" zegt.
Selecteer wat er op de server staat en bekijk het plan. De teksten zijn ingekort en vertaald; de volgorde en de beslissingen zijn dezelfde als in de Firebird 5.0-installer.
- 1Servercontrolerechten, bitness; op Linux ook systemd en de kernel
- 2Kitcontrolesha256 vóór het uitpakken; bestandshandtekeningen vóór de installatie
- 3Planwat is gevonden en wat er gaat gebeuren
- 4Vragenservernaam voor HQCenter; Firebird stoppen? andere versie?
- 5InstallatieFirebird, agent, console, services
- 6✓ Resultaatservices, consoleadres, login
Als er iets misgaat
Een weigering in de planfase (poort in gebruik, map niet leeg) wijzigt niets: de installer noemt de reden. In de wizard kun je een pagina niet verlaten zolang een waarde onjuist is.
Een fout tijdens de installatie, voordat de agentservice start: services keren terug naar hun vorige staat. Oude HQbird, als die was gestopt, start weer.
| Code | Betekenis (Linux .run) |
|---|---|
| 0 | Klaar |
| 1 | Geweigerd: server, schakelaar of plan. Niets gewijzigd |
| 2 | Installatie mislukt, wijzigingen teruggedraaid |
| 3 | Rollback onvolledig: het resultaat vermeldt wat je moet controleren |
| 4 | Antwoord nodig: geen terminal en geen --yes |
| 5 | Kit heeft de controle niet doorstaan: download opnieuw |
| 6 | Geen OS-bibliotheken en geen repository |
| 7 | Firebird uit distributiepakketten |
| Code | Betekenis (Windows setup.exe) |
|---|---|
| 0 | Geïnstalleerd |
| 1 | Geweigerd vóór installatie: verkeerde schakelaar of bestand, een nieuwere versie is geïnstalleerd, geen administratorrechten |
| 4 | De installer had een vraag, maar er is geen /YES-schakelaar |
| 7 | Servercontrole of installatie mislukt. De reden staat in het log en in het resultaatbestand |
| 10 | Geïnstalleerd, maar de verbinding met HQCenter is mislukt |
-p3050); nieuwe installaties krijgen -fb50.FBDataGuard → fbagent
Overstappen van HQbird 2024
Het installatieprogramma vindt de oude HQbird en de Firebird die erdoor wordt bediend. Deze Firebird wordt ter plaatse bijgewerkt, FBDataGuard-taken verhuizen naar de agent, oude services worden gestopt. Databases, configuraties en wachtwoorden blijven behouden.
- Wat niet verandert
databases.confofaliases.conf, de security-database, het SYSDBA-wachtwoord, databases, back-ups en oude HQbird-bestanden. Infirebird.confwordt alleen de regelMonitoringPlugin = fblwmontoegevoegd, als die ontbreekt. - Kopie van oude FirebirdDe programmamap van de oude Firebird wordt ernaast bewaard als
<folder>.old_<time>. - Takengbak- en nbackup-back-ups, sweep, indexstatistieken. De import wordt één keer uitgevoerd en doorloopt de controle van de nieuwe configuratie; de oude configuratie wordt bewaard.
- Oude back-upsDe agent neemt back-ups uit de FBDataGuard-journals op in zijn eigen administratie. Bewaarregels en herstel zien ze op dezelfde manier als nieuwe. De namen van nbackup-niveaus blijven hetzelfde.
- TaaknamenDe taaknaam eindigt met de databasenaam uit FBDataGuard, bijvoorbeeld "Verified backup - MANUAL". Groepstaken herhalen de structuur van de bronmappen.
- Oude services: drie optiesAutomatisch (aanbevolen): schakel ze uit wanneer elke Firebird die door FBDataGuard wordt bediend een agent heeft. Alles uitschakelen:
/DISABLEHQBIRD. Ongewijzigd laten:/NOHQBIRD. - U kunt terugDe status van elke service voordat deze werd uitgeschakeld, wordt opgeslagen in
fbagent-hqbird-takeover.json. Met dit bestand kan de oude HQbird weer worden ingeschakeld. - LicentieDe oude HQbird-licentie wordt niet overgedragen. Er geldt een proefperiode totdat u een nieuwe licentie krijgt of verbinding maakt met HQCenter.
- Onduidelijk padAls de import een substitutie in een FBDataGuard-pad niet kan uitbreiden, blijft deze ongewijzigd en blijft de taak uitgeschakeld. Corrigeer het pad en schakel de taak in.
Als taken worden geïmporteerd maar oude services nog steeds draaien (bijvoorbeeld wanneer de server twee Firebird-servers onder FBDataGuard heeft), komen de taken uitgeschakeld binnen. Zo wordt één taak niet twee keer uitgevoerd.
Poorten · mappen · services
Meerdere Firebird-servers op één machine
Eén agent per Firebird. Een nieuwe instantie wordt naast de andere geïnstalleerd, op een eigen poort, met een eigen agent en een eigen console. Geïnstalleerde instanties veranderen niet.
Voeg Firebird-servers toe en bekijk welke namen en poorten het installatieprogramma kiest.
- Poorten per lijnDe eerste Firebird op de server krijgt 3050. De volgende: 3052 voor 2.5, 3053 voor 3.0, 3054 voor 4.0, 3055 voor 5.0. Het installatieprogramma neemt geen poort die in gebruik is.
- Tweede instantie van dezelfde lijnNummer
-2in map- en servicenamen. Op Windows is dit de wizardoptie "Nog een instantie installeren"; de poort is de eerste vrije in het bereik van de lijn.
- Updates alleen binnen een lijn5.0.x → 5.0.y. Overstappen van 3.0 naar 5.0 betekent een tweede instantie naast de eerste; een persoon verplaatst de databases met back-up en herstel.
- XNET op WindowsEen Firebird die niet op poort 3050 draait, krijgt een eigen naam
IpcName = FIREBIRD_<port>. Lokale XNET-verbindingen naar de tweede server werken. - Eén console per agentHQbird Monitor op 20000 + Firebird-poort: 23050, 23055. Eén inlogbestand voor alle instanties op de server.
- Poorten zijn vastDe poorten van de console en van de lokale API van de agent worden bij de installatie vastgelegd. Als u de Firebird-poort later wijzigt, blijven ze hetzelfde. De agent accepteert geen gelijke poorten.
- Cluster: een slot voor elke agentElke agent op de server krijgt een eigen slot van 0 tot 9: koppelpoort 7450 + slot, nodepoorten 7051 + slot en 7061 + slot. Zo kunnen twee agents van één server lid worden van een cluster. De schakelaar
--pairing-portstelt het slot expliciet in.
Images · compose · poorten
HQbird in Docker
Er is een kant-en-klare image voor elke Firebird-lijn. Firebird, de agent en HQbird Monitor draaien in de container. De agent installeert het clusternode in de container zelf wanneer de server lid wordt van een cluster. Hij installeert RCM alleen wanneer deze server is aangewezen als de cluster-RCM.
| Image | Firebird | Firebird-poort | HQbird Monitor |
|---|---|---|---|
ghcr.io/ibsurgeon/hqbird2027-fb50 | 5.0 | 3050 | 23050 |
ghcr.io/ibsurgeon/hqbird2027-fb40 | 4.0 | 3050 | 23050 |
ghcr.io/ibsurgeon/hqbird2027-fb30 | 3.0 | 3050 | 23050 |
ghcr.io/ibsurgeon/hqbird2027-fb25 | 2.5 | 3050 | 23050 |
- Eerste startKopieer
compose.yamluit de kit, plaats het SYSDBA-wachtwoord in een secret-bestand, verwijder de#uit de regelssecrets:en voerdocker compose up -duit. De server is gereed wanneerdocker compose pshealthytoont. - Firebird-poortDe variabele
HQBIRD_FB_PORT, standaard 3050. HQbird Monitor luistert op 20000 + deze poort. - Image-handtekeningDe images zijn ondertekend met het cosign-hulpprogramma. De publieke sleutel voor de controle is nog niet gepubliceerd.
- Meerdere instanties op één hostFirebird op 3050 + N, HQbird Monitor op 20000 + Firebird-poort, clusternode op 7051 + N. Slechts één instantie op de host kan RCM hebben.
- Hetzelfde poortnummer buiten en binnenPubliceer
3051:3051, niet3051:3050. De agent en het cluster rapporteren de poort die zij binnen de container zien. - ClusterHet lidadres is het adres van de Docker-host. Publiceer de nodepoort en, voor RCM, poorten 7443 en 7444.
Docker publiceert poorten voorbij ufw. Een ufw-regel "alleen poort 22" sluit de containerpoorten niet. Publiceer de poort op één hostadres of sluit deze met een externe firewall.
Cloud en Docker: instellingen, volumes, poorten, updatesAgent · console · cluster · Firebird
Updates na de installatie
Nadat de agent verbinding heeft gemaakt met HQCenter, werkt hij zichzelf, HQbird Monitor, clustercomponenten, fbmcp en Firebird zelfstandig bij. Een server zonder HQCenter werkt zichzelf ook bij: de agent haalt nieuwe versies van de IBSurgeon-updateserver.
De agent ziet binnen een minuut een nieuwe versie van zichzelf in HQCenter. Nieuwe versies van HQbird Monitor, fbmcp en Firebird: binnen een uur. Elke update volgt hetzelfde patroon: controleren, een terugdraaipunt opslaan, vervangen, controleren of het werkt. Als het niet werkt, wordt de oude versie hersteld.
Updates zonder HQCenter
- Wat zichzelf bijwerktDe agent, HQbird Monitor en de MCP-server. De controle wordt elke 6 uur uitgevoerd.
- Firebird wacht op een opdrachtHet Firebird-pakket wordt gedownload en wacht. De beheerder past het toe: met de knop op de pagina Updates of met de opdracht
fbagent --firebird-update --apply. - U kiest de modusDe installatieschakelaar
--auto-update all|agent|off, op Windows/AUTOUPDATE=all|agent|off.agentis de standaard.allinstalleert ook Firebird, in het updatevenster.offcontroleert niets.
- Pagina Updates in HQbird MonitorToont waar de agent versies vandaan haalt, de modus en het laatste antwoord van de server, de status van de updates van Firebird, console en MCP-server. De beheerder wijzigt de modus en past het Firebird-pakket toe.
- BroncontroleDe updateserver wordt gecontroleerd aan de hand van een vastgezette sleutel. De leveranciershandtekening is altijd vereist.
- Cluster verloopt via het centrumEen clusternode en RCM werken niet op deze manier bij: HQCenter of RCM werkt ze bij.
Zelfupdate van de agent
- Alleen vooruitDe agent installeert geen versie die ouder is dan zijn eigen versie, zelfs niet als die verplicht is. De controle vindt plaats voordat de eerste byte wordt gedownload. Zo kan een valse server geen oude kwetsbare build terugbrengen. De uitzondering is één oude versie die is toegestaan in de eigen configuratie van de agent (
allow_downgrade_to). - HandtekeningReleases zijn ondertekend met een Ed25519-sleutel; de publieke sleutel is ingebouwd in de agent. Een onjuiste handtekening wordt altijd geweigerd. De modus "alleen ondertekend" wordt ingeschakeld in de eigen configuratie van de agent, niet vanaf de server.
- Handmatige rollbackNaast de agent staat een script
rollback_to_version_NNN: het herstelt de vorige agent en configuratie en blokkeert de defecte versie. De twee meest recente rollbackpunten worden bewaard; oudere worden automatisch verwijderd. - Linux: root voert alleen zijn eigen kopie uitDe agent draait als
firebird. De vervanging wordt uitgevoerd door een geverifieerde kopie in een map waarnaar alleen root kan schrijven.
Firebird-update
Firebird wordt alleen binnen zijn eigen lijn bijgewerkt en alleen naar een nieuwere build. De agent kan het pakket op elk moment downloaden en voorbereiden, maar stopt Firebird alleen in het updatevenster.
- 1Voorbereidingdownload, handtekening, build niet ouder dan de engine
- 2Vensterdagelijks venster; een verplichte release wacht ook op het venster
- 3Takengbak, nbackup of een SQL-script is bezig: de poging wordt uitgesteld
- 4Vervangingoude enginebestanden worden apart gezet, configuraties blijven
- 5ControleFirebird start en antwoordt op zijn poort
- 6✓ of rollbackoude bestanden komen terug, de build wordt geblokkeerd
| Wat wordt bijgewerkt | Bescherming | Als het mislukt |
|---|---|---|
| fbagent-agent | Handtekening, alleen nieuwer, gereed binnen 180 s en 45 s actief | Rollback, 30 minuten pauze; een tweede fout blokkeert de versie |
| HQbird Monitor, cluster, fbmcp | Handtekening, alleen nieuwer dan geïnstalleerd | De vorige versie blijft; de 2 meest recente kopieën worden bewaard |
| Firebird | Venster, wachten op back-ups, controle na het starten | Oude engine komt terug, de build gaat naar de blokkeerlijst |
Een geblokkeerde versie wordt niet opnieuw geïnstalleerd, maar de volgende versie installeert zoals gebruikelijk. Zo blijft de server niet in een lus van "update → rollback → update" hangen.
Mappen · logboeken · verwijderen
Waar de bestanden staan en hoe u kunt verwijderen
Windows
C:\HQbird\ Firebird50\ Firebird 5.0, configuraties, beveiligingsdatabase fbagent-fb50\ agent en HQbird Monitor agent_config.json agentconfiguratie logs\ bak\ update\ logboeken, kopieën, updatecache C:\HQbirdData\ werkgegevens van agent en console config\access.properties console-aanmelding C:\ProgramData\fbagent\ installatieresultaat en logboek
Linux
/opt/firebird/ Firebird 5.0 (tweede lijn: /opt/fb50) /opt/hqbird/ conf/access.properties console-aanmelding, 0600 fbagent-fb50/ agent en HQ Monitor agent_config.json agentconfiguratie logs/ bak/ update/ logboeken, kopieën, updatecache /var/lib/hqmonitor/ consolegegevens /var/log/fbagent/install.log installatielogboek, geen wachtwoorden
- Verwijderen raakt uw databases nietUw databases en back-ups (
*.fdb,*.gdb,*.fbk,*.nbk) blijven altijd behouden. Gegevens verwijderen verwijdert alleen de beveiligingsdatabase en de voorbeelden uit het Firebird-pakket. - Windows"Apps": verwijdert de agent, de console, de RCM van deze agent, firewallregels en de Firebird die deze installer als nieuw heeft geïnstalleerd. Als andere agents de RCM van deze agent gebruiken, vraagt de wizard "Deze instantie toch verwijderen?"; een stille verwijdering vereist
/FORCE. Een bijgewerkte Firebird blijft. Configuraties en de beveiligingsdatabase worden alleen verwijderd als u "gegevens verwijderen" selecteert.
- Linux
--uninstallverwijdert de agent- en consolediensten, de RCM van deze agent, sudoers-regels en de poorten die de installer heeft geopend in firewalld of ufw. De agent verlaat eerst het cluster. Als andere agents zijn RCM gebruiken, hebt u de schakelaar--forcenodig. Firebird blijft.--remove-dataverwijdert ook de configuratie, logboeken en consolegegevens. - Oude HQbirdHet verwijderen van HQbird 2027 schakelt de oude diensten niet weer in: de beheerder beslist dit aan de hand van het statusbestand.
sudo sh hqbird2027-fb50-linux-<version>.run --uninstall --agent-dir /opt/hqbird/fbagent-fb50-2