HQbird 2027 voor Linux: installatiehandleiding
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. Wat de installer installeert
- 2. De installatie in één oogopslag
- 3. Nieuwe installatie
- 4. Na de installatie
- 5. Update van een oudere HQbird (2024 en eerder)
- 6. Update van HQbird 2027 naar een nieuwe versie
- 7. Onderhoudscommando’s
- 8. Koppelen aan uw HQCenter
- 9. Onbeheerde installatie en scripts
- 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.confvoor 2.5), de beveiligingsdatabase en het SYSDBA-wachtwoord blijven behouden. - Firebird debug-bestanden (symbolen voor crashanalyse), geïnstalleerd in de Firebird-map.
--no-debugslaat ze over. - HQbird-agent (
fbagent): de systemd-unithqbirdfbagent-fb50, draaiend als de gebruikerfirebird, 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, adreshttp://<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/hqbirdrcmen draait het als de unithqbirdrcm; de samenvatting toont het adres in de regelRCM:. De node krijgt zijn unit (bijvoorbeeldhqclusternode-master-p3050) wanneer u de host in RCM koppelt. Kits vanaf 2027.2.19 met een oudere agent installeren RCM op elke server (--rcm offlaat 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 unithqbirdrcmen geen regelRCM:.
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
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
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.sha256De 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)
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
sudo sh hqbird2027-fb50-linux-2027.2.9.runKits 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.
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: quitDe 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 variabeleHQBIRD_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; TERMisdumbof niet ingesteld;- het venster is kleiner dan 80 kolommen bij 24 rijen (in
tmuxmet 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:
[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 --uninstallDit 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:
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--yesmee; 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]enTurn 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.--yesen 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 doorrooten 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:
- de optie
--lang en|ru|pt-BR|de; - de variabele
HQBIRD_LANG; - de locale van de console (
LC_ALL, danLC_MESSAGES, danLANG), wanneer het een UTF-8-locale is; - Engels.
De tweede regel van de uitvoer zegt welke taal het is en hoe je die wijzigt. Deze regel is altijd Engels:
[install] Language: Русский (auto). Use --lang en to change.Opmerkingen:
- PuTTY stuurt
LANGniet 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.--langwerkt daar nog steeds. - De installer heeft een UTF-8-locale op de host nodig voor de andere talen
(
C.UTF-8ofen_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:
[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 IDgeeft 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-idgeeft 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
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.fdbGebruik 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).
/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--jsontoe 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:
Wat je op de terminal ziet:
[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-rooten--portkunnen 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 versionwordt gevraagd wanneer de oudere HQbird een Firebird van een andere versie beheert (werk die bij, of een nieuwe ernaast).--yesbeantwoordt alle vragen met Ja; zonder terminal en zonder--yesstopt de installer met exitcode 4 en wijzigt niets. --disable-hqbirdschakelt de oudere HQbird-units in elk geval uit;--no-hqbirdlaat 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.propertieswordt behouden, dus meld je aan met de login en het wachtwoord die je eerder gebruikte. De installer geeft het bestand aanfirebirdmet 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, ofaliases.confvoor 2.5) als regelsnaam = 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 eeninclude-richtlijn wordt niet gewijzigd. - Het verwijdert de oude monitoringlogs van de oudere HQbird: de inhoud van de mappen
mon/outcomingenmon/outtracevan 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:
sudo sh hqbird2027-fb50-linux-2027.2.9.run --yes --disable-hqbird6. 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.
sudo sh hqbird2027-fb50-linux-2027.2.9.runIn 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:
[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
offis (“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
sudo sh hqbird2027-fb50-linux-2027.2.9.run --fb-root /opt/fb50-2 --port 3056De 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:
# 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-dataZonder --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:
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:
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 $B8. 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.
- 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 slaattach.jsonop. 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 wanneeradmin_panel.install_script_urlis ingesteld. - Kopieer
attach.jsonnaar de server. - Koppel op een van twee manieren:
# 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.jsonMet 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:
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:
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.txtNieuwe installatie met het trial-e-mailadres, een licentiebestand en het attach-bestand:
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.jsonUpdate van een oudere HQbird, alle oudere HQbird-units uit:
sudo sh hqbird2027-fb50-linux-2027.2.9.run --yes --disable-hqbirdUpdate van HQbird 2027 naar een nieuwe versie (één instance; bij meerdere
--fb-root en --port toevoegen):
sudo sh hqbird2027-fb50-linux-2027.2.9.run --yesEen tweede Firebird 5.0-instance op poort 3056:
sudo sh hqbird2027-fb50-linux-2027.2.9.run --yes --fb-root /opt/fb50-2 --port 3056Verwijderen:
sudo sh hqbird2027-fb50-linux-2027.2.9.run --uninstall
sudo sh hqbird2027-fb50-linux-2027.2.9.run --uninstall --remove-dataEen script dat stopt bij een mislukte installatie:
#!/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:
[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 ./*.debOp 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 |