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

Deze handleiding is voor de beheerder die HQbird 2027 installeert op een Linux-server met de offline-installer hqbird2027-fbNN-linux-<version>.run. Het behandelt een nieuwe installatie, de update van een oudere HQbird en van een eerdere HQbird 2027, de onderhoudscommando’s, de verbinding met uw HQCenter, de onbeheerde (gescripte) installatie, en waar de bestanden zich na de installatie bevinden.

De voorbeelden tonen de installer voor Firebird 5.0 op Ubuntu 24.04. De installers voor Firebird 2.5, 3.0 en 4.0 werken op dezelfde manier; alleen de versie, de standaardpoort en de mapnamen verschillen. De Windows-setup wordt beschreven in Windows installation.

Inhoud

  1. 1. Wat de installer installeert
  2. 2. De installatie in één oogopslag
  3. 3. Nieuwe installatie
  4. 4. Na de installatie
  5. 5. Update van een oudere HQbird (2024 en eerder)
  6. 6. Update van HQbird 2027 naar een nieuwe versie
  7. 7. Onderhoudscommando’s
  8. 8. Koppelen aan uw HQCenter
  9. 9. Onbeheerde installatie en scripts
  10. 10. Probleemoplossing

1. Wat de installer installeert

Eén .run-bestand = één Firebird-lijn. Kies de installer van de Firebird-versie die uw databases gebruiken:

Installer Firebird die hij installeert of bijwerkt Eerste Firebird op de host Grootte
hqbird2027-fb50-linux-<version>.run Firebird 5.0 (HQbird-build) /opt/firebird, poort 3050 ongeveer 250 MB
hqbird2027-fb40-linux-<version>.run Firebird 4.0 (HQbird-build) /opt/firebird, poort 3050 ongeveer 220 MB
hqbird2027-fb30-linux-<version>.run Firebird 3.0 (HQbird-build) /opt/firebird, poort 3050 ongeveer 130 MB
hqbird2027-fb25-linux-<version>.run Firebird 2.5 (HQbird-build) /opt/firebird, poort 3050 ongeveer 80 MB

Elke installer bevat, en installeert zonder internet:

  • Firebird (de HQbird-build van die lijn): een nieuwe server, of een in-place update van de Firebird van die lijn die al op de host staat. Uw firebird.conf, databases.conf (aliases.conf voor 2.5), de beveiligingsdatabase en het SYSDBA-wachtwoord blijven behouden.
  • Firebird debug-bestanden (symbolen voor crashanalyse), geïnstalleerd in de Firebird-map. --no-debug slaat ze over.
  • HQbird-agent (fbagent): de systemd-unit hqbirdfbagent-fb50, draaiend als de gebruiker firebird, die de back-ups, monitoring, onderhoudstaken en de updates uitvoert. De naam eindigt met de Firebird-lijn (-fb25 … -fb50); een tweede instantie van de lijn heeft -fb50-2.
  • HQ Monitor: de webconsole van deze HQbird-instantie, unit hqbirdmonitor-fb50, adres http://<server>:<20000 + Firebird port>/ (voor Firebird op poort 3050: http://localhost:23050/).
  • Clustercomponenten: de clusterconsole RCM (hqbirdrcm) en de clusternode (hqclusternode) worden naar de cache van de agent gekopieerd. Kits met agent (fbagent) 3.1.0 en later maken standaard geen cluster: geen RCM, geen pairing-venster, geen clusterpoort in de firewall. Twee vragen (of --rcm on, --cluster-pairing on) schakelen ze in (“Next: cluster” in sectie 3). Met RCM wordt het geïnstalleerd in /opt/hqbirdrcm en draait het als de unit hqbirdrcm; de samenvatting toont het adres in de regel RCM:. De node krijgt zijn unit (bijvoorbeeld hqclusternode-master-p3050) wanneer u de host in RCM koppelt. Kits vanaf 2027.2.19 met een oudere agent installeren RCM op elke server (--rcm off laat het in de cache) en openen het pairing-venster. Kits vóór 2027.2.19 kopiëren beide componenten alleen naar de cache van de agent: er is geen unit hqbirdrcm en geen regel RCM:.

Instanties geïnstalleerd vóór 2027.2.9 hebben de Firebird-poort in de agentnamen: map /opt/hqbird/fbagent-p3050, units hqbirdfbagent-p3050 en hqbirdmonitor-p3050. Een update verandert deze namen niet. Alleen nieuwe instanties krijgen de namen -fb<NN>, zodat één host beide vormen kan hebben.

Vereisten: x86_64, kernel 3.2 of nieuwer, systemd; een Linux met apt, dnf/yum of zypper (Ubuntu, Debian, AlmaLinux, Rocky, RHEL, Oracle Linux, openSUSE, RED OS en andere); root. Ongeveer 300 MB vrij in /var/tmp tijdens de installatie (een map waar programma’s mogen draaien; zie --tmpdir). Een paar OS-bibliotheken (libtommath, ICU) worden uit de repository van de distributie gehaald; een server zonder internet krijgt de exacte commando’s om ze voor te bereiden (sectie 9).

Niet ondersteund: een Firebird die is geïnstalleerd uit de pakketten van de distributie (firebird3.0-server, firebird rpm). De installer stopt voordat hij iets wijzigt (exitcode 7); verwijder eerst de pakketten (bewaar een gbak-back-up van uw databases) of gebruik de online-installer met --import-firebird.

Meerdere Firebird-lijnen op één server: elke lijn heeft zijn eigen installer. De eerste Firebird op de host gaat naar /opt/firebird; een tweede lijn gaat naar /opt/fb<NN> (/opt/fb50, /opt/fb40, /opt/fb30) op de poort van zijn lijn: 3053 voor 3.0, 3054 voor 4.0, 3055 voor 5.0. Wanneer die poort in gebruik is, stopt de installer en vraagt om --port N. Meerdere instanties van één lijn (een tweede Firebird 5.0 op een andere poort) worden geïnstalleerd met --fb-root <new folder> --port <port> (sectie 7). Firebird 2.5 heeft slechts één instantie, in /opt/firebird; gebruik voor een tweede server ernaast een andere lijn (bijvoorbeeld Firebird 5.0 in /opt/fb50).

Een stapsgewijze runbook voor twee instanties op poorten 3050 en 3051, voor elke lijn, met kopieer-en-plak-commando’s, staat in hqbird2027-linux-two-instances-runbook.ru.md (Russisch) en hqbird2027-linux-two-instances-runbook.pt.md (Portugees).

Proefversie: zonder licentie draait de agent een proefperiode van 7 dagen. Het proef-e-mailadres (--email) verlengt deze tot 30 dagen. Een licentiebestand (--license) of de verbinding met uw HQCenter (sectie 8) vervangt de proefperiode.

Updates: vanaf kit 2027.2.31 (agent 3.3.0) controleert een server die aan geen HQCenter is gekoppeld de updateserver van de leverancier. Standaard werken de agent, HQ Monitor en fbmcp zichzelf bij, en wordt een nieuw Firebird-pakket gedownload dat op u wacht. --auto-update all|agent|off of de regel Updates van de tekstinterface wijzigt dit (“Updates zonder HQCenter” in sectie 4). Een server die aan een HQCenter is gekoppeld, haalt zijn updates van dat HQCenter.

2. De installatie in één oogopslag

Diagram

De servercontrole en de installatie zelf worden uitgevoerd door de HQbird-agent die de installer meebrengt (fbagent --install-plan, fbagent --setup-install). Er wordt niets gedownload behalve de ontbrekende OS-pakketten. Er wordt niets gewijzigd voordat het plan is bevestigd: de OS-pakketten worden na de bevestiging geïnstalleerd. In een terminal openen kits na 2027.2.30 de tekstinterface (stap 3 van sectie 3); --no-tui voert de gewone installer uit, die zijn vragen als tekstregels stelt. Zonder terminal en zonder --yes stopt de installer bij de bevestiging met exitcode 4. Als de installatie mislukt voordat de agent-unit start, draait de agent de units terug naar de staat die ze daarvoor hadden (exitcode 2; code 3 wanneer de terugdraaiing niet volledig was, de samenvatting vermeldt wat u moet controleren).

3. Nieuwe installatie

Stap 1: Download de installer en controleer hem

Command
KIT=hqbird2027-fb50-linux-2027.2.9.run
curl -fL -O https://ib-aid.com/download/hqbird/v2027/$KIT -O https://ib-aid.com/download/hqbird/v2027/$KIT.sha256
sha256sum -c $KIT.sha256

De andere lijnen hebben dezelfde namen met fb40, fb30, fb25. Verwacht: hqbird2027-fb50-linux-2027.2.9.run: OK. Een server zonder internet: download de twee bestanden op een pc met dezelfde links en kopieer ze naar de server (scp, een USB-stick, een share).

De installer controleert ook zijn eigen payload voordat hij iets uitpakt: een afgebroken of beschadigde download stopt met exitcode 5 (“download it again”).

Stap 2: Controleer de host zonder hem te wijzigen (optioneel)

Command
sudo sh hqbird2027-fb50-linux-2027.2.9.run --check

--check voert de hostcontrole uit, meldt de ontbrekende OS-bibliotheken (en de commando’s om ze op een server zonder internet te verkrijgen), toont wat de agent heeft gevonden en wat hij zou doen, en sluit af. Er wordt niets geïnstalleerd.

Stap 3: Voer de installer uit

Command
sudo sh hqbird2027-fb50-linux-2027.2.9.run

Kits na 2027.2.30 openen de tekstinterface wanneer u ze in een terminal start: schermvullende pagina’s met het plan en de instellingen. Kits tot en met 2027.2.30, en de gevallen in “De gewone installer” hieronder, stellen hun vragen als tekstregels. Beide doen dezelfde installatie met dezelfde opties.

De tekstinterface

De installer controleert de host, pakt zichzelf uit, leest het plan en toont de eerste pagina. Er wordt niets op de host gewijzigd totdat u de installatie start op de pagina Install.

text
 HQbird 2027 setup <version> | Firebird 5.0 (5.0.5.1917)

 Plan M1: New Firebird and HQbird agent
   Firebird: new /opt/firebird (unit firebird, port 3050)
   Agent: new, in /opt/hqbird/fbagent-fb50
   OS packages to install: libtommath1 (see Plan details)

   Language         English (auto)
   Firebird folder  automatic (/opt/firebird)
   Firebird port    automatic (3050)
   Agent id         automatic (srv1261114-fb50)
   SYSDBA password  generated (for a new Firebird)
   HQ Monitor       port automatic, login admin
   License          not now (add it later in HQ Monitor)
   HQCenter         not attached
   Cluster          RCM off, discovery mode off
   Components       debug files: yes, fbmcp: yes
   Updates          HQbird only (recommended)

 > Install
   Plan details
   About plans
   Quit

 Up/Down: move   Enter: change or start   Esc: quit

De bovenste regels zijn het plan voor de instellingen van dit moment: de code ervan en wat de installer met Firebird en de agent zal doen. Een plan dat niet mogelijk is, is rood, met de reden, en de cursor staat op de instelling die het oplost. Na elke wijziging leest de installer het plan opnieuw.

Toets Wat hij doet
Omhoog, Omlaag Verplaatst de cursor (ook k, j)
Enter Opent de instelling onder de cursor, selecteert een item, accepteert een getypte waarde
Spatie Schakelt een component in of uit (de pagina Components)
Esc Terug naar de vorige pagina; op de eerste pagina: de installer verlaten (hij vraagt eerst)
Ctrl+C Stopt de installer onmiddellijk (exitcode 2). Er was niets gewijzigd vóór de pagina Install

Op een pagina waar u een waarde typt (een map, een poort, een adres), accepteert Enter deze en een lege waarde betekent “automatisch”. Esc verlaat zo’n pagina niet.

Instelling Wat u kiest Hetzelfde als de optie
Language Engels, Russisch, Braziliaans Portugees, Duits; de pagina’s veranderen onmiddellijk --lang
Firebird folder De map van een nieuwe Firebird, of van de Firebird die moet worden bijgewerkt. Firebird 2.5 heeft één map, dus de installer ervan heeft geen dergelijke regel --fb-root
Firebird port De TCP-poort van Firebird --port
Agent id Automatisch, de hostnaam, de hostnaam en de instantie, of uw eigen waarde. Alleen voor een nieuwe agent: een geïnstalleerde agent behoudt zijn id, en de regel wordt niet getoond --agent-id
SYSDBA password Voor een nieuwe Firebird: gegenereerd, of uw eigen --sysdba-pass-file
HQ Monitor De poort en de aanmelding van de webconsole --hqmonitor-port, --hqmonitor-login, --hqmonitor-password-file
License Niet nu, een proefperiode van 30 dagen per e-mail (adres, privacyverklaring, zone), of een licentiebestand --email --accept-privacy --trial-zone, --license
HQCenter Het bestand attach.json van uw HQCenter --attach
Cluster De clustermanager RCM (cluster-id, beheerderswachtwoord), discovery-modus, de pairing-poort --rcm, --cluster-id, --rcm-password-file, --cluster-pairing, --pairing-port
Components Firebird debug-bestanden; fbmcp en de adressen van zijn externe modus --no-debug, --no-fbmcp, --fbmcp-allow-from

| Updates | Alleen HQbird (de agent, HQ Monitor en fbmcp werken zichzelf bij, een nieuwe Firebird wacht op jou), HQbird en Firebird (Firebird werkt zichzelf ook bij, ’s nachts van 03:30 tot 04:00, met een herstart van Firebird), of Uit. Kits vanaf 2027.2.31; alleen voor een nieuwe agent zonder attach.json-bestand: een HQCenter beheert de updates van een aangesloten agent | --auto-update |

Opties op de commandoregel zijn de waarden waarmee de pagina’s beginnen: sudo sh hqbird2027-fb50-linux-<ver>.run --rcm on --port 3055 opent de eerste pagina met RCM aan en poort 3055.

De vier regels onder de instellingen:

  • Install toont het plan volledig en vraagt dan Start the install now? met de cursor op Nee. De vragen van het plan (een oudere HQbird, een draaiende Firebird die gestopt moet worden) staan op dezelfde pagina: Ja beantwoordt ze allemaal. Na Ja sluiten de pagina’s en drukt de installatie haar log en de samenvatting af op het normale scherm, zoals in de gewone installer hieronder.
  • Plan details toont wat de code van het plan betekent, wat de installer op de host heeft gevonden, de waarschuwingen en de OS-pakketten die hij zal installeren.
  • About plans somt alle codes op (M1 … M17). Enter op een code legt deze uit. Een * markeert de code van het plan van nu.
  • Quit verlaat de installer (exitcode 1). Er is niets gewijzigd.

De gewone installer

De gewone installer draait wanneer een van deze voorwaarden geldt:

  • de optie --no-tui, of de variabele HQBIRD_NO_TUI=1;
  • --yes, --check, --uninstall, --extract, --plan-help, --help;
  • stdin of stdout is geen terminal: een script, ssh host 'command' zonder een terminal, of een pipe zoals ... 2>&1 | tee install.log;
  • TERM is dumb of niet ingesteld;
  • het venster is kleiner dan 80 kolommen bij 24 rijen (in tmux met zijn statusregel heeft een 80x24-terminal 23 rijen: maak het venster groter, of gebruik --no-tui);
  • bash op de host is ouder dan 4.4 (RHEL 7, CentOS 7);
  • de kit is 2027.2.30 of ouder.

Voor het venster en voor bash zegt de eerste regel van de uitvoer waarom de pagina’s niet zijn geopend.

Een typische run van de gewone installer op een server zonder Firebird:

text
[install] HQbird 2027 setup 2027.2.9, Firebird 5.0 (5.0.5.1916)
[install] host: Ubuntu 24.04.5 LTS, kernel 6.8.0-142-generic
[install] checking the payload (sha256) ...
[install] unpacking into /var/tmp/hqbird2027.k3Qf1x ...
[install] OS libraries missing: libtommath.so.1 (packages: libtommath1)
[install] plan M1: Firebird new /opt/firebird (unit firebird, port 3050)
[install]              agent new in /opt/hqbird/fbagent-fb50 (unit hqbirdfbagent-fb50), HQ Monitor hqbirdmonitor-fb50
[install]              OS packages to install: libtommath1
[install] Install as planned? Yes/No y
[install] installing from the package repository: libtommath1
[install] OS libraries: installed
[install] installing (fbagent --setup-install; log /var/log/fbagent/install.log) ...
...
Done: agent hqbirdfbagent-fb50 in /opt/hqbird/fbagent-fb50, Firebird 5.0.5.1916 in /opt/firebird (port 3050).
HQ Monitor: http://localhost:23050/ (login admin; password in /opt/hqbird/conf/access.properties)
[install] done. Uninstall: sudo sh hqbird2027-fb50-linux-2027.2.9.run --uninstall

Dit voorbeeld is van kit 2027.2.9. Vanaf kit 2027.2.19 bevat de samenvatting ook de regels RCM: en Pairing: van de clusterconsole (“Next: cluster” hieronder). Met agent 3.1.0 en later en geen gekozen cluster zijn ze:

text
RCM:        off; turn it on in HQbird Monitor or with fbagent --cluster-init <id>
Pairing:    off; turn it on in HQbird Monitor or with fbagent --cluster-pairing on (port 7450)

Wat de regels betekenen:

  • host: de distributie en de kernel; de installer weigert een host die niet x86_64 is, geen systemd heeft, of een kernel ouder dan 3.2 draait.
  • OS libraries: wat de Firebird van deze lijn van het OS nodig heeft (sectie 9). Het plan somt de ontbrekende pakketten op (OS packages to install); na de bevestiging haalt de installer ze uit de repository van de distributie. Zonder repository stopt hij met exitcode 6 en drukt de commando’s af.
  • plan: wat de agent heeft gevonden (found Firebird ..., HQbird: ... regels) en wat hij zal doen: Firebird new (een nieuwe server), update (de Firebird van deze lijn wordt ter plaatse bijgewerkt), of een weigering met de reden (exitcode 1, niets gewijzigd).
  • Install as planned? Yes/No: de laatste vraag voordat er iets wordt gewijzigd. Antwoord y. Wanneer het plan eigen vragen heeft (een oudere HQbird, een andere versie), komen die in plaats daarvan (sectie 5). Zonder terminal geef je --yes mee; anders stopt de installer met exitcode 4.
  • Clustervragen (agent 3.1.0 en later): Install the cluster manager (RCM) on this host and make a new cluster? [y/N] en Turn on discovery mode for 24 hours (an RCM on the network may invite this agent into its cluster; port 7450)? [y/N]. De standaard is Nee. De eerste wordt alleen gevraagd wanneer de host geen RCM heeft en de agent in geen cluster zit; de tweede niet wanneer de agent in een cluster zit of de RCM draait. --yes en een run zonder terminal antwoorden Nee (geen exitcode 4).
  • HQ Monitor: het adres en de login. Een nieuwe installatie krijgt de login admin; het gegenereerde wachtwoord staat in /opt/hqbird/conf/access.properties (modus 0600, alleen leesbaar door root en de agent). Alle HQbird 2027-instanties van de host delen dit bestand. Wijzig het wachtwoord in HQ Monitor.

Het SYSDBA-wachtwoord van een nieuwe Firebird wordt gegenereerd en opgeslagen in /root/fbagent-install-sysdba.txt (modus 0600): een commentaarregel, dan de regel SYSDBA_PASS=<password>. Een latere, extra Firebird op dezelfde host krijgt hetzelfde wachtwoord uit dit bestand. Om je eigen wachtwoord in te stellen, geef je --sysdba-pass-file <file> mee (eerste regel van het bestand) of --sysdba-pass <password>.

Taal van de installer

Kits na 2027.2.30 spreken vier talen: Engels, Russisch (ru), Braziliaans Portugees (pt-BR) en Duits (de). De installer kiest de taal in deze volgorde:

  1. de optie --lang en|ru|pt-BR|de;
  2. de variabele HQBIRD_LANG;
  3. de locale van de console (LC_ALL, dan LC_MESSAGES, dan LANG), wanneer het een UTF-8-locale is;
  4. Engels.

De tweede regel van de uitvoer zegt welke taal het is en hoe je die wijzigt. Deze regel is altijd Engels:

text
[install] Language: Русский (auto). Use --lang en to change.

Opmerkingen:

  • PuTTY stuurt LANG niet naar de server. De eigen locale van de server telt, dus de taal is vaak Engels. Gebruik --lang.
  • Met --yes, en zonder terminal, is de automatische taal Engels: scripts lezen die uitvoer. --lang werkt daar nog steeds.
  • De installer heeft een UTF-8-locale op de host nodig voor de andere talen (C.UTF-8 of en_US.UTF-8). Hij stelt er zelf een in. Zonder een daarvan spreekt hij Engels.
  • In de tekstinterface wijzigt de regel Language van de eerste pagina de taal onmiddellijk. De terminal moet UTF-8 tonen (PuTTY: Window, Translation, Remote character set UTF-8, wat de standaard is).
  • Engels blijft staan in: de voortgangsregels van de installatie zelf, de Done:-samenvatting, /var/log/fbagent/install.log, en de waarschuwingen van de hostscan.

De code van het plan

Het plan heeft een code: M1, M2, … Die benoemt het geval dat de installer op de host heeft gevonden. De installer drukt af wat de code betekent:

text
[install] plan M1: New Firebird and HQbird agent
[install]              This host has no Firebird and no older HQbird. Setup installs a new Firebird and a new HQbird agent.
[install] plan M1: Firebird new /opt/firebird (unit firebird, port 3050)

--plan-help drukt alle codes af en sluit af. Het wijzigt niets. In de tekstinterface toont de eerste pagina de code en de titel, toont “Plan details” de tekst, en somt “About plans” alle codes op.

Code Wat de installer heeft gevonden Firebird Agent Oudere HQbird
M1 niets nieuw nieuw —
M2 Firebird van deze lijn, geen oudere HQbird update nieuw —
M3 Firebird van een andere lijn, geen oudere HQbird nieuw, poort 305N nieuw —
M4 oudere HQbird die de Firebird van deze lijn bedient update nieuw uitgeschakeld, de taken ervan geïmporteerd als ingeschakeld
M5 oudere HQbird van een andere lijn; een Firebird van deze lijn is aanwezig update, na een vraag nieuw blijft werken
M6 oudere HQbird van een andere lijn; geen Firebird van deze lijn nieuw, na een vraag nieuw blijft werken
M7 oudere HQbird zonder een lokale Firebird van een bekende versie update of nieuw nieuw blijft werken, een waarschuwing
M8 een HQbird 2027-agent voor een andere Firebird update of nieuw nieuw, naast de eerste niet gewijzigd
M9 als M8, en een oudere HQbird bedient deze lijn update nieuw, naast de eerste uitgeschakeld, de taken ervan geïmporteerd als ingeschakeld
M10 een agent bedient deze Firebird al (een herhaalde run) update ter plaatse uitgeschakeld wanneer hij draait
M11 --fb-root is een Firebird van deze lijn update nieuw of ter plaatse zoals hierboven
M13 --fb-root is een lege of nieuwe map nieuw in die map nieuw zoals hierboven

Codes van een weigering (exitcode 1, niets gewijzigd): M12 de map bevat een Firebird die de installer niet kan bijwerken (een andere lijn, een versie die hij niet kan lezen, een uitgeschakelde service); M14 de map is niet leeg en bevat geen Firebird; M16 meerdere Firebird-servers van deze lijn, geef --fb-root mee; M17 Firebird 2.5 werkt alleen in /opt/firebird. M15 is de agent-only kit: Firebird wordt niet geïnstalleerd en niet bijgewerkt.

De agent-id

De agent-id benoemt de agent in HQCenter, in de licentie en in het cluster. Hij wordt alleen bij de eerste installatie ingesteld:

  • Standaard: hostnaam + datum + instantie, bijvoorbeeld srv1261114-fb50.
  • --agent-id ID geeft je eigen id (1-128 letters, cijfers, ., _ of -; het eerste teken een letter of cijfer).
  • De installer weigert een id die een andere agent van de host heeft.
  • In de tekstinterface biedt de pagina Agent id de automatische id, de hostnaam, de hostnaam met de instantie, en je eigen waarde, en somt de ids op die de host al heeft.
  • Een geïnstalleerde agent behoudt zijn id. Een herhaalde run toont hem in het plan (id srv1 (kept)), de tekstinterface heeft dan geen regel Agent id, en --agent-id geeft daar alleen een waarschuwing. Een nieuwe agent in een map die een eerdere installatie met zijn configuratie heeft achtergelaten, behoudt ook de id van die configuratie.

Stap 4: Controleer het resultaat

Command
systemctl status firebird hqbirdfbagent-fb50 hqbirdmonitor-fb50 --no-pager
ss -ltnp | grep -E ':3050|:23050'
ISC_PASSWORD="$(sed -n 's/^SYSDBA_PASS=//p' /root/fbagent-install-sysdba.txt)" \
  /opt/firebird/bin/isql -user SYSDBA localhost/3050:/opt/firebird/examples/empbuild/employee.fdb

Gebruik het volledige pad van de voorbeelddatabase: het werkt voor elke lijn en ook na een update, terwijl de behouden databases.conf van een oudere installatie mogelijk geen employee-alias heeft (een nieuwe installatie van 2027.2.3 heeft die wel).

Open http://<server>:23050/ in een browser en meld je aan als admin met het wachtwoord uit /opt/hqbird/conf/access.properties. De Firebird-poort en de HQ Monitor-poort worden geopend in firewalld (zone public) wanneer die draait, anders in ufw wanneer die actief is; met een andere firewall open je ze zelf. Clusterpoorten worden alleen geopend voor een clusteroptie: 7443, 7444 en de nodepoort met --rcm on; de nodepoort en de pairing-poort met --cluster-pairing on. Zonder actieve firewall drukt de installer één regel af met de poorten die hij niet heeft geopend. Een poort die al open was vóór de installatie blijft zoals hij is.

Volgende: cluster

Om je databases van een masterserver naar een replicaserver te repliceren, koppel je de twee servers in de clusterconsole RCM. Met agent 3.1.0 en later installeer je RCM alleen op de master (--rcm on, of antwoord y) en zet je de discovery-modus aan op de replica (--cluster-pairing on). Discovery-modus opent het pairing-venster voor 24 uur: de pairing-poort van de slot van de agent (7450 voor de eerste instantie, 7451 voor de tweede, tot 7459) is open in de firewall, en de RCM kan de agent uitnodigen. Eén host heeft één RCM (poorten 7443 en 7444); de agent die hem heeft gemaakt draait hem en opent geen pairing-venster.

Later, zonder de installer: HQ Monitor → Clusters → Cluster op deze server, of fbagent --cluster-init <id> en fbagent --cluster-pairing on. Kits vanaf 2027.2.19 met een oudere agent starten RCM op elke server en printen het adres in de regel RCM: van de samenvatting; een installatie vóór 2027.2.19 krijgt RCM wanneer je deze bijwerkt met een nieuwere kit (sectie 6). De clustergids (voor kit 2027.2.33) gaat stap voor stap van twee nieuwe servers naar een werkende replica, met schermafbeeldingen: Linux-clustergids (ook in het Russisch en Portugees). Dezelfde stappen alleen als commando’s: hqbird2027-linux-cluster-runbook.md (hqbird2027-linux-cluster-runbook.ru.md, hqbird2027-linux-cluster-runbook.pt.md).

4. Na de installatie

Units

Unit Wat Draait als
firebird (2.5, 4.0, 5.0 in /opt/firebird); firebird-superserver (3.0 in /opt/firebird); voor een andere map de mapnaam met / → _: firebird.opt_fb50, firebird.opt_fb40-2 (4.0, 5.0 in /opt/fb50, /opt/fb40-2), firebird.opt_fb30-superserver (3.0 in /opt/fb30) Firebird-server firebird
hqbirdfbagent-fb50 (tweede instantie hqbirdfbagent-fb50-2; vóór 2027.2.9 hqbirdfbagent-p<Firebird-poort>) HQbird-agent firebird
hqbirdmonitor-fb50 (hqbirdmonitor-fb50-2; vóór 2027.2.9 hqbirdmonitor-p<Firebird-poort>) HQ Monitor firebird

Alle drie zijn ingeschakeld en starten bij het opstarten. journalctl -u hqbirdfbagent-fb50 toont het unitlog van de agent. Firebird 3.0 heeft ook de units firebird-classic.socket en [email protected] (firebird.opt_fb30-classic.* in een andere map), en Firebird 2.5 heeft firebird.socket: ze blijven inactive, dit is normaal. Het Firebird 2.5-proces is fb_smp_server (SuperClassic).

Waar de bestanden staan

Het voorbeeld is de eerste Firebird 5.0-instantie in /opt/firebird op poort 3050. Een tweede instantie van de lijn heeft -2 in de agentnamen (fbagent-fb50-2, hqbirdfbagent-fb50-2, hqbirdmonitor-fb50-2). Instanties die vóór 2027.2.9 zijn geïnstalleerd, hebben de poort in deze namen (fbagent-p3050, hqbirdfbagent-p3050, hqbirdmonitor-p3050).

text
/opt/firebird/                         Firebird 5.0 server: bin/, lib/, plugins/, firebird.conf,
                                       databases.conf, security5.fdb, *.debug files (symbols)
/opt/fb50/                             a Firebird 5.0 next to another line (/opt/fb40, /opt/fb30)
/opt/hqbird/                           root of the HQbird agents
  conf/access.properties               HQ Monitor sign-in, shared by all instances of the host (0600)
  fbagent-fb50/                        HQbird agent of this Firebird
    fbagent                            the agent (unit hqbirdfbagent-fb50)
    hqmonitor                          HQ Monitor (unit hqbirdmonitor-fb50)
    agent_config.json                  agent configuration (encrypted secrets: config_secret.key)
    config.properties                  HQ Monitor configuration
    hqbird2027-firebird.json           the Firebird this installer installed
    hqbird2027-hqmonitor-firewall.json the HQ Monitor port this installer opened in firewalld or ufw
    conf/                              trace and job settings
    logs/                              agent log (firebird-agent_<date>.jsonl), license_state.json;
                                       journal.log and server_status.json after the first checks
    bak/                               backups of the configuration
    outcoming/                         status reports for HQCenter
    update/                            update cache: hqmonitor/, hqclusternode/, hqbirdrcm/
    certs/                             certificates after the attach to HQCenter
  fbagent-hqbird-takeover.json         state of the older HQbird units before the takeover (section 5)
/opt/hqbirdrcm/                        the cluster console RCM (unit hqbirdrcm, owner firebird):
                                       with agent 3.1.0 only after --rcm on (or HQ Monitor);
                                       kits 2027.2.19+ with an older agent: unless --rcm off
/opt/hqclusternode/                    the cluster node (owner firebird), empty until the host is
                                       linked in RCM or HQCenter adds it to a cluster
/var/lib/hqmonitor/<server id>/        HQ Monitor data
/var/log/fbagent/install.log           log of the installer's steps (passwords are hidden)
/root/fbagent-install-sysdba.txt       SYSDBA password of a new Firebird (root only, 0600)
/etc/sysctl.d/90-hqbird-firebird.conf  kernel settings for Firebird (vm.max_map_count), only when
                                       the system value is lower (Ubuntu 24.04 needs none)
/etc/sudoers.d/                        the agent's sudoers rules for its root helpers (updates, HQ Monitor)

De installer laat niets achter in /var/tmp: de werkmappen /var/tmp/hqbird2027.XXXXXX worden aan het einde verwijderd, ook na een fout.

Logs

Log Waar
Installer de terminal; /var/log/fbagent/install.log
Agent /opt/hqbird/fbagent-fb50/logs/firebird-agent_<datum>.jsonl, journal.log; journalctl -u hqbirdfbagent-fb50
HQ Monitor journalctl -u hqbirdmonitor-fb50; auditlog /opt/hqbird/fbagent-fb50/hqmonitor_audit.log
Firebird /opt/firebird/firebird.log

Updates zonder HQCenter

Vanaf kit 2027.2.31 (agent 3.3.0) haalt een agent die aan geen HQCenter is gekoppeld nieuwe versies van de updateserver van de leverancier. De updatemodus is de sleutel update.mode van agent_config.json:

Modus Wat zichzelf bijwerkt
agent (standaard) De agent, HQ Monitor en fbmcp. Een nieuw Firebird-pakket wordt gedownload en wacht op de beheerder
all Hetzelfde, en ook Firebird, in het toepassingsvenster (’s nachts van 03:30 tot 04:00; de update herstart Firebird)
off Niets: de agent voert geen updatecontroles uit. Om bij te werken, voer de installer van een nieuwe versie uit (sectie 6)
  • Bij de installatie: de regel Updates van de tekstinterface, of --auto-update all|agent|off. Zonder deze wijzigt de installer de modus niet.
  • Later: de pagina Updates van HQ Monitor, of opnieuw de installer met --auto-update <modus>.
  • De status: sudo /opt/hqbird/fbagent-fb50/fbagent --update-status (voeg --json toe voor een script). Het toont de releasebron, de zone en het laatste antwoord van de updateserver.

De agent opent alleen uitgaande HTTPS-verbindingen naar deze adressen. Er is geen inkomende poort nodig.

Doel Adres
Updates, zone EU liceu.ibsurgeon.com:9443
Updates, zone BR licbr.ibsurgeon.com:9443
Updates, zone RU licru.ibsurgeon.com:20943
Proeflicentie trialeu.ibsurgeon.com:9443, trialbr.ibsurgeon.com:19443, trialru.ibsurgeon.com:23943

Een server die aan een HQCenter is gekoppeld, gebruikt de updateadressen niet: deze haalt zijn updates van dat HQCenter (sectie 8).

Meldingen

Vanaf kit 2027.2.33 (agent 3.4.0) stuurt de agent berichten over serverproblemen naar een eigen Telegram-bot, een webhook of e-mail (SMTP). De installer stelt geen kanaal in, en er wordt niets verzonden tot je er een toevoegt: HQ Monitor → Servers → Meldingen. Om een kanaal vanaf de opdrachtregel te testen: sudo -u firebird /opt/hqbird/fbagent-fb50/fbagent --notify-test <kanaal>; --notify-history toont de laatste afleveringen.

5. Update van een oudere HQbird (2024 en eerder)

De installer vindt een geïnstalleerde HQbird (FBDataGuard) in /opt/hqbird en de bijbehorende units, en de Firebird-servers die deze beheert. Daarna volgt hij dezelfde regels als de HQbird-installatiescripts:

Diagram

Wat je op de terminal ziet:

text
[install]   found Firebird 5.0.5.1878: /opt/firebird, port 3050, unit firebird, no agent
[install] plan M4: Firebird update /opt/firebird (unit firebird, port 3050)
[install]              agent new in /opt/hqbird/fbagent-fb50 (unit hqbirdfbagent-fb50), HQ Monitor hqbirdmonitor-fb50
[install]              HQbird services to turn off: hqbird
[install] Firebird 5.0.5.1878: unit firebird, port 3050, 0 TCP connections
[install] Confirm to stop running Firebird 5.0.5.1878? Yes/No y
  • Het plan noemt de Firebird die wordt bijgewerkt; --fb-root en --port kunnen deze niet verplaatsen (de unit is vastgelegd).
  • De vraag Confirm to stop running Firebird? wordt gesteld wanneer de engine moet worden gestopt; de regel ervoor toont de open verbindingen. Another version wordt gevraagd wanneer de oudere HQbird een Firebird van een andere versie beheert (werk die bij, of een nieuwe ernaast). --yes beantwoordt alle vragen met Ja; zonder terminal en zonder --yes stopt de installer met exitcode 4 en wijzigt niets.
  • --disable-hqbird schakelt de oudere HQbird-units in elk geval uit; --no-hqbird laat de oudere HQbird met rust (deze blijft naast HQbird 2027 draaien).
  • Het SYSDBA-wachtwoord wordt niet gevraagd: de agent neemt het over van de oudere HQbird.
  • HQ Monitor gebruikt de aanmelding van de oudere HQbird: het bestand /opt/hqbird/conf/access.properties wordt behouden, dus meld je aan met de login en het wachtwoord die je eerder gebruikte. De installer geeft het bestand aan firebird met modus 0600 (de oudere HQbird liet het leesbaar voor elke gebruiker). De gastlogin van de oudere HQbird (access.guest-login) wordt niet door HQ Monitor gebruikt.

Wat behouden blijft: firebird.conf, databases.conf / aliases.conf, de beveiligingsdatabase, het SYSDBA-wachtwoord, de databases, de back-ups en de bestanden van de oudere HQbird. De update vervangt de Firebird-programmabestanden ter plaatse; de vervangen bestanden worden bewaard in /opt/fbagent-update-backup/<mapnaam>-<id>/<tijd>_<oude versie>_to_<nieuwe versie>/ (de twee nieuwste updates blijven). De HQbird-jobs (back-ups, sweeps, monitoring) worden geïmporteerd in de nieuwe agent. De HQbird-licentie van de oudere HQbird wordt niet overgedragen: de nieuwe agent draait de proefversie totdat een licentie is geïnstalleerd of de server aan je HQCenter is gekoppeld.

Vanaf kit 2027.2.33 (agent 3.4.0) doet de import van de configuratie van de oudere HQbird nog twee dingen:

  • Het registreert de databases van de oudere HQbird in het Firebird-aliassenbestand (databases.conf, of aliases.conf voor 2.5) als regels naam = pad. Het oude bestand wordt eerst gekopieerd. Een database wordt overgeslagen wanneer het pad al in het bestand staat, of wanneer het bestand niet bestaat. Een bestand met een include-richtlijn wordt niet gewijzigd.
  • Het verwijdert de oude monitoringlogs van de oudere HQbird: de inhoud van de mappen mon/outcoming en mon/outtrace van de uitvoermap (de mappen blijven). Er wordt niets verwijderd terwijl een service van de oudere HQbird draait. De verwijdering kan niet ongedaan worden gemaakt: als je deze logs nodig hebt, kopieer ze dan vóór de installatie.

Beide staan standaard aan. De sleutels hqbird_import.register_databases en hqbird_import.clean_mon_logs van agent_config.json (beide staan in de configuratie-editor van HQ Monitor) schakelen ze uit voor een latere import; de installer heeft er geen optie voor.

De status van de oudere HQbird-units vóór de overname wordt opgeslagen in /opt/hqbird/fbagent-hqbird-takeover.json. --uninstall schakelt ze niet weer in.

Niet-interactieve vorm:

Command
sudo sh hqbird2027-fb50-linux-2027.2.9.run --yes --disable-hqbird

6. Update van HQbird 2027 naar een nieuwe versie

Een nieuwere installer van dezelfde lijn, uitgevoerd op een host met HQbird 2027, werkt de geïnstalleerde instantie ter plaatse bij: Firebird, de debug-bestanden, de agent en HQ Monitor. De configuratie, de databases, de proef- of licentiestatus, de HQ Monitor-poort en de aanmelding blijven behouden.

Command
sudo sh hqbird2027-fb50-linux-2027.2.9.run

In de tekstinterface toont de eerste pagina Plan M10: Update of an installed HQbird 2027, de agent met zijn id (kept), en geen regel Agent-id; Install start de update. De gewone installer toont:

text
[install] HQbird 2027 setup 2027.2.9, Firebird 5.0 (5.0.5.1916)
[install]   found Firebird 5.0.5.1880: /opt/firebird, port 3050, unit firebird, agent hqbirdfbagent-p3050
[install] plan M10: Firebird update /opt/firebird (unit firebird, port 3050)
[install]              agent in_place in /opt/hqbird/fbagent-p3050 (unit hqbirdfbagent-p3050), HQ Monitor hqbirdmonitor-p3050
[install] Firebird 5.0.5.1880: unit firebird, port 3050, 2 TCP connections
[install] Confirm to stop running Firebird 5.0.5.1880? Yes/No y
...
Firebird updated: 5.0.5.1880 -> 5.0.5.1916
HQ Monitor updated 1.31.0 -> 1.33.0 (...)
Done: agent hqbirdfbagent-p3050 in /opt/hqbird/fbagent-p3050, Firebird 5.0.5.1916 in /opt/firebird (port 3050).

Een update verandert de namen van de agentmap en de units niet: de instantie in dit voorbeeld is geïnstalleerd vóór 2027.2.9 en behoudt fbagent-p3050.

Wanneer de Firebird-build van het installatieprogramma dezelfde is als de al geïnstalleerde (bijvoorbeeld Firebird 2.5.9.27194 in elke HQbird 2027 voor 2.5), worden alleen de agent en HQ Monitor bijgewerkt: Firebird wordt niet gestopt en er is geen Bevestigen om te stoppen-vraag.

De behouden databases.conf van een instantie die door een oudere HQbird 2027 is geïnstalleerd, heeft mogelijk geen employee-alias; maak verbinding met de voorbeelddatabase via het volledige pad (sectie 3, stap 4). Op Firebird 3.0 laat een update vanaf 2027.2.0 /opt/firebird/examples/empbuild/employee.fdb achter met modus 0444, en Firebird kan deze niet openen (no permission for read-write access); als u de voorbeelddatabase nodig hebt: sudo chmod 660 /opt/firebird/examples/empbuild/employee.fdb. Uw eigen databases worden niet aangeraakt.

  • Met meerdere instanties van de lijn, geef de instantie op die bijgewerkt moet worden: --fb-root /opt/fb50-2 --port 3056.
  • Hetzelfde installatieprogramma opnieuw uitvoeren over de geïnstalleerde versie is een reparatie: de programmabestanden en units worden opnieuw geschreven, de gegevens blijven behouden.
  • Na de verbinding met een HQCenter (sectie 8) worden de agent, HQ Monitor, Firebird en de clustercomponenten bijgewerkt vanuit de HQCenter- catalogus; een nieuw installatieprogramma is dan niet nodig.
  • Een server die aan geen HQCenter is gekoppeld met agent 3.3.0 of later (kits vanaf 2027.2.31) werkt de agent, HQ Monitor en fbmcp zelf bij, tenzij de updatemodus off is (“Updates zonder HQCenter” in sectie 4). Een installatie van vóór 2027.2.31 krijgt dit na één update met een nieuwer installatieprogramma. Een update met het installatieprogramma behoudt de updatemodus; --auto-update <mode> wijzigt deze.

7. Onderhoudscommando’s

Elke onderhoudsactie is een uitvoering van het installatieprogramma met opties, of een agentcommando in de agentmap. In een terminal opent een uitvoering zonder --yes de tekstinterface met deze opties al ingesteld (kits na 2027.2.30): controleer het plan op de eerste pagina en kies vervolgens Installeren.

Actie Commando
Een andere instantie van deze lijn sudo sh hqbird2027-fb50-linux-<ver>.run --fb-root /opt/fb50-2 --port 3056
Repareren / bijwerken sudo sh hqbird2027-fb50-linux-<ver>.run (met meerdere instanties: --fb-root <folder> --port <port>)
Koppelen aan HQCenter sudo sh hqbird2027-fb50-linux-<ver>.run --attach attach.json tijdens de installatie, of later cd /opt/hqbird/fbagent-fb50 && sudo ./fbagent --attach --file /path/attach.json
De trial-e-mail verzenden cd /opt/hqbird/fbagent-fb50 && sudo -u firebird ./fbagent --trial-email [email protected] --accept-privacy
De trialcode uit de e-mail bevestigen cd /opt/hqbird/fbagent-fb50 && sudo -u firebird ./fbagent --trial-confirm <code> (of in HQ Monitor)
Een licentiebestand installeren --license <file> tijdens de installatie, of cd /opt/hqbird/fbagent-fb50 && sudo -u firebird ./fbagent --license-install /path/license.json
Status van de installatie sudo /opt/hqbird/fbagent-fb50/fbagent --install-state --json
Status van de updates (geen HQCenter) sudo /opt/hqbird/fbagent-fb50/fbagent --update-status
De updatemodus wijzigen (geen HQCenter) HQ Monitor, de pagina Updates; of sudo sh hqbird2027-fb50-linux-<ver>.run --auto-update all|agent|off
Verwijderen sudo sh hqbird2027-fb50-linux-<ver>.run --uninstall [--remove-data] [--force] [--agent-dir /opt/hqbird/fbagent-fb50]

Een andere instantie

Command
sudo sh hqbird2027-fb50-linux-2027.2.9.run --fb-root /opt/fb50-2 --port 3056

De nieuwe Firebird gaat naar /opt/fb50-2 (een nieuwe of lege map), unit firebird.opt_fb50-2, met een eigen agent (/opt/hqbird/fbagent-fb50-2, unit hqbirdfbagent-fb50-2) en een eigen HQ Monitor (http://localhost:23056/, unit hqbirdmonitor-fb50-2). De agent krijgt het laagste vrije nummer van de lijn: fb50-2 voor de tweede instantie, ook naast een agent die vóór 2027.2.9 is geïnstalleerd (fbagent-p3050). Het HQ Monitor-aanmeldbestand /opt/hqbird/conf/access.properties wordt gedeeld door de instanties van de host: een nieuwe instantie zonder --hqmonitor-login behoudt de bestaande aanmelding, en --hqmonitor-login/--hqmonitor-password-file op een willekeurige instantie wijzigen de aanmelding van alle instanties (het oude bestand wordt bewaard als access.properties.bak-<time>). Firebird 2.5 ondersteunt geen tweede instantie: het installatieprogramma stopt met refused (M17): Firebird 2.5 works only in /opt/firebird, not in <folder> (exitcode 1, niets gewijzigd). Installeer een Firebird van een andere lijn ernaast, bijvoorbeeld sudo sh hqbird2027-fb50-linux-<ver>.run --fb-root /opt/fb50 --port 3051.

Verwijderen

Het verwijderen op Windows en Linux, servers in een cluster en wat op de schijf achterblijft, wordt volledig beschreven in verwijderingshandleiding. In het kort:

Command
# the agent and HQ Monitor of this instance; Firebird, the databases, configs and logs stay
sudo sh hqbird2027-fb50-linux-2027.2.9.run --uninstall
# the same, and the agent's configuration, logs, license state and HQ Monitor data too
sudo sh hqbird2027-fb50-linux-2027.2.9.run --uninstall --remove-data

Zonder --agent-dir verwijdert het installatieprogramma de enige agent in /opt/hqbird. Met meerdere agents op de host stopt het (exitcode 1), toont hun mappen en vraagt om --agent-dir:

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

--uninstall stopt en verwijdert de units van de agent en zijn HQ Monitor (hqbirdfbagent-fb50, hqbirdmonitor-fb50), de sudoers-regels van de agent en zijn programma’s (fbagent, hqmonitor), en sluit de HQ Monitor-poort die de installatie had geopend in firewalld of ufw. De agentmap blijft met de configuratie en logs; --remove-data verwijdert ook de map en de HQ Monitor-gegevens in /var/lib/hqmonitor/. Firebird blijft geïnstalleerd (unit, programma- map, databases); de oudere HQbird-units die waren uitgeschakeld blijven uitgeschakeld. Met meerdere agents op de host blijft het gedeelde HQ Monitor-aanmeldbestand behouden tot de laatste agent is verwijderd.

Als de agent de RCM van de host draait en andere agents die RCM gebruiken, weigert --uninstall met exitcode 5 en wijzigt niets: this agent runs the RCM of the host, and other agents use it: remove the cluster in the RCM console, or run again with --force. --force verwijdert de agent toch; het cluster verliest dan zijn CA (geen nieuwe certificaten, geen nieuwe leden). De RCM-unit blijft zolang andere agents van de host deze gebruiken. Om een andere agent de eigenaar van een nieuwe RCM te maken wanneer de oude eigenaar weg is: fbagent --cluster-init <id> --rcm-takeover (een nieuwe CA: koppel de leden opnieuw).

De hint aan het einde van een installatie (Uninstall: sudo sh ... --uninstall) heeft geen --agent-dir: voeg deze bij meerdere instanties toe zoals hierboven getoond.

Om ook de Firebird van een instantie te verwijderen (het installatieprogramma doet dit niet; maak eerst gbak-back-ups van de databases), bijvoorbeeld 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

8. Koppelen aan uw HQCenter

HQCenter is de centrale server van uw bedrijf die de HQbird- agents beheert: licenties, configuratie, updates, back-upoverzicht. Zonder een HQCenter werkt de agent zelfstandig met de versies van het installatieprogramma en het trial- of licentiebestand.

Diagram
  1. Open in het HQCenter-beheerpaneel Tokens (https://<hqcenter>:8443/admin/tokens). Kies in het formulier Install script de licentie (of geen), de modus, het aantal servers en de geldigheidsduur (1 tot 365 dagen); de velden platform en Firebird worden niet gebruikt. Klik op Download connection file en sla attach.json op. Het bestand bevat een geheim token: bewaar het veilig (chmod 600), verwijder het na gebruik en trek het token in de lijst op dezelfde pagina in. Het formulier wordt alleen getoond wanneer admin_panel.install_script_url is ingesteld.
  2. Kopieer attach.json naar de server.
  3. Koppel op een van twee manieren:
Command
# during the installation
sudo sh hqbird2027-fb50-linux-2027.2.9.run --yes --attach /root/attach.json
# later, for an installed agent
cd /opt/hqbird/fbagent-fb50 && sudo ./fbagent --attach --file /root/attach.json

Met een gewoon token wacht het commando tot de HQCenter-beheerder het verzoek goedkeurt (tot 30 minuten). Met een licentietoken wordt de agent direct gekoppeld en krijgt de licentie. Na het koppelen eindigt de trial wanneer HQCenter de agent een licentie geeft; de agent, HQ Monitor, Firebird en de clustercomponenten worden dan bijgewerkt vanuit de HQCenter-catalogus. Een mislukte koppeling tijdens de installatie maakt de installatie niet ongedaan: de samenvatting vermeldt dit, en het bovenstaande commando herhaalt het.

Vereisten: HQCenter (goafts) 1.15.0 of nieuwer (oudere versies hebben geen knop voor het verbindingsbestand); de server bereikt de HQCenter-bootstrap-poort één keer voor het koppelen en daarna de poort van de agents (443 standaard). HQCenter kan zonder internet werken. Een tweede koppeling van dezelfde server aan hetzelfde HQCenter vereist de goedkeuring van de beheerder, zelfs met een licentietoken.

9. Onbeheerde installatie en scripts

Elke optie werkt ook op de terminal. Een onbeheerde uitvoering vereist --yes (beantwoordt de vragen van het plan; zonder terminal en zonder --yes stopt het installatieprogramma met exitcode 4). --yes opent nooit de tekst- interface. Een script dat het installatieprogramma in een terminal start en zelf de vragen beantwoordt (bijvoorbeeld met expect) moet --no-tui toevoegen of HQBIRD_NO_TUI=1 instellen: kits na 2027.2.30 openen daar de pagina’s. De exitcode geeft het resultaat aan; de details staan op de terminal en in /var/log/fbagent/install.log.

Opties

Optie Betekenis Standaard
--fb-root DIR Map van de nieuwe Firebird (nieuw of leeg); of de map van de Firebird die moet worden bijgewerkt /opt/firebird, daarna /opt/fb<NN>
--port N Firebird-poort 3050 voor de eerste Firebird; voor een andere lijn de poort van de lijn (3053 voor 3.0, 3054 voor 4.0, 3055 voor 5.0)
--sysdba-pass-file F, --sysdba-pass P SYSDBA-wachtwoord van een nieuwe Firebird (eerste regel van F; P wordt naar een 0600-bestand geschreven) gegenereerd, opgeslagen in /root/fbagent-install-sysdba.txt; een volgende Firebird op de host neemt het wachtwoord uit dat bestand
--agent-id ID agent.id van de nieuwe agent; alleen bij de eerste installatie, een geïnstalleerde agent behoudt zijn id (“De agent-id” in sectie 3) hostnaam + datum + instantie
--hqmonitor-port N HQ Monitor-poort 20000 + Firebird-poort
--hqmonitor-login L --hqmonitor-password-file F HQ Monitor-aanmelding, gedeeld door alle instanties van de host: opgegeven op één instantie, wijzigt de aanmelding van alle admin + gegenereerd wachtwoord; een update of een volgende instantie behoudt de bestaande aanmelding
--email ADDR --accept-privacy [--trial-zone RU|EU|BR] Trial-e-mail (30 dagen); het adres wordt naar de trialserver van de leverancier verzonden geen
--auto-update all|agent|off Updates van een server die aan geen HQCenter is gekoppeld (kits vanaf 2027.2.31): agent = de agent, HQ Monitor en fbmcp werken zichzelf bij, een Firebird-pakket wacht op u; all = Firebird ook, in zijn venster; off = geen updatecontroles (“Updates zonder HQCenter” in sectie 4) de modus wordt niet gewijzigd; een nieuwe agent heeft agent

| --license F | Licentiebestand om te installeren | geen | | --attach F | Koppelen aan uw HQCenter (attach.json) | geen | | --no-hqbird, --disable-hqbird | De oudere HQbird met rust laten / al zijn units uitschakelen | automatisch | | --no-debug | De Firebird-debugbestanden niet installeren | geïnstalleerd | | --no-fbmcp | fbmcp (de MCP-server voor AI-clients) niet installeren en de fbmcp van deze host niet wijzigen | geïnstalleerd | | --fbmcp-allow-from A,B | De remote-modus van fbmcp inschakelen voor deze beheerdersadressen (IP of CIDR) | alleen lokaal | | --fbmcp-port N, --fbmcp-dns NAME,..., --fbmcp-ip ADDR | De remote-poort van fbmcp; extra namen voor het certificaat; het adres voor het certificaat en de listener | poort 8650 | | --rcm on\|off | De clusterconsole RCM op deze host installeren en een nieuw cluster maken (agent 3.1.0 en later) | gevraagd; Nee | | --rcm-password-file F | RCM-beheerderswachtwoord met --rcm on (eerste regel van F) | gegenereerd, aan het einde getoond | | --cluster-id ID | Cluster-id met --rcm on | de hostnaam | | --cluster-pairing on\|off | Discovery-modus: het koppelvenster gedurende 24 uur, een RCM mag deze agent uitnodigen | gevraagd; Nee | | --rcm-allow A,B,... | Alleen deze RCM’s mogen deze host uitnodigen in discovery-modus (IP, CIDR of hostnaam) | elke RCM | | --pairing-port N | Koppelpoort 7450–7459 van een nieuwe agent; hij kiest de slot (nodepoorten 7051+k, 7061+k). Een latere setup behoudt de slot | de eerste vrije slot | | --cluster-node on\|off | De clusternode-service in de cache van de agent plaatsen | aan | | --yes | Antwoord Ja op de vragen van het plan (Nee op de clustervragen) | vragen | | --check | Alleen de controles, de bibliotheken en het plan; er wordt niets gewijzigd | — | | --plan-help | Afdrukken wat de codes van het plan betekenen (M1, M2, …) en afsluiten | — | | --no-tui | De gewone installer, zonder de tekstinterface; ook de variabele HQBIRD_NO_TUI=1 (“The plain installer” in sectie 3) | de tekstinterface in een terminal | | --lang en\|ru\|pt-BR\|de | Taal van de installer; ook de variabele HQBIRD_LANG (“Language of the installer” in sectie 3) | de UTF-8-locale van de console, anders Engels | | --tmpdir DIR | Hier uitpakken (een map waar programma’s mogen draaien) | /var/tmp | | --extract DIR | Alleen de payload uitpakken naar DIR/payload en afsluiten | — | | --uninstall [--remove-data] [--force] [--agent-dir DIR] | De agent en HQ Monitor verwijderen (Firebird blijft); --force verwijdert ook de agent die de RCM van de host draait terwijl andere agents die gebruiken | — |

Opties kunnen worden geschreven als --port 3055 of --port=3055. Relatieve paden tellen vanaf de huidige map.

Voorbeelden

Nieuwe installatie met de standaardwaarden:

Command
sudo sh hqbird2027-fb50-linux-2027.2.9.run --yes
echo "exit code $?"

Nieuwe installatie in een gekozen map en poort, met een SYSDBA-wachtwoord uit een bestand en een HQ Monitor-aanmelding:

Command
umask 077
printf '%s\n' 'S3cret-Sysdba' > /root/sysdba.txt
printf '%s\n' 'S3cret-Monitor' > /root/hqm.txt
sudo sh hqbird2027-fb50-linux-2027.2.9.run --yes \
  --fb-root /opt/firebird --port 3050 \
  --sysdba-pass-file /root/sysdba.txt \
  --hqmonitor-port 24000 --hqmonitor-login ops --hqmonitor-password-file /root/hqm.txt
rm -f /root/sysdba.txt /root/hqm.txt

Nieuwe installatie met het trial-e-mailadres, een licentiebestand en het attach-bestand:

Command
sudo sh hqbird2027-fb50-linux-2027.2.9.run --yes \
  --email [email protected] --accept-privacy --trial-zone EU \
  --license /root/hqbird-license.json \
  --attach /root/attach.json

Update van een oudere HQbird, alle oudere HQbird-units uit:

Command
sudo sh hqbird2027-fb50-linux-2027.2.9.run --yes --disable-hqbird

Update van HQbird 2027 naar een nieuwe versie (één instance; bij meerdere --fb-root en --port toevoegen):

Command
sudo sh hqbird2027-fb50-linux-2027.2.9.run --yes

Een tweede Firebird 5.0-instance op poort 3056:

Command
sudo sh hqbird2027-fb50-linux-2027.2.9.run --yes --fb-root /opt/fb50-2 --port 3056

Verwijderen:

Command
sudo sh hqbird2027-fb50-linux-2027.2.9.run --uninstall
sudo sh hqbird2027-fb50-linux-2027.2.9.run --uninstall --remove-data

Een script dat stopt bij een mislukte installatie:

Command
#!/bin/sh
set -e
sh hqbird2027-fb50-linux-2027.2.9.run --yes || {
  rc=$?
  echo "HQbird setup failed with code $rc, see /var/log/fbagent/install.log" >&2
  exit $rc
}
echo "HQbird 2027 installed"

Server zonder internet: OS-bibliotheken

De Firebird van een lijn heeft deze bibliotheken van het OS nodig (naast glibc):

Lijn Pakketten (Debian/Ubuntu) Pakketten (RHEL-familie)
5.0 libtommath1, libicu<NN>, libgssapi-krb5-2 libtommath (EPEL), libicu, krb5-libs
4.0 libtommath1, libicu<NN> libtommath (EPEL), libicu
3.0 libtommath1, libicu<NN> libtommath (EPEL), libicu
2.5 meestal niets (libstdc++6 zit in het basissysteem) meestal niets

Kits na 2027.2.30 van de lijnen 3.0, 4.0 en 5.0 hebben ook het programma colrm nodig, dat het Firebird-installatiescript gebruikt: pakket bsdextrautils (bsdmainutils op oudere Debian en Ubuntu). Een minimale Debian heeft het niet; de RHEL-familie heeft het in util-linux, dat er altijd is.

Wanneer een pakket ontbreekt en de repository niet bereikbaar is, stopt de installer met exitcode 6 en wordt er niets gewijzigd:

text
[install] ERROR: no access to the package repository, or a package is not there; nothing was changed.
[install] Missing: libtommath1
[install] Install them, then run this file again:
[install]   apt-get install -y libtommath1
[install] On a server without internet: on a PC with the same Ubuntu 24.04.5 LTS
[install]   apt-get download libtommath1
[install] copy the .deb files here and run:  apt-get install -y ./*.deb

Op de RHEL-familie zit libtommath in EPEL: met een bereikbare repository voegt de installer zelf epel-release toe. Zonder bereikbare repository zijn de commando’s dnf install -y epel-release, dnf download --resolve <packages> en dnf install -y ./*.rpm. --check drukt dezelfde lijst vooraf af, zodat de pakketten kunnen worden voorbereid vóór het installatievenster.

Exitcodes

Code Betekenis Wijzigingen op de host
0 Klaar (waarschuwingen over het trial-e-mailadres, de attach of de licentie staan in de samenvatting) ja
1 Geweigerd: de host, een optie, een bestand of het plan (de reden wordt afgedrukt). Ook: Quit in de tekstinterface geen
2 De installatie is mislukt en teruggedraaid. Ook: de installer is gestopt door een signaal (Ctrl+C) teruggedraaid; geen wanneer gestopt vóór de installatie
3 De installatie is mislukt en de terugdraaiing was niet volledig (de samenvatting zegt wat te controleren) gedeeltelijk
4 Een vraag van het plan werd niet bevestigd (geen terminal, geen --yes). geen
5 De payload heeft de controle niet doorstaan (sha256, handtekeningen): download het bestand opnieuw. Met --uninstall: geweigerd, de agent draait de RCM van de host en andere agents gebruiken die (sectie 7) geen
6 OS-bibliotheken ontbreken en de pakketrepository is niet bereikbaar geen
7 Een Firebird uit de pakketten van de distributie is geïnstalleerd geen

10. Probleemoplossing

Probleem Wat te doen
run as root (sudo sh ...) Voer de installer uit met sudo of als root
De pagina’s van de tekstinterface openen niet De eerste regel zegt waarom: needs a window of 80x24 or larger (maak het venster groter; tmux met een statusregel neemt één rij in) of needs bash 4.4 or newer. De gewone installer die dan draait, doet dezelfde installatie
Verkeerde tekens of gebroken regels op de pagina’s Stel de terminal in op UTF-8, of voer uit met --lang en; --no-tui draait de gewone installer
/var/tmp is mounted noexec Voer opnieuw uit met --tmpdir /root (elke map waar programma’s mogen draaien)
is damaged or cut (exitcode 5) Kopieer het .run-bestand opnieuw en vergelijk de sha256sum met de gepubliceerde waarde
Exitcode 6, bibliotheken ontbreken Bereid de pakketten voor zoals afgedrukt (sectie 9) en voer de installer daarna opnieuw uit
Exitcode 7, Firebird uit de distro-pakketten Verwijder de pakketten (apt-get remove firebird3.0-server, houd een gbak-backup) of gebruik de online-installer met --import-firebird
refused (M17): Firebird 2.5 works only in /opt/firebird Een tweede Firebird 2.5 is niet mogelijk; installeer een andere lijn ernaast (sectie 7)
--uninstall geweigerd (exitcode 1) met meerdere agents Voeg --agent-dir toe met een map uit de lijst, bijvoorbeeld --agent-dir /opt/hqbird/fbagent-fb50-2
--uninstall geweigerd (exitcode 5): this agent runs the RCM of the host Verwijder eerst het cluster in de RCM-console, of voer opnieuw uit met --force (sectie 7)
no permission for read-write access voor employee.fdb na een update (3.0) sudo chmod 660 /opt/firebird/examples/empbuild/employee.fdb (sectie 6)
refused (M14): the folder is not empty Kies een lege of nieuwe map met --fb-root, of geef de Firebird op die moet worden bijgewerkt
Exitcode 2 of 3 Lees /var/log/fbagent/install.log; de units zijn terug in hun staat van vóór de uitvoering (code 2) of hebben een controle nodig (code 3)
HQ Monitor opent niet systemctl status hqbirdmonitor-fb50 (hqbirdmonitor-p<port> vóór 2027.2.9); controleer dat niets anders op de poort luistert; open de poort in de firewall; --hqmonitor-port voor een andere poort
Het HQ Monitor-wachtwoord kwijt Voer de installer opnieuw uit (reparatie) met --hqmonitor-login admin --hqmonitor-password-file <file>; het oude /opt/hqbird/conf/access.properties wordt bewaard als access.properties.bak-<time>. De nieuwe aanmelding geldt voor alle instances van de host
Het trial-e-mailadres is niet verzonden (geen netwerk) Verstuur het later: cd /opt/hqbird/fbagent-fb50 && sudo -u firebird ./fbagent --trial-email <address> --accept-privacy
SELinux (AlmaLinux, RHEL) Ondersteund in enforcing-modus: de installer herstelt de contexten van de bestanden die hij schrijft; niets te doen