HQbird 2027-cluster op Linux: master en replica met RCM
Andere talen: Русский, Português.
Deze handleiding gaat van twee schone servers naar een werkende Firebird 5.0-replica.
Je doet alles in de browser, in de RCM-console, behalve de
installatie en één map. De schermafbeeldingen komen uit de run van
2026-11-17: kit 2027.2.33, RCM en nodes 2027.5.12, Ubuntu 24.04, de
Engelse UI. Het rapport van de eerdere run van 2026-11-08:
hqbird2027-rcm-cluster-check-report.ru.md
(Russisch, sectie “Прогон 2”). Alleen commando’s, zonder schermafbeeldingen:
hqbird2027-linux-cluster-runbook.md. Elke RCM-pagina in detail:
de RCM-gebruikershandleiding (repository hqcluster-node, docs/user-guide/).
Deze handleiding is voor kit 2027.2.24 en later. Voor kit 2027.2.22, zie de editie van dit bestand van 2026-11-07 in de git-geschiedenis.
De kit om te downloaden is 2027.2.33 (2026-11-16): agent 3.4.0, HQ Monitor 1.57.0, RCM en nodes 2027.5.12, Firebird 5.0.5.1917. Deze handleiding is ermee gecontroleerd op 2026-11-17 (twee servers, Ubuntu 24.04, databases van 3 MB en 167 MB): alle stappen zijn geslaagd. De tekst noemt de resultaten van die run “de run van 2026-11-17”. De schermafbeeldingen komen uit een tweede doorgang van die dag met dezelfde kit (databases van 3 MB en 2,88 GB). De andere getallen komen nog steeds uit de run van 2026-11-08. Wat de kits na 2027.2.27 veranderden voor een cluster:
| Kit | Wijziging |
|---|---|
| 2027.2.29 (agent 3.1.0, RCM 2027.5.9) | Standaard geen cluster (zie hieronder). Meerdere agents van één host kunnen lid worden van een cluster: elk heeft zijn eigen pairing-poort (7450–7459) en node-poort. fbagent --cluster-leave. De pagina Clusters van HQ Monitor |
| 2027.2.30 (RCM 2027.5.10) | Switchover en failover van een service, routers |
| 2027.2.31 (agent 3.3.0, RCM 2027.5.11) | De installer opent een tekstinterface in een terminal (stap 1). De pagina’s Services van RCM. Een server die aan geen enkele HQCenter is gekoppeld, werkt de agent, HQ Monitor en fbmcp zelf bij |
| 2027.2.33 (agent 3.4.0, RCM 2027.5.12) | RCM stuurt zijn meldingen naar Telegram, een webhook of e-mail (“Wat hierna te bekijken”). Een cluster van twee Docker-containers: Docker-handleiding |
Alle wijzigingen: Wat is er nieuw.
Kits met agent (fbagent) 3.1.0 en later (vanaf 2027.2.29) maken standaard geen cluster: geen RCM, geen pairing-venster, en de cluster-poorten blijven gesloten in de firewall. In stap 1 zet je RCM aan op de master en discovery-modus op de replica.
Tijd: ≈30 minuten plus het kopiëren van de databases (≈1 minuut per 3 GB op een 1 Gbit/s-netwerk).
Wat je krijgt
| Server 1 | Server 2 | |
|---|---|---|
| Rol | master + RCM-console | replica |
| Databases | /databases/master/*.fdb |
/databases/replica/<replica node>/<master node>/*.fdb |
| Services | firebird, hqbirdfbagent-fb50, hqbirdmonitor-fb50, fbmcp, hqbirdrcm, hqclusternode-master-p3050 |
dezelfde, maar hqclusternode-replica-p3050 en geen hqbirdrcm (een oudere kit laat daar zijn eigen RCM achter, gestopt) |
Wat je nodig hebt
- Twee Linux x86-64-servers (gecontroleerd op Ubuntu 24.04), 2 cores, 4 GB geheugen.
- Schijfruimte. Master: vrij ≥ 105 % van de databasegrootte (het
.delta-bestand groeit tijdens de lock). Replica: vrij ≥ 105 % van de databasegrootte plus de ondergrenslimits.free_space_floor_gb(standaard 1 GB). Een reinit over een bestaande replica houdt het oude bestand tot het einde, dus het replica-volume heeft ongeveer 2 × de databasegrootte nodig. Met het vakje Verwijder de oude replica als ruimte schaars is (stap 8) is 105 % plus de ondergrens genoeg. - Netwerk tussen de servers: poorten 3050, 7051, 7443, 7444, 7450. Dit zijn de poorten van de eerste instantie van een server (slot 0). Een tweede instantie van een server gebruikt de pairing-poort 7451 en de node-poort 7052.
- Je pc kan poort 7444 van de master bereiken (de RCM-console), direct of via een SSH-tunnel.
- Een gebruiker met
sudo.
Firewall. De installer opent poorten in een ingeschakelde firewalld of ufw (met elke systeemtaal): 3050 en 23050 altijd, de cluster-poorten alleen voor de opties van stap 1. Master: 7443, 7444, 7051. Replica: 7450, 7051. De agent sluit 7450 weer wanneer het pairing-venster eindigt of de host is gekoppeld. Op Ubuntu is ufw meestal uitgeschakeld. Dan schrijft de installer één regel, bijvoorbeeld op de master:
no active firewall (firewalld or ufw): ports 3050, 23050, 7443, 7444, 7051/tcp are not opened by this install; they are reachable from every network; close them or enable a firewall. Sluit in een cloud de poorten met de cloud-firewall: van buiten alleen jouw adres; tussen de servers het interne netwerk.
Hieronder staan de adressen van de run: master 10.114.0.5, replica
10.114.0.6 (privénetwerk). Gebruik je eigen adressen.
Stap 1. Installeren op beide servers
Op elke server:
V=2027.2.33
wget https://ib-aid.com/download/hqbird/v2027/hqbird2027-fb50-linux-$V.run
wget https://ib-aid.com/download/hqbird/v2027/hqbird2027-fb50-linux-$V.run.sha256
sha256sum -c hqbird2027-fb50-linux-$V.run.sha256
sudo sh hqbird2027-fb50-linux-$V.runIn een terminal opent de installer zijn tekstinterface (kits vanaf
2027.2.31). De eerste pagina heeft de regel Cluster RCM off, discovery mode off. Open Cluster en wijzig één regel:
| Regel van de Cluster-pagina | Master | Replica |
|---|---|---|
| Cluster manager (RCM) | on |
off |
| Discovery mode (24 h) | off (deze agent draait de RCM) |
on |
De regels Cluster id (standaard: de hostnaam), RCM admin password
(standaard: gegenereerd) en Pairing port (standaard: de eerste vrije,
7450) kunnen blijven zoals ze zijn. Ga terug (Esc) en kies Install. De
installer toont het plan: druk op Enter. Dan vraagt hij Nothing on this host was changed yet. Start the install now?. De cursor staat op No: verplaats hem
naar Yes en druk op Enter. De installer voegt ontbrekende bibliotheken (bijvoorbeeld
libtommath1) zelf toe. De tekstinterface in volledigheid:
hqbird2027-linux-setup-guide.md.
Met --no-tui, en in kits 2027.2.29–2027.2.30, stelt de installer
vragen. De eerste is Install as planned? Yes/No: antwoord y. Dan
stelt hij twee clustervragen. Het antwoord is standaard No (Enter):
| Vraag | Master | Replica |
|---|---|---|
Install the cluster manager (RCM) on this host and make a new cluster? [y/N] |
y |
Enter (No) |
Turn on discovery mode for 24 hours (an RCM on the network may invite this agent into its cluster; port 7450)? [y/N] |
niet gesteld: deze agent draait de RCM | y |
Of geef de antwoorden als opties: in een terminal zetten ze de waarden van de
Cluster-pagina voordat die opent. Gebruik ze ook voor een run zonder terminal:
--yes alleen betekent No voor beide.
sudo sh hqbird2027-fb50-linux-$V.run --rcm on # master
sudo sh hqbird2027-fb50-linux-$V.run --cluster-pairing on # replicaDe installatie duurt ongeveer een minuut (de run van 2026-11-17: 61 seconden
op de master, 43 seconden op de replica). Het einde van de uitvoer op de
master met kit 2027.2.33 (de hash is hier verkort; de cluster-id van
de voorbeelden hieronder is hq27d-m, uit de run van 2026-11-08):
Done: agent hqbirdfbagent-fb50 in /opt/hqbird/fbagent-fb50, Firebird 5.0.5.1917 in /opt/firebird (port 3050).
HQ Monitor: http://localhost:23050/ (login admin; password in /opt/hqbird/conf/access.properties)
RCM: https://10.114.0.5:7444 (cluster hq27d-m)
CA hash: sha256:9754e0be…087cb195
Login: rcmadmin
Password: in /opt/hqbird/fbagent-fb50/clusterca/hq27d-m/rcm-initial-password (read it with sudo; RCM asks for a new one at the first login)
Pairing: not needed: this agent runs the RCM; other agents link through it
fbmcp: 2027.2.24, service running; local only (remote mode: sudo fbmcp ctl hqbird-install --allow-from CIDR)Op de replica:
RCM: off; turn it on in HQbird Monitor or with fbagent --cluster-init <id>
Pairing: port 7450 open until 2026-11-09T16:25:27Z (fingerprint sha256:0d137a71…09fe44cf); an RCM may invite this hostEen oudere kit drukt Pairing: not opened (this agent runs the RCM) af op
de master.
Noteer de regels RCM: en CA hash: van de master en de
regel Pairing: van de replica. Je hebt de fingerprint nodig in stap 3.
Oudere kits (agent vóór 3.1.0, bijvoorbeeld kit 2027.2.27) stellen geen clustervragen. Ze installeren RCM op elke server en openen het pairing- venster overal. Gebruik de RCM van de master; de RCM van de tweede server stopt vanzelf na de koppeling.
Later, zonder de installer. Open in HQ Monitor van de server Clusters, sectie Cluster on this server. Op de master: Enable the cluster console (RCM); HQ Monitor opent 7443 en 7444 in de firewall. Op de replica: Open the pairing window for 24 hours. Hetzelfde met commando’s, als de gebruiker van de agent:
cd /opt/hqbird/fbagent-fb50
sudo -u firebird ./fbagent --cluster-init hq27d-m # master; open 7443 and 7444 yourself
sudo -u firebird ./fbagent --cluster-pairing on # replicaZolang het pairing-venster open is, opent de agent zijn pairing-poort in de firewall. Hij sluit de poort wanneer het venster eindigt of de host is gekoppeld.
De uitvoer bevat geen wachtwoorden. Het RCM-wachtwoord staat in het bestand uit de
regel Password:, het SYSDBA-wachtwoord staat in
/root/fbagent-install-sysdba.txt, en het HQ Monitor-wachtwoord staat in
/opt/hqbird/conf/access.properties.
Je hoeft geen licentie te installeren: een nieuwe agent start zelf een proefperiode van 7 dagen, en de cluster-nodes werken.
Stap 2. Aanmelden bij RCM
Open het adres uit de regel RCM: van de master. Als poort 7444 gesloten is
voor je pc, gebruik een SSH-tunnel en https://localhost:7444:
ssh -L 7444:127.0.0.1:7444 <user>@<master>Als poort 7444 bezet is op je pc, gebruik een andere lokale poort, bijvoorbeeld
-L 17444:127.0.0.1:7444 en https://localhost:17444.
De browser waarschuwt over het certificaat: de cluster-CA heeft het RCM-
certificaat ondertekend. De aanmeldpagina toont de Cluster CA hash: vergelijk die met
de regel CA hash: van de installer-uitvoer. Als ze overeenkomen, installeer het CA-
certificaat (de link Download the CA certificate (hqcluster-ca.crt) op
dezelfde pagina) als vertrouwd, of accepteer de waarschuwing. Als ze niet overeenkomen,
meld je niet aan, en controleer het adres.
De gebruikersnaam is rcmadmin. Het wachtwoord staat in het bestand uit de regel Password::
# the path is from the Password: line of your output
sudo cat /opt/hqbird/fbagent-fb50/clusterca/hq27d-m/rcm-initial-passwordRCM vraagt meteen om een nieuw wachtwoord (minimaal 12 tekens):
Een RCM vóór 2027.5.12 kon deze pagina steeds opnieuw laden. RCM 2027.5.12 (kit 2027.2.33) heeft de fix.
Na de wachtwoordwijziging verwijdert de agent van de master het bestand
rcm-initial-password zelf binnen één minuut. Met een oudere kit heeft de
tweede server ook een eigen RCM. Na de koppeling verplaatst de agent
dat eerdere cluster naar de map cluster/left/. Agent 3.1.0 verwijdert
daar zijn rcm-initial-password; een oudere agent doet dat niet. Verwijder dan
het bestand zelf:
# on server 2, after step 3
sudo find /opt/hqbird -name rcm-initial-password
sudo rm <path from the find output>Verwijder het bestand /opt/hqbirdrcm/initial-admin.json niet: het bevat
alleen de hash van het oude wachtwoord, en zonder dat bestand start een RCM die zijn
gebruikersbestand kwijt is met het standaardwachtwoord.
Na de wachtwoordwijziging opent RCM meteen Settings → Link hosts: het
cluster heeft nog geen nodes. De lijst Releases in the mirror toont de
hqbirdrcm- en hqclusternode-releases waaruit de agents de
nodes installeren.
Stap 3. De hosts koppelen
De eerste rij van de lijst is al ingevuld (de RCM-host). Voeg een tweede rij toe: het replica-adres dat de master kan bereiken. Voer een IP in als de servers geen gemeenschappelijke DNS hebben: RCM houdt de string zoals hij is, en de nodes vinden elkaar erop.
Klik op Check hosts. Voor een host zonder poort leest RCM de pairing-
poorten 7450–7459 en toont één rij voor elke agent die antwoordt, als
host:port (hier 10.114.0.6:7450). Schrijf host:port om één poort
alleen te lezen. De RCM-host heeft geen pairing-venster nodig: RCM vindt zijn agent in zijn eigen
register. Vergelijk de Certificate fingerprint met de uitvoer van de installer
(de regel Pairing: van de replica): ze moeten overeenkomen. De status van de
tweede host is Ready to link.
De kolom Member ID toont de naam die de host in het cluster krijgt:
<host name>-<role>, bijvoorbeeld hq27d-m-master. Het instance-suffix
(-fb50) wordt alleen toegevoegd wanneer de host meerdere agents heeft.
Elke rij heeft een selectievakje, de poort, de instance en de node-poort. Link neemt alleen
de aangevinkte rijen. Een rij met een fout kan niet worden aangevinkt en houdt de
andere niet tegen. Onder de tabel schrijft RCM 2027.5.12 regels zoals 10.114.0.6, no agent: closed or no answer: 7451-7459: ze noemen de pairing-poorten van de
host waar geen andere agent antwoordt. Het zijn geen fouten.
De master is de host waar de productiedatabases zullen staan. Klik op Link en bevestig:
Voortgang: “Joining → Joined → The node starts → Running”. In de run duurde de koppeling 56 seconden (de run van 2026-11-17: 47 seconden).
Het Overview toont nu twee nodes: de master en de replica. Direct na de koppeling kan de replica één minuut lang “stale” zijn; daarna is hij “online”.
Als je opnieuw op Check hosts klikt voor een host die al is gekoppeld, toont het dat er geen agent antwoordt op de pairing-poorten, of dat de host onbereikbaar is: het pairing-venster op die host is gesloten, en dat geldt ook voor zijn pairing-poort in de firewall. Dit is geen fout.
Eén host in een cluster dat een master heeft. Een koppeling van één rij wordt geweigerd
met lone_master: geef aan wat de rij wordt. Voeg -replica-of <master member>
toe voor een replica van die master, of -new-master (het selectievakje op de Link hosts-
pagina) voor een eigen master.
Stap 4. Databasemap op de master
Op de master moet de database in een map staan waar de gebruiker
firebird toegang toe heeft:
sudo install -d -o firebird -g firebird -m 0770 /databases/master
# example: the sample database from the kit
sudo cp /opt/firebird/examples/empbuild/employee.fdb /databases/master/
sudo chown firebird:firebird /databases/master/employee.fdbJe hoeft niets voor te bereiden op de replica: de knop Create folder in het Initialize-dialoogvenster maakt de map voor de kopieën aan (stap 6).
Stap 5. De databases op de master inschrijven
Databases → in de tabel Nodes, in de rij van de master → Enroll.
- Folder path on that server:
/databases/master, recursive. - Include file mask:
*.fdb. - Sync tracking tables: de tabellen waarvan de knop Verify de rijenaantallen vergelijkt. Je stelt de lijst voor elke database in die je inschrijft. Laat het veld leeg: dan telt de database zijn publicatietabellen. Voor een database die al wordt beheerd, wijzig je de lijst op de pagina van de masterdatabase.
Preview → selecteer de databases → Enroll selected en bevestig.
Het resultaat is “Enrolled: 2.” en een hint: Firebird van de master moet opnieuw worden gestart. De tekst “No new databases matched.” eronder is geen fout: de databases zijn al ingeschreven.
De databases wachten op de herstart:
Klik op Restart Firebird of the master in de rij van een willekeurige database van de master (één herstart is genoeg voor allemaal) en bevestig. Alle verbindingen met Firebird van de master verbreken enkele seconden (4 seconden in de run): kies een goed moment.
Na de herstart is de masternode CONFIGURED. Elke database heeft de
badge publication OFF, en de replica toont “not paired”.
Stap 6. De replica initialiseren
In de databaserij, in de replica-kolom → Initialize. Het dialoogvenster heeft de titel “Initialize database?”.
- Publication. Zolang de publicatie van de database uit staat, schrijft Firebird
de wijzigingen niet naar het journaal, en de replica krijgt niets.
Het dialoogvenster zegt dit en toont een knop Sync publication and initialize.
Klik erop: RCM voegt alle tabellen met een primaire of unieke sleutel toe aan de
publicatie en start de initialisatie meteen. De knop Initialize
helpt niet zolang de publicatie uit staat: de masternode
weigert (
publication_off). - Replica folder: het dialoogvenster stelt
/databases/replica/<replica node>voor, in de run/databases/replica/hq27d-r-replica. Elke replica- node van een host heeft zijn eigen map nodig. Behoud deze. Als het veld “✗ The folder does not exist” toont, klik dan op Create folder; dan zie je “✓ The folder was created.” De kopie gaat naar/databases/replica/hq27d-r-replica/hq27d-m-master/. Voor de volgende databases is de map al ingesteld, en het dialoogvenster wijzigt deze niet. - Method: Smooth (de standaard). Het controleert de schrijvende transacties vóór de lock. Standard vergrendelt de database meteen.
- De vakjes “Let … stop its Firebird for this reinit” en “Remove the old replica if space is short” heb je niet nodig voor een nieuwe replica.
Verbind de applicaties opnieuw na de eerste publicatie-sync. Een verbinding met de masterdatabase die werd geopend voordat de publicatie werd aangezet, wordt niet gejournald totdat hij opnieuw verbindt. In de run van 2026-11-17 schreef een verbinding die was geopend vóór Sync publication and initialize ongeveer 9.500 rijen na de kopie, en de replica kreeg er geen enkele van. RCM toonde “Ok” voor beide kanten; alleen Verify (stap 9) toonde “Not ok (desynced)”. Rijen van een nieuwe verbinding werden meteen gerepliceerd. Dus, na de eerste Sync publication van een database: verbind de applicaties opnieuw (of herstart Firebird van de master), en voer daarna Verify uit zonder schrijfacties. Als de replica rijen mist, voer dan een reinit uit (stap 7).
Eerste initialisatie onder belasting. Zolang het archief van de master nog
geen journaalsegment heeft, kan Smooth weigeren als er naar de database wordt
geschreven. De databaserij toont
long_transactions: … the archive holds no segment yet en een hint in de
UI-taal:
In de run gebeurde dit ook na Sync publication and initialize (bevinding G-04 in het rapport). De publicatie staat op dit punt al aan. Wacht tot de masterdatabase “archive: 1 seg” of meer toont (15 seconden in de run), en klik opnieuw op Initialize met de methode Smooth. Of kies Standard. In de run van 2026-11-17 (≈49 transacties/s vanuit één verbinding) werd Smooth niet geweigerd.
De voortgang wordt getoond in de databaserij: SPACE CHECK → LOCKING → COPYING TO NODE (%) → UNLOCKING → SEEDING → RESTARTING REPLICA. De voortgang is ook zichtbaar na een pagina-herlaad. De knop Initialize is inactief gedurende deze tijd.
Na de kopie herstart de replicanode Firebird van de replica zelf op het geplande moment. De rij zegt wanneer; de knop Restart Firebird of the replica doet het meteen. Alle verbindingen met Firebird van de replica verbreken op dit moment.
Een grote database werkt op dezelfde manier. In de run werd bulk.fdb (3,13 GB)
geïnitialiseerd met de knop Sync publication and initialize, zonder
belasting erop:
Het is klaar wanneer de master en de replica “Ok” tonen, en de “last applied
seg” van de replica de “last seg” van de master bereikt. Een database zonder
nieuwe schrijfacties (hier bulk.fdb) toont “Pending” met segment 0 voor de
replica: dit is normaal.
Metingen van de run (employee.fdb onder een belasting van ≈55
transacties/s):
| Database | Grootte | Master: van start tot einde | Lock op de master | Paar “Ok” |
|---|---|---|---|---|
employee.fdb |
4 MB | 0,7 s | 0,35 s | na ≈1 min (wachtte op de herstart van de replica) |
bulk.fdb |
3,13 GB | 64 s (≈55 MB/s) | 59 s | na ≈2 min |
De run van 2026-11-17 (kit 2027.2.33): employee.fdb (3 MB) duurde 3 seconden
op de master, bulk.fdb (167 MB) 15 seconden. De replicakant werd gekoppeld
≈40 seconden na de start (het wachtte op de herstart van Firebird van de
replica).
Tijdens de lock werkt de masterdatabase: de wijzigingen gaan naar het .delta-
bestand.
Publicatie later. Je hebt de knop Sync publication van een master- database nodig wanneer er nieuwe tabellen in de database verschijnen. Die laat de publicatie in één transactie overeenkomen met de tabellen; Firebird wordt niet herstart.
Publication tables toont welke tabellen repliceren. Je kunt een tabel zonder sleutel niet publiceren: geef die een primaire sleutel.
Stap 7. Herinitialisatie
Je hebt die nodig wanneer de replica afwijkt van de master, of wanneer de node
erom vraagt (NEEDS_REINIT). In de replicarij → Reinit, methode
Smooth. Er is al een segmentarchief, en de smooth-methode werkt onder
belasting. Die wacht op schrijftransacties die ouder zijn dan de
journaalgeschiedenis, en toont ze.
De voortgang is dezelfde als bij de initialisatie. Een reinit vereist
gewoonlijk geen herstart van Firebird van de replica. In de run van 2026-11-17
herstartte de reinit van employee.fdb wel Firebird van de replica: reken op
een onderbreking van de verbindingen naar de replica. Die reinit duurde 4
seconden op de master onder ≈49 transacties/s; nadat het schrijven stopte,
kwamen de rijaantallen overeen (14.418 rijen in de belastingstabel aan beide
kanten).
Metingen van de run:
| Database | Belasting | Tijd | Lock | Overig |
|---|---|---|---|---|
employee.fdb |
≈55 transacties/s | 1,7 s | 0,32 s | 417 transacties opnieuw afgespeeld uit de segmenten |
bulk.fdb |
geen | 61 s | 55 s | geen herstart van Firebird van de replica |
Na een smooth reinit onder belasting kan de replica de info-melding
replication_conflict_resolved tonen (“Record being inserted … already exists,
updating instead”): de replica speelde transacties opnieuw af die al in de
kopie zaten. De gegevens komen overeen: in de run kwamen de rijaantallen van
alle tabellen overeen. Je kunt de melding bevestigen (bevinding G-07 in het
rapport).
Stap 8. Weinig schijfruimte op de replica
Het replicavolume heeft ≥ 105 % van de databasegrootte vrij nodig plus 1 GB boven de oude kopie: de oude kopie blijft tot het einde staan, en het nieuwe bestand neemt meteen zijn volledige grootte in. Als de ruimte krap is, toont de dialoog hoeveel ruimte er nodig is, hoeveel er vrij is, en hoeveel de oude kopie inneemt (een RCM-schatting; de replicanode beslist). Als de ruimte toereikend is zonder de oude kopie, stelt de dialoog het vakje Remove the old replica if space is short voor.
Met het vakje stopt de replicanode, na de lock op de master, Firebird van de
replica, verwijdert de oude kopie en start Firebird opnieuw. In de run (2,97 GB
vrij, de nieuwe kopie heeft 3,29 GB nodig, de oude kopie is 3,13 GB) duurde de
reinit van bulk.fdb met het vakje 65 seconden. Zonder het vakje weigert de
node met insufficient disk space on replica.
De dialoog kan geen getallen tonen wanneer alleen de ondergrens van 1 GB
ontbreekt. In de run van 2026-11-17 (1,1 GB vrij, de database is 167 MB) toonde
de dialoog geen schatting, en de reinit zonder het vakje mislukte in 3
seconden. De databaserij en de pagina Commands toonden de reden:
insufficient disk space on replica: need 184125850 bytes (105% of the database) + 1073741824 bytes free_space_floor_gb; free 1152950272 … Removing the old replica copy would free 175357952 bytes: ask again with remove_old_replica. Dezelfde reinit met het vakje duurde 9 seconden.
Risico van het vakje. Terwijl de kopie loopt, is er geen replica van deze database. Als de reinit mislukt, is het paar
NEEDS_REINIT, heeft de replica de meldingreplica_removed_for_reinit(warn), en is een nieuwe poging een nieuwe volledige reinit. Een automatische reinit verwijdert de oude kopie alleen als de RCM-sleutelauto_reinit.remove_old_replica_when_shortaan staat (standaard uit).
Stap 9. Verificatie
Verify in de replicarij vergelijkt COUNT(*) van de trackingtabellen op
de master en op de replica. Het vergelijkt de rijen zelf niet. De regel “Table
list source” noemt de lijst: de eigen lijst van de database, de lijst van de
node, de publicatietabellen, of RDB$FIELDS. Rijaantallen hebben
cijfergroepen.
Onder belasting loopt de replica een paar seconden achter, en geeft Verify “Not ok” voor de tabellen waarnaar wordt geschreven:
Zonder schrijfacties komen de aantallen overeen:
Een tabel die in geen van beide databases staat, is “not in the database”: dat is geen afwijking. Een tabel die maar aan één kant staat, is “no table”: dat is wel een afwijking.
Een veiligere controle is het rijaantal van alle tabellen aan beide kanten
nadat het schrijven stopt (het script staat in de
hqbird2027-linux-cluster-runbook.md). In de run kwamen alle 11 tabellen
overeen (employee.fdb: 10, bulk.fdb: 1, met 2.800.000 rijen).
De periodieke controle (Data check) staat standaard uit. Klik op Turn on for all nodes en bevestig: elke node telt zijn rijen, en de master vergelijkt de aantallen. Je hoeft niet te herstarten: RCM toont “Saved and in force now: the node needs no restart.” De eerste controle loopt één interval later (standaard 2 uur).
Waar je vervolgens op moet letten
-
Overview: de nodes, hun status, de databaseroot en de schijfruimte.
Overview -
Alerts: problemen van nodes en databases. De run had twee meldingen, en je kunt beide bevestigen:
replication_conflict_resolvedna de smooth reinit (stap 7), enparse_no_observationsop de master (“no events parsed from /opt/firebird/replication.log”). Firebird van de master schrijft alleen fouten naarreplication.log, dus een leeg logboek is normaal (bevinding G-06 in het rapport).
Alerts RCM 2027.5.12 en later (kit 2027.2.33) kan de meldingen van ernst
warnen hoger naar een eigen Telegram-bot, een webhook of e-mail sturen. Je stelt de kanalen in het bestand/opt/hqbirdrcm/rcm.jsonin, sleutelnotify.channels, en herstart RCM (sudo systemctl restart hqbirdrcm). Het blok Notification channels van deze pagina toont dan de kanalen, elk met een knop Send test. Zonder kanaal staat er “No channel is configured: RCM sends its alerts nowhere.” Een Telegram-kanaal:"notify": { "channels": [ { "name": "ops", "type": "telegram", "token_file": "secrets/telegram-ops.token", "chat_id": "-1001234567890" } ] }De run van 2026-11-17 controleerde het blok zonder kanaal; er werd geen bericht verzonden.
-
Services (RCM 2027.5.11 en later, kits vanaf 2027.2.31): de master, de replica’s en de routers van een service, en de bewerkingen switchover, failover en rejoin. Deze handleiding behandelt ze niet: zie de RCM-gebruikershandleiding. Werk RCM en de nodes bij naar dezelfde versie voordat je ze gebruikt.
-
Commands: elke RCM-bewerking met het resultaat. De tijd is de lokale tijd van de browser met zijn zone (bijvoorbeeld
17:59:45 UTC+1); de tooltip toont de tijd in UTC. De nodelogboeken gebruiken UTC.
Commands -
HQ Monitor:
http://<server>:23050/, gebruikersnaamadmin, het wachtwoord staat in/opt/hqbird/conf/access.properties. Het toont de server en de databases. In de kits met agent 3.1.0 en later heeft HQ Monitor de pagina Clusters. Op de master (de RCM-host) toont die het cluster via de agent, zonder RCM-instellingen in HQ Monitor. Op de replica noemt die de host van de RCM en linkt naar de console ervan. HQ Monitor 1.49.0 heeft geen replicatiestatus en geen link naar RCM. Vanaf kit 2027.2.33 (agent 3.4.0) stuurt de agent de problemen van zijn server ook naar je kanalen: Servers → Notifications.
Het cluster bijwerken
Werk eerst HQbird RCM bij, dan de nodes. Vanaf kit 2027.2.31 werkt een server die aan geen HQCenter is gekoppeld de agent, HQ Monitor en fbmcp zelf bij (“Updates without HQCenter” in hqbird2027-linux-setup-guide.md); een server die aan een HQCenter is gekoppeld, haalt zijn updates van dat HQCenter.
Een host uit het cluster halen
cd /opt/hqbird/fbagent-fb50
sudo ./fbagent --cluster-leaveDe agent stopt en meldt zijn nodeservices af, sluit hun nodepoorten, verwijdert
zijn clustercertificaten en zet cluster.source op none. De nodemap blijft
staan (--remove-data verwijdert die). De agent die de RCM draait, wordt
geweigerd. De agent vertrekt ook vanzelf wanneer RCM hem intrekt of zijn laatste
lid wegneemt. Een de-installatie verlaat altijd het cluster: een herinstallatie
in dezelfde map begint vrij. In de run van 2026-11-17 drukte de opdracht
Cluster: left <cluster id> af, bleven de replicadatabases in hun map staan, en
toonde RCM een minuut later nog steeds de node van die host. Het verwijderen van
HQbird van een clusterserver, ook van de server die de RCM draait:
hqbird2027-removal-guide.md, sectie 4.
Veelvoorkomende fouten
| Wat je ziet | Oorzaak | Wat te doen |
|---|---|---|
publication_off bij de initialisatie |
de publicatie staat uit, of heeft geen tabel terwijl de database tabellen met een sleutel heeft | de knop Sync publication and initialize (stap 6) |
long_transactions … the archive holds no segment yet |
eerste initialisatie met de smooth-methode terwijl er naar de database wordt geschreven, en het archief van de master is leeg | wacht op “archive: 1 seg” en probeer Smooth opnieuw, of kies Standard |
reinit_pre_publication_transactions |
een schrijftransactie begon voordat de publicatie werd aangezet en staat langer dan een minuut open | rond die af (COMMIT of ROLLBACK) en probeer opnieuw |
| “✗ The folder does not exist on …” in de dialoog | niemand heeft de replicamap aangemaakt | de knop Create folder in de dialoog, of install -d -o firebird -g firebird -m 0770 <folder> op de replica |
| “Not ok (desynced)” in Verify | er wordt naar de database geschreven, en de replica loopt seconden achter | probeer opnieuw zonder belasting; kijk naar de kolom Match |
| “Not ok (desynced)” in Verify zonder schrijfacties; beide kanten tonen “Ok” | een applicatieverbinding werd geopend voordat de publicatie werd aangezet: die wordt niet gejournald | verbind de applicatie opnieuw, en doe dan Reinit (stap 6, de opmerking over de eerste publicatiesync) |
| Host “unreachable” of “no agent” in Link hosts | het koppelvenster van de host is gesloten (standaard uit, of de 24 u is verstreken), of een firewall tussen de servers sluit 7450–7459 | open het venster op de host: HQ Monitor → Clusters → Open the pairing window for 24 hours, of fbagent --cluster-pairing on; open de poort in de cloudfirewall |
| insufficient disk space on replica bij een reinit | de oude replica blijft tot het einde staan, en het nieuwe bestand neemt zijn volledige grootte in | maak ≥ 105 % van de databasegrootte + 1 GB boven het oude bestand vrij op het replicavolume, of gebruik het vakje Remove the old replica if space is short (stap 8) |
| De node verschijnt niet na Link hosts | de RCM-mirror heeft geen ondertekende hqclusternode-release | Releases in the mirror op de pagina Link hosts (stap 2) |