HQbird Cluster: cluster en replicatie
Cluster en replicatie HQbird Cluster
De master schrijft wijzigingen naar segmenten en verstuurt ze via een beveiligd kanaal naar de replica's. De node maakt zelf de databasekopie voor een nieuwe replica, via nbackup, terwijl gebruikers blijven doorwerken. De clustermanager (RCM) toont de lag, wachtrijen en fouten van alle nodes. Hij verplaatst ook de master naar een andere host: als geplande verplaatsing, zonder gegevensverlies, of als noodverplaatsing, wanneer de masterhost verloren is gegaan.
- Firebird 2.5 · 3 · 4 · 5
- nbackup-kopie zonder de master te stoppen
- switchover zonder gegevensverlies
- failover handmatig of volgens een regel
- router de verbindingsstring verandert niet
- mTLS op alle kanalen
Nodes · RCM · indelingen
Hoe de cluster werkt
Naast elke Firebird draait een node. Een node heeft één rol: master of replica. De masternode verstuurt segmenten, de replicanode ontvangt ze, en de Firebird van de replica past ze toe op zijn kopie van de database.
Er is één RCM per cluster. Die draait op een willekeurige host die alle nodes kan bereiken. Nodes sturen er statistieken naartoe, en hij geeft operatorcommando's aan hen door. RCM koppelt een master en een replica via de database-GUID, niet via de nodenaam.
RCM wordt niet vanzelf geïnstalleerd. Je schakelt het op één host in wanneer je een cluster nodig hebt. Je kunt een router voor de applicaties plaatsen: die stuurt ze altijd naar de huidige master.
| Component | Hoeveel | Wat het doet |
|---|---|---|
| Firebird (HQbird) | op elke databaseserver | Slaat databases op en schrijft replicatiesegmenten. |
| fbagent | één per Firebird-instantie | Stopt en start Firebird wanneer de node daarom vraagt. |
| hqclusternode | één per instantie en rol | Stelt replicatie in, verstuurt segmenten, maakt de databasekopie voor een replica. |
| hqbirdrcm (RCM) | één per cluster | Webinterface, commando's, meldingen, statistieken. Voert switchover en failover uit. |
| Router (hqclusternode router) | optioneel, op de applicatiehost, Linux | Houdt HAProxy gericht op de master van elke service. Applicaties verbinden met de router. |
- Zelfde majorversie5.0 op de master, 5.0 op de replica. Anders weigert de replica vóór enige gegevensoverdracht.
- HQbird 2.5 en 3.0Replicatie via de replconf-plugin. Filters bepalen de set tabellen.
- Eigen map voor elke masterDe replica plaatst de database in een map die naar de masternode is vernoemd. Databases met dezelfde naam van verschillende masters conflicteren niet.
- Geen fbagent, geen wijzigingenAls fbagent niet beschikbaar is, weigert de node elke actie die de configuratie wijzigt. Hij werkt niet “gedeeltelijk”.
- Node zonder RCMEen node kan zelfstandig werken. RCM is nodig voor het overzicht en de commando's.
- KanaalcompressieVoor een traag netwerk: zstd per peer, werkt direct.
- Tot 3 hosts zonder HQCenterElke host met een master of een replica neemt een plaats in de cluster in. RCM accepteert geen vierde host.
RCM · pairing-venster · Link hosts · slots
Een cluster opbouwen
De HQbird-setup plaatst de clusterprogramma's op elke server, maar schakelt ze niet in. RCM en het pairing-venster staan standaard uit. Je bouwt een cluster in drie stappen: schakel RCM in op één host, open het pairing-venster op de andere hosts, koppel de hosts met één knop.
- 1RCM inschakelenop één host: in HQ Monitor of met
fbagent --cluster-init - 2Het pairing-venster openenop de andere hosts, voor 24 uur
- 3Hosts koppelenRCM vindt de agents, geeft certificaten uit en start de nodes
Stap 1. RCM op één host
Open in HQ Monitor de sectie “Cluster op deze server” en schakel RCM in. Een commando op de host doet hetzelfde. De agent maakt de cluster-CA, het RCM-certificaat en de eerste gebruiker aan. Poorten 7443 en 7444 worden in de firewall geopend.
fbagent --cluster-init <id>
Tijdens de setup doet de schakelaar --rcm on (Linux) of /RCM (Windows) hetzelfde.
Stap 2. Pairing-venster
Op elke host die aan de cluster deelneemt, opent de agent de pairing-poort voor 24 uur. De poort sluit vanzelf wanneer het venster eindigt of wanneer de agent aan de cluster is toegetreden.
fbagent --cluster-pairing on
Een knop in HQ Monitor doet hetzelfde. Tijdens de setup: --cluster-pairing on of /DISCOVERY.
Stap 3. Hosts koppelen
Open in RCM Instellingen → Link hosts en voer de hosts in, één per regel. De knop Check hosts leest poorten 7450–7459 van elke host. Elke agent die antwoordde, is één rij in de tabel.
- Een rij toont: poort, instantie, Firebird-versie en -poort, nodepoort, certificaatvingerafdruk.
- Selecteer de rijen met selectievakjes en kies de master. Een rij met een fout blokkeert de andere rijen niet.
- Link geeft elk agent een certificaat, maakt de members en de master → replica-koppelingen aan.
- RCM wacht tot 10 minuten op het agentcertificaat en tot 20 minuten tot de nodes zijn gestart.
hqbirdrcm cluster link -hosts db1,db2,db3 -master db1
Vergelijk de vingerafdruk in de rij met die de agent op zijn host toonde. Zo weet je dat je de juiste server koppelt.
- Meerdere agents op één hostElke agent heeft zijn eigen slot van 0 tot 9. Pairing-poort 7450 + slot, nodepoorten 7051 + slot en 7061 + slot. De setup kiest het slot; de schakelaar
--pairing-portstelt het expliciet in. - Member toevoegenDe Cluster-pagina stelt een vrije nodepoort voor en weigert een poort die een ander member van deze host gebruikt.
- Membernamen
<hostnaam>-masteren<hostnaam>-replica. RCM hernoemt een member niet: een nieuwe naam is een nieuwe member. - Zonder het pairing-vensterRCM geeft een token uit voor één agent, voor 24 uur. Op de nieuwe host:
fbagent --cluster-joinmet dit token en de CA-hash.
- RCM-eigenaarDe agent die RCM op de host heeft ingeschakeld. Een tweede agent op deze host krijgt een weigering. Als de eigenaar wordt verwijderd, verplaatst
fbagent --cluster-init --rcm-takeoverRCM naar een andere agent. De cluster krijgt een nieuwe CA, en je moet de members opnieuw koppelen. - De cluster verlaten
fbagent --cluster-leavestopt de nodes, sluit hun poorten en verwijdert de clustercertificaten. De nodemappen blijven staan;--remove-dataverwijdert ze. De agent vertrekt vanzelf als RCM hem heeft ingetrokken of zijn laatste member heeft verwijderd. - FirewallDe agent opent en sluit zijn clusterpoorten zelf. Hij sluit geen poort die al open was voordat hij hem opende.
- HQbird verwijderenDe RCM-eigenaar wordt niet verwijderd zolang andere agents zijn RCM gebruiken. De setup-wizard vraagt het; stille modus vereist
--forceof/FORCE.
De Clusters-pagina in de lokale HQ Monitor werkt via de agent op de RCM-host. Het RCM-wachtwoord is niet nodig. Alleen een beheerder ziet de sectie “Cluster op deze server”.
Initialisatie · reinit
Nieuwe replica zonder de master te stoppen
Een replica krijgt de database alleen van de master. Het masterknooppunt bevriest het bestand met nbackup -L, verstuurt het in delen en verwijdert de lock meteen. Gebruikers van de master blijven de hele tijd doorwerken: hun wijzigingen gaan naar .delta en keren later terug in de database.
gbak en een handmatige bestandskopie werken hier niet. gbak wijzigt de database-GUID en verbreekt de koppeling tussen master en replica. Een bestandskopie van een draaiende database is niet consistent.
Gebruikers van de master
Bestanden
- Verbinding verbrokenDe overdracht gaat verder vanaf het laatst ontvangen deel. Een onvoltooide kopie blijft 24 uur op de replica staan.
- FoutHet knooppunt verwijdert de lock, verwijdert het onvoltooide bestand en zet de database op FAILED. De volgende poging begint vanuit een bekende toestand.
- Transacties tijdens de lockZe gaan niet verloren. Firebird 4 en 5: het knooppunt vindt de transacties die open waren op het moment van
nbackup -L, en de replica herhaalt ze uit de segmenten. HQbird 2.5 en 3.0: het knooppunt wacht tot zulke transacties eindigen (ongeveer een minuut), anders start de kopie niet.
- Eén database tegelijkStandaard kopieert het masterknooppunt één database. De andere wachten in een wachtrij.
- Andere replica's van deze databaseTerwijl de kopie loopt, krijgen ze geen segmenten van deze database. Later halen ze de achterstand in.
- Automatische herinitialisatieRCM kan een database in de staat NEEDS_REINIT vanzelf opnieuw kopiëren, alleen binnen een ingesteld tijdvenster. Standaard uit.
De voorzichtige modus wacht op langdurige transacties
Vóór de lock zoekt het knooppunt naar schrijftransacties die zijn gestart vóór het oudste segment in het archief van de master. Als het archief leeg is (eerste kopie), is de grens het moment waarop het knooppunt publicatie heeft ingeschakeld. De replica kan zulke transacties niet herhalen en zou stoppen. Daarom start de kopie niet zolang zulke transacties open zijn.
RCM toont de vijf verbindingen met de oudste transacties: gebruiker, client, leeftijd, huidige query. Je kunt ze verbreken en de kopie meteen herhalen. Terwijl de kopie wacht, wordt het archief van de master niet opgeruimd, maar niet langer dan 1000 segmenten. Daarna gaat het opruimen verder en geeft RCM een melding.
De normale modus vergrendelt de database meteen, zonder de controle.
Ruimte en snelheid
| Waar | Wat nodig is |
|---|---|
| Master, databasevolume | Minstens 105 % van de databasegrootte vrij. .delta groeit tijdens de kopie. |
| Replica, databasevolume | 105 % plus de volumereserve free_space_floor_gb (standaard 1 GB). Het knooppunt reserveert vooraf de volledige grootte; een tweede kopie is niet nodig. Bij een herhaalde kopie blijft het oude bestand staan tot het einde. Als er geen ruimte is voor beide bestanden, verwijdert het selectievakje “Remove the old replica” het oude bestand vóór de overdracht. |
| Nachtelijke snelheid | In het overdrachtsvenster (standaard 23:00–05:00) is die constant, standaard 100 MB/s. |
| Dagelijkse snelheid | Een deel van de gemeten schijfsnelheid, standaard de helft. Een kopie die overdag start, versnelt 's nachts vanzelf. |
Ruimte wordt twee keer gecontroleerd en alleen vóór de lock: eerst door RCM op basis van statistieken, daarna door de knooppunten met een live meting aan beide zijden. De controle door het knooppunt kan niet worden overgeslagen: die beschermt de schijf tegen vollopen midden in de kopie.
Firebird 4 en 5 · HQbird 2.5 en 3.0
Publicatie: welke tabellen naar de replica gaan
Firebird 4 en 5 schrijven naar segmenten alleen wijzigingen van gepubliceerde tabellen, en alleen wanneer publicatie aan staat. Zonder publicatie bereiken wijzigingen de replica niet. Het knooppunt merkt dit op en geeft een melding. Met de knop “Sync publication” wordt publicatie ingeschakeld en de juiste tabellenlijst opgebouwd.
Wat de synchronisatie doet
- schakelt publicatie in, tenzij de operator die opzettelijk heeft uitgeschakeld;
- voegt alle tabellen met een primaire sleutel of een unieke index toe;
- verwijdert tabellen zonder sleutel en tabellen die de operator heeft uitgesloten;
- schakelt het automatisch toevoegen van nieuwe tabellen uit.
Zonder sleutel kan de replica de rij voor UPDATE en DELETE niet vinden. Zo'n tabel kan dus niet worden gepubliceerd: voeg een sleutel toe en synchroniseer opnieuw.
- Elk uur een controleAls publicatie uit staat, controleert het knooppunt dit elke 2 minuten. Voor een database met een replica is dit een melding.
- UitsluitingslijstWordt op het masterknooppunt opgeslagen. Wanneer een replica tot master wordt gepromoveerd, verhuist de lijst naar de nieuwe master.
- Nieuwe tabelWordt niet vanzelf aan de publicatie toegevoegd. Maak een sleutel aan en klik op “Sync publication”.
- Kopiëren zonder publicatieHet masterknooppunt weigert de database te kopiëren als publicatie uit staat of geen tabellen heeft (
publication_off). Het initialisatievenster biedt “Sync publication and initialize” aan. - HQbird 2.5 en 3.0Geen publicaties. Include- en exclude-filters in de replicatie-instellingen bepalen de set tabellen.
Wijzigingen die zijn gemaakt terwijl publicatie uit stond of een tabel was uitgesloten, bereiken de replica niet, ook niet nadat je publicatie hebt ingeschakeld. “Verify” vergelijkt alleen rijenaantallen; het vindt geen verloren UPDATEs. Als er naar de database is geschreven terwijl publicatie uit stond, kopieer de database dan opnieuw.
Achterstand · archief · meldingen · gegevenscontrole
Monitoring: de replica raakt niet stil achterop
Knooppunten sturen elke 30 seconden statistieken naar RCM. Voor elk master-replicapaar zie je: het laatste segment, hoeveel er zijn verzonden, bevestigd en toegepast, de wachtrij en de achterstand in seconden.
| Databasestaat | Groep in RCM | Betekenis |
|---|---|---|
IN_SYNC | Ok | De replica heeft alle segmenten ontvangen. |
LAGGING | Pending | De replica loopt achter, segmenten staan in de wachtrij. |
SEEDING | Pending | De database wordt naar de replica gekopieerd. |
NEEDS_REINIT | Error | De replica moet opnieuw worden gekopieerd. |
FAILED | Error | De laatste kopie is mislukt. |
Het archief van de master wordt in fasen opgeruimd
De master bewaart verzonden segmenten zodat een replica ze opnieuw kan opvragen. Bij weinig ruimte verwijdert hij eerst wat zeker niet nodig is.
- 1Door iedereen toegepast, ouder dan de limietstandaardlimiet is 2 dagen
- 2Toegepast, maar nieuwer dan de limietals er minder dan 1 GB vrij is; melding
- 3Nog niet toegepastals laatste stap; de replica heeft een nieuwe kopie nodig
Meldingen met instructies
RCM kent meer dan 20 soorten meldingen, en elk heeft een instructie over wat te doen. Je kunt een melding bevestigen, 60 minuten dempen of verwijderen. Als de oorzaak blijft bestaan, verschijnt de melding opnieuw.
Er is geen e-mail of webhook: houd de pagina “Alerts” in het oog of poll de RCM-API.
| Code | Wat er is gebeurd |
|---|---|
backlog_warn / backlog_critical | De master heeft 32 / 48 niet-gearchiveerde segmenten. |
apply_error, replication_stopped | De replica kan een segment niet toepassen. |
replication_guid_mismatch | De GUID van de masterdatabase is gewijzigd: restore of bestandsvervanging. |
segment_missing, sequence_gap | De segmentreeks is onderbroken. |
firebird_down, firebird_log_error | Firebird is gestopt of schrijft fouten. |
firebird_not_answering | De Firebird-poort is open, maar een verbinding met de database is een minuut lang mislukt. |
master_publication_off | Publicatie is uit voor een database met een replica. |
data_mismatch | De periodieke datacontrole heeft een verschil gevonden. De datacontrole wordt apart ingeschakeld. |
Vergelijking van master en replica
Verify telt de rijen van de geselecteerde tabellen op de master en op de replica en vergelijkt ze. Het vergelijkt niet de inhoud van de rijen: gewijzigde rijen worden niet gevonden. Voer het uit op een rustig moment: bij actieve schrijfacties kunnen de aantallen verschillen.
De periodieke controle staat standaard uit: COUNT(*) leest de hele tabel. Schakel deze in met de nodeparameter data_check_enabled; deze wordt eens per 2 uur uitgevoerd. Nieuwe controle-instellingen worden direct van kracht, zonder herstart van de node. De controle vergelijkt gegevens wanneer de master en de replica zich op hetzelfde segment bevinden. Een verschil leidt tot een melding. Een tabel die van publicatie is uitgesloten, wordt als “niet gepubliceerd” weergegeven, niet als fout.
- Verzending pauzerenVoor één of meerdere databases. Na “Hervatten” gaat de verzending verder vanaf het laatste segment, zonder nieuwe kopie. Het archief groeit ondertussen.
- Logboeken van externe nodesreplication.log, firebird.log en het nodelogboek direct in RCM, zonder in te loggen op de server.
- Geen licentieDe master stopt met verzenden; Firebird en de databases blijven werken. Nadat u een licentie hebt geïnstalleerd, wordt de verzending binnen een minuut vanzelf hervat.
- OpdrachtlogboekElke RCM-opdracht wordt vastgelegd met de auteur en het resultaat. Clusterrapport in één JSON-bestand.
Service · epoch · waar de master is
Services: één database op meerdere hosts
Een service is één logische database op meerdere hosts. De master kan van host naar host verhuizen, maar de servicenaam en de databasealias veranderen niet. Applicaties en routers vragen RCM waar de master van de service zich nu bevindt.
Elke wijziging van de master krijgt het volgende nummer: de epoch. RCM houdt de epoch-geschiedenis bij: wanneer de master is gewijzigd en waarom. RCM vindt een service via de node en het bestandspad, niet via de GUID: bij een switchover verandert de database-GUID, maar het pad blijft hetzelfde.
Wat een service beschrijft
- alias: de databasenaam in
databases.conf. De nieuwe master schrijft deze zelf. - members: één vermelding per host: masternode, replicanode, bestandspad, prioriteit.
- router_port: de poort waarop routers de applicaties van deze service accepteren.
- policy: de regels voor automatische failover en de modus die de oude master sluit.
Elke host van een service draait twee nodes op één Firebird: een masternode en een replicanode. Dit is dezelfde indeling “Twee nodes per host” als in het diagram hierboven.
De masternode heeft het Firebird-adres voor clients nodig: de parameter advertise_addr. Zonder deze kan RCM een applicatie niet vertellen waar deze moet verbinden.
Waar de master nu is
hqbirdrcm services put -id shop -file shop.json hqbirdrcm services hqbirdrcm where -service shop hqbirdrcm where -db shop
where antwoordt met: de masterhost en het adres, het epochnummer, de replica's en de gevonden problemen. Via de API kan een applicatie op een nieuwe epoch wachten zonder RCM elke seconde te bevragen.
De pagina Services in RCM toont hetzelfde voor elke service: de status, de epoch, de master, het Firebird-adres, de replica's en de problemen. Het veld Zoeken vindt een database op alias, servicenaam, GUID of pad.
Services in de browser
Alles wat de hqbirdrcm-opdrachten voor services doen, staat ook in de RCM-webinterface. U hebt hiervoor geen opdrachtregel nodig.
- ServicepaginaDe status en de reden daarvan, de master, de replica's met hun lag, de hosts en hun rollen, de routers, de oude masters die wachten om te worden gesloten, de regel voor automatische failover, de lopende bewerking stap voor stap en de geschiedenis van masters.
- ActieknoppenSwitchover, Failover, Rejoin, Resume. Elke knop voert eerst een controle uit en toont de problemen. De actie start pas nadat u deze hebt bevestigd. Een tweede klik start geen tweede bewerking.
- ServiceformulierDe knop Nieuwe service maakt een service aan: naam, alias, routerpoort en één regel per host. Het formulier biedt de nodes en de databases die zij zien aan. Controleren controleert het formulier, Opslaan toont eerst de lijst met wijzigingen.
- BewerkingenEen pagina met alle switchovers, failovers en rejoins, nieuwste eerst. Terwijl een bewerking loopt, staat in de kop van elke pagina een label met een link ernaar.
- Een service verwijderenAlleen de registratie in RCM wordt verwijderd. De dialoog meldt wat blijft (databases, replicatie, noderollen, alias) en wat verloren gaat (geschiedenis, regel, poort op de routers), en vraagt u de servicenaam te typen.
- Viewer-rolEen gebruiker met deze rol ziet alle pagina's en voert controles uit, maar heeft geen actieknoppen.
| Servicestatus | Betekenis | Wat te doen |
|---|---|---|
ok | De master werkt, de replica op een andere host volgt deze. | Niets. |
rejoining | De oude master komt terug als replica. | Wachten: de database wordt gekopieerd. |
degraded_no_replica | De master werkt, er is geen replica. Dit gebeurt na een failover of na een rejoin-fout. | hqbirdrcm rejoin |
failed | RCM kan de status niet vaststellen, of de Firebird van de master antwoordt niet. | hqbirdrcm resume na een controle |
Een service in de status failed start noch een switchover noch een automatische failover. Alleen de operator kan deze uit deze status halen: met de opdracht resume, met een rejoin of met een handmatige failover.
Geplande verhuizing van de master · zonder gegevensverlies
Switchover: de master verhuist naar een andere host
Switchover verplaatst de master van een service naar een andere host zonder gegevensverlies. RCM stopt zelf de schrijfacties op de oude master, wacht tot de replica het laatste segment heeft toegepast en maakt deze tot master. Daarna komt de oude master terug in het cluster als replica van de nieuwe, op hetzelfde pad.
U hebt dit nodig voor gepland onderhoud: OS-update, schijfvervanging, verplaatsen van de belasting naar een andere server. Eerst de controle, dan de start:
hqbirdrcm switchover -service shop -check # alleen controleren, wijzigt niets hqbirdrcm switchover -service shop -to db2 # verplaats de master naar db2
De opdracht voert de bewerking tot het einde uit en drukt elke stap af. Exitcode 0 betekent succes. De knop Switchover op de servicepagina in RCM doet hetzelfde: eerst de controle, dan de bevestiging, dan de stappen van de bewerking op het scherm.
Applicaties
Hosts en service
Wat RCM vóór de start controleert
- De service verkeert in de status
ok, de master is bekend. - De doolreplica verkeert in de status
IN_SYNC. - Alle vier nodes van de twee hosts antwoorden.
- De doolreplica is niet gepauzeerd vanwege de licentie.
- Er loopt geen databasekopie of promotie op deze nodes.
Als er iets mis is, weigert RCM en geeft de reden als een code. Tot dit punt is er niets gewijzigd.
Als er iets misgaat
- Vóór het punt van geen terugkeer. Een fout, een time-out of een annulering brengt de oude master weer online. De service blijft
okop de oude host. Als de oude master niet weer online komt, krijgt de servicefailed: breng de database online metgfix -online normalen voerresumeuit. - Na het punt van geen terugkeer. U kunt niet annuleren. Een fout zet de service op
failed. - Fout tijdens rejoin. De nieuwe master werkt, er is geen replica:
degraded_no_replica. Voerhqbirdrcm rejoin -service shopuit.
hqbirdrcm operations show -id <id> hqbirdrcm operations cancel -id <id>
In de browser is dit de pagina Operations en de knop Cancel op de servicepagina.
- Schrijven stoppenDe oude master gaat volledig uit. De node wacht tot de verbindingen eindigen: standaard 120 seconden, maximaal 900. De schakelaar
-force Nverbreekt de verbindingen na N seconden. - BijwerkenElke seconde vraagt RCM aan de replica of deze het laatste segment heeft toegepast. De standaardlimiet is 300 seconden.
- Eén Firebird-herstartOp de nieuwe master, zonder op het venster te wachten. Tijdens rejoin wordt Firebird van de oude host alleen herstart als de replica-node dat nodig heeft.
- Rejoin is een databasekopieDe nieuwe master kopieert de database naar de oude host via nbackup. Voor een grote database duurt dit lang, dus wacht de opdracht tot 2 uur op de operatie.
- RCM herstartElke stap wordt naar schijf geschreven vóór de node-aanroep. Na een herstart zet RCM de operatie voort vanaf de huidige stap.
- ServicelockTerwijl een switchover of een rejoin loopt, weigert RCM andere wijzigingen op deze nodes: instellingen, Firebird-herstart, kopie, shipping-pauze.
Verbindingen naar de oude master sluiten bij de stap stop-writes. De applicatie moet opnieuw verbinden. Met een router blijft de connection string hetzelfde. Zonder router gaat de applicatie naar het adres van de nieuwe master: hqbirdrcm where -service shop geeft het.
HAProxy · Linux · één connection string
Routers: applicaties houden hetzelfde adres
Een router draait op de applicatiehost en houdt HAProxy gericht op de master van elke service. Applicaties verbinden met <router host>:<service port>. Na een switchover of een failover blijft de connection string hetzelfde.
Hoe de router een host kiest
- Hij haalt de servicetabel op bij RCM: epoch, masterhost, Firebird-adressen.
- Elke 2 seconden vraagt hij aan de master-node: “ben jij de master van deze epoch, en is de database online?”
- Antwoord “ja”: de host accepteert verbindingen.
- Antwoord “nee”: geen nieuwe verbindingen, open verbindingen blijven.
- Nieuwe epoch: de sessies van de oude master sluiten onmiddellijk.
Als RCM niet beschikbaar is, werkt de router met de laatste tabel. De router bewaart die op zijn schijf.
Een router toevoegen
Een router is een clustermember met de rol router. Voeg hem toe op de pagina Cluster, net als een master of een replica. De fbagent op deze host krijgt een certificaat, schrijft de configuratie en registreert de service. HAProxy moet op de host geïnstalleerd zijn.
De router_port in de servicebeschrijving stelt de servicepoort in. Je kunt meerdere routers hebben: één op elke applicatiehost.
De pagina Settings → Routers in RCM toont de routers en hun rapporten: welke epoch de router heeft toegepast en naar welke host hij leidt.
- Verbindingen verbrekenWanneer de master verandert, sluiten open verbindingen. De applicatie moet opnieuw verbinden, naar hetzelfde adres.
- ClientadresFirebird ziet het HAProxy-adres, niet het applicatieadres. Toegangsregels op basis van client-IP werken niet achter een router.
- Alleen LinuxDe router werkt op Linux. Databaseservers kunnen op Windows en Linux staan.
- WitnessesRouters melden aan RCM of ze de Firebird-poort van de master kunnen bereiken. Zonder hen wordt automatische failover niet ingeschakeld.
Masterhost verloren · handmatig of via een regel
Failover: de replica neemt de masterrol over
Je hebt failover nodig wanneer de masterhost niet antwoordt. De replica wordt de master met de segmenten die hij heeft ontvangen. Wat de master niet heeft verzonden, gaat verloren. De operator moet het verlies dus expliciet accepteren.
hqbirdrcm failover -service shop -check # what will be lost hqbirdrcm failover -service shop -to db2 -accept-data-loss # start
Zonder de schakelaar -accept-data-loss controleert de opdracht alleen en toont de schatting van het verlies: het laatste segment van de master, hoeveel segmenten de replica heeft ontvangen en toegepast, en hoeveel segmenten ten minste verloren gaan.
In de browser is dit de knop Failover op de servicepagina. Hij start de operatie alleen wanneer de operator het vakje voor dataverlies heeft aangevinkt en de servicenaam heeft getypt.
- 1Checkde master antwoordt niet, de replica heeft een bruikbare kopie
- 2Bijwerkende replica past alles toe wat hij heeft ontvangen; limiet 60 s
- 3Promotiepoint of no return: nieuwe GUID, Firebird-herstart
- 4Nieuwe epochde replica is de master; de oude master wacht om te worden gesloten
- De master antwoordt nogRCM weigert:
master_reachable. Voer een switchover uit, of stop eerst de master-node. - Achterlopende replicaDe status
LAGGINGwordt geaccepteerd. Een replica die een nieuwe kopie nodig heeft, is niet geschikt. - Meerdere replica'sStandaard neemt RCM degene die meer segmenten heeft toegepast, en dan degene met de hogere prioriteit.
- Na failoverDe service verkeert in de status
degraded_no_replica: de master werkt, er is geen replica. Er is geen rejoin tot de oude host weer up is. - Service in de failed-statusEen handmatige failover werkt ook daarvoor. Dit is de uitweg wanneer Firebird van de master vastloopt en je het niet snel kunt herstarten.
- Uitgesloten tabellenRCM haalt hun lijst uit de replica of uit de laatste statistieken van de oude master. Als er geen lijst is, stel de tabellen in op de publicatiepagina van de nieuwe master.
- BijwerklimietDe schakelaar
-apply-timeout, standaard 60 seconden, maximaal 3600.
Automatische failover optioneel
RCM kan zelf een failover starten. Dit staat standaard uit. Je schakelt de regel per service afzonderlijk in: op de servicepagina in de browser of met een opdracht.
hqbirdrcm policy -service shop # show the rule
hqbirdrcm policy -service shop -auto-failover on -max-data-loss 30
RCM controleert de voorwaarden elke 10 seconden en start een failover alleen wanneer ze allemaal waar zijn.
| Voorwaarde | Waarom |
|---|---|
| De master-node is 90 seconden stil | De master verzendt geen statistieken. |
| Een directe aanroep van RCM naar de master-node mislukt (5 seconden) | Dit is niet alleen late statistiek. |
| Meer dan de helft van de routers kan de Firebird-poort van de master niet bereiken | Applicaties kunnen ook niet verbinden. |
| De replica-node heeft de master 90 seconden niet gezien | Derde witness. |
| De replica-lag is 30 seconden of minder | Limiet voor dataverlies. |
| Er is een uur verstreken sinds de laatste automatische failover | De master springt niet tussen hosts. |
| RCM draait al meer dan 90 seconden | Na een herstart heeft RCM geen verse gegevens. |
Service is ok, er draaien geen kopieer- of promotiebewerkingen op de nodes | Geen conflict met lopend werk. |
- Routers zijn nodigDe regel heeft zowel routers als een servicepoort nodig. Als een van beide ontbreekt, wordt de regel niet ingeschakeld:
no_witnesses. Plaats de routers zo dat de meeste ervan niet op de masterhost staan. - EenmaligNa een automatische failover schakelt de regel zichzelf uit. Alleen de operator schakelt hem weer in.
- Waarom hij niet startteRCM bewaart de reden voor wachten samen met de serviceregel en schrijft elke nieuwe reden eenmalig naar zijn log.
- LogDe bewerking draait als
system:autofailover. De eerste vermelding zegt wat de witnesses zagen.
De limiet van 30 seconden geldt alleen voor de wachtrij die de replica heeft ontvangen en nog niet heeft toegepast. Segmenten die de master heeft geschreven maar niet heeft verzonden, zitten er niet in. Het bewerkingsrapport toont hun aantal.
Fence · rejoin · hung master · resume
Opnieuw toetreden en herstel
Na een failover heeft het cluster twee bestanden die de master waren. Je moet het oude sluiten zodat het geen schrijfacties accepteert, en het terugbrengen als replica. RCM doet het eerste zelf, het tweede op commando van de operator.
De oude master sluiten (fence)
RCM probeert de oude master elke 10 seconden te sluiten. Wanneer zijn node antwoordt, krijgt hij de rol “gesloten” en stopt hij met het verzenden van segmenten. Elke fence wordt naar het auditlog geschreven.
- Modus
route(standaard). De database van de oude master blijft online. Routers gebruiken hem niet meer. - Modus
shutdown. RCM stopt eerst de database. Verbindingen sluiten na 5 seconden.
hqbirdrcm policy -service shop -fence-mode shutdown
De oude master terugbrengen (rejoin)
Wanneer de oude host weer werkt, start je de rejoin. RCM sluit eerst de oude master, als dat nog niet is gebeurd. Daarna kopieert de nieuwe master zijn database naar de oude host, op hetzelfde pad.
hqbirdrcm rejoin -service shop
Het oude bestand wordt niet verwijderd. Het blijft naast het nieuwe staan als <name>.pre-reinit-<time>.fdb. Dit bestand en het archief van de oude master bevatten wijzigingen die de nieuwe master niet heeft.
In de modus route kunnen applicaties die rechtstreeks verbinding maken met de oude host, niet via een router, nog steeds naar de oude database schrijven. Deze wijzigingen bereiken de nieuwe master niet. Als sommige applicaties zonder router werken, schakel dan de modus shutdown in.
Vastgelopen master
Firebird kan zodanig vastlopen dat de poort open is, maar je geen verbinding kunt maken met de database. Een poortcontrole ziet dit niet. Daarom maakt de node zelf elke minuut verbinding met de database, met een limiet van 10 seconden.
- Een minuut zonder antwoord: de ernstige melding
firebird_not_answering. - RCM zet de service op
faileden schrijft de reden: node, host, tijd. - Automatische failover start niet in deze toestand.
Wat te doen: sla de Firebird-threadstacks en firebird.log op, herstart Firebird op de masterhost en voer daarna resume uit. Als je niet snel kunt herstarten, stop dan de masternode en start een failover.
De failed-toestand verlaten
hqbirdrcm resume -service shop -check hqbirdrcm resume -service shop
RCM vraagt het rechtstreeks aan de masternode en controleert:
- er draait geen bewerking op de service;
- de masternode antwoordt;
- zijn Firebird accepteert verbindingen;
- de host is de master van het huidige epoch, de database is online.
De service gaat naar ok als een replica op een andere host de master volgt. Anders gaat hij naar degraded_no_replica: voer dan rejoin uit.
Naar normaal omzetten · promoveren tot master
Handmatige replicapromotie: stap voor stap
Voor een database die deel uitmaakt van een service gebruik je switchover en failover: die doen alle onderstaande stappen zelf. Het handmatige pad blijft voor databases zonder service. “Naar normaal omzetten” maakt van de replica een aparte werkdatabase: voor rapporten, tests of een storing. “Promoveren tot master” maakt van de replica de nieuwe master.
Promotie werkt voor een paar companion-nodes: een replicanode en een masternode op dezelfde Firebird-instantie. Het databasebestand blijft op zijn plaats; de besturing gaat naar de companion. Elke stap is zichtbaar in de databaserij. Als een stap werd onderbroken, klik je opnieuw op de knop: voltooide stappen worden niet herhaald.
Verbindingen
Wat RCM toont
Waarom een nieuwe GUID
Zonder deze zou de nieuwe master segmenten schrijven onder de GUID van de oude master, en zijn replica's zouden ze weigeren. De node geeft de database ter plaatse een nieuwe GUID, via nbackup, zonder Firebird-herstart. Dit werkt op 2.5, 3.0, 4.0 en 5.0.
Na een nieuwe GUID past de oude nbackup-keten niet meer. Maak een nieuwe level 0-kopie.
Handmatige switchover zonder service
- Stop schrijfacties van applicaties naar de oude master.
- Wacht op
IN_SYNCen een lege wachtrij. - Klik op “Verifiëren”: de rijaantallen komen overeen. Dit controleert alleen de rijaantallen.
- “Promoveren tot master”, wacht op de FINALIZE-stap.
- Schakel de applicaties over naar de nieuwe master.
- Maak een level 0 nbackup-kopie en verbind een nieuwe replica.
Handmatige promotie controleert niet of applicaties naar de oude master schrijven, en brengt de oude master niet terug als replica. Stop de schrijfacties zelf eerst. Switchover doet beide stappen voor je: het stopt de schrijfacties en brengt de oude master terug.
Herstart · parameters · certificaten
Instellingen en beveiliging
Firebird leest replicatie-instellingen alleen bij het opstarten. Het maakt dus uit wie Firebird herstart en wanneer. De regel is eenvoudig: de Firebird van de master wordt nooit automatisch herstart. Er is één uitzondering: switchover en failover. Daar maakt de herstart deel uit van een bewerking die de operator heeft gestart, of die een door de operator ingeschakelde regel heeft gestart.
| Node | Wie Firebird herstart |
|---|---|
| Master | Alleen jij. De masternode herstart Firebird niet zelf. |
| Replica, dezelfde Firebird heeft masterdatabases | Jij. De toestemming in het kopieervenster laat de node Firebird alleen stoppen om het oude replicabestand te vervangen of te verwijderen. |
| Replica, automatische herstart niet toegestaan | Jij. |
| Andere replica's | De node, in zijn herstartvenster. Eenmalig na een reeks kopieën, niet na elke database. |
Replicatieparameters voor veel databases
Selecteer databases: RCM groepeert ze op Firebird-versie en rol. Kies voor elke parameter een actie: behouden, instellen, terugzetten naar het niveau erboven of niet schrijven. Je ziet waar de huidige waarde vandaan komt: de database, de node of Firebird.
Voorbeeld controleert de waarden op de nodes en wijzigt niets. Het toont ook wie Firebird zal herstarten en hoeveel databases dit raakt.
- TijdvenstersEen door jou aangevraagde masterherstart: 22:00–05:00. Replica: elk moment. Handmatige promotie tot master herstart beide Firebird-servers tegelijk, zonder venster. Switchover herstart één Firebird: op de nieuwe master. Volledige kopiesnelheid: 23:00–05:00.
- Segmentsnelheid50 MB/s standaard, korte piek 200 MB. Wijzigingen direct, zonder herstart.
- Het replicabestand verplaatsenNaar een andere submap zonder nieuwe kopie; terugdraaien bij een fout.
- Handmatig geconfigureerde replicaJe kunt deze onder beheer nemen zonder nieuwe kopie. RCM koppelt de bestanden op GUID.
- OpdrachtregelKopiëren, controleren, pauzeren, promotie en andere RCM-opdrachten staan ook in
hqbirdrcm. Switchover, failover en de serviceregel zijn op drie manieren beschikbaar: in de browser, met een opdracht en via de API. - Viewer-rolEen RCM-gebruiker met de viewer-rol ziet alles en voert controles uit. Elke wijziging is voor deze gebruiker verboden.
- 6 talenRCM-interface. Waarschuwingsinstructies zijn in het Engels.
Eén document beschrijft het cluster
Leden, hun rollen en master → replica-koppelingen worden ingesteld op de Clusters-pagina in HQ Monitor of in RCM. De fbagent op elke host krijgt de beschrijving en installeert en configureert de nodes zelf. Zonder HQCenter beheert RCM één cluster van maximaal 3 hosts.
mTLS en certificaten
Alle clusterkanalen zijn beveiligd met mTLS met een gedeelde CA. De sleutel wordt aangemaakt op de lidhost en verlaat deze nooit: alleen de certificaataanvraag gaat naar buiten. Een certificaat is 90 dagen geldig en verlengt zichzelf 30 dagen voordat het verloopt. Een nieuwe sleutel en een nieuwe CA worden op commando van een beheerder uitgegeven.
De RCM-webinterface werkt via HTTPS op poort 7444. De agent opent deze poort in de firewall wanneer RCM op de host wordt ingeschakeld. Aanmelden gebeurt met een gebruikersnaam en wachtwoord; het eerste wachtwoord moet u wijzigen. Het staat in het bestand rcm-initial-password op de RCM-host en wordt niet op het scherm getoond. Na de wachtwoordwijziging verwijdert de agent dit bestand. De aanmeldpagina toont de CA-hash van het cluster: vergelijk deze met de regel "CA hash" in de installatiesamenvatting op de RCM-host. Elke wijziging en aanmelding wordt naar het auditlog geschreven.
Commando's · time-outs · poorten · weigeringscodes
Referentie
Commando's
| Taak | Commando |
|---|---|
| RCM inschakelen op een host | fbagent --cluster-init <id> |
| Het koppelvenster openen of sluiten | fbagent --cluster-pairing on|off |
| Hosts koppelen | hqbirdrcm cluster link -hosts db1,db2 -master db1 |
| Token voor een host zonder het koppelvenster | hqbirdrcm cluster join-token -note db2 |
| Het cluster verlaten | fbagent --cluster-leave |
| Een service beschrijven | hqbirdrcm services put -id shop -file shop.json |
| Waar de master is | hqbirdrcm where -service shop |
| Geplande verplaatsing van de master | hqbirdrcm switchover -service shop [-to db2] [-check] |
| Noodverplaatsing | hqbirdrcm failover -service shop -accept-data-loss |
| De oude master als replica terugbrengen | hqbirdrcm rejoin -service shop |
| De failed-status verlaten | hqbirdrcm resume -service shop [-check] |
| Regel voor automatische failover | hqbirdrcm policy -service shop -auto-failover on|off |
| Voortgang en annulering van een bewerking | hqbirdrcm operations show|cancel -id <id> |
Time-outs en intervallen
| Wat | Standaard | Hoe te wijzigen |
|---|---|---|
| Switchover: wachten tot verbindingen eindigen | 120 s, maximaal 900 s | -quiesce-timeout |
| Switchover: replica past het laatste segment toe | 300 s | -apply-timeout |
| Switchover: commando wacht op het einde van de bewerking | 2 uur | -timeout |
| Failover: replica past toe wat het heeft ontvangen | 60 s, maximaal 3600 s | -apply-timeout |
| Automatische failover: master is stil | 90 s | -failover-delay |
| Automatische failover: lag-limiet | 30 s | -max-data-loss |
| Automatische failover: pauze tussen twee | 1 uur | -min-interval |
| Controle van failover-voorwaarden en van de afscherming van de oude master | elke 10 s | kan niet worden gewijzigd |
| Vastgelopen Firebird: verbindingsprobe | eens per minuut, limiet 10 s | kan niet worden gewijzigd |
| Router: peiling van de masternode | elke 2 s | kan niet worden gewijzigd |
| Koppelvenster, join-token | 24 uur | venster: aantal uren in het verzoek |
| Hosts koppelen: agentcertificaat, nodestart | tot 10 minuten, tot 20 minuten | kan niet worden gewijzigd |
Poorten
| Poort | Doel |
|---|---|
7443 | RCM: nodes, agents en routers, mTLS. |
7444 | RCM: webinterface en operatorcommando's, HTTPS. |
7450–7459 | Koppelvenster van de agent: 7450 + slot. |
7051–7060 | Eerste node van de agent: 7051 + slot. |
7061–7070 | Tweede node van de agent: 7061 + slot. |
router_port | Servicepoort op de router, bijvoorbeeld 3051. |
Weigeringscodes
| Code | Betekenis |
|---|---|
not_in_sync | De doellocatie-replica loopt achter: switchover start niet. |
busy | Er loopt een databasekopie of promotie op de nodes. |
service_busy | Er loopt al een bewerking op de service. |
master_reachable | De master antwoordt: failover is niet nodig. |
replica_unusable | De replica heeft geen bruikbare databasekopie. |
data_loss_not_accepted | Failover zonder de schakelaar -accept-data-loss. |
past_no_return | Annuleren na het punt van geen terugkeer. |
no_witnesses | Automatische failover zonder routers. |
node_port_clash | Een ander lid van de host gebruikt de nodepoort. |
seats_exceeded | Het cluster heeft al 3 hosts. |
De belangrijkste punten in het kort
Veelgestelde vragen
Wat is het verschil tussen switchover en failover?
Switchover is gepland: beide hosts werken, er gaat geen data verloren, de oude master komt vanzelf als replica terug. Failover is een noodgeval: de masterhost is verloren, wat de master niet heeft verzonden gaat verloren, en u brengt de oude master terug met een apart commando.
Wat ziet de applicatie tijdens een switchover?
Verbindingen naar de oude master sluiten wanneer RCM het schrijven stopt. Totdat de replica de master wordt, is er niets om naar te schrijven. Na het nieuwe tijdperk maakt de applicatie opnieuw verbinding: naar hetzelfde routeradres of naar het adres van de nieuwe master.
Hoe lang duurt een switchover?
De schrijfpauze bestaat uit drie delen: wachten tot verbindingen eindigen (standaard tot 120 seconden), het inhalen van het laatste segment, en één Firebird-herstart op de nieuwe master. De rejoin van de oude master loopt daarna op de achtergrond. De duur daarvan is de duur van de databasekopie.
Kan ik zonder router werken?
Ja. Switchover en handmatige failover werken zonder routers. De applicatie haalt het masteradres dan zelf bij RCM. Automatische failover wordt niet ingeschakeld zonder routers: routers zijn de getuigen ervan.
Hoeveel data kan een automatische failover verliezen?
De regel start niet als de replica meer dan 30 seconden achterloopt. Maar segmenten die de master heeft geschreven en niet heeft verzonden, gaan verloren. Het bewerkingsrapport toont hun aantal. Het oude databasebestand wordt bewaard: deze wijzigingen blijven erin en in het archief van de oude master.
De service verkeert in de failed-status. Wat moet ik doen?
Bekijk de reden op de Services-pagina. Als de Firebird van de master is vastgelopen, herstart deze dan. Daarna toont hqbirdrcm resume -service <id> -check wat de service blokkeert, en resume zonder de schakelaar brengt de service weer aan het werk.
Hoeveel ruimte heeft de rejoin van de oude master nodig?
Rejoin is een nieuwe databasekopie. Dezelfde regels gelden als voor elke kopie: 105 % van de databasegrootte. Na een failover blijft het oude bestand naast het nieuwe staan, dus de oude host heeft ruimte nodig voor beide bestanden.
Werkt het op Windows?
Nodes en RCM werken op Windows en Linux. De router werkt alleen op Linux.