HQbird 2027 cluster na Linuxu: master a replika s RCM
Další jazyky: Русский, Português.
Tento průvodce vede od dvou čistých serverů k funkční replice Firebird 5.0.
Vše děláte v prohlížeči, v konzoli RCM, kromě
instalace a jedné složky. Snímky obrazovky pocházejí z běhu
2026-11-17: kit 2027.2.33, RCM a nody 2027.5.12, Ubuntu 24.04,
anglické UI. Zpráva z dřívějšího běhu 2026-11-08:
hqbird2027-rcm-cluster-check-report.ru.md
(ruština, sekce „Прогон 2"). Pouze příkazy, bez snímků obrazovky:
hqbird2027-linux-cluster-runbook.md. Každá stránka RCM podrobně:
uživatelská příručka RCM (repozitář hqcluster-node, docs/user-guide/).
Tento průvodce je pro kit 2027.2.24 a novější. Pro kit 2027.2.22 viz verze tohoto souboru z 2026-11-07 v historii gitu.
Kit ke stažení je 2027.2.33 (2026-11-16): agent 3.4.0, HQ Monitor 1.57.0, RCM a nody 2027.5.12, Firebird 5.0.5.1917. Tento průvodce byl s ním ověřen 2026-11-17 (dva servery, Ubuntu 24.04, databáze o velikosti 3 MB a 167 MB): všechny kroky prošly. Text označuje výsledky tohoto běhu jako „běh z 2026-11-17". Snímky obrazovky pocházejí z druhého průchodu téhož dne se stejným kitem (databáze o velikosti 3 MB a 2,88 GB). Ostatní čísla stále pocházejí z běhu z 2026-11-08. Co kity po 2027.2.27 změnily pro cluster:
| Kit | Změna |
|---|---|
| 2027.2.29 (agent 3.1.0, RCM 2027.5.9) | Ve výchozím nastavení žádný cluster (viz níže). Několik agentů jednoho hostitele se může připojit ke clusteru: každý má vlastní párovací port (7450–7459) a port nodu. fbagent --cluster-leave. Stránka Clusters v HQ Monitor |
| 2027.2.30 (RCM 2027.5.10) | Switchover a failover služby, routery |
| 2027.2.31 (agent 3.3.0, RCM 2027.5.11) | Instalátor otevře v terminálu textové rozhraní (krok 1). Stránky Services v RCM. Server, který není připojen k žádnému HQCenter, aktualizuje agent, HQ Monitor a fbmcp sám |
| 2027.2.33 (agent 3.4.0, RCM 2027.5.12) | RCM posílá svá upozornění do Telegramu, webhooku nebo e-mailem („What to watch next"). Cluster ze dvou Docker kontejnerů: průvodce Dockerem |
Všechny změny: What’s New.
Kity s agentem (fbagent) 3.1.0 a novějším (od 2027.2.29) ve výchozím nastavení nevytvářejí cluster: žádné RCM, žádné párovací okno a clusterové porty zůstávají ve firewallu zavřené. V kroku 1 zapnete RCM na masteru a discovery režim na replice.
Čas: ≈30 minut plus kopie databází (≈1 minuta na 3 GB na síti 1 Gbit/s).
Co získáte
| Server 1 | Server 2 | |
|---|---|---|
| Role | master + konzole RCM | replika |
| Databáze | /databases/master/*.fdb |
/databases/replica/<replica node>/<master node>/*.fdb |
| Služby | firebird, hqbirdfbagent-fb50, hqbirdmonitor-fb50, fbmcp, hqbirdrcm, hqclusternode-master-p3050 |
totéž, ale hqclusternode-replica-p3050 a žádné hqbirdrcm (starší kit tam nechá vlastní RCM, zastavené) |
Co potřebujete
- Dva linuxové servery x86-64 (ověřeno na Ubuntu 24.04), 2 jádra, 4 GB paměti.
- Místo na disku. Master: volno ≥ 105 % velikosti databáze (soubor
.deltaběhem zámku roste). Replika: volno ≥ 105 % velikosti databáze plus minimumlimits.free_space_floor_gb(výchozí 1 GB). Reinit přes existující repliku ponechá starý soubor až do konce, takže svazek repliky potřebuje přibližně 2 × velikost databáze. S políčkem Remove the old replica if space is short (krok 8) stačí 105 % plus minimum. - Síť mezi servery: porty 3050, 7051, 7443, 7444, 7450. To jsou porty první instance serveru (slot 0). Druhá instance serveru používá párovací port 7451 a port nodu 7052.
- Váš PC dosáhne na port 7444 masteru (konzole RCM), přímo nebo přes SSH tunel.
- Uživatel se
sudo.
Firewall. Instalátor otevře porty v zapnutém firewalld nebo ufw (s libovolným systémovým jazykem): 3050 a 23050 vždy, clusterové porty pouze pro volby z kroku 1. Master: 7443, 7444, 7051. Replika: 7450, 7051. Agent znovu zavře 7450, když párovací okno skončí nebo je hostitel propojen. Na Ubuntu je ufw obvykle vypnutý. Pak instalátor zapíše jeden řádek, například na masteru:
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. V cloudu zavřete porty cloudovým firewallem: zvenčí pouze vaše adresa; mezi servery interní síť.
Níže jsou adresy z běhu: master 10.114.0.5, replika
10.114.0.6 (privátní síť). Použijte vlastní adresy.
Krok 1. Instalace na oba servery
Na každém serveru:
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.runV terminálu instalátor otevře své textové rozhraní (kity od
2027.2.31). První stránka má řádek Cluster RCM off, discovery mode off. Otevřete Cluster a změňte jeden řádek:
| Řádek stránky Cluster | Master | Replika |
|---|---|---|
| Cluster manager (RCM) | on |
off |
| Discovery mode (24 h) | off (tento agent spouští RCM) |
on |
Řádky Cluster id (výchozí: název hostitele), RCM admin password
(výchozí: vygenerované) a Pairing port (výchozí: první volný,
7450) mohou zůstat tak, jak jsou. Vraťte se zpět (Esc) a zvolte Install.
Instalátor zobrazí plán: stiskněte Enter. Poté se zeptá Nothing on this host was changed yet. Start the install now?. Kurzor je na No: přesuňte jej
na Yes a stiskněte Enter. Instalátor sám doplní chybějící knihovny (například
libtommath1). Textové rozhraní v plném rozsahu:
hqbird2027-linux-setup-guide.md.
S --no-tui a v kitech 2027.2.29–2027.2.30 se instalátor ptá na
otázky. První je Install as planned? Yes/No: odpovězte y. Poté
se zeptá na dvě clusterové otázky. Odpověď je ve výchozím nastavení No (Enter):
| Otázka | Master | Replika |
|---|---|---|
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] |
neptá se: tento agent spouští RCM | y |
Nebo zadejte odpovědi jako volby: v terminálu nastaví hodnoty
stránky Cluster před jejím otevřením. Použijte je také pro běh bez terminálu:
--yes samo o sobě znamená No pro obě.
sudo sh hqbird2027-fb50-linux-$V.run --rcm on # master
sudo sh hqbird2027-fb50-linux-$V.run --cluster-pairing on # replicaInstalace trvá přibližně jednu minutu (běh z 2026-11-17: 61 sekund
na masteru, 43 sekund na replice). Konec výstupu na
masteru s kitem 2027.2.33 (hash je zde zkrácen; cluster id
níže uvedených příkladů je hq27d-m, z běhu z 2026-11-08):
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)Na replice:
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 hostStarší kit vypíše na masteru Pairing: not opened (this agent runs the RCM).
Zapište si řádky RCM: a CA hash: masteru a
řádek Pairing: repliky. V kroku 3 budete potřebovat fingerprint.
Starší kity (agent před 3.1.0, například kit 2027.2.27) se na clusterové otázky neptají. Nainstalují RCM na každý server a otevřou párovací okno všude. Použijte RCM masteru; RCM druhého serveru se po propojení sám zastaví.
Později, bez instalátoru. V HQ Monitor serveru otevřete Clusters, sekci Cluster on this server. Na masteru: Enable the cluster console (RCM); HQ Monitor otevře 7443 a 7444 ve firewallu. Na replice: Open the pairing window for 24 hours. Totéž s příkazy, jako uživatel agenta:
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 # replicaDokud je párovací okno otevřené, agent otevře svůj párovací port ve firewallu. Port zavře, když okno skončí nebo je hostitel propojen.
Výstup neobsahuje žádná hesla. Heslo RCM je v souboru z
řádku Password:, heslo SYSDBA je v
/root/fbagent-install-sysdba.txt a heslo HQ Monitor je v
/opt/hqbird/conf/access.properties.
Licenci instalovat nemusíte: nový agent sám spustí 7denní zkušební verzi a clusterové nody fungují.
Krok 2. Přihlášení do RCM
Otevřete adresu z řádku RCM: masteru. Pokud je port 7444 pro váš PC
zavřený, použijte SSH tunel a https://localhost:7444:
ssh -L 7444:127.0.0.1:7444 <user>@<master>Pokud je port 7444 na vašem PC obsazený, použijte jiný místní port, například
-L 17444:127.0.0.1:7444 a https://localhost:17444.
Prohlížeč varuje před certifikátem: certifikát RCM podepsala clusterová CA.
Přihlašovací stránka zobrazuje Cluster CA hash: porovnejte jej s
řádkem CA hash: z výstupu instalátoru. Pokud se shodují, nainstalujte certifikát CA
(odkaz Download the CA certificate (hqcluster-ca.crt) na
stejné stránce) jako důvěryhodný, nebo přijměte varování. Pokud se neshodují,
nepřihlašujte se a zkontrolujte adresu.
Uživatelské jméno je rcmadmin. Heslo je v souboru z řádku Password::
# the path is from the Password: line of your output
sudo cat /opt/hqbird/fbagent-fb50/clusterca/hq27d-m/rcm-initial-passwordRCM okamžitě požádá o nové heslo (alespoň 12 znaků):
RCM před 2027.5.12 mohl tuto stránku načítat znovu a znovu. RCM 2027.5.12 (kit 2027.2.33) obsahuje opravu.
Po změně hesla agent masteru sám do jedné minuty smaže soubor
rcm-initial-password. U staršího kitu má i druhý server vlastní RCM.
Po propojení agent přesune tento dřívější cluster do složky cluster/left/.
Agent 3.1.0 tam smaže svůj rcm-initial-password; starší agent ne.
Pak soubor smažte sami:
# on server 2, after step 3
sudo find /opt/hqbird -name rcm-initial-password
sudo rm <path from the find output>Soubor /opt/hqbirdrcm/initial-admin.json nemažte: obsahuje
pouze hash starého hesla, a bez něj RCM, který ztratil svůj
uživatelský soubor, začne s výchozím heslem.
Po změně hesla RCM okamžitě otevře Settings → Link hosts: cluster
zatím nemá žádné nody. Seznam Releases in the mirror zobrazuje
verze hqbirdrcm a hqclusternode, ze kterých agenti instalují
nody.
Krok 3. Propojení hostitelů
První řádek seznamu je již vyplněn (hostitel RCM). Přidejte druhý řádek: adresu repliky, kterou master dosáhne. Zadejte IP, pokud servery nemají společný DNS: RCM řetězec ponechá tak, jak je, a uzly se podle něj navzájem najdou.
Klikněte na Check hosts. U hostitele bez portu RCM čte párovací
porty 7450–7459 a zobrazí jeden řádek pro každého agenta, který odpoví,
jako host:port (zde 10.114.0.6:7450). Zapište host:port, chcete-li
číst pouze jeden port. Hostitel RCM nepotřebuje párovací okno: RCM najde
svého agenta ve svém vlastním registru. Porovnejte Certificate
fingerprint s výstupem instalátoru (řádek Pairing: repliky): musí se
shodovat. Stav druhého hostitele je Ready to link.
Sloupec Member ID zobrazuje název, který hostitel v clusteru dostane:
<host name>-<role>, například hq27d-m-master. Přípona instance
(-fb50) se přidá pouze tehdy, když má hostitel několik agentů.
Každý řádek má zaškrtávací políčko, port, instanci a port uzlu. Link
bere pouze zaškrtnuté řádky. Řádek s chybou nelze zaškrtnout a nezastaví
ostatní. Pod tabulkou RCM 2027.5.12 zapisuje řádky jako 10.114.0.6, no agent: closed or no answer: 7451-7459: pojmenovávají párovací porty
hostitele, kde neodpovídá žádný jiný agent. Nejsou to chyby.
Master je hostitel, kde budou produkční databáze. Klikněte na Link a potvrďte:
Průběh: „Joining → Joined → The node starts → Running“. Při běhu propojení trvalo 56 sekund (běh z 2026-11-17: 47 sekund).
Overview nyní zobrazuje dva uzly: master a repliku. Hned po propojení může být replika jednu minutu „stale“; poté je „online“.
Pokud znovu kliknete na Check hosts u hostitele, který je již propojen, zobrazí, že na párovacích portech neodpovídá žádný agent, nebo že hostitel je nedostupný: párovací okno na tomto hostiteli je zavřené, a stejně tak jeho párovací port ve firewallu. Není to chyba.
Jeden hostitel do clusteru, který má master. Propojení jednoho řádku
je odmítnuto s lone_master: řekněte, čím se řádek stane. Přidejte
-replica-of <master member> pro repliku tohoto masteru, nebo
-new-master (zaškrtávací políčko na stránce Link hosts) pro vlastní
master.
Krok 4. Složka databáze na masteru
Na masteru musí být databáze ve složce, ke které má uživatel
firebird přístup:
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.fdbNa replice nemusíte nic připravovat: tlačítko Create folder v dialogu Initialize vytvoří složku pro kopie (krok 6).
Krok 5. Zaevidování databází na masteru
Databases → v tabulce Nodes, v řádku masteru → Enroll.
- Folder path on that server:
/databases/master, recursive. - Include file mask:
*.fdb. - Sync tracking tables: tabulky, jejichž počty řádků porovnává tlačítko Verify. Seznam nastavíte pro každou databázi, kterou zaevidujete. Ponechte pole prázdné: databáze pak počítá své publikační tabulky. U databáze, která je již spravována, změňte seznam na stránce databáze masteru.
Preview → vyberte databáze → Enroll selected a potvrďte.
Výsledek je „Enrolled: 2.“ a nápověda: Firebird masteru je nutné restartovat. Text „No new databases matched.“ pod ním není chyba: databáze jsou již zaevidovány.
Databáze čekají na restart:
Klikněte na Restart Firebird of the master v řádku kterékoli databáze masteru (jeden restart stačí pro všechny) a potvrďte. Všechna připojení k Firebird masteru se na několik sekund přeruší (v běhu 4 sekundy): zvolte vhodný čas.
Po restartu je uzel masteru CONFIGURED. Každá databáze má odznak
publication OFF a replika zobrazuje „not paired“.
Krok 6. Inicializace repliky
V řádku databáze ve sloupci repliky → Initialize. Dialog má titulek „Initialize database?“.
- Publication. Dokud je publikace databáze vypnutá, Firebird
nezapisuje změny do žurnálu a replika nic nedostane. Dialog to říká a
zobrazuje tlačítko Sync publication and initialize. Klikněte na něj:
RCM přidá všechny tabulky s primárním nebo jedinečným klíčem do
publikace a inicializaci spustí okamžitě. Tlačítko Initialize při
vypnuté publikaci nepomůže: uzel masteru odmítne (
publication_off). - Replica folder: dialog navrhuje
/databases/replica/<replica node>, v běhu/databases/replica/hq27d-r-replica. Každý uzel repliky hostitele potřebuje vlastní složku. Ponechte ji. Pokud pole zobrazuje „✗ The folder does not exist“, klikněte na Create folder; poté uvidíte „✓ The folder was created.“ Kopie jde do/databases/replica/hq27d-r-replica/hq27d-m-master/. Pro další databáze je složka již nastavena a dialog ji nemění. - Method: Smooth (výchozí). Před uzamčením zkontroluje zapisující transakce. Standard databázi uzamkne okamžitě.
- Pro novou repliku nepotřebujete políčka „Let … stop its Firebird for this reinit“ a „Remove the old replica if space is short“.
Po první synchronizaci publikace znovu připojte aplikace. Připojení k databázi masteru, které bylo otevřeno před zapnutím publikace, se do žurnálu nezapisuje, dokud se znovu nepřipojí. V běhu z 2026-11-17 připojení otevřené před Sync publication and initialize zapsalo po kopii asi 9 500 řádků a replika z nich nedostala žádný. RCM zobrazoval „Ok“ pro obě strany; pouze Verify (krok 9) zobrazil „Not ok (desynced)“. Řádky nového připojení se replikovaly okamžitě. Takže po první Sync publication databáze: znovu připojte aplikace (nebo restartujte Firebird masteru), poté spusťte Verify bez zápisů. Pokud replice chybí řádky, spusťte reinit (krok 7).
První inicializace pod zátěží. Dokud archiv masteru nemá žádný
segment žurnálu, Smooth může odmítnout, pokud se do databáze zapisuje.
Řádek databáze zobrazuje
long_transactions: … the archive holds no segment yet a nápovědu v
jazyce UI:
V běhu se to stalo i po Sync publication and initialize (zjištění G-04 ve zprávě). Publikace je v tomto okamžiku již zapnutá. Počkejte, dokud databáze masteru nezobrazí „archive: 1 seg“ nebo více (v běhu 15 sekund), a klikněte znovu na Initialize s metodou Smooth. Nebo zvolte Standard. V běhu z 2026-11-17 (≈49 transakcí/s z jednoho připojení) Smooth odmítnut nebyl.
Průběh se zobrazuje v řádku databáze: SPACE CHECK → LOCKING → COPYING TO NODE (%) → UNLOCKING → SEEDING → RESTARTING REPLICA. Průběh je viditelný i po znovunačtení stránky. Tlačítko Initialize je během této doby neaktivní.
Po kopii uzel repliky sám restartuje Firebird repliky v naplánované minutě. Řádek uvádí kdy; tlačítko Restart Firebird of the replica to provede okamžitě. V tomto okamžiku se přeruší všechna připojení k Firebird repliky.
Velká databáze funguje stejně. V běhu byla bulk.fdb (3,13 GB)
inicializována tlačítkem Sync publication and initialize bez zátěže:
Hotovo je, když master i replika zobrazují „Ok“ a „last applied seg“
repliky dosáhne „last seg“ masteru. Databáze bez nových zápisů (zde
bulk.fdb) zobrazuje pro repliku „Pending“ se segmentem 0: to je
normální.
Měření běhu (employee.fdb pod zátěží ≈55 transakcí/s):
| Databáze | Velikost | Master: od začátku do konce | Uzamčení na masteru | Pár „Ok“ |
|---|---|---|---|---|
employee.fdb |
4 MB | 0,7 s | 0,35 s | po ≈1 min (čekalo se na restart repliky) |
bulk.fdb |
3,13 GB | 64 s (≈55 MB/s) | 59 s | po ≈2 min |
Běh z 2026-11-17 (kit 2027.2.33): employee.fdb (3 MB) trval 3 sekundy
na masteru bulk.fdb (167 MB) 15 sekund. Strana repliky byla spárována
≈40 sekund po startu (čekala na restart Firebird na
replice).
Během zámku master databáze funguje: změny jdou do souboru .delta.
Publikace později. Potřebujete tlačítko Sync publication na master databázi, když se v databázi objeví nové tabulky. Srovná publikaci s tabulkami v jedné transakci; Firebird se nerestartuje.
Publication tables ukazuje, které tabulky se replikují. Tabulku nelze publikovat bez klíče: dejte jí primární klíč.
Krok 7. Reinitializace
Potřebujete ji, když se replika liší od masteru, nebo když o ni uzel požádá
(NEEDS_REINIT). V řádku repliky → Reinit, metoda
Smooth. Archiv segmentů už existuje a metoda smooth funguje
i pod zátěží. Čeká na zapisující transakce, které jsou starší než
historie žurnálu, a zobrazí je.
Průběh je stejný jako při inicializaci. Reinit obvykle
nepotřebuje restart Firebird na replice. Při běhu 2026-11-17
reinit employee.fdb restartoval Firebird na replice: počítejte s
přerušením spojení k replice. Tento reinit trval 4 sekundy na
masteru při ≈49 transakcích/s; po zastavení zápisů se počty řádků
shodovaly (14 418 řádků v zátěžové tabulce na obou stranách).
Měření běhu:
| Databáze | Zátěž | Čas | Zámek | Ostatní |
|---|---|---|---|---|
employee.fdb |
≈55 transakcí/s | 1,7 s | 0,32 s | 417 transakcí přehraných ze segmentů |
bulk.fdb |
žádná | 61 s | 55 s | žádný restart Firebird na replice |
Po smooth reinitu pod zátěží může replika zobrazit upozornění info
replication_conflict_resolved („Record being inserted … already exists,
updating instead“): replika přehrála transakce, které už byly v
kopii. Data se shodují: při běhu se počty řádků všech tabulek shodovaly.
Upozornění můžete potvrdit (zjištění G-07 ve zprávě).
Krok 8. Málo místa na disku na replice
Svazek repliky potřebuje volných ≥ 105 % velikosti databáze plus 1 GB nad starou kopií: stará kopie zůstává až do konce a nový soubor zabere svou plnou velikost najednou. Pokud je místa málo, dialog ukáže, kolik místa je potřeba, kolik je volného a kolik zabírá stará kopie (odhad RCM; rozhoduje uzel repliky). Pokud místo stačí i bez staré kopie, dialog nabídne zaškrtávací pole Remove the old replica if space is short.
S tímto polem uzel repliky po zámku na masteru zastaví
Firebird na replice, smaže starou kopii a znovu spustí Firebird.
Při běhu (2,97 GB volných, nová kopie potřebuje 3,29 GB, stará kopie
3,13 GB) trval reinit bulk.fdb s tímto polem 65 sekund. Bez
pole uzel odmítne s insufficient disk space on replica.
Dialog nemusí ukázat žádná čísla, když chybí jen spodní hranice 1 GB. Při
běhu 2026-11-17 (1,1 GB volných, databáze má 167 MB) dialog neukázal
žádný odhad a reinit bez pole selhal za 3 sekundy. Řádek databáze a stránka Commands ukázaly důvod: 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. Stejný reinit s polem trval 9 sekund.
Riziko pole. Zatímco kopie běží, neexistuje replika této databáze. Pokud reinit selže, pár je
NEEDS_REINIT, replika má upozorněníreplica_removed_for_reinit(warn) a opakování je nový plný reinit. Automatický reinit smaže starou kopii jen tehdy, když je zapnutý klíč RCMauto_reinit.remove_old_replica_when_short(ve výchozím stavu vypnutý).
Krok 9. Ověření
Verify v řádku repliky porovnává COUNT(*) sledovacích tabulek na
masteru a na replice. Neporovnává samotné řádky.
Řádek „Table list source“ uvádí seznam: vlastní seznam databáze,
seznam uzlu, tabulky publikace nebo RDB$FIELDS. Počty řádků mají
oddělené číselné skupiny.
Pod zátěží replika zaostává o několik sekund a Verify dá „Not ok“ pro tabulky, do kterých se právě zapisuje:
Bez zápisů se počty shodují:
Tabulka, která není v žádné databázi, je „not in the database“: to není neshoda. Tabulka jen na jedné straně je „no table“: to je neshoda.
Bezpečnější kontrola je počet řádků všech tabulek na obou stranách po
zastavení zápisů (skript je v
hqbird2027-linux-cluster-runbook.md). Při
běhu se shodovalo všech 11 tabulek (employee.fdb: 10, bulk.fdb: 1, s
2 800 000 řádky).
Periodická kontrola (Data check) je ve výchozím stavu vypnutá. Klikněte na Turn on for all nodes a potvrďte: každý uzel spočítá své řádky a master porovná počty. Restart není potřeba: RCM ukáže „Saved and in force now: the node needs no restart.“ První kontrola proběhne o jeden interval později (ve výchozím stavu 2 hodiny).
Na co se dál zaměřit
-
Overview: uzly, jejich stav, kořen databáze a místo na disku.
Overview -
Alerts: problémy uzlů a databází. Běh měl dvě upozornění a obě můžete potvrdit:
replication_conflict_resolvedpo smooth reinitu (krok 7) aparse_no_observationsna masteru („no events parsed from /opt/firebird/replication.log“). Firebird na masteru zapisuje doreplication.logjen chyby, takže prázdný log je normální (zjištění G-06 ve zprávě).
Alerts RCM 2027.5.12 a novější (kit 2027.2.33) umí posílat upozornění se závažností
warna vyšší do vašeho vlastního Telegram bota, na webhook nebo e-mailem. Kanály nastavíte v souboru/opt/hqbirdrcm/rcm.json, klíčnotify.channels, a restartujete RCM (sudo systemctl restart hqbirdrcm). Blok Notification channels na této stránce pak vypíše kanály, každý s tlačítkem Send test. Bez kanálu hlásí „No channel is configured: RCM sends its alerts nowhere.“ Kanál Telegram:"notify": { "channels": [ { "name": "ops", "type": "telegram", "token_file": "secrets/telegram-ops.token", "chat_id": "-1001234567890" } ] }Běh 2026-11-17 zkontroloval blok bez kanálu; žádná zpráva nebyla odeslána.
-
Services (RCM 2027.5.11 a novější, kity od 2027.2.31): master, repliky a routery služby a operace switchover, failover a rejoin. Tato příručka je nepokrývá: viz uživatelská příručka RCM. Před použitím aktualizujte RCM a uzly na stejnou verzi.
-
Commands: každá operace RCM s výsledkem. Čas je místní čas prohlížeče s jeho zónou (například
17:59:45 UTC+1); popisek ukazuje čas v UTC. Logy uzlů používají UTC.
Commands -
HQ Monitor:
http://<server>:23050/, uživatelské jménoadmin, heslo je v/opt/hqbird/conf/access.properties. Ukazuje server a databáze. V kitech s agentem 3.1.0 a novějším má HQ Monitor stránku Clusters. Na masteru (hostitel RCM) ukazuje cluster přes agenta, bez nastavení RCM v HQ Monitoru. Na replice uvádí hostitele RCM a odkazuje na jeho konzoli. HQ Monitor 1.49.0 nemá stav replikace ani odkaz na RCM. Od kitu 2027.2.33 (agent 3.4.0) agent posílá problémy svého serveru i do vašich kanálů: Servers → Notifications.
Aktualizace clusteru
Nejprve aktualizujte HQbird RCM, potom uzly. Od kitu 2027.2.31 se server, který není připojen k žádnému HQCenter, aktualizuje agenta, HQ Monitor a fbmcp sám („Updates without HQCenter“ v hqbird2027-linux-setup-guide.md); server připojený k HQCenter bere aktualizace z tohoto HQCenter.
Vyřazení hostitele z clusteru
cd /opt/hqbird/fbagent-fb50
sudo ./fbagent --cluster-leaveAgent se zastaví a odregistruje své uzel-služby, zavře jejich porty uzlů,
smaže své clusterové certifikáty a nastaví cluster.source na none. Složka uzlu
zůstává (--remove-data ji smaže). Agent, který provozuje RCM, je
odmítnut. Agent také odejde sám, když jej RCM odvolá nebo odebere jeho poslední
člen. Odinstalace vždy opustí cluster: reinstalace do stejné
složky začíná čistě. Při běhu 2026-11-17 příkaz vypsal Cluster: left <cluster id>, databáze repliky zůstaly ve své složce a RCM
o minutu později stále ukazoval uzel tohoto hostitele. Odstranění HQbird
z clusterového serveru, také
ze serveru, který provozuje RCM:
hqbird2027-removal-guide.md, sekce 4.
Časté chyby
| Co vidíte | Příčina | Co dělat |
|---|---|---|
publication_off při inicializaci |
publikace je vypnutá, nebo nemá žádnou tabulku, ačkoli databáze má tabulky s klíčem | tlačítko Sync publication and initialize (krok 6) |
long_transactions … the archive holds no segment yet |
první inicializace metodou smooth, zatímco se do databáze zapisuje, a archiv masteru je prázdný | počkejte na „archive: 1 seg“ a zkuste znovu Smooth, nebo zvolte Standard |
reinit_pre_publication_transactions |
zapisující transakce začala před zapnutím publikace a je otevřená déle než jednu minutu | dokončete ji (COMMIT nebo ROLLBACK) a zkuste znovu |
| „✗ The folder does not exist on …“ v dialogu | nikdo nevytvořil složku repliky | tlačítko Create folder v dialogu, nebo install -d -o firebird -g firebird -m 0770 <folder> na replice |
| „Not ok (desynced)“ v Verify | do databáze se zapisuje a replika zaostává o sekundy | zkuste znovu bez zátěže; podívejte se na sloupec Match |
| „Not ok (desynced)“ v Verify bez zápisů; obě strany ukazují „Ok“ | spojení aplikace bylo otevřeno před zapnutím publikace: není žurnálováno | znovu připojte aplikaci a pak Reinit (krok 6, poznámka o první synchronizaci publikace) |
| Host „nedostupný“ nebo „žádný agent“ v Link hosts | okno párování hostitele je zavřené (ve výchozím nastavení vypnuto nebo vypršelo 24 h), nebo firewall mezi servery uzavírá 7450–7459 | otevřete okno na hostiteli: HQ Monitor → Clusters → Open the pairing window for 24 hours, nebo fbagent --cluster-pairing on; otevřete port v cloudovém firewallu |
| insufficient disk space on replica při reinicializaci | stará replika zůstává až do konce a nový soubor zabírá svou plnou velikost | uvolněte ≥ 105 % velikosti databáze + 1 GB nad starým souborem na svazku repliky, nebo zaškrtněte políčko Remove the old replica if space is short (krok 8) |
| Uzel se po Link hosts neobjeví | zrcadlo RCM nemá podepsané vydání hqclusternode | Releases in the mirror na stránce Link hosts (krok 2) |