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

Andere Sprachen: Русский, Português.

Diese Anleitung führt von zwei sauberen Servern zu einer funktionierenden Firebird 5.0-Replik. Alles geschieht im Browser, in der RCM-Konsole, außer der Installation und einem Ordner. Die Screenshots stammen aus dem Lauf vom 2026-11-17: Kit 2027.2.33, RCM und Nodes 2027.5.12, Ubuntu 24.04, die englische UI. Der Bericht des früheren Laufs vom 2026-11-08: hqbird2027-rcm-cluster-check-report.ru.md (russisch, Abschnitt „Прогон 2“). Nur Befehle, ohne Screenshots: hqbird2027-linux-cluster-runbook.md. Jede RCM-Seite im Detail: das RCM-Benutzerhandbuch (Repository hqcluster-node, docs/user-guide/).

Diese Anleitung gilt für Kit 2027.2.24 und später. Für Kit 2027.2.22 siehe die Ausgabe dieser Datei vom 2026-11-07 in der Git-Historie.

Das herunterzuladende Kit ist 2027.2.33 (2026-11-16): Agent 3.4.0, HQ Monitor 1.57.0, RCM und Nodes 2027.5.12, Firebird 5.0.5.1917. Diese Anleitung wurde damit am 2026-11-17 geprüft (zwei Server, Ubuntu 24.04, Datenbanken von 3 MB und 167 MB): alle Schritte bestanden. Der Text nennt die Ergebnisse dieses Laufs „den Lauf vom 2026-11-17“. Die Screenshots stammen aus einem zweiten Durchgang desselben Tages mit demselben Kit (Datenbanken von 3 MB und 2,88 GB). Die anderen Zahlen stammen weiterhin aus dem Lauf vom 2026-11-08. Was die Kits nach 2027.2.27 für einen Cluster geändert haben:

Kit Änderung
2027.2.29 (Agent 3.1.0, RCM 2027.5.9) Standardmäßig kein Cluster (siehe unten). Mehrere Agents eines Hosts können einem Cluster beitreten: jeder hat seinen eigenen Pairing-Port (7450–7459) und Node-Port. fbagent --cluster-leave. Die Seite Clusters von HQ Monitor
2027.2.30 (RCM 2027.5.10) Switchover und Failover eines Dienstes, Router
2027.2.31 (Agent 3.3.0, RCM 2027.5.11) Der Installer öffnet eine Textoberfläche in einem Terminal (Schritt 1). Die Seiten Services von RCM. Ein Server, der an kein HQCenter angebunden ist, aktualisiert den Agent, HQ Monitor und fbmcp selbst
2027.2.33 (Agent 3.4.0, RCM 2027.5.12) RCM sendet seine Alerts an Telegram, einen Webhook oder E-Mail („What to watch next“). Ein Cluster aus zwei Docker-Containern: Docker-Anleitung

Alle Änderungen: What’s New.

Kits mit Agent (fbagent) 3.1.0 und später (ab 2027.2.29) erzeugen standardmäßig keinen Cluster: kein RCM, kein Pairing-Fenster, und die Cluster-Ports bleiben in der Firewall geschlossen. In Schritt 1 aktivieren Sie RCM auf dem Master und den Discovery-Modus auf der Replik.

Zeit: ≈30 Minuten plus das Kopieren der Datenbanken (≈1 Minute pro 3 GB in einem 1-Gbit/s-Netzwerk).

Was Sie erhalten

Server 1 Server 2
Rolle Master + RCM-Konsole Replik
Datenbanken /databases/master/*.fdb /databases/replica/<replica node>/<master node>/*.fdb
Dienste firebird, hqbirdfbagent-fb50, hqbirdmonitor-fb50, fbmcp, hqbirdrcm, hqclusternode-master-p3050 dieselben, aber hqclusternode-replica-p3050 und kein hqbirdrcm (ein älteres Kit hinterlässt dort sein eigenes RCM, gestoppt)

Was Sie benötigen

  • Zwei Linux-x86-64-Server (geprüft auf Ubuntu 24.04), 2 Kerne, 4 GB Speicher.
  • Speicherplatz. Master: frei ≥ 105 % der Datenbankgröße (die .delta-Datei wächst während der Sperre). Replik: frei ≥ 105 % der Datenbankgröße plus den Mindestwert limits.free_space_floor_gb (Standard 1 GB). Eine Reinit über eine bestehende Replik behält die alte Datei bis zum Ende, daher benötigt das Replik-Volume etwa 2 × die Datenbankgröße. Mit dem Kontrollkästchen Remove the old replica if space is short (Schritt 8) reichen 105 % plus der Mindestwert.
  • Netzwerk zwischen den Servern: Ports 3050, 7051, 7443, 7444, 7450. Dies sind die Ports der ersten Instanz eines Servers (Slot 0). Eine zweite Instanz eines Servers verwendet den Pairing-Port 7451 und den Node-Port 7052.
  • Ihr PC kann Port 7444 des Masters erreichen (die RCM-Konsole), direkt oder über einen SSH-Tunnel.
  • Ein Benutzer mit sudo.

Firewall. Der Installer öffnet Ports in einer aktivierten firewalld oder ufw (mit beliebiger Systemsprache): 3050 und 23050 immer, die Cluster-Ports nur für die Optionen von Schritt 1. Master: 7443, 7444, 7051. Replik: 7450, 7051. Der Agent schließt 7450 wieder, wenn das Pairing-Fenster endet oder der Host verknüpft ist. Unter Ubuntu ist ufw normalerweise deaktiviert. Dann schreibt der Installer eine Zeile, zum Beispiel auf dem Master: no active firewall (firewalld or ufw): ports 3050, 23050, 7443, 7444, 7051/tcp are not opened by this install; they are reachable from every network; close them or enable a firewall. In einer Cloud schließen Sie die Ports mit der Cloud-Firewall: von außen nur Ihre Adresse; zwischen den Servern das interne Netzwerk.

Unten stehen die Adressen des Laufs: Master 10.114.0.5, Replik 10.114.0.6 (privates Netzwerk). Verwenden Sie Ihre eigenen Adressen.

Schritt 1. Auf beiden Servern installieren

Auf jedem Server:

Command
V=2027.2.33
wget https://ib-aid.com/download/hqbird/v2027/hqbird2027-fb50-linux-$V.run
wget https://ib-aid.com/download/hqbird/v2027/hqbird2027-fb50-linux-$V.run.sha256
sha256sum -c hqbird2027-fb50-linux-$V.run.sha256
sudo sh hqbird2027-fb50-linux-$V.run

In einem Terminal öffnet der Installer seine Textoberfläche (Kits ab 2027.2.31). Die erste Seite hat die Zeile Cluster RCM off, discovery mode off. Öffnen Sie Cluster und ändern Sie eine Zeile:

Zeile der Cluster-Seite Master Replik
Cluster manager (RCM) on off
Discovery mode (24 h) off (dieser Agent betreibt das RCM) on

Die Zeilen Cluster id (Standard: der Hostname), RCM admin password (Standard: generiert) und Pairing port (Standard: der erste freie, 7450) können bleiben, wie sie sind. Gehen Sie zurück (Esc) und wählen Sie Install. Der Installer zeigt den Plan: Enter drücken. Dann fragt er Nothing on this host was changed yet. Start the install now?. Der Cursor steht auf No: bewegen Sie ihn auf Yes und drücken Sie Enter. Der Installer fügt fehlende Bibliotheken (zum Beispiel libtommath1) selbst hinzu. Die Textoberfläche vollständig: hqbird2027-linux-setup-guide.md.

Mit --no-tui, und in Kits 2027.2.29–2027.2.30, stellt der Installer Fragen. Die erste ist Install as planned? Yes/No: antworten Sie y. Dann stellt er zwei Cluster-Fragen. Die Antwort ist standardmäßig No (Enter):

Frage Master Replik
Install the cluster manager (RCM) on this host and make a new cluster? [y/N] y Enter (No)
Turn on discovery mode for 24 hours (an RCM on the network may invite this agent into its cluster; port 7450)? [y/N] nicht gefragt: dieser Agent betreibt das RCM y

Oder geben Sie die Antworten als Optionen an: in einem Terminal setzen sie die Werte der Cluster-Seite, bevor sie sich öffnet. Verwenden Sie sie auch für einen Lauf ohne Terminal: --yes allein bedeutet No für beide.

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

Die Installation dauert etwa eine Minute (der Lauf vom 2026-11-17: 61 Sekunden auf dem Master, 43 Sekunden auf der Replik). Das Ende der Ausgabe auf dem Master mit Kit 2027.2.33 (der Hash ist hier gekürzt; die Cluster-ID der Beispiele unten ist hq27d-m, aus dem Lauf vom 2026-11-08):

text
Done: agent hqbirdfbagent-fb50 in /opt/hqbird/fbagent-fb50, Firebird 5.0.5.1917 in /opt/firebird (port 3050).
HQ Monitor: http://localhost:23050/ (login admin; password in /opt/hqbird/conf/access.properties)
RCM:        https://10.114.0.5:7444 (cluster hq27d-m)
CA hash:    sha256:9754e0be…087cb195
Login:      rcmadmin
Password:   in /opt/hqbird/fbagent-fb50/clusterca/hq27d-m/rcm-initial-password (read it with sudo; RCM asks for a new one at the first login)
Pairing:    not needed: this agent runs the RCM; other agents link through it
fbmcp:      2027.2.24, service running; local only (remote mode: sudo fbmcp ctl hqbird-install --allow-from CIDR)

Auf der Replik:

text
RCM:        off; turn it on in HQbird Monitor or with fbagent --cluster-init <id>
Pairing:    port 7450 open until 2026-11-09T16:25:27Z (fingerprint sha256:0d137a71…09fe44cf); an RCM may invite this host

Ein älteres Kit gibt auf dem Master Pairing: not opened (this agent runs the RCM) aus.

Notieren Sie die Zeilen RCM: und CA hash: des Masters und die Zeile Pairing: der Replik. Den fingerprint benötigen Sie in Schritt 3.

Ältere Kits (Agent vor 3.1.0, zum Beispiel Kit 2027.2.27) stellen keine Cluster-Fragen. Sie installieren RCM auf jedem Server und öffnen das Pairing-Fenster überall. Verwenden Sie das RCM des Masters; das RCM des zweiten Servers stoppt nach der Verknüpfung von selbst.

Später, ohne den Installer. Öffnen Sie in HQ Monitor des Servers Clusters, Abschnitt Cluster on this server. Auf dem Master: Enable the cluster console (RCM); HQ Monitor öffnet 7443 und 7444 in der Firewall. Auf der Replik: Open the pairing window for 24 hours. Dasselbe mit Befehlen, als Benutzer des Agents:

Command
cd /opt/hqbird/fbagent-fb50
sudo -u firebird ./fbagent --cluster-init hq27d-m     # master; open 7443 and 7444 yourself
sudo -u firebird ./fbagent --cluster-pairing on       # replica

Solange das Pairing-Fenster offen ist, öffnet der Agent seinen Pairing-Port in der Firewall. Er schließt den Port, wenn das Fenster endet oder der Host verknüpft ist.

Die Ausgabe enthält keine Passwörter. Das RCM-Passwort steht in der Datei aus der Zeile Password:, das SYSDBA-Passwort in /root/fbagent-install-sysdba.txt, und das HQ Monitor-Passwort in /opt/hqbird/conf/access.properties.

Sie müssen keine Lizenz installieren: ein neuer Agent startet selbst eine 7-Tage-Testversion, und die Cluster-Nodes funktionieren.

Schritt 2. Bei RCM anmelden

Öffnen Sie die Adresse aus der Zeile RCM: des Masters. Wenn Port 7444 für Ihren PC geschlossen ist, verwenden Sie einen SSH-Tunnel und https://localhost:7444:

Command
ssh -L 7444:127.0.0.1:7444 <user>@<master>

Wenn Port 7444 auf Ihrem PC belegt ist, verwenden Sie einen anderen lokalen Port, zum Beispiel -L 17444:127.0.0.1:7444 und https://localhost:17444.

Der Browser warnt vor dem Zertifikat: die Cluster-CA hat das RCM-Zertifikat signiert. Die Anmeldeseite zeigt den Cluster CA hash: vergleichen Sie ihn mit der Zeile CA hash: der Installer-Ausgabe. Wenn sie übereinstimmen, installieren Sie das CA- Zertifikat (den Link Download the CA certificate (hqcluster-ca.crt) auf derselben Seite) als vertrauenswürdig, oder akzeptieren Sie die Warnung. Wenn sie nicht übereinstimmen, melden Sie sich nicht an, und prüfen Sie die Adresse.

RCM sign-in
RCM sign-in

Der Benutzername ist rcmadmin. Das Passwort steht in der Datei aus der Zeile Password::

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

RCM fragt sofort nach einem neuen Passwort (mindestens 12 Zeichen):

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

Ein RCM vor 2027.5.12 konnte diese Seite immer wieder laden. RCM 2027.5.12 (Kit 2027.2.33) enthält die Korrektur.

Nach der Passwortänderung löscht der Agent des Masters die Datei rcm-initial-password selbst innerhalb einer Minute. Bei einem älteren Kit hat der zweite Server ebenfalls ein eigenes RCM. Nach der Verknüpfung verschiebt der Agent diesen früheren Cluster in den Ordner cluster/left/. Agent 3.1.0 löscht dort sein rcm-initial-password; ein älterer Agent nicht. Dann löschen Sie die Datei selbst:

Command
# on server 2, after step 3
sudo find /opt/hqbird -name rcm-initial-password
sudo rm <path from the find output>

Löschen Sie nicht die Datei /opt/hqbirdrcm/initial-admin.json: sie enthält nur den Hash des alten Passworts, und ohne sie startet ein RCM, der seine Benutzerdatei verloren hat, mit dem Standardpasswort.

Nach der Passwortänderung öffnet RCM sofort Settings → Link hosts: der Cluster hat noch keine Nodes. Die Liste Releases in the mirror zeigt die hqbirdrcm- und hqclusternode-Releases, aus denen die Agents die Nodes installieren.

Hosts nach der Anmeldung verknüpfen
Hosts nach der Anmeldung verknüpfen

Schritt 3. Die Hosts verknüpfen

Die erste Zeile der Liste ist bereits ausgefüllt (der RCM-Host). Fügen Sie eine zweite Zeile hinzu: die Replica-Adresse, die der Master erreichen kann. Geben Sie eine IP ein, wenn die Server kein gemeinsames DNS haben: RCM behält die Zeichenkette unverändert, und die Knoten finden sich darüber.

Liste der Hosts
Liste der Hosts

Klicken Sie auf Check hosts. Bei einem Host ohne Port liest RCM die Pairing- Ports 7450–7459 und zeigt eine Zeile für jeden Agenten, der antwortet, als host:port (hier 10.114.0.6:7450). Schreiben Sie host:port, um nur einen Port zu lesen. Der RCM-Host braucht kein Pairing-Fenster: RCM findet seinen Agenten in seiner eigenen Registry. Vergleichen Sie den Certificate fingerprint mit der Installer-Ausgabe (die Zeile Pairing: der Replica): Sie müssen übereinstimmen. Der Status des zweiten Hosts ist Ready to link. Die Spalte Member ID zeigt den Namen, den der Host im Cluster erhält: <host name>-<role>, zum Beispiel hq27d-m-master. Das Instanz-Suffix (-fb50) wird nur hinzugefügt, wenn der Host mehrere Agenten hat.

Prüfung der Hosts
Prüfung der Hosts

Jede Zeile hat ein Kontrollkästchen, den Port, die Instanz und den Knoten-Port. Link übernimmt nur die angekreuzten Zeilen. Eine Zeile mit Fehler kann nicht angekreuzt werden und hält die anderen nicht auf. Unter der Tabelle schreibt RCM 2027.5.12 Zeilen wie 10.114.0.6, no agent: closed or no answer: 7451-7459: Sie nennen die Pairing-Ports des Hosts, auf denen kein anderer Agent antwortet. Sie sind keine Fehler.

Der master ist der Host, auf dem die Produktionsdatenbanken liegen werden. Klicken Sie auf Link und bestätigen Sie:

Bestätigung
Bestätigung

Fortschritt: „Joining → Joined → The node starts → Running“. Im Lauf dauerte die Verknüpfung 56 Sekunden (der Lauf vom 2026-11-17: 47 Sekunden).

Fortschritt der Verknüpfung
Fortschritt der Verknüpfung
Fertig
Fertig

Die Overview zeigt jetzt zwei Knoten: den Master und die Replica. Direkt nach der Verknüpfung kann die Replica eine Minute lang „stale“ sein; danach ist sie „online“.

Overview: zwei Knoten
Overview: zwei Knoten

Wenn Sie erneut auf Check hosts für einen Host klicken, der bereits verknüpft ist, zeigt es, dass kein Agent auf den Pairing-Ports antwortet, oder dass der Host nicht erreichbar ist: Das Pairing-Fenster auf diesem Host ist geschlossen, und ebenso sein Pairing-Port in der Firewall. Dies ist kein Fehler.

Ein Host in einen Cluster, der einen Master hat. Eine Verknüpfung einer einzelnen Zeile wird mit lone_master abgelehnt: Geben Sie an, was aus der Zeile wird. Fügen Sie -replica-of <master member> für eine Replica dieses Masters hinzu, oder -new-master (das Kontrollkästchen auf der Link hosts- Seite) für einen eigenen Master.

Schritt 4. Datenbankordner auf dem Master

Auf dem Master muss sich die Datenbank in einem Ordner befinden, auf den der Benutzer firebird zugreifen kann:

Command
sudo install -d -o firebird -g firebird -m 0770 /databases/master
# example: the sample database from the kit
sudo cp /opt/firebird/examples/empbuild/employee.fdb /databases/master/
sudo chown firebird:firebird /databases/master/employee.fdb

Auf der Replica müssen Sie nichts vorbereiten: Die Schaltfläche Create folder im Initialize-Dialog erstellt den Ordner für die Kopien (Schritt 6).

Schritt 5. Die Datenbanken auf dem Master registrieren

Databases → in der Tabelle Nodes, in der Zeile des Masters → Enroll.

  • Folder path on that server: /databases/master, recursive.
  • Include file mask: *.fdb.
  • Sync tracking tables: die Tabellen, deren Zeilenanzahlen die Schaltfläche Verify vergleicht. Sie legen die Liste für jede Datenbank fest, die Sie registrieren. Lassen Sie das Feld leer: Dann zählt die Datenbank ihre Publikationstabellen. Für eine Datenbank, die bereits verwaltet wird, ändern Sie die Liste auf der Seite der Master-Datenbank.
Enroll-Formular
Enroll-Formular

Preview → wählen Sie die Datenbanken aus → Enroll selected und bestätigen Sie.

Bestätigung der Registrierung
Bestätigung der Registrierung

Das Ergebnis ist „Enrolled: 2.“ und ein Hinweis: Firebird des Masters muss neu gestartet werden. Der Text „No new databases matched.“ darunter ist kein Fehler: Die Datenbanken sind bereits registriert.

Ergebnis der Registrierung
Ergebnis der Registrierung

Die Datenbanken warten auf den Neustart:

Wartet auf den Neustart
Wartet auf den Neustart

Klicken Sie auf Restart Firebird of the master in der Zeile einer beliebigen Datenbank des Masters (ein Neustart genügt für alle) und bestätigen Sie. Alle Verbindungen zu Firebird des Masters brechen für einige Sekunden ab (4 Sekunden im Lauf): Wählen Sie einen guten Zeitpunkt.

Neustart von Firebird des Masters
Neustart von Firebird des Masters

Nach dem Neustart ist der Master-Knoten CONFIGURED. Jede Datenbank hat das Badge publication OFF, und die Replica zeigt „not paired“.

Nach dem Neustart
Nach dem Neustart

Schritt 6. Die Replica initialisieren

In der Datenbankzeile, in der Replica-Spalte → Initialize. Der Dialog hat den Titel „Initialize database?“.

Initialize-Dialog
Initialize-Dialog
  • Publication. Solange die Publikation der Datenbank aus ist, schreibt Firebird die Änderungen nicht ins Journal, und die Replica erhält nichts. Der Dialog sagt das und zeigt eine Schaltfläche Sync publication and initialize. Klicken Sie darauf: RCM fügt alle Tabellen mit einem Primär- oder Unique-Key zur Publikation hinzu und startet die Initialisierung sofort. Die Schaltfläche Initialize hilft nicht, solange die Publikation aus ist: Der Master-Knoten lehnt ab (publication_off).
  • Replica folder: Der Dialog schlägt /databases/replica/<replica node> vor, im Lauf /databases/replica/hq27d-r-replica. Jeder Replica- Knoten eines Hosts braucht seinen eigenen Ordner. Behalten Sie ihn. Wenn das Feld „✗ The folder does not exist“ zeigt, klicken Sie auf Create folder; dann sehen Sie „✓ The folder was created.“ Die Kopie geht nach /databases/replica/hq27d-r-replica/hq27d-m-master/. Für die nächsten Datenbanken ist der Ordner bereits gesetzt, und der Dialog ändert ihn nicht.
  • Method: Smooth (die Standardeinstellung). Es prüft die schreibenden Transaktionen vor der Sperre. Standard sperrt die Datenbank sofort.
  • Die Kontrollkästchen „Let … stop its Firebird for this reinit“ und „Remove the old replica if space is short“ brauchen Sie für eine neue Replica nicht.

Verbinden Sie die Anwendungen nach der ersten Publikationssynchronisierung neu. Eine Verbindung zur Master-Datenbank, die geöffnet wurde, bevor die Publikation eingeschaltet wurde, wird nicht journalisiert, bis sie sich erneut verbindet. Im Lauf vom 2026-11-17 schrieb eine Verbindung, die vor Sync publication and initialize geöffnet wurde, etwa 9.500 Zeilen nach der Kopie, und die Replica erhielt keine davon. RCM zeigte „Ok“ für beide Seiten; nur Verify (Schritt 9) zeigte „Not ok (desynced)“. Zeilen einer neuen Verbindung wurden sofort repliziert. Also nach der ersten Sync publication einer Datenbank: Verbinden Sie die Anwendungen neu (oder starten Sie Firebird des Masters neu) und führen Sie dann Verify ohne Schreibvorgänge aus. Wenn die Replica Zeilen vermisst, führen Sie eine Reinit aus (Schritt 7).

Erste Initialisierung unter Last. Solange das Archiv des Masters noch kein Journal-Segment hat, kann Smooth ablehnen, wenn in die Datenbank geschrieben wird. Die Datenbankzeile zeigt long_transactions: … the archive holds no segment yet und einen Hinweis in der UI-Sprache:

Ablehnung der Smooth-Methode
Ablehnung der Smooth-Methode

Im Lauf geschah dies auch nach Sync publication and initialize (Befund G-04 im Bericht). Die Publikation ist zu diesem Zeitpunkt bereits an. Warten Sie, bis die Master-Datenbank „archive: 1 seg“ oder mehr zeigt (15 Sekunden im Lauf), und klicken Sie erneut auf Initialize mit der Methode Smooth. Oder wählen Sie Standard. Im Lauf vom 2026-11-17 (≈49 Transaktionen/s von einer Verbindung) wurde Smooth nicht abgelehnt.

Der Fortschritt zeigt sich in der Datenbankzeile: SPACE CHECK → LOCKING → COPYING TO NODE (%) → UNLOCKING → SEEDING → RESTARTING REPLICA. Der Fortschritt ist auch nach einem Neuladen der Seite sichtbar. Die Schaltfläche Initialize ist während dieser Zeit inaktiv.

Fortschritt der Initialisierung
Fortschritt der Initialisierung

Nach der Kopie startet der Replica-Knoten Firebird der Replica selbst zur geplanten Minute neu. Die Zeile sagt, wann; die Schaltfläche Restart Firebird of the replica erledigt es sofort. Alle Verbindungen zu Firebird der Replica brechen in diesem Moment ab.

Wartet auf den Neustart von Firebird der Replica
Wartet auf den Neustart von Firebird der Replica

Eine große Datenbank funktioniert genauso. Im Lauf wurde bulk.fdb (3,13 GB) mit der Schaltfläche Sync publication and initialize initialisiert, ohne Last darauf:

Kopie der großen Datenbank
Kopie der großen Datenbank

Es ist fertig, wenn der Master und die Replica „Ok“ zeigen und das „last applied seg“ der Replica das „last seg“ des Masters erreicht. Eine Datenbank ohne neue Schreibvorgänge (hier bulk.fdb) zeigt „Pending“ mit Segment 0 für die Replica: Das ist normal.

Beide Datenbanken bereit
Beide Datenbanken bereit

Messungen des Laufs (employee.fdb unter einer Last von ≈55 Transaktionen/s):

Datenbank Größe Master: von Anfang bis Ende Sperre auf dem Master Paar „Ok“
employee.fdb 4 MB 0,7 s 0,35 s nach ≈1 min (wartete auf den Replica-Neustart)
bulk.fdb 3,13 GB 64 s (≈55 MB/s) 59 s nach ≈2 min

Der Lauf vom 2026-11-17 (Kit 2027.2.33): employee.fdb (3 MB) dauerte 3 Sekunden

Auf dem Master, bulk.fdb (167 MB) 15 Sekunden. Die Replica-Seite wurde ≈40 Sekunden nach dem Start gepaart (sie wartete auf den Neustart von Firebird der Replica).

Während der Sperre arbeitet die Master-Datenbank: Die Änderungen gehen in die .delta-Datei.

Veröffentlichung später. Sie brauchen die Schaltfläche Sync publication einer Master-Datenbank, wenn neue Tabellen in der Datenbank erscheinen. Sie bringt die Veröffentlichung in einer Transaktion mit den Tabellen in Übereinstimmung; Firebird startet nicht neu.

Sync publication
Sync publication

Publication tables zeigt, welche Tabellen repliziert werden. Sie können eine Tabelle ohne Schlüssel nicht veröffentlichen: Geben Sie ihr einen Primärschlüssel.

Publication tables
Publication tables

Schritt 7. Reinitialisierung

Sie brauchen sie, wenn die Replica vom Master abweicht oder wenn der Knoten sie anfordert (NEEDS_REINIT). In der Replica-Zeile → Reinit, Methode Smooth. Es gibt bereits ein Segmentarchiv, und die Smooth-Methode funktioniert unter Last. Sie wartet auf schreibende Transaktionen, die älter als die Journal-Historie sind, und zeigt sie an.

Reinit, smooth method
Reinit, smooth method

Der Fortschritt ist derselbe wie bei der Initialisierung. Eine Reinit benötigt normalerweise keinen Neustart von Firebird der Replica. Im Lauf vom 2026-11-17 startete die Reinit von employee.fdb Firebird der Replica neu: Planen Sie eine Unterbrechung der Verbindungen zur Replica ein. Diese Reinit dauerte 4 Sekunden auf dem Master bei ≈49 Transaktionen/s; nachdem die Schreibvorgänge aufhörten, stimmten die Zeilenzahlen überein (14.418 Zeilen in der Lasttabelle auf beiden Seiten).

Copy at the reinit
Copy at the reinit

Messungen des Laufs:

Datenbank Last Zeit Sperre Sonstiges
employee.fdb ≈55 Transaktionen/s 1,7 s 0,32 s 417 Transaktionen aus den Segmenten wiederabgespielt
bulk.fdb keine 61 s 55 s kein Neustart von Firebird der Replica

Nach einer Smooth-Reinit unter Last kann die Replica den info-Alert replication_conflict_resolved anzeigen („Record being inserted … already exists, updating instead“): Die Replica spielte Transaktionen erneut ab, die bereits in der Kopie waren. Die Daten stimmen überein: Im Lauf stimmten die Zeilenzahlen aller Tabellen überein. Sie können den Alert bestätigen (Befund G-07 im Bericht).

Schritt 8. Wenig Speicherplatz auf der Replica

Das Replica-Volume benötigt frei ≥ 105 % der Datenbankgröße plus 1 GB über der alten Kopie: Die alte Kopie bleibt bis zum Ende, und die neue Datei nimmt sofort ihre volle Größe ein. Wenn der Platz knapp ist, zeigt der Dialog, wie viel Platz benötigt wird, wie viel frei ist und wie viel die alte Kopie belegt (eine RCM-Schätzung; der Replica-Knoten entscheidet). Wenn der Platz ohne die alte Kopie ausreicht, schlägt der Dialog das Kästchen Remove the old replica if space is short vor.

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

Mit dem Kästchen stoppt der Replica-Knoten nach der Sperre auf dem Master Firebird der Replica, löscht die alte Kopie und startet Firebird erneut. Im Lauf (2,97 GB frei, die neue Kopie benötigt 3,29 GB, die alte Kopie ist 3,13 GB) dauerte die Reinit von bulk.fdb mit dem Kästchen 65 Sekunden. Ohne das Kästchen verweigert der Knoten mit insufficient disk space on replica.

Der Dialog kann keine Zahlen anzeigen, wenn nur der Mindestwert von 1 GB fehlt. Im Lauf vom 2026-11-17 (1,1 GB frei, die Datenbank ist 167 MB) zeigte der Dialog keine Schätzung, und die Reinit ohne das Kästchen schlug in 3 Sekunden fehl. Die Datenbankzeile und die Seite Commands zeigten den Grund: insufficient disk space on replica: need 184125850 bytes (105% of the database) + 1073741824 bytes free_space_floor_gb; free 1152950272 … Removing the old replica copy would free 175357952 bytes: ask again with remove_old_replica. Dieselbe Reinit mit dem Kästchen dauerte 9 Sekunden.

Risiko des Kästchens. Während die Kopie läuft, gibt es keine Replica dieser Datenbank. Wenn die Reinit fehlschlägt, ist das Paar NEEDS_REINIT, die Replica hat den Alert replica_removed_for_reinit (warn), und ein erneuter Versuch ist eine neue vollständige Reinit. Eine automatische Reinit löscht die alte Kopie nur, wenn der RCM-Schlüssel auto_reinit.remove_old_replica_when_short aktiv ist (standardmäßig aus).

Schritt 9. Verifikation

Verify in der Replica-Zeile vergleicht COUNT(*) der Tracking-Tabellen auf dem Master und auf der Replica. Es vergleicht nicht die Zeilen selbst. Die Zeile „Table list source“ nennt die Liste: die eigene Liste der Datenbank, die Liste des Knotens, die Publication tables oder RDB$FIELDS. Zeilenzahlen haben Zifferngruppen.

Unter Last ist die Replica einige Sekunden im Rückstand, und Verify liefert „Not ok“ für die Tabellen, in die geschrieben wird:

Verify under load
Verify under load

Ohne Schreibvorgänge stimmen die Zählungen überein:

Verify without load
Verify without load

Eine Tabelle, die in keiner der beiden Datenbanken ist, ist „not in the database“: Das ist keine Abweichung. Eine Tabelle nur auf einer Seite ist „no table“: Das ist eine Abweichung.

Eine sicherere Prüfung ist die Zeilenzahl aller Tabellen auf beiden Seiten, nachdem die Schreibvorgänge aufhören (das Skript ist in der hqbird2027-linux-cluster-runbook.md). Im Lauf stimmten alle 11 Tabellen überein (employee.fdb: 10, bulk.fdb: 1, mit 2.800.000 Zeilen).

Die periodische Prüfung (Data check) ist standardmäßig aus. Klicken Sie auf Turn on for all nodes und bestätigen Sie: Jeder Knoten zählt seine Zeilen, und der Master vergleicht die Zählungen. Sie brauchen keinen Neustart: RCM zeigt „Saved and in force now: the node needs no restart.“ Die erste Prüfung läuft ein Intervall später (standardmäßig 2 Stunden).

Periodic check
Periodic check

Worauf Sie als Nächstes achten sollten

  • Overview: die Knoten, ihr Zustand, das Datenbank-Stammverzeichnis und der Speicherplatz.

    Overview
    Overview
  • Alerts: Probleme von Knoten und Datenbanken. Der Lauf hatte zwei Alerts, und Sie können beide bestätigen: replication_conflict_resolved nach der Smooth-Reinit (Schritt 7) und parse_no_observations auf dem Master („no events parsed from /opt/firebird/replication.log“). Firebird des Masters schreibt nur Fehler in replication.log, daher ist ein leeres Log normal (Befund G-06 im Bericht).

    Alerts
    Alerts

    RCM 2027.5.12 und später (Kit 2027.2.33) kann die Alerts der Schwere warn und höher an einen eigenen Telegram-Bot, einen Webhook oder E-Mail senden. Sie legen die Kanäle in der Datei /opt/hqbirdrcm/rcm.json fest, Schlüssel notify.channels, und starten RCM neu (sudo systemctl restart hqbirdrcm). Der Block Notification channels dieser Seite listet dann die Kanäle auf, jeder mit einer Schaltfläche Send test. Ohne Kanal steht dort „No channel is configured: RCM sends its alerts nowhere.“ Ein Telegram-Kanal:

    json
    "notify": { "channels": [ { "name": "ops", "type": "telegram",
        "token_file": "secrets/telegram-ops.token", "chat_id": "-1001234567890" } ] }

    Der Lauf vom 2026-11-17 prüfte den Block ohne Kanal; es wurde keine Nachricht gesendet.

  • Services (RCM 2027.5.11 und später, Kits ab 2027.2.31): der Master, die Replicas und die Router eines Service sowie die Operationen Switchover, Failover und Rejoin. Dieser Leitfaden behandelt sie nicht: Siehe das RCM-Benutzerhandbuch. Aktualisieren Sie RCM und die Knoten auf dieselbe Version, bevor Sie sie verwenden.

  • Commands: jede RCM-Operation mit ihrem Ergebnis. Die Zeit ist die lokale Zeit des Browsers mit ihrer Zone (zum Beispiel 17:59:45 UTC+1); der Tooltip zeigt die Zeit in UTC. Die Knoten-Logs verwenden UTC.

    Commands
    Commands
  • HQ Monitor: http://<server>:23050/, Benutzername admin, das Passwort steht in /opt/hqbird/conf/access.properties. Es zeigt den Server und die Datenbanken. In den Kits mit Agent 3.1.0 und später hat HQ Monitor die Seite Clusters. Auf dem Master (dem RCM-Host) zeigt sie den Cluster über den Agent, ohne RCM-Einstellungen in HQ Monitor. Auf der Replica nennt sie den Host des RCM und verlinkt auf dessen Konsole. HQ Monitor 1.49.0 hat keinen Replikationszustand und keinen Link zu RCM. Ab Kit 2027.2.33 (Agent 3.4.0) sendet der Agent die Probleme seines Servers auch an Ihre Kanäle: Servers → Notifications.

Den Cluster aktualisieren

Aktualisieren Sie zuerst HQbird RCM, dann die Knoten. Ab Kit 2027.2.31 aktualisiert ein Server, der an kein HQCenter angebunden ist, den Agent, HQ Monitor und fbmcp selbst („Updates without HQCenter“ in hqbird2027-linux-setup-guide.md); ein an ein HQCenter angebundener Server bezieht seine Updates von diesem HQCenter.

Einen Host aus dem Cluster entfernen

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

Der Agent stoppt und deregistriert seine Knoten-Dienste, schließt deren Knoten-Ports, löscht seine Cluster-Zertifikate und setzt cluster.source auf none. Der Knotenordner bleibt (--remove-data löscht ihn). Der Agent, der das RCM ausführt, wird abgelehnt. Der Agent verlässt den Cluster auch von selbst, wenn RCM ihn widerruft oder ihm sein letztes Mitglied entzieht. Eine Deinstallation verlässt immer den Cluster: Eine Neuinstallation im selben Ordner startet frei. Im Lauf vom 2026-11-17 gab der Befehl Cluster: left <cluster id> aus, die Replica-Datenbanken blieben in ihrem Ordner, und RCM zeigte eine Minute später noch den Knoten dieses Hosts. Das Entfernen von HQbird von einem Cluster-Server, auch vom Server, der das RCM ausführt: hqbird2027-removal-guide.md, Abschnitt 4.

Häufige Fehler

Was Sie sehen Ursache Was zu tun ist
publication_off bei der Initialisierung die Veröffentlichung ist aus, oder sie hat keine Tabelle, obwohl die Datenbank Tabellen mit einem Schlüssel hat die Schaltfläche Sync publication and initialize (Schritt 6)
long_transactions … the archive holds no segment yet erste Initialisierung mit der Smooth-Methode, während in die Datenbank geschrieben wird, und das Archiv des Masters ist leer warten Sie auf „archive: 1 seg“ und versuchen Sie Smooth erneut, oder wählen Sie Standard
reinit_pre_publication_transactions eine schreibende Transaktion begann, bevor die Veröffentlichung eingeschaltet wurde, und ist länger als eine Minute offen schließen Sie sie ab (COMMIT oder ROLLBACK) und versuchen Sie es erneut
„✗ The folder does not exist on …“ im Dialog niemand hat den Replica-Ordner erstellt die Schaltfläche Create folder im Dialog, oder install -d -o firebird -g firebird -m 0770 <folder> auf der Replica
„Not ok (desynced)“ in Verify in die Datenbank wird geschrieben, und die Replica ist Sekunden im Rückstand versuchen Sie es ohne Last erneut; sehen Sie sich die Spalte Match an
„Not ok (desynced)“ in Verify ohne Schreibvorgänge; beide Seiten zeigen „Ok“ eine Anwendungsverbindung wurde geöffnet, bevor die Veröffentlichung eingeschaltet wurde: Sie wird nicht journalisiert verbinden Sie die Anwendung neu, dann Reinit (Schritt 6, der Hinweis zur ersten Publication-Synchronisierung)

| Host „nicht erreichbar“ oder „kein Agent“ in Hosts verknüpfen | das Pairing-Fenster des Hosts ist geschlossen (standardmäßig aus, oder die 24 h sind abgelaufen), oder eine Firewall zwischen den Servern blockiert 7450–7459 | Öffnen Sie das Fenster auf dem Host: HQ Monitor → Cluster → Pairing-Fenster für 24 Stunden öffnen, oder fbagent --cluster-pairing on; öffnen Sie den Port in der Cloud-Firewall | | insufficient disk space on replica bei einer Reinitialisierung | die alte Replik bleibt bis zum Ende bestehen, und die neue Datei nimmt ihre volle Größe ein | geben Sie ≥ 105 % der Datenbankgröße + 1 GB über der alten Datei auf dem Replik-Volume frei, oder aktivieren Sie das Kontrollkästchen Alte Replik entfernen, wenn der Speicher knapp ist (Schritt 8) | | Der Knoten erscheint nach Hosts verknüpfen nicht | der RCM-Mirror hat kein signiertes hqclusternode-Release | Releases im Mirror auf der Seite Hosts verknüpfen (Schritt 2) |