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

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.

ComponentWat het doetWindowsLinux
Firebird, HQbird-buildEen 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-agentBack-ups, monitoring, onderhoud, updates.HQbirdFBAgent-fb50hqbirdfbagent-fb50, gebruiker firebird
HQbird MonitorWebconsole 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-fb50hqbirdmonitor-fb50
ClustercomponentenDe 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-serverToegang voor AI-clients tot Firebird. Standaard alleen vanaf deze server.selectievakje in de wizard of /NOFBMCP--no-fbmcp
Firebird-debugbestandenSymbolen 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.

Op de server

        


          


          

  1. 1Servercontrolerechten, bitness; op Linux ook systemd en de kernel
  2. 2Kitcontrolesha256 vóór het uitpakken; bestandshandtekeningen vóór de installatie
  3. 3Planwat is gevonden en wat er gaat gebeuren
  4. 4Vragenservernaam voor HQCenter; Firebird stoppen? andere versie?
  5. 5InstallatieFirebird, agent, console, services
  6. 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.

CodeBetekenis (Linux .run)
0Klaar
1Geweigerd: server, schakelaar of plan. Niets gewijzigd
2Installatie mislukt, wijzigingen teruggedraaid
3Rollback onvolledig: het resultaat vermeldt wat je moet controleren
4Antwoord nodig: geen terminal en geen --yes
5Kit heeft de controle niet doorstaan: download opnieuw
6Geen OS-bibliotheken en geen repository
7Firebird uit distributiepakketten
CodeBetekenis (Windows setup.exe)
0Geïnstalleerd
1Geweigerd vóór installatie: verkeerde schakelaar of bestand, een nieuwere versie is geïnstalleerd, geen administratorrechten
4De installer had een vraag, maar er is geen /YES-schakelaar
7Servercontrole of installatie mislukt. De reden staat in het log en in het resultaatbestand
10Geïnstalleerd, maar de verbinding met HQCenter is mislukt
Plan in de wizard. "Found on this computer" en "Setup will do the following". Onderaan: er verandert niets tot je op Install klikt.
Resultaat. Wat is geïnstalleerd, het consoleadres vanaf deze computer en vanaf een andere, waar het loginwachtwoord staat. Overgenomen uit een vroege build: daar gebruiken de agentservice- en mapnamen de poort (-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.

Overstappen van HQbird 2024: FBDataGuard-taken verhuizen naar de HQbird 2027-agent, Firebird wordt ter plaatse bijgewerkt, oude HQbird-services worden uitgeschakeld
  • Wat niet verandertdatabases.conf of aliases.conf, de security-database, het SYSDBA-wachtwoord, databases, back-ups en oude HQbird-bestanden. In firebird.conf wordt alleen de regel MonitoringPlugin = fblwmon toegevoegd, 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.

Toevoegen
  • 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 -2 in 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-port stelt het slot expliciet in.
Twee instanties van één lijn. Het plan ziet beide Firebird-servers en beide agents en wijzigt alleen de geselecteerde instantie.

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.

ImageFirebirdFirebird-poortHQbird Monitor
ghcr.io/ibsurgeon/hqbird2027-fb505.0305023050
ghcr.io/ibsurgeon/hqbird2027-fb404.0305023050
ghcr.io/ibsurgeon/hqbird2027-fb303.0305023050
ghcr.io/ibsurgeon/hqbird2027-fb252.5305023050
  • Eerste startKopieer compose.yaml uit de kit, plaats het SYSDBA-wachtwoord in een secret-bestand, verwijder de # uit de regels secrets: en voer docker compose up -d uit. De server is gereed wanneer docker compose ps healthy toont.
  • 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, niet 3051: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, updates

Agent · 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. agent is de standaard. all installeert ook Firebird, in het updatevenster. off controleert 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

Zelfupdate van de agent: controles, rollbackpunt, vervangen, gereed binnen 180 s, 45 s actief; bij een fout: rollback, 30 min pauze, versie geblokkeerd na de 2e fout
  • 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.

  1. 1Voorbereidingdownload, handtekening, build niet ouder dan de engine
  2. 2Vensterdagelijks venster; een verplichte release wacht ook op het venster
  3. 3Takengbak, nbackup of een SQL-script is bezig: de poging wordt uitgesteld
  4. 4Vervangingoude enginebestanden worden apart gezet, configuraties blijven
  5. 5ControleFirebird start en antwoordt op zijn poort
  6. 6✓ of rollbackoude bestanden komen terug, de build wordt geblokkeerd
Wat wordt bijgewerktBeschermingAls het mislukt
fbagent-agentHandtekening, alleen nieuwer, gereed binnen 180 s en 45 s actiefRollback, 30 minuten pauze; een tweede fout blokkeert de versie
HQbird Monitor, cluster, fbmcpHandtekening, alleen nieuwer dan geïnstalleerdDe vorige versie blijft; de 2 meest recente kopieën worden bewaard
FirebirdVenster, wachten op back-ups, controle na het startenOude 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--uninstall verwijdert 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 --force nodig. Firebird blijft. --remove-data verwijdert 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.
Linux, één instantie verwijderen (Firebird en databases blijven):
sudo sh hqbird2027-fb50-linux-<version>.run --uninstall --agent-dir /opt/hqbird/fbagent-fb50-2

← Terug naar het HQbird 2027-overzicht · Serverstatus →