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

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.

Clusterdiagram: masternodes sturen segmenten naar replicanodes, RCM houdt alle nodes in het oog
ComponentHoeveelWat het doet
Firebird (HQbird)op elke databaseserverSlaat databases op en schrijft replicatiesegmenten.
fbagentéén per Firebird-instantieStopt en start Firebird wanneer de node daarom vraagt.
hqclusternodeéén per instantie en rolStelt replicatie in, verstuurt segmenten, maakt de databasekopie voor een replica.
hqbirdrcm (RCM)één per clusterWebinterface, commando's, meldingen, statistieken. Voert switchover en failover uit.
Router (hqclusternode router)optioneel, op de applicatiehost, LinuxHoudt 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.

  1. 1RCM inschakelenop één host: in HQ Monitor of met fbagent --cluster-init
  2. 2Het pairing-venster openenop de andere hosts, voor 24 uur
  3. 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-port stelt 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>-master en <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-join met 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-takeover RCM naar een andere agent. De cluster krijgt een nieuwe CA, en je moet de members opnieuw koppelen.
  • De cluster verlatenfbagent --cluster-leave stopt de nodes, sluit hun poorten en verwijdert de clustercertificaten. De nodemappen blijven staan; --remove-data verwijdert 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 --force of /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

    aan het werk

    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.

    De kopie starten. Modus (voorzichtig of normaal), replicamap met een controle, toestemming om de Firebird van de replica te stoppen.

    Ruimte en snelheid

    WaarWat nodig is
    Master, databasevolumeMinstens 105 % van de databasegrootte vrij. .delta groeit tijdens de kopie.
    Replica, databasevolume105 % 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 snelheidIn het overdrachtsvenster (standaard 23:00–05:00) is die constant, standaard 100 MB/s.
    Dagelijkse snelheidEen 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.

    Publicatietabellen. De sleutel van elke tabel en de staat: gepubliceerd, nog niet gepubliceerd, uitgesloten, geen sleutel.

    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.

    Overdracht en wachtrijen. Eén rij per master → replica-pad: segmenten, wachtrij en achterstand.
    DatabasestaatGroep in RCMBetekenis
    IN_SYNCOkDe replica heeft alle segmenten ontvangen.
    LAGGINGPendingDe replica loopt achter, segmenten staan in de wachtrij.
    SEEDINGPendingDe database wordt naar de replica gekopieerd.
    NEEDS_REINITErrorDe replica moet opnieuw worden gekopieerd.
    FAILEDErrorDe 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.

    1. 1Door iedereen toegepast, ouder dan de limietstandaardlimiet is 2 dagen
    2. 2Toegepast, maar nieuwer dan de limietals er minder dan 1 GB vrij is; melding
    3. 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.

    Meldingen. Code, knooppunt, bericht en acties.
    CodeWat er is gebeurd
    backlog_warn / backlog_criticalDe master heeft 32 / 48 niet-gearchiveerde segmenten.
    apply_error, replication_stoppedDe replica kan een segment niet toepassen.
    replication_guid_mismatchDe GUID van de masterdatabase is gewijzigd: restore of bestandsvervanging.
    segment_missing, sequence_gapDe segmentreeks is onderbroken.
    firebird_down, firebird_log_errorFirebird is gestopt of schrijft fouten.
    firebird_not_answeringDe Firebird-poort is open, maar een verbinding met de database is een minuut lang mislukt.
    master_publication_offPublicatie is uit voor een database met een replica.
    data_mismatchDe periodieke datacontrole heeft een verschil gevonden. De datacontrole wordt apart ingeschakeld.
    Datacontrole. Aantal rijen per tabel op de master en op de replica.

    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.
    ServicestatusBetekenisWat te doen
    okDe master werkt, de replica op een andere host volgt deze.Niets.
    rejoiningDe oude master komt terug als replica.Wachten: de database wordt gekopieerd.
    degraded_no_replicaDe master werkt, er is geen replica. Dit gebeurt na een failover of na een rejoin-fout.hqbirdrcm rejoin
    failedRCM 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

      werken

      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 ok op de oude host. Als de oude master niet weer online komt, krijgt de service failed: breng de database online met gfix -online normal en voer resume uit.
      • 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. Voer hqbirdrcm rejoin -service shop uit.
      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 N verbreekt 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.

      Routerdiagram: vóór de epoch-wijziging gaan applicaties via de router naar db1; na de wijziging naar db2 epoch 4 · master on db1 Applications router:3051 Router HAProxy db1 master db2 replica epoch 5 · master on db2 Applications router:3051 Router HAProxy db1 closed (fenced) db2 master
      Epoch-wijziging. De router sluit de sessies van de oude master onmiddellijk en opent de nieuwe master wanneer die “ready” antwoordt. Het adres en de poort voor applicaties veranderen niet.

      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.

      1. 1Checkde master antwoordt niet, de replica heeft een bruikbare kopie
      2. 2Bijwerkende replica past alles toe wat hij heeft ontvangen; limiet 60 s
      3. 3Promotiepoint of no return: nieuwe GUID, Firebird-herstart
      4. 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 LAGGING wordt 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.

      VoorwaardeWaarom
      De master-node is 90 seconden stilDe 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 bereikenApplicaties kunnen ook niet verbinden.
      De replica-node heeft de master 90 seconden niet gezienDerde witness.
      De replica-lag is 30 seconden of minderLimiet voor dataverlies.
      Er is een uur verstreken sinds de laatste automatische failoverDe master springt niet tussen hosts.
      RCM draait al meer dan 90 secondenNa een herstart heeft RCM geen verse gegevens.
      Service is ok, er draaien geen kopieer- of promotiebewerkingen op de nodesGeen 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 failed en 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

        behouden

        Wat RCM toont

        Stappen in de databaserij. Voltooide stappen zijn groen, de huidige is rood, de volgende zijn grijs.

        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

        1. Stop schrijfacties van applicaties naar de oude master.
        2. Wacht op IN_SYNC en een lege wachtrij.
        3. Klik op “Verifiëren”: de rijaantallen komen overeen. Dit controleert alleen de rijaantallen.
        4. “Promoveren tot master”, wacht op de FINALIZE-stap.
        5. Schakel de applicaties over naar de nieuwe master.
        6. 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.

        NodeWie Firebird herstart
        MasterAlleen jij. De masternode herstart Firebird niet zelf.
        Replica, dezelfde Firebird heeft masterdatabasesJij. De toestemming in het kopieervenster laat de node Firebird alleen stoppen om het oude replicabestand te vervangen of te verwijderen.
        Replica, automatische herstart niet toegestaanJij.
        Andere replica'sDe 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.

        Replicatieparameters. Een hint voor elke sleutel, node- en Firebird-waarden, voorbeeld: “jij herstart het”.
        • 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.
        Clusterbeschrijving in HQ Monitor (demomodus). Leden en rollen, master → replica-koppelingen, de certificaatvervaldatum van elk lid.

        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

        TaakCommando
        RCM inschakelen op een hostfbagent --cluster-init <id>
        Het koppelvenster openen of sluitenfbagent --cluster-pairing on|off
        Hosts koppelenhqbirdrcm cluster link -hosts db1,db2 -master db1
        Token voor een host zonder het koppelvensterhqbirdrcm cluster join-token -note db2
        Het cluster verlatenfbagent --cluster-leave
        Een service beschrijvenhqbirdrcm services put -id shop -file shop.json
        Waar de master ishqbirdrcm where -service shop
        Geplande verplaatsing van de masterhqbirdrcm switchover -service shop [-to db2] [-check]
        Noodverplaatsinghqbirdrcm failover -service shop -accept-data-loss
        De oude master als replica terugbrengenhqbirdrcm rejoin -service shop
        De failed-status verlatenhqbirdrcm resume -service shop [-check]
        Regel voor automatische failoverhqbirdrcm policy -service shop -auto-failover on|off
        Voortgang en annulering van een bewerkinghqbirdrcm operations show|cancel -id <id>

        Time-outs en intervallen

        WatStandaardHoe te wijzigen
        Switchover: wachten tot verbindingen eindigen120 s, maximaal 900 s-quiesce-timeout
        Switchover: replica past het laatste segment toe300 s-apply-timeout
        Switchover: commando wacht op het einde van de bewerking2 uur-timeout
        Failover: replica past toe wat het heeft ontvangen60 s, maximaal 3600 s-apply-timeout
        Automatische failover: master is stil90 s-failover-delay
        Automatische failover: lag-limiet30 s-max-data-loss
        Automatische failover: pauze tussen twee1 uur-min-interval
        Controle van failover-voorwaarden en van de afscherming van de oude masterelke 10 skan niet worden gewijzigd
        Vastgelopen Firebird: verbindingsprobeeens per minuut, limiet 10 skan niet worden gewijzigd
        Router: peiling van de masternodeelke 2 skan niet worden gewijzigd
        Koppelvenster, join-token24 uurvenster: aantal uren in het verzoek
        Hosts koppelen: agentcertificaat, nodestarttot 10 minuten, tot 20 minutenkan niet worden gewijzigd

        Poorten

        PoortDoel
        7443RCM: nodes, agents en routers, mTLS.
        7444RCM: webinterface en operatorcommando's, HTTPS.
        7450–7459Koppelvenster van de agent: 7450 + slot.
        7051–7060Eerste node van de agent: 7051 + slot.
        7061–7070Tweede node van de agent: 7061 + slot.
        router_portServicepoort op de router, bijvoorbeeld 3051.

        Weigeringscodes

        CodeBetekenis
        not_in_syncDe doellocatie-replica loopt achter: switchover start niet.
        busyEr loopt een databasekopie of promotie op de nodes.
        service_busyEr loopt al een bewerking op de service.
        master_reachableDe master antwoordt: failover is niet nodig.
        replica_unusableDe replica heeft geen bruikbare databasekopie.
        data_loss_not_acceptedFailover zonder de schakelaar -accept-data-loss.
        past_no_returnAnnuleren na het punt van geen terugkeer.
        no_witnessesAutomatische failover zonder routers.
        node_port_clashEen ander lid van de host gebruikt de nodepoort.
        seats_exceededHet 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.

        ← Terug naar het HQbird 2027-overzicht