Diese Seite wurde maschinell übersetzt. Lesen Sie das englische Original. English

Cluster und Replikation HQbird Cluster

Der Master schreibt Änderungen in Segmente und sendet sie über einen sicheren Kanal an die Replikas. Der Knoten erstellt die Datenbankkopie für eine neue Replik selbst über nbackup, während die Benutzer weiterarbeiten. Der Cluster-Manager (RCM) zeigt Verzögerung, Warteschlangen und Fehler aller Knoten. Er verschiebt den Master auch auf einen anderen Host: als geplanten Umzug ohne Datenverlust oder als Notfall-Umzug, wenn der Master-Host verloren geht.

  • Firebird 2.5 · 3 · 4 · 5
  • nbackup-Kopie ohne Anhalten des Masters
  • switchover ohne Datenverlust
  • failover manuell oder nach einer Regel
  • router die Verbindungszeichenfolge ändert sich nicht
  • mTLS auf allen Kanälen

Knoten · RCM · Layouts

So funktioniert der Cluster

Ein Knoten läuft neben jeder Firebird-Instanz. Ein Knoten hat eine Rolle: Master oder Replik. Der Master-Knoten sendet Segmente, der Replik-Knoten empfängt sie, und die Firebird-Instanz der Replik wendet sie auf ihre Kopie der Datenbank an.

Es gibt ein RCM pro Cluster. Es läuft auf einem beliebigen Host, der alle Knoten erreichen kann. Die Knoten senden ihm Statistiken, und es leitet Bedienerbefehle an sie weiter. RCM verknüpft einen Master und eine Replik über die Datenbank-GUID, nicht über den Knotennamen.

RCM wird nicht von selbst installiert. Sie aktivieren es auf einem Host, wenn Sie einen Cluster benötigen. Sie können einen Router vor die Anwendungen setzen: Er leitet sie immer an den aktuellen Master weiter.

Cluster-Diagramm: Master-Knoten senden Segmente an Replik-Knoten, RCM überwacht alle Knoten
KomponenteWie vieleWas sie tut
Firebird (HQbird)auf jedem DatenbankserverSpeichert Datenbanken und schreibt Replikationssegmente.
fbagenteiner pro Firebird-InstanzStoppt und startet Firebird, wenn der Knoten es verlangt.
hqclusternodeeiner pro Instanz und RolleRichtet die Replikation ein, sendet Segmente, erstellt die Datenbankkopie für eine Replik.
hqbirdrcm (RCM)eines pro ClusterWeboberfläche, Befehle, Warnungen, Statistiken. Führt Switchover und Failover aus.
Router (hqclusternode router)optional, auf dem Anwendungshost, LinuxHält HAProxy auf den Master jedes Dienstes gerichtet. Anwendungen verbinden sich mit dem Router.
  • Gleiche Hauptversion5.0 auf dem Master, 5.0 auf der Replik. Andernfalls lehnt die Replik vor jeder Datenübertragung ab.
  • HQbird 2.5 und 3.0Replikation über das replconf-Plugin. Filter definieren die Menge der Tabellen.
  • Eigener Ordner für jeden MasterDie Replik legt die Datenbank in einem nach dem Master-Knoten benannten Ordner ab. Datenbanken mit gleichem Namen von verschiedenen Mastern kollidieren nicht.
  • Kein fbagent, keine ÄnderungenWenn fbagent nicht verfügbar ist, lehnt der Knoten jede Aktion ab, die die Konfiguration ändert. Er arbeitet nicht „teilweise“.
  • Knoten ohne RCMEin Knoten kann eigenständig arbeiten. RCM wird für die Übersicht und Befehle benötigt.
  • Kanal-KomprimierungFür ein langsames Netzwerk: zstd pro Peer, wirkt sofort.
  • Bis zu 3 Hosts ohne HQCenterJeder Host mit einem Master oder einer Replik belegt einen Platz im Cluster. RCM akzeptiert keinen vierten Host.

RCM · Pairing-Fenster · Hosts verknüpfen · Slots

So baut man einen Cluster auf

Die HQbird-Installation legt die Cluster-Programme auf jedem Server ab, aktiviert sie aber nicht. RCM und das Pairing-Fenster sind standardmäßig aus. Sie bauen einen Cluster in drei Schritten auf: RCM auf einem Host aktivieren, das Pairing-Fenster auf den anderen Hosts öffnen, die Hosts mit einer Schaltfläche verknüpfen.

  1. 1RCM aktivierenauf einem Host: in HQ Monitor oder mit fbagent --cluster-init
  2. 2Pairing-Fenster öffnenauf den anderen Hosts, für 24 Stunden
  3. 3Hosts verknüpfenRCM findet die Agenten, stellt Zertifikate aus und startet die Knoten

Schritt 1. RCM auf einem Host

Öffnen Sie in HQ Monitor den Abschnitt „Cluster auf diesem Server“ und aktivieren Sie RCM. Ein Befehl auf dem Host bewirkt dasselbe. Der Agent erstellt die Cluster-CA, das RCM-Zertifikat und den ersten Benutzer. Die Ports 7443 und 7444 werden in der Firewall geöffnet.

fbagent --cluster-init <id>

Während der Installation bewirkt der Schalter --rcm on (Linux) oder /RCM (Windows) dasselbe.

Schritt 2. Pairing-Fenster

Auf jedem Host, der dem Cluster beitreten soll, öffnet der Agent den Pairing-Port für 24 Stunden. Der Port schließt sich von selbst, wenn das Fenster endet oder wenn der Agent dem Cluster beigetreten ist.

fbagent --cluster-pairing on

Eine Schaltfläche in HQ Monitor bewirkt dasselbe. Während der Installation: --cluster-pairing on oder /DISCOVERY.

Schritt 3. Hosts verknüpfen

Öffnen Sie in RCM Einstellungen → Hosts verknüpfen und geben Sie die Hosts ein, einen pro Zeile. Die Schaltfläche Hosts prüfen liest die Ports 7450–7459 jedes Hosts. Jeder Agent, der geantwortet hat, ist eine Zeile der Tabelle.

  • Eine Zeile zeigt: Port, Instanz, Firebird-Version und -Port, Knoten-Port, Zertifikat-Fingerabdruck.
  • Wählen Sie die Zeilen mit Kontrollkästchen aus und wählen Sie den Master. Eine Zeile mit einem Fehler blockiert die anderen Zeilen nicht.
  • Verknüpfen stellt jedem Agenten ein Zertifikat aus, erstellt die Mitglieder und die Master → Replik-Verknüpfungen.
  • RCM wartet bis zu 10 Minuten auf das Agenten-Zertifikat und bis zu 20 Minuten auf den Start der Knoten.
hqbirdrcm cluster link -hosts db1,db2,db3 -master db1

Vergleichen Sie den Fingerabdruck in der Zeile mit dem, den der Agent auf seinem Host angezeigt hat. So wissen Sie, dass Sie den richtigen Server verknüpfen.

  • Mehrere Agenten auf einem HostJeder Agent hat seinen eigenen Slot von 0 bis 9. Pairing-Port 7450 + Slot, Knoten-Ports 7051 + Slot und 7061 + Slot. Die Installation wählt den Slot; der Schalter --pairing-port legt ihn explizit fest.
  • Mitglied hinzufügenDie Cluster-Seite schlägt einen freien Knoten-Port vor und lehnt einen Port ab, den ein anderes Mitglied dieses Hosts verwendet.
  • Mitgliedsnamen<Hostname>-master und <Hostname>-replica. RCM benennt ein Mitglied nicht um: Ein neuer Name ist ein neues Mitglied.
  • Ohne Pairing-FensterRCM stellt ein Token für einen Agenten aus, für 24 Stunden. Auf dem neuen Host: fbagent --cluster-join mit diesem Token und dem CA-Hash.
  • RCM-EigentümerDer Agent, der RCM auf dem Host aktiviert hat. Ein zweiter Agent auf diesem Host erhält eine Ablehnung. Wenn der Eigentümer entfernt wird, verschiebt fbagent --cluster-init --rcm-takeover RCM auf einen anderen Agenten. Der Cluster erhält eine neue CA, und Sie müssen die Mitglieder erneut verknüpfen.
  • Verlassen des Clustersfbagent --cluster-leave stoppt die Knoten, schließt ihre Ports und löscht die Cluster-Zertifikate. Die Knotenordner bleiben; --remove-data löscht sie. Der Agent verlässt den Cluster von selbst, wenn RCM ihn widerrufen oder sein letztes Mitglied entfernt hat.
  • FirewallDer Agent öffnet und schließt seine Cluster-Ports selbst. Er schließt keinen Port, der bereits vor ihm geöffnet war.
  • Deinstallation von HQbirdDer RCM-Eigentümer wird nicht entfernt, solange andere Agenten sein RCM verwenden. Der Setup-Assistent fragt nach; der Silent-Modus benötigt --force oder /FORCE.

Die Seite „Cluster“ im lokalen HQ Monitor arbeitet über den Agenten auf dem RCM-Host. Sie benötigt kein RCM-Passwort. Nur ein Administrator sieht den Abschnitt „Cluster auf diesem Server“.

Initialisierung · reinit

Neue Replik, ohne den Master zu stoppen

Eine Replik erhält die Datenbank nur vom Master. Der Master-Knoten friert die Datei mit nbackup -L ein, sendet sie in Teilen und entfernt die Sperre sofort wieder. Die Benutzer des Masters arbeiten die ganze Zeit weiter: ihre Änderungen gehen in .delta und kehren später in die Datenbank zurück.

gbak und ein manuelles Kopieren der Datei funktionieren hier nicht. gbak ändert die GUID der Datenbank und bricht die Verbindung zwischen Master und Replik. Eine Dateikopie einer laufenden Datenbank ist nicht konsistent.

    Benutzer des Masters

    arbeiten

    Dateien

    • VerbindungsverlustDie Übertragung wird ab dem zuletzt empfangenen Teil fortgesetzt. Eine unvollständige Kopie bleibt 24 Stunden lang auf der Replik.
    • FehlerDer Knoten entfernt die Sperre, löscht die unvollständige Datei und setzt die Datenbank auf FAILED. Der nächste Versuch startet von einem bekannten Zustand aus.
    • Transaktionen während der SperreSie gehen nicht verloren. Firebird 4 und 5: Der Knoten findet die Transaktionen, die im Moment von nbackup -L offen sind, und die Replik wiederholt sie aus den Segmenten. HQbird 2.5 und 3.0: Der Knoten wartet, bis solche Transaktionen beendet sind (etwa eine Minute), andernfalls startet die Kopie nicht.
    • Eine Datenbank zur ZeitStandardmäßig kopiert der Master-Knoten eine Datenbank. Die anderen warten in einer Warteschlange.
    • Andere Repliken dieser DatenbankWährend die Kopie läuft, erhalten sie keine Segmente dieser Datenbank. Später holen sie auf.
    • Automatische NeuinitialisierungRCM kann eine Datenbank im Zustand NEEDS_REINIT von selbst erneut kopieren, jedoch nur in einem festgelegten Zeitfenster. Standardmäßig aus.

    Der schonende Modus wartet auf lange Transaktionen

    Vor der Sperre sucht der Knoten nach Schreibtransaktionen, die vor dem ältesten Segment im Archiv des Masters begonnen haben. Ist das Archiv leer (erste Kopie), ist der Zeitpunkt maßgeblich, an dem der Knoten die Publikation eingeschaltet hat. Die Replik kann solche Transaktionen nicht wiederholen und würde anhalten. Daher startet die Kopie nicht, solange solche Transaktionen offen sind.

    RCM zeigt die fünf Verbindungen mit den ältesten Transaktionen: Benutzer, Client, Alter, aktuelle Abfrage. Sie können sie trennen und die Kopie sofort wiederholen. Solange die Kopie wartet, wird das Archiv des Masters nicht bereinigt, jedoch für höchstens 1000 Segmente. Danach wird die Bereinigung fortgesetzt, und RCM löst einen Alarm aus.

    Der normale Modus sperrt die Datenbank sofort, ohne die Prüfung.

    Starten der Kopie. Modus (schonend oder normal), Replik-Ordner mit Prüfung, Erlaubnis, den Firebird der Replik zu stoppen.

    Speicherplatz und Geschwindigkeit

    WoWas benötigt wird
    Master, Datenbank-VolumeMindestens 105 % der Datenbankgröße frei. .delta wächst während der Kopie.
    Replik, Datenbank-Volume105 % plus die Volume-Reserve free_space_floor_gb (standardmäßig 1 GB). Der Knoten reserviert die volle Größe im Voraus; eine zweite Kopie ist nicht nötig. Bei einer wiederholten Kopie bleibt die alte Datei bis zum Ende erhalten. Reicht der Platz nicht für beide Dateien, löscht das Kontrollkästchen „Remove the old replica“ die alte Datei vor der Übertragung.
    NachtgeschwindigkeitIm Übertragungsfenster (standardmäßig 23:00–05:00) ist sie konstant, standardmäßig 100 MB/s.
    TagesgeschwindigkeitEin Anteil der gemessenen Festplattengeschwindigkeit, standardmäßig die Hälfte. Eine tagsüber gestartete Kopie beschleunigt nachts von selbst.

    Der Speicherplatz wird zweimal geprüft und nur vor der Sperre: zuerst von RCM anhand der Statistiken, dann von den Knoten mit einer Live-Messung auf beiden Seiten. Die Prüfung durch den Knoten kann nicht übersprungen werden: Sie schützt die Festplatte davor, mitten in der Kopie vollzulaufen.

    Firebird 4 und 5 · HQbird 2.5 und 3.0

    Publikation: Welche Tabellen auf die Replik gehen

    Firebird 4 und 5 schreiben in Segmente nur Änderungen publizierter Tabellen und nur, wenn die Publikation eingeschaltet ist. Ohne sie erreichen die Änderungen die Replik nicht. Der Knoten bemerkt dies und löst einen Alarm aus. Die Schaltfläche „Sync publication“ schaltet sie ein und erstellt die korrekte Tabellenliste.

    Publikationstabellen. Der Schlüssel jeder Tabelle und ihr Zustand: publiziert, noch nicht publiziert, herausgenommen, kein Schlüssel.

    Was die Synchronisierung tut

    • schaltet die Publikation ein, sofern der Operator sie nicht absichtlich ausgeschaltet hat;
    • fügt alle Tabellen mit einem Primärschlüssel oder einem eindeutigen Index hinzu;
    • entfernt Tabellen ohne Schlüssel und Tabellen, die der Operator ausgeschlossen hat;
    • schaltet das automatische Hinzufügen neuer Tabellen aus.

    Ohne Schlüssel kann die Replik die Zeile für UPDATE und DELETE nicht finden. Daher kann eine solche Tabelle nicht publiziert werden: Fügen Sie einen Schlüssel hinzu und synchronisieren Sie erneut.

    • Stündliche PrüfungIst die Publikation aus, prüft der Knoten sie alle 2 Minuten. Bei einer Datenbank mit einer Replik ist das ein Alarm.
    • AusschlusslisteWird auf dem Master-Knoten gespeichert. Wird eine Replik zum Master befördert, wandert die Liste zum neuen Master.
    • Neue TabelleTritt nicht von selbst der Publikation bei. Erstellen Sie einen Schlüssel und klicken Sie auf „Sync publication“.
    • Kopie ohne PublikationDer Master-Knoten verweigert das Kopieren der Datenbank, wenn die Publikation aus ist oder keine Tabellen hat (publication_off). Das Initialisierungsfenster bietet „Sync publication and initialize“ an.
    • HQbird 2.5 und 3.0Keine Publikationen. Include- und Exclude-Filter in den Replikationseinstellungen legen die Menge der Tabellen fest.

    Änderungen, die vorgenommen wurden, während die Publikation aus war oder eine Tabelle ausgeschlossen war, erreichen die Replik nicht, auch nicht, nachdem Sie sie eingeschaltet haben. „Verify“ vergleicht nur Zeilenanzahlen; es findet verlorene UPDATEs nicht. Wurde in die Datenbank geschrieben, während die Publikation aus war, kopieren Sie die Datenbank erneut.

    Verzögerung · Archiv · Alarme · Datenprüfung

    Überwachung: Die Replik bleibt nicht unbemerkt zurück

    Knoten senden alle 30 Sekunden Statistiken an RCM. Für jedes Master–Replik-Paar sehen Sie: das letzte Segment, wie viele gesendet, bestätigt und angewendet wurden, die Warteschlange und die Verzögerung in Sekunden.

    Übertragung und Warteschlangen. Eine Zeile pro Pfad Master → Replik: Segmente, Warteschlange und Verzögerung.
    DatenbankzustandGruppe in RCMBedeutung
    IN_SYNCOkDie Replik hat alle Segmente erhalten.
    LAGGINGPendingDie Replik ist im Rückstand, Segmente sind in der Warteschlange.
    SEEDINGPendingDie Datenbank wird auf die Replik kopiert.
    NEEDS_REINITErrorDie Replik muss erneut kopiert werden.
    FAILEDErrorDie letzte Kopie ist fehlgeschlagen.

    Das Archiv des Masters wird in Stufen bereinigt

    Der Master behält gesendete Segmente, damit eine Replik sie erneut anfordern kann. Ist der Platz knapp, löscht er zuerst das, was sicher nicht mehr benötigt wird.

    1. 1Von allen angewendet, älter als das LimitStandardlimit sind 2 Tage
    2. 2Angewendet, aber neuer als das Limitwenn weniger als 1 GB frei ist; Alarm
    3. 3Noch nicht angewendetals letzter Schritt; die Replik benötigt eine neue Kopie

    Alarme mit Anweisungen

    RCM kennt mehr als 20 Alarmtypen, und jeder hat eine Anweisung, was zu tun ist. Sie können einen Alarm bestätigen, ihn 60 Minuten lang stummschalten oder ihn löschen. Bleibt die Ursache bestehen, erscheint der Alarm erneut.

    Es gibt keine E-Mail und keinen Webhook: Beobachten Sie die Seite „Alerts“ oder fragen Sie die RCM-API ab.

    Alarme. Code, Knoten, Meldung und Aktionen.
    CodeWas passiert ist
    backlog_warn / backlog_criticalDer Master hat 32 / 48 nicht archivierte Segmente.
    apply_error, replication_stoppedDie Replik kann ein Segment nicht anwenden.
    replication_guid_mismatchDie GUID der Master-Datenbank hat sich geändert: Restore oder Dateiaustausch.
    segment_missing, sequence_gapDie Segmentfolge ist unterbrochen.
    firebird_down, firebird_log_errorFirebird ist ausgefallen oder schreibt Fehler.
    firebird_not_answeringDer Firebird-Port ist offen, aber eine Verbindung zur Datenbank schlägt seit einer Minute fehl.
    master_publication_offDie Publikation ist für eine Datenbank mit Replik ausgeschaltet.
    data_mismatchDie periodische Datenprüfung hat eine Abweichung gefunden. Die Datenprüfung wird separat eingeschaltet.
    Datenprüfung. Zeilenanzahl jeder Tabelle auf dem Master und auf der Replik.

    Vergleich von Master und Replik

    Verify zählt die Zeilen der ausgewählten Tabellen auf dem Master und auf der Replik und vergleicht sie. Der Inhalt der Zeilen wird nicht verglichen: geänderte Zeilen werden nicht gefunden. Führen Sie es zu einer ruhigen Zeit aus: bei aktiven Schreibvorgängen können die Zählungen abweichen.

    Die periodische Prüfung ist standardmäßig ausgeschaltet: COUNT(*) liest die ganze Tabelle. Schalten Sie sie mit dem Knotenparameter data_check_enabled ein; sie läuft alle 2 Stunden einmal. Neue Prüfeinstellungen wirken sofort, ohne Neustart des Knotens. Die Prüfung vergleicht die Daten, wenn Master und Replik auf demselben Segment stehen. Eine Abweichung löst einen Alarm aus. Eine von der Publikation ausgeschlossene Tabelle erscheint als „nicht publiziert“, nicht als Fehler.

    • Versand pausierenFür eine oder viele Datenbanken. Nach „Fortsetzen“ wird der Versand ab dem letzten Segment fortgesetzt, ohne neue Kopie. Das Archiv wächst in der Zwischenzeit.
    • Protokolle entfernter Knotenreplication.log, firebird.log und das Knotenprotokoll direkt in RCM, ohne Anmeldung am Server.
    • Keine LizenzDer Master stellt den Versand ein; Firebird und die Datenbanken arbeiten weiter. Nach der Installation einer Lizenz wird der Versand innerhalb einer Minute von selbst fortgesetzt.
    • BefehlsprotokollJeder RCM-Befehl wird mit Autor und Ergebnis aufgezeichnet. Cluster-Bericht in einer JSON-Datei.

    Service · Epoche · wo der Master ist

    Services: eine Datenbank auf mehreren Hosts

    Ein Service ist eine logische Datenbank auf mehreren Hosts. Der Master kann von Host zu Host wechseln, aber der Service-Name und der Datenbank-Alias ändern sich nicht. Anwendungen und Router fragen RCM, wo der Master des Service jetzt ist.

    Jeder Master-Wechsel erhält die nächste Nummer: die Epoche. RCM führt die Epochen-Historie: wann der Master gewechselt hat und warum. RCM findet einen Service über den Knoten und den Dateipfad, nicht über die GUID: beim Switchover ändert sich die GUID der Datenbank, aber der Pfad bleibt gleich.

    Was ein Service beschreibt

    • alias: der Datenbankname in databases.conf. Der neue Master schreibt ihn selbst.
    • members: ein Eintrag pro Host: Master-Knoten, Replik-Knoten, Dateipfad, Priorität.
    • router_port: der Port, auf dem Router die Anwendungen dieses Service annehmen.
    • policy: die Regeln des automatischen Failover und der Modus, der den alten Master schließt.

    Jeder Host eines Service betreibt zwei Knoten auf einem Firebird: einen Master-Knoten und einen Replik-Knoten. Das ist dasselbe Layout „Zwei Knoten pro Host“ wie im Diagramm oben.

    Der Master-Knoten benötigt die Firebird-Adresse für Clients: den Parameter advertise_addr. Ohne ihn kann RCM einer Anwendung nicht sagen, wohin sie sich verbinden soll.

    Wo der Master jetzt ist

    hqbirdrcm services put -id shop -file shop.json
    hqbirdrcm services
    hqbirdrcm where -service shop
    hqbirdrcm where -db shop

    where antwortet mit: dem Master-Host und der Adresse, der Epochennummer, den Repliken und den gefundenen Problemen. Über die API kann eine Anwendung auf eine neue Epoche warten, ohne RCM jede Sekunde abzufragen.

    Die Seite Services in RCM zeigt dasselbe für jeden Service: den Zustand, die Epoche, den Master, die Firebird-Adresse, die Repliken und die Probleme. Das Feld Find findet eine Datenbank über Alias, Service-Name, GUID oder Pfad.

    Services im Browser

    Alles, was die hqbirdrcm-Befehle für Services tun, gibt es auch in der RCM-Weboberfläche. Dafür brauchen Sie die Kommandozeile nicht.

    • Service-SeiteDer Zustand und sein Grund, der Master, die Repliken mit ihrem Rückstand, die Hosts und ihre Rollen, die Router, die alten Master, die auf das Schließen warten, die Regel für automatisches Failover, der laufende Operationsschritt Schritt für Schritt und die Historie der Master.
    • AktionsschaltflächenSwitchover, Failover, Rejoin, Resume. Jede Schaltfläche führt zuerst eine Prüfung aus und zeigt die Probleme. Die Aktion startet erst nach Ihrer Bestätigung. Ein zweiter Klick startet keine zweite Operation.
    • Service-FormularDie Schaltfläche New service erstellt einen Service: Name, Alias, Router-Port und eine Zeile pro Host. Das Formular bietet die Knoten und die Datenbanken an, die sie sehen. Check prüft das Formular, Save zeigt zuerst die Liste der Änderungen.
    • OperationenEine Seite mit allen Switchovers, Failovers und Rejoins, neueste zuerst. Während eine Operation läuft, hat die Kopfzeile jeder Seite eine Beschriftung mit einem Link darauf.
    • Löschen eines ServiceNur der Datensatz in RCM wird gelöscht. Der Dialog sagt, was bleibt (Datenbanken, Replikation, Knotenrollen, Alias) und was verloren geht (Historie, Regel, Port auf den Routern), und fordert Sie auf, den Service-Namen einzugeben.
    • Viewer-RolleEin Benutzer mit dieser Rolle sieht alle Seiten und führt Prüfungen aus, hat aber keine Aktionsschaltflächen.
    Service-ZustandBedeutungWas zu tun ist
    okDer Master arbeitet, die Replik auf einem anderen Host folgt ihm.Nichts.
    rejoiningDer alte Master kommt als Replik zurück.Warten: die Datenbank wird kopiert.
    degraded_no_replicaDer Master arbeitet, es gibt keine Replik. Das passiert nach einem Failover oder nach einem Rejoin-Fehler.hqbirdrcm rejoin
    failedRCM kann den Zustand nicht ermitteln, oder das Firebird des Masters antwortet nicht.hqbirdrcm resume nach einer Prüfung

    Ein Service im Zustand failed startet weder einen Switchover noch ein automatisches Failover. Nur der Operator kann ihn aus diesem Zustand herausführen: mit dem Befehl resume, mit einem rejoin oder mit einem manuellen Failover.

    Geplanter Umzug des Masters · ohne Datenverlust

    Switchover: der Master wechselt auf einen anderen Host

    Switchover verschiebt den Master eines Service ohne Datenverlust auf einen anderen Host. RCM selbst stoppt die Schreibvorgänge auf dem alten Master, wartet, bis die Replik das letzte Segment angewendet hat, und macht sie zum Master. Dann kommt der alte Master als Replik des neuen in den Cluster zurück, am selben Pfad.

    Sie brauchen es für geplante Arbeiten: OS-Update, Festplattenaustausch, Verlagerung der Last auf einen anderen Server. Zuerst die Prüfung, dann der Start:

    hqbirdrcm switchover -service shop -check   # nur prüfen, ändert nichts
    hqbirdrcm switchover -service shop -to db2  # den Master auf db2 verschieben

    Der Befehl führt die Operation bis zum Ende aus und gibt jeden Schritt aus. Exit-Code 0 bedeutet Erfolg. Die Schaltfläche Switchover auf der Service-Seite in RCM tut dasselbe: zuerst die Prüfung, dann die Bestätigung, dann die Schritte der Operation auf dem Bildschirm.

      Anwendungen

      arbeiten

      Hosts und Service

      Was RCM vor dem Start prüft

      • Der Service ist im Zustand ok, der Master ist bekannt.
      • Die Ziel-Replik ist im Zustand IN_SYNC.
      • Alle vier Knoten der beiden Hosts antworten.
      • Die Ziel-Replik ist nicht wegen der Lizenz pausiert.
      • Auf diesen Knoten läuft keine Datenbankkopie und keine Promotion.

      Wenn etwas nicht stimmt, lehnt RCM ab und nennt den Grund als Code. Bis zu diesem Punkt hat sich nichts geändert.

      Wenn etwas schiefgeht

      • Vor dem Punkt ohne Rückkehr. Ein Fehler, ein Timeout oder ein Abbruch bringt den alten Master wieder online. Der Service bleibt ok auf dem alten Host. Wenn der alte Master nicht wieder online kommt, erhält der Service failed: Bringen Sie die Datenbank mit gfix -online normal online und führen Sie resume aus.
      • Nach dem Punkt ohne Rückkehr. Sie können nicht abbrechen. Ein Fehler setzt den Service auf failed.
      • Fehler während des Rejoin. Der neue Master arbeitet, es gibt keine Replik: degraded_no_replica. Führen Sie hqbirdrcm rejoin -service shop aus.
      hqbirdrcm operations show -id <id>
      hqbirdrcm operations cancel -id <id>

      Im Browser sind dies die Seite Operations und die Schaltfläche Cancel auf der Dienstseite.

      • Schreibvorgänge stoppenDer alte Master wird vollständig heruntergefahren. Der Knoten wartet, bis die Verbindungen enden: standardmäßig 120 Sekunden, höchstens 900. Der Schalter -force N trennt die Verbindungen nach N Sekunden.
      • AufholenJede Sekunde fragt RCM die Replik, ob sie das letzte Segment angewendet hat. Das Standardlimit beträgt 300 Sekunden.
      • Ein Firebird-NeustartAuf dem neuen Master, ohne auf das Wartungsfenster zu warten. Beim Rejoin startet Firebird auf dem alten Host nur neu, wenn der Replik-Knoten es benötigt.
      • Rejoin ist eine DatenbankkopieDer neue Master kopiert die Datenbank über nbackup auf den alten Host. Bei einer großen Datenbank dauert das lange, daher wartet der Befehl bis zu 2 Stunden auf den Vorgang.
      • RCM neu gestartetJeder Schritt wird auf die Festplatte geschrieben, bevor der Knoten aufgerufen wird. Nach einem Neustart setzt RCM den Vorgang ab dem aktuellen Schritt fort.
      • Dienst-SperreWährend ein Switchover oder ein Rejoin läuft, lehnt RCM andere Änderungen an diesen Knoten ab: Einstellungen, Firebird-Neustart, Kopie, Shipping-Pause.

      Verbindungen zum alten Master werden beim Schritt „Schreibvorgänge stoppen“ geschlossen. Die Anwendung muss sich erneut verbinden. Mit einem Router bleibt die Verbindungszeichenfolge gleich. Ohne Router wechselt die Anwendung zur Adresse des neuen Masters: hqbirdrcm where -service shop liefert sie.

      HAProxy · Linux · eine Verbindungszeichenfolge

      Router: Anwendungen behalten dieselbe Adresse

      Ein Router läuft auf dem Anwendungs-Host und hält HAProxy auf den Master jedes Dienstes ausgerichtet. Anwendungen verbinden sich mit <router host>:<service port>. Nach einem Switchover oder einem Failover bleibt die Verbindungszeichenfolge gleich.

      Router-Diagramm: vor dem Epochenwechsel gehen Anwendungen über den Router zu db1; nach dem Wechsel zu 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
      Epochenwechsel. Der Router schließt die Sitzungen des alten Masters sofort und öffnet den neuen Master, sobald dieser „bereit“ meldet. Adresse und Port für Anwendungen ändern sich nicht.

      Wie der Router einen Host auswählt

      • Er holt die Diensttabelle von RCM: Epoche, Master-Host, Firebird-Adressen.
      • Alle 2 Sekunden fragt er den Master-Knoten: „Bist du der Master dieser Epoche, und ist die Datenbank online?“
      • Antwort „ja“: Der Host nimmt Verbindungen an.
      • Antwort „nein“: keine neuen Verbindungen, offene Verbindungen bleiben bestehen.
      • Neue Epoche: Die Sitzungen des alten Masters werden sofort geschlossen.

      Wenn RCM nicht verfügbar ist, arbeitet der Router mit der letzten Tabelle. Der Router bewahrt sie auf seiner Festplatte auf.

      So fügen Sie einen Router hinzu

      Ein Router ist ein Cluster-Mitglied mit der Rolle router. Fügen Sie ihn auf der Seite Cluster hinzu, wie einen Master oder eine Replik. Der fbagent auf diesem Host erhält ein Zertifikat, schreibt die Konfiguration und registriert den Dienst. HAProxy muss auf dem Host installiert sein.

      Der router_port in der Dienstbeschreibung legt den Dienstport fest. Sie können mehrere Router haben: einen auf jedem Anwendungs-Host.

      Die Seite Settings → Routers in RCM zeigt die Router und ihre Berichte: welche Epoche der Router angewendet hat und zu welchem Host er führt.

      • Verbindungen brechen abWenn der Master wechselt, werden offene Verbindungen geschlossen. Die Anwendung muss sich erneut verbinden, zur selben Adresse.
      • Client-AdresseFirebird sieht die HAProxy-Adresse, nicht die Adresse der Anwendung. Zugriffsregeln nach Client-IP funktionieren hinter einem Router nicht.
      • Nur LinuxDer Router läuft unter Linux. Datenbankserver können unter Windows und Linux laufen.
      • WitnessesRouter melden an RCM, ob sie den Firebird-Port des Masters erreichen können. Ohne sie wird das automatische Failover nicht aktiviert.

      Master-Host verloren · manuell oder nach einer Regel

      Failover: Die Replik übernimmt die Master-Rolle

      Ein Failover ist nötig, wenn der Master-Host nicht antwortet. Die Replik wird mit den Segmenten, die sie erhalten hat, zum Master. Was der Master nicht gesendet hat, geht verloren. Daher muss der Operator den Verlust ausdrücklich akzeptieren.

      hqbirdrcm failover -service shop -check                       # what will be lost
      hqbirdrcm failover -service shop -to db2 -accept-data-loss  # start

      Ohne den Schalter -accept-data-loss prüft der Befehl nur und zeigt die Verlustschätzung: das letzte Segment des Masters, wie viele Segmente die Replik empfangen und angewendet hat und wie viele Segmente mindestens verloren gehen.

      Im Browser ist dies die Schaltfläche Failover auf der Dienstseite. Sie startet den Vorgang nur, wenn der Operator das Kontrollkästchen für den Datenverlust aktiviert und den Dienstnamen eingegeben hat.

      1. 1Prüfender Master antwortet nicht, die Replik hat eine brauchbare Kopie
      2. 2Aufholendie Replik wendet alles an, was sie empfangen hat; Limit 60 s
      3. 3PromotionPunkt ohne Rückkehr: neue GUID, Firebird-Neustart
      4. 4Neue Epochedie Replik ist der Master; der alte Master wartet auf das Schließen
      • Der Master antwortet nochRCM lehnt ab: master_reachable. Führen Sie ein Switchover aus oder stoppen Sie zuerst den Master-Knoten.
      • Zurückbleibende ReplikDer Zustand LAGGING wird akzeptiert. Eine Replik, die eine neue Kopie benötigt, ist nicht geeignet.
      • Mehrere ReplikenStandardmäßig nimmt RCM diejenige, die mehr Segmente angewendet hat, dann diejenige mit der höheren Priorität.
      • Nach dem FailoverDer Dienst befindet sich im Zustand degraded_no_replica: Der Master arbeitet, es gibt keine Replik. Es gibt keinen Rejoin, bis der alte Host wieder läuft.
      • Dienst im FehlerzustandEin manuelles Failover funktioniert auch dafür. Das ist der Ausweg, wenn Firebird auf dem Master hängt und Sie es nicht schnell neu starten können.
      • Ausgeschlossene TabellenRCM entnimmt ihre Liste der Replik oder der letzten Statistik des alten Masters. Wenn es keine Liste gibt, legen Sie die Tabellen auf der Publikationsseite des neuen Masters fest.
      • Aufhol-LimitDer Schalter -apply-timeout, standardmäßig 60 Sekunden, höchstens 3600.

      Automatisches Failover optional

      RCM kann ein Failover selbst starten. Dies ist standardmäßig deaktiviert. Sie aktivieren die Regel für jeden Dienst separat: auf der Dienstseite im Browser oder mit einem Befehl.

      hqbirdrcm policy -service shop                                     # show the rule
      hqbirdrcm policy -service shop -auto-failover on -max-data-loss 30

      RCM prüft die Bedingungen alle 10 Sekunden und startet ein Failover nur, wenn alle zutreffen.

      BedingungWarum
      Der Master-Knoten ist 90 Sekunden lang stummDer Master sendet keine Statistiken.
      Ein direkter Aufruf von RCM an den Master-Knoten schlägt fehl (5 Sekunden)Es sind nicht nur verspätete Statistiken.
      Mehr als die Hälfte der Router können den Firebird-Port des Masters nicht erreichenAuch Anwendungen können sich nicht verbinden.
      Der Replik-Knoten hat den Master 90 Sekunden lang nicht gesehenDritter Witness.
      Der Replik-Lag beträgt 30 Sekunden oder wenigerGrenze für den Datenverlust.
      Seit dem letzten automatischen Failover ist eine Stunde vergangenDer Master springt nicht zwischen Hosts hin und her.
      RCM läuft seit mehr als 90 SekundenNach einem Neustart hat RCM keine frischen Daten.
      Der Dienst ist ok, auf den Knoten läuft weder eine Kopie noch eine PromotionKein Konflikt mit laufender Arbeit.
      • Router sind erforderlichDie Regel benötigt sowohl Router als auch einen Dienst-Port. Fehlt eines davon, wird die Regel nicht aktiviert: no_witnesses. Platzieren Sie die Router so, dass sich die meisten von ihnen nicht auf dem Master-Host befinden.
      • EinmaligNach einem automatischen Failover schaltet sich die Regel selbst ab. Nur der Operator schaltet sie wieder ein.
      • Warum sie nicht gestartet istRCM speichert den Grund für das Warten zusammen mit der Dienstregel und schreibt jeden neuen Grund einmal in sein Log.
      • LogDie Operation läuft als system:autofailover. Der erste Eintrag sagt, was die Witnesses gesehen haben.

      Das 30-Sekunden-Limit umfasst nur die Warteschlange, die die Replica empfangen und noch nicht angewendet hat. Segmente, die der Master geschrieben, aber nicht gesendet hat, sind nicht darin enthalten. Der Operationsbericht zeigt ihre Anzahl.

      Fence · Rejoin · hängender Master · Resume

      Rejoin und Wiederherstellung

      Nach einem Failover hat der Cluster zwei Dateien, die der Master waren. Sie müssen die alte schließen, damit sie keine Schreibvorgänge mehr annimmt, und sie als Replica zurückbringen. RCM erledigt das Erste selbst, das Zweite auf einen Operator-Befehl hin.

      Den alten Master schließen (Fence)

      RCM versucht alle 10 Sekunden, den alten Master zu schließen. Wenn sein Knoten antwortet, erhält er die Rolle „geschlossen“ und sendet keine Segmente mehr. Jeder Fence wird ins Audit-Log geschrieben.

      • Modus route (Standard). Die Datenbank des alten Masters bleibt online. Router verwenden sie nicht mehr.
      • Modus shutdown. RCM stoppt zuerst die Datenbank. Verbindungen werden nach 5 Sekunden geschlossen.
      hqbirdrcm policy -service shop -fence-mode shutdown

      Den alten Master zurückbringen (Rejoin)

      Wenn der alte Host wieder funktioniert, starten Sie den Rejoin. RCM schließt zuerst den alten Master, falls dies noch nicht geschehen ist. Dann kopiert der neue Master seine Datenbank auf den alten Host, an denselben Pfad.

      hqbirdrcm rejoin -service shop

      Die alte Datei wird nicht gelöscht. Sie bleibt neben der neuen als <name>.pre-reinit-<time>.fdb erhalten. Diese Datei und das Archiv des alten Masters enthalten Änderungen, die der neue Master nicht hat.

      Im Modus route können Anwendungen, die sich direkt mit dem alten Host verbinden, nicht über einen Router, weiterhin in die alte Datenbank schreiben. Diese Änderungen erreichen den neuen Master nicht. Wenn einige Anwendungen ohne Router arbeiten, aktivieren Sie den Modus shutdown.

      Hängender Master

      Firebird kann so hängen, dass der Port offen ist, aber keine Verbindung zur Datenbank möglich ist. Eine Portprüfung erkennt dies nicht. Daher verbindet sich der Knoten selbst jede Minute mit der Datenbank, mit einem Limit von 10 Sekunden.

      • Eine Minute ohne Antwort: der ernste Alarm firebird_not_answering.
      • RCM setzt den Dienst auf failed und schreibt den Grund: Knoten, Host, Zeit.
      • Ein automatisches Failover startet in diesem Zustand nicht.

      Was zu tun ist: Sichern Sie die Firebird-Thread-Stacks und firebird.log, starten Sie Firebird auf dem Master-Host neu und führen Sie dann resume aus. Wenn Sie nicht schnell neu starten können, stoppen Sie den Master-Knoten und starten Sie ein Failover.

      Den Fehlerzustand verlassen

      hqbirdrcm resume -service shop -check
      hqbirdrcm resume -service shop

      RCM fragt den Master-Knoten direkt und prüft:

      • auf dem Dienst läuft keine Operation;
      • der Master-Knoten antwortet;
      • sein Firebird akzeptiert Verbindungen;
      • der Host ist der Master der aktuellen Epoche, die Datenbank ist online.

      Der Dienst wechselt auf ok, wenn eine Replica auf einem anderen Host dem Master folgt. Andernfalls wechselt er auf degraded_no_replica: Führen Sie dann rejoin aus.

      Auf Normal umstellen · zum Master befördern

      Manuelle Replica-Promotion: Schritt für Schritt

      Für eine Datenbank, die Teil eines Dienstes ist, verwenden Sie Switchover und Failover: Sie erledigen alle unten aufgeführten Schritte selbst. Der manuelle Weg bleibt für Datenbanken ohne Dienst. „Auf Normal umstellen“ macht die Replica zu einer eigenständigen Arbeitsdatenbank: für Berichte, Tests oder einen Ausfall. „Zum Master befördern“ macht die Replica zum neuen Master.

      Die Promotion funktioniert für ein Paar von Companion-Knoten: einen Replica-Knoten und einen Master-Knoten auf derselben Firebird-Instanz. Die Datenbankdatei bleibt an ihrem Platz; die Kontrolle geht auf den Companion über. Jeder Schritt ist in der Datenbankzeile sichtbar. Wenn ein Schritt unterbrochen wurde, klicken Sie erneut auf die Schaltfläche: Abgeschlossene Schritte werden nicht wiederholt.

        Verbindungen

        beibehalten

        Was RCM anzeigt

        Schritte in der Datenbankzeile. Abgeschlossene Schritte sind grün, der aktuelle ist rot, die nächsten sind grau.

        Warum eine neue GUID

        Ohne sie würde der neue Master Segmente unter der GUID des alten Masters schreiben, und seine Replicas würden sie ablehnen. Der Knoten vergibt der Datenbank direkt vor Ort eine neue GUID, über nbackup, ohne Firebird-Neustart. Dies funktioniert auf 2.5, 3.0, 4.0 und 5.0.

        Nach einer neuen GUID passt die alte nbackup-Kette nicht mehr. Erstellen Sie eine neue Level-0-Kopie.

        Manueller Switchover ohne Dienst

        1. Stoppen Sie die Schreibvorgänge der Anwendungen auf den alten Master.
        2. Warten Sie auf IN_SYNC und eine leere Warteschlange.
        3. Klicken Sie auf „Verify“: Die Zeilenanzahlen stimmen überein. Dies prüft nur die Zeilenanzahlen.
        4. „Zum Master befördern“, warten Sie auf den Schritt FINALIZE.
        5. Stellen Sie die Anwendungen auf den neuen Master um.
        6. Erstellen Sie eine nbackup-Level-0-Kopie und verbinden Sie eine neue Replica.

        Die manuelle Promotion prüft nicht, ob Anwendungen auf den alten Master schreiben, und bringt den alten Master nicht als Replica zurück. Stoppen Sie die Schreibvorgänge zuerst selbst. Switchover erledigt beide Schritte für Sie: Es stoppt die Schreibvorgänge und bringt den alten Master zurück.

        Neustart · Parameter · Zertifikate

        Einstellungen und Sicherheit

        Firebird liest Replikationseinstellungen nur beim Start. Daher ist es wichtig, wer Firebird wann neu startet. Die Regel ist einfach: Der Firebird des Masters wird niemals automatisch neu gestartet. Es gibt eine Ausnahme: Switchover und Failover. Dort ist der Neustart Teil einer Operation, die der Operator gestartet hat oder die eine vom Operator aktivierte Regel gestartet hat.

        KnotenWer Firebird neu startet
        MasterNur Sie. Der Master-Knoten startet Firebird nicht von selbst neu.
        Replica, derselbe Firebird hat Master-DatenbankenSie. Die Berechtigung im Kopierfenster erlaubt dem Knoten nur, Firebird zu stoppen, um die alte Replica-Datei zu ersetzen oder zu löschen.
        Replica, automatischer Neustart nicht erlaubtSie.
        Andere ReplicasDer Knoten, in seinem Neustartfenster. Einmal nach einer Reihe von Kopien, nicht nach jeder Datenbank.

        Replikationsparameter für viele Datenbanken

        Datenbanken auswählen: RCM gruppiert sie nach Firebird-Version und Rolle. Wählen Sie für jeden Parameter eine Aktion: beibehalten, setzen, auf die Ebene darüber zurücksetzen oder nicht schreiben. Sie sehen, woher der aktuelle Wert stammt: von der Datenbank, vom Knoten oder von Firebird.

        Vorschau prüft die Werte auf den Knoten und ändert nichts. Sie zeigt auch, wer Firebird neu startet und wie viele Datenbanken dies betrifft.

        Replikationsparameter. Ein Hinweis für jeden Schlüssel, Knoten- und Firebird-Werte, Vorschau: „Sie starten neu“.
        • ZeitfensterEin von Ihnen angeforderter Master-Neustart: 22:00–05:00. Replica: jederzeit. Manuelle Promotion zum Master startet beide Firebird-Server gleichzeitig neu, ohne Zeitfenster. Switchover startet einen Firebird neu: auf dem neuen Master. Geschwindigkeit der Vollkopie: 23:00–05:00.
        • SegmentgeschwindigkeitStandardmäßig 50 MB/s, kurze Spitze 200 MB. Änderungen sofort, ohne Neustart.
        • Verschieben der Replica-DateiIn einen anderen Unterordner ohne neue Kopie; Rollback bei Fehler.
        • Manuell konfigurierte ReplicaSie können sie ohne neue Kopie unter Verwaltung nehmen. RCM gleicht die Dateien anhand der GUID ab.
        • KommandozeileKopieren, Prüfen, Pausieren, Promotion und andere RCM-Befehle sind auch in hqbirdrcm verfügbar. Switchover, Failover und die Dienstregel sind auf drei Wegen verfügbar: im Browser, mit einem Befehl und über die API.
        • Viewer-RolleEin RCM-Benutzer mit der Viewer-Rolle sieht alles und führt Prüfungen aus. Jede Änderung ist für diesen Benutzer verboten.
        • 6 SprachenRCM-Oberfläche. Alarm-Anweisungen sind auf Englisch.
        Cluster-Beschreibung in HQ Monitor (Demo-Modus). Mitglieder und Rollen, Master → Replica-Verbindungen, der Zertifikatsablauf jedes Mitglieds.

        Ein Dokument beschreibt den Cluster

        Mitglieder, ihre Rollen und Master → Replica-Verbindungen werden auf der Clusters-Seite in HQ Monitor oder in RCM festgelegt. Der fbagent auf jedem Host erhält die Beschreibung und installiert und konfiguriert die Knoten selbst. Ohne HQCenter verwaltet RCM einen Cluster mit bis zu 3 Hosts.

        mTLS und Zertifikate

        Alle Cluster-Kanäle sind durch mTLS mit einer gemeinsamen CA geschützt. Der Schlüssel wird auf dem Mitglieds-Host erstellt und verlässt ihn nie: Nur die Zertifikatsanfrage geht hinaus. Ein Zertifikat ist 90 Tage gültig und erneuert sich 30 Tage vor Ablauf selbst. Ein neuer Schlüssel und eine neue CA werden auf Anweisung eines Administrators ausgestellt.

        Die RCM-Weboberfläche arbeitet über HTTPS auf Port 7444. Der Agent öffnet diesen Port in der Firewall, wenn RCM auf dem Host eingeschaltet wird. Die Anmeldung erfolgt mit Benutzername und Passwort; das erste Passwort muss geändert werden. Es befindet sich in der Datei rcm-initial-password auf dem RCM-Host und wird nicht auf dem Bildschirm angezeigt. Nach der Passwortänderung löscht der Agent diese Datei. Die Anmeldeseite zeigt den Cluster-CA-Hash: Vergleichen Sie ihn mit der Zeile „CA hash“ in der Einrichtungszusammenfassung auf dem RCM-Host. Jede Änderung und jede Anmeldung wird im Audit-Log protokolliert.

        Befehle · Timeouts · Ports · Ablehnungscodes

        Referenz

        Befehle

        AufgabeBefehl
        RCM auf einem Host einschaltenfbagent --cluster-init <id>
        Das Pairing-Fenster öffnen oder schließenfbagent --cluster-pairing on|off
        Hosts verbindenhqbirdrcm cluster link -hosts db1,db2 -master db1
        Token für einen Host ohne Pairing-Fensterhqbirdrcm cluster join-token -note db2
        Den Cluster verlassenfbagent --cluster-leave
        Einen Dienst beschreibenhqbirdrcm services put -id shop -file shop.json
        Wo der Master isthqbirdrcm where -service shop
        Geplante Verlagerung des Mastershqbirdrcm switchover -service shop [-to db2] [-check]
        Notfall-Verlagerunghqbirdrcm failover -service shop -accept-data-loss
        Den alten Master als Replica zurückbringenhqbirdrcm rejoin -service shop
        Den Fehlerzustand verlassenhqbirdrcm resume -service shop [-check]
        Regel für automatisches Failoverhqbirdrcm policy -service shop -auto-failover on|off
        Fortschritt und Abbruch einer Operationhqbirdrcm operations show|cancel -id <id>

        Timeouts und Intervalle

        WasStandardWie ändern
        Switchover: auf das Ende der Verbindungen warten120 s, höchstens 900 s-quiesce-timeout
        Switchover: Replica wendet das letzte Segment an300 s-apply-timeout
        Switchover: Befehl wartet auf das Ende der Operation2 Stunden-timeout
        Failover: Replica wendet an, was sie erhalten hat60 s, höchstens 3600 s-apply-timeout
        Automatisches Failover: Master ist stumm90 s-failover-delay
        Automatisches Failover: Lag-Grenze30 s-max-data-loss
        Automatisches Failover: Pause zwischen zwei1 Stunde-min-interval
        Prüfung der Failover-Bedingungen und der Fence des alten Mastersalle 10 skann nicht geändert werden
        Hängendes Firebird: Verbindungsprüfungeinmal pro Minute, Limit 10 skann nicht geändert werden
        Router: Abfrage des Master-Knotensalle 2 skann nicht geändert werden
        Pairing-Fenster, Join-Token24 StundenFenster: Anzahl der Stunden in der Anfrage
        Hosts verbinden: Agent-Zertifikat, Knotenstartbis zu 10 Minuten, bis zu 20 Minutenkann nicht geändert werden

        Ports

        PortZweck
        7443RCM: Knoten, Agenten und Router, mTLS.
        7444RCM: Weboberfläche und Operator-Befehle, HTTPS.
        7450–7459Agent-Pairing-Fenster: 7450 + Slot.
        7051–7060Erster Knoten des Agenten: 7051 + Slot.
        7061–7070Zweiter Knoten des Agenten: 7061 + Slot.
        router_portDienst-Port auf dem Router, zum Beispiel 3051.

        Ablehnungscodes

        CodeBedeutung
        not_in_syncDie Ziel-Replica ist im Rückstand: Der Switchover startet nicht.
        busyAuf den Knoten läuft eine Datenbankkopie oder eine Promotion.
        service_busyAuf dem Dienst läuft bereits eine Operation.
        master_reachableDer Master antwortet: Ein Failover ist nicht nötig.
        replica_unusableDie Replica hat keine nutzbare Datenbankkopie.
        data_loss_not_acceptedFailover ohne den Schalter -accept-data-loss.
        past_no_returnAbbruch nach dem Punkt ohne Wiederkehr.
        no_witnessesAutomatisches Failover ohne Router.
        node_port_clashEin anderes Mitglied des Hosts verwendet den Knoten-Port.
        seats_exceededDer Cluster hat bereits 3 Hosts.

        Die wichtigsten Punkte in Kürze

        Häufige Fragen

        Was ist der Unterschied zwischen Switchover und Failover?

        Switchover ist geplant: Beide Hosts arbeiten, es gehen keine Daten verloren, der alte Master kommt von selbst als Replica zurück. Failover ist ein Notfall: Der Master-Host ist verloren, was der Master nicht gesendet hat, ist verloren, und Sie bringen den alten Master mit einem separaten Befehl zurück.

        Was sieht die Anwendung während eines Switchovers?

        Verbindungen zum alten Master werden geschlossen, wenn RCM die Schreibvorgänge stoppt. Bis die Replica zum Master wird, kann nirgendwo geschrieben werden. Nach der neuen Epoche verbindet sich die Anwendung erneut: mit derselben Router-Adresse oder mit der Adresse des neuen Masters.

        Wie lange dauert ein Switchover?

        Die Schreibpause hat drei Teile: Warten auf das Ende der Verbindungen (standardmäßig bis zu 120 Sekunden), Aufholen des letzten Segments und ein Firebird-Neustart auf dem neuen Master. Das Rejoin des alten Masters läuft danach im Hintergrund. Seine Dauer entspricht der Dauer der Datenbankkopie.

        Kann ich ohne Router arbeiten?

        Ja. Switchover und manuelles Failover funktionieren ohne Router. Die Anwendung erhält die Master-Adresse dann von RCM selbst. Automatisches Failover lässt sich ohne Router nicht einschalten: Router sind seine Zeugen.

        Wie viele Daten kann ein automatisches Failover verlieren?

        Die Regel startet nicht, wenn die Replica mehr als 30 Sekunden im Rückstand ist. Aber Segmente, die der Master geschrieben und nicht gesendet hat, gehen verloren. Der Operationsbericht zeigt ihre Anzahl. Die alte Datenbankdatei wird aufbewahrt: Diese Änderungen bleiben in ihr und im Archiv des alten Masters.

        Der Dienst ist im Fehlerzustand. Was mache ich?

        Sehen Sie den Grund auf der Services-Seite nach. Wenn das Firebird des Masters hängt, starten Sie es neu. Dann zeigt hqbirdrcm resume -service <id> -check, was den Dienst blockiert, und resume ohne den Schalter bringt den Dienst wieder zum Laufen.

        Wie viel Platz benötigt das Rejoin des alten Masters?

        Rejoin ist eine neue Datenbankkopie. Es gelten dieselben Regeln wie für jede Kopie: 105 % der Datenbankgröße. Nach einem Failover bleibt die alte Datei neben der neuen, daher benötigt der alte Host Platz für beide Dateien.

        Funktioniert es unter Windows?

        Knoten und RCM funktionieren unter Windows und Linux. Der Router funktioniert nur unter Linux.

        ← Zurück zur HQbird 2027-Übersicht