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

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 ondergrens limits.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:

Command
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.run

In 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.

Command
sudo sh hqbird2027-fb50-linux-$V.run --rcm on               # master
sudo sh hqbird2027-fb50-linux-$V.run --cluster-pairing on   # replica

De 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):

text
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:

text
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 host

Een 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:

Command
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       # replica

Zolang 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:

Command
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.

RCM sign-in
RCM sign-in

De gebruikersnaam is rcmadmin. Het wachtwoord staat in het bestand uit de regel Password::

Command
# the path is from the Password: line of your output
sudo cat /opt/hqbird/fbagent-fb50/clusterca/hq27d-m/rcm-initial-password

RCM vraagt meteen om een nieuw wachtwoord (minimaal 12 tekens):

New password at the first sign-in
New password at the first sign-in

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:

Command
# 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.

Hosts koppelen na de aanmelding
Hosts koppelen na de aanmelding

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.

Lijst van hosts
Lijst van hosts

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.

Controle van de hosts
Controle van de hosts

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:

Bevestiging
Bevestiging

Voortgang: “Joining → Joined → The node starts → Running”. In de run duurde de koppeling 56 seconden (de run van 2026-11-17: 47 seconden).

Voortgang van de koppeling
Voortgang van de koppeling
Gereed
Gereed

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”.

Overview: twee nodes
Overview: twee nodes

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:

Command
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.fdb

Je 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.
Inschrijfformulier
Inschrijfformulier

Preview → selecteer de databases → Enroll selected en bevestig.

Bevestiging van de inschrijving
Bevestiging van de inschrijving

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.

Resultaat van de inschrijving
Resultaat van de inschrijving

De databases wachten op de herstart:

Wacht op de herstart
Wacht 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.

Herstart van Firebird van de master
Herstart van Firebird van de master

Na de herstart is de masternode CONFIGURED. Elke database heeft de badge publication OFF, en de replica toont “not paired”.

Na de herstart
Na de herstart

Stap 6. De replica initialiseren

In de databaserij, in de replica-kolom → Initialize. Het dialoogvenster heeft de titel “Initialize database?”.

Initialize-dialoogvenster
Initialize-dialoogvenster
  • 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:

Weigering van de smooth-methode
Weigering van de smooth-methode

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.

Voortgang van de initialisatie
Voortgang van de initialisatie

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.

Wacht op de herstart van Firebird van de replica
Wacht op de herstart van Firebird van de replica

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:

Kopie van de grote database
Kopie van de grote database

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.

Beide databases gereed
Beide databases gereed

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.

Sync publication
Sync publication

Publication tables toont welke tabellen repliceren. Je kunt een tabel zonder sleutel niet publiceren: geef die een primaire sleutel.

Publication tables
Publication tables

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.

Reinit, smooth method
Reinit, smooth method

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).

Copy at the reinit
Copy at the reinit

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.

Low space: the “Remove the old replica if space is short” box
Low space: the “Remove the old replica if space is short” box

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 melding replica_removed_for_reinit (warn), en is een nieuwe poging een nieuwe volledige reinit. Een automatische reinit verwijdert de oude kopie alleen als de RCM-sleutel auto_reinit.remove_old_replica_when_short aan 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:

Verify under load
Verify under load

Zonder schrijfacties komen de aantallen overeen:

Verify without load
Verify without load

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).

Periodic check
Periodic check

Waar je vervolgens op moet letten

  • Overview: de nodes, hun status, de databaseroot en de schijfruimte.

    Overview
    Overview
  • Alerts: problemen van nodes en databases. De run had twee meldingen, en je kunt beide bevestigen: replication_conflict_resolved na de smooth reinit (stap 7), en parse_no_observations op de master (“no events parsed from /opt/firebird/replication.log”). Firebird van de master schrijft alleen fouten naar replication.log, dus een leeg logboek is normaal (bevinding G-06 in het rapport).

    Alerts
    Alerts

    RCM 2027.5.12 en later (kit 2027.2.33) kan de meldingen van ernst warn en hoger naar een eigen Telegram-bot, een webhook of e-mail sturen. Je stelt de kanalen in het bestand /opt/hqbirdrcm/rcm.json in, sleutel notify.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:

    json
    "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
    Commands
  • HQ Monitor: http://<server>:23050/, gebruikersnaam admin, 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

Command
cd /opt/hqbird/fbagent-fb50
sudo ./fbagent --cluster-leave

De 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) |