Ова страница је машински преведена. Прочитајте енглески оригинал. English

Остали језици: Русский, Português.

Овај водич води од два чиста сервера до радне Firebird 5.0 реплике. Све радите у прегледачу, у RCM конзоли, осим инсталације и једног фолдера. Снимци екрана потичу из покретања од 2026-11-17: комплет 2027.2.33, RCM и чворови 2027.5.12, Ubuntu 24.04, енглески интерфејс. Извештај ранијег покретања од 2026-11-08: hqbird2027-rcm-cluster-check-report.ru.md (руски, одељак „Прогон 2"). Само команде, без снимака екрана: hqbird2027-linux-cluster-runbook.md. Свака RCM страница детаљно: кориснички приручник за RCM (репозиторијум hqcluster-node, docs/user-guide/).

Овај водич је за комплет 2027.2.24 и новије. За комплет 2027.2.22, погледајте издање овог фајла од 2026-11-07 у git историји.

Комплет који треба преузети је 2027.2.33 (2026-11-16): agent 3.4.0, HQ Monitor 1.57.0, RCM и чворови 2027.5.12, Firebird 5.0.5.1917. Овај водич је проверен са њим 2026-11-17 (два сервера, Ubuntu 24.04, базе од 3 MB и 167 MB): сви кораци су прошли. Текст назива резултате тог покретања „покретањем од 2026-11-17". Снимци екрана потичу из другог пролаза тог дана са истим комплетом (базе од 3 MB и 2.88 GB). Остали бројеви и даље потичу из покретања од 2026-11-08. Шта су комплети после 2027.2.27 променили за кластер:

Комплет Промена
2027.2.29 (agent 3.1.0, RCM 2027.5.9) Подразумевано нема кластера (види испод). Неколико агената једног хоста може се придружити кластеру: сваки има свој порт за упаривање (7450–7459) и порт чвора. fbagent --cluster-leave. Страница Clusters у HQ Monitor
2027.2.30 (RCM 2027.5.10) Switchover и failover сервиса, рутери
2027.2.31 (agent 3.3.0, RCM 2027.5.11) Инсталатер отвара текстуални интерфејс у терминалу (корак 1). Странице Services у RCM. Сервер који није повезан ни са једним HQCenter сам ажурира agent, HQ Monitor и fbmcp
2027.2.33 (agent 3.4.0, RCM 2027.5.12) RCM шаље своја упозорења на Telegram, webhook или е-пошту („Шта даље пратити"). Кластер од два Docker контејнера: упутство за Docker

Све промене: What’s New.

Комплети са agent (fbagent) 3.1.0 и новијим (од 2027.2.29) подразумевано не праве кластер: нема RCM-а, нема прозора за упаривање, а портови кластера остају затворени у заштитном зиду. У кораку 1 укључујете RCM на мастеру и режим откривања на реплици.

Време: ≈30 минута плус копирање база (≈1 минут на 3 GB на мрежи од 1 Gbit/s).

Шта добијате

Сервер 1 Сервер 2
Улога мастер + RCM конзола реплика
Базе /databases/master/*.fdb /databases/replica/<replica node>/<master node>/*.fdb
Сервиси firebird, hqbirdfbagent-fb50, hqbirdmonitor-fb50, fbmcp, hqbirdrcm, hqclusternode-master-p3050 исти, али hqclusternode-replica-p3050 и без hqbirdrcm (старији комплет тамо оставља сопствени RCM, заустављен)

Шта вам је потребно

  • Два Linux x86-64 сервера (проверено на Ubuntu 24.04), 2 језгра, 4 GB меморије.
  • Диск простор. Мастер: слободно ≥ 105 % величине базе (фајл .delta расте током закључавања). Реплика: слободно ≥ 105 % величине базе плус доња граница limits.free_space_floor_gb (подразумевано 1 GB). Реиницијализација преко постојеће реплике задржава стари фајл до краја, тако да волумен реплике треба око 2 × величине базе. Са пољем Remove the old replica if space is short (корак 8), 105 % плус доња граница је довољно.
  • Мрежа између сервера: портови 3050, 7051, 7443, 7444, 7450. То су портови прве инстанце сервера (слот 0). Друга инстанца сервера користи порт за упаривање 7451 и порт чвора 7052.
  • Ваш рачунар може да достигне порт 7444 мастера (RCM конзола), директно или кроз SSH тунел.
  • Корисник са sudo.

Заштитни зид. Инсталатер отвара портове у омогућеном firewalld или ufw (са било којим системским језиком): 3050 и 23050 увек, портове кластера само за опције корака 1. Мастер: 7443, 7444, 7051. Реплика: 7450, 7051. Agent поново затвара 7450 када се прозор за упаривање заврши или када је хост повезан. На Ubuntu-у је ufw обично онемогућен. Тада инсталатер исписује једну линију, на пример на мастеру: 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. У облаку затворите портове cloud заштитним зидом: споља, само ваша адреса; између сервера, интерна мрежа.

Испод су адресе из покретања: мастер 10.114.0.5, реплика 10.114.0.6 (приватна мрежа). Користите своје адресе.

Корак 1. Инсталација на оба сервера

На сваком серверу:

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

У терминалу, инсталатер отвара свој текстуални интерфејс (комплети од 2027.2.31). Прва страница има линију Cluster RCM off, discovery mode off. Отворите Cluster и промените једну линију:

Линија странице Cluster Мастер Реплика
Cluster manager (RCM) on off
Discovery mode (24 h) off (овај agent покреће RCM) on

Линије Cluster id (подразумевано: име хоста), RCM admin password (подразумевано: генерисан) и Pairing port (подразумевано: први слободан, 7450) могу остати како јесу. Вратите се (Esc) и изаберите Install. Инсталатер приказује план: притисните Enter. Затим пита Nothing on this host was changed yet. Start the install now?. Курсор је на No: померите га на Yes и притисните Enter. Инсталатер сам додаје библиотеке које недостају (на пример, libtommath1). Текстуални интерфејс у целини: hqbird2027-linux-setup-guide.md.

Са --no-tui, и у комплетима 2027.2.29–2027.2.30, инсталатер поставља питања. Прво је Install as planned? Yes/No: одговорите y. Затим поставља два питања о кластеру. Одговор је подразумевано No (Enter):

Питање Мастер Реплика
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] није питано: овај agent покреће RCM y

Или дајте одговоре као опције: у терминалу оне постављају вредности странице Cluster пре него што се отвори. Користите их и за покретање без терминала: --yes сам по себи значи No за оба.

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

Инсталација траје око једног минута (покретање од 2026-11-17: 61 секунда на мастеру, 43 секунде на реплици). Крај излаза на мастеру са комплетом 2027.2.33 (хеш је овде скраћен; cluster id примера испод је hq27d-m, из покретања од 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)

На реплици:

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

Старији кит исписује Pairing: not opened (this agent runs the RCM) на мастеру.

Запишите линије RCM: и CA hash: мастера и линију Pairing: реплике. Потребан вам је fingerprint у кораку 3.

Старији китови (агент пре 3.1.0, на пример кит 2027.2.27) не постављају питања о кластеру. Они инсталирају RCM на сваки сервер и отварају прозор упаривања свуда. Користите RCM мастера; RCM другог сервера се сам зауставља након повезивања.

Касније, без инсталера. У HQ Monitor-у сервера отворите Clusters, одељак Cluster on this server. На мастеру: Enable the cluster console (RCM); HQ Monitor отвара 7443 и 7444 у фајерволу. На реплици: Open the pairing window for 24 hours. Исто и командама, као корисник агента:

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

Док је прозор упаривања отворен, агент отвара свој порт за упаривање у фајерволу. Он затвара порт када се прозор заврши или када се хост повеже.

Излаз не садржи лозинке. Лозинка RCM-а је у фајлу из линије Password:, лозинка SYSDBA је у /root/fbagent-install-sysdba.txt, а лозинка HQ Monitor-а је у /opt/hqbird/conf/access.properties.

Није потребно да инсталирате лиценцу: нови агент сам започиње 7-дневну пробну верзију, и чворови кластера раде.

Корак 2. Пријавите се на RCM

Отворите адресу из линије RCM: мастера. Ако је порт 7444 затворен за ваш рачунар, користите SSH тунел и https://localhost:7444:

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

Ако је порт 7444 заузет на вашем рачунару, користите други локални порт, на пример -L 17444:127.0.0.1:7444 и https://localhost:17444.

Прегледач упозорава на сертификат: CA кластера је потписао RCM сертификат. Страница за пријаву приказује Cluster CA hash: упоредите је са линијом CA hash: из излаза инсталера. Ако се поклапају, инсталирајте CA сертификат (линк Download the CA certificate (hqcluster-ca.crt) на истој страници) као поверљив, или прихватите упозорење. Ако се не поклапају, не пријављујте се и проверите адресу.

RCM sign-in
RCM sign-in

Корисничко име је rcmadmin. Лозинка је у фајлу из линије 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 одмах тражи нову лозинку (најмање 12 знакова):

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

RCM пре 2027.5.12 је могао да учитава ову страницу изнова и изнова. RCM 2027.5.12 (кит 2027.2.33) има исправку.

Након промене лозинке, агент мастера сам брише фајл rcm-initial-password у року од једног минута. Са старијим китом, други сервер такође има сопствени RCM. Након повезивања, агент премешта тај ранији кластер у фасциклу cluster/left/. Агент 3.1.0 брише свој rcm-initial-password тамо; старији агент то не чини. Затим обришите фајл сами:

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

Не бришите фајл /opt/hqbirdrcm/initial-admin.json: он садржи само хеш старе лозинке, и без њега RCM који је изгубио свој фајл корисника почиње са подразумеваном лозинком.

Након промене лозинке, RCM одмах отвара Settings → Link hosts: кластер још нема чворова. Листа Releases in the mirror приказује hqbirdrcm и hqclusternode издања из којих агенти инсталирају чворове.

Link hosts after the sign-in
Link hosts after the sign-in

Корак 3. Повежите хостове

Први ред листе је већ попуњен (хост RCM-а). Додајте други ред: адреса реплике коју мастер може да достигне. Унесите IP ако сервери немају заједнички DNS: RCM задржава стринг какав јесте, и чворови се проналазе по њему.

List of hosts
List of hosts

Кликните Check hosts. За хост без порта, RCM чита портове за упаривање 7450–7459 и приказује по један ред за сваки агент који одговори, као host:port (овде 10.114.0.6:7450). Напишите host:port да читате само један порт. Хост RCM-а не захтева прозор за упаривање: RCM проналази свој агент у сопственом регистру. Упоредите Certificate fingerprint са излазом инсталера (линија Pairing: реплике): морају се поклапати. Стање другог хоста је Ready to link. Колона Member ID приказује име које хост добија у кластеру: <host name>-<role>, на пример hq27d-m-master. Суфикс инстанце (-fb50) се додаје само када хост има више агената.

Check of the hosts
Check of the hosts

Сваки ред има поље за потврду, порт, инстанцу и порт чвора. Link узима само означене редове. Ред са грешком не може бити означен и не зауставља остале. Испод табеле, RCM 2027.5.12 исписује линије као 10.114.0.6, no agent: closed or no answer: 7451-7459: оне именују портове за упаривање хоста на којима ниједан други агент не одговара. Оне нису грешке.

Мастер је хост на коме ће бити продукционе базе података. Кликните Link и потврдите:

Confirmation
Confirmation

Напредак: „Joining → Joined → The node starts → Running”. У покретању, повезивање је трајало 56 секунди (покретање од 2026-11-17: 47 секунди).

Link progress
Link progress
Done
Done

Overview сада приказује два чвора: мастер и реплику. Одмах након повезивања, реплика може бити „stale” један минут; затим је „online”.

Overview: two nodes
Overview: two nodes

Ако поново кликнете Check hosts за хост који је већ повезан, то показује да ниједан агент не одговара на портовима за упаривање, или да је хост недоступан: прозор за упаривање на том хосту је затворен, а такође и његов порт за упаривање у фајерволу. Ово није грешка.

Један хост у кластер који има мастер. Повезивање једног реда се одбија са lone_master: наведите шта ред постаје. Додајте -replica-of <master member> за реплику тог мастера, или -new-master (поље за потврду на страници Link hosts) за сопствени мастер.

Корак 4. Фасцикла базе података на мастеру

На мастеру, база података мора бити у фасцикли којој корисник firebird може да приступи:

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

Није потребно да припремите ништа на реплици: Create folder

дугме у дијалогу за иницијализацију креира фасциклу за копије (корак 6).

Корак 5. Упишите базе података на мастер

Databases → у табели Nodes, у реду мастера → Enroll.

  • Folder path on that server: /databases/master, recursive.
  • Include file mask: *.fdb.
  • Sync tracking tables: табеле чији број редова пореди дугме Verify. Листу постављате за сваку базу коју упишете. Оставите поље празно: тада база броји своје табеле публикације. За базу која је већ под управљањем, измените листу на страници мастер базе.
Enroll form
Enroll form

Preview → изаберите базе → Enroll selected и потврдите.

Confirmation of the enrollment
Confirmation of the enrollment

Резултат је „Enrolled: 2.” и напомена: Firebird мастера мора поново да се покрене. Текст „No new databases matched.” испод тога није грешка: базе су већ уписане.

Result of the enrollment
Result of the enrollment

Базе чекају поновно покретање:

Waits for the restart
Waits for the restart

Кликните Restart Firebird of the master у реду било које базе мастера (једно поновно покретање је довољно за све њих) и потврдите. Све везе са Firebird мастера прекидају се на неколико секунди (4 секунде у извршавању): изаберите погодно време.

Restart of Firebird of the master
Restart of Firebird of the master

После поновног покретања, мастер чвор је CONFIGURED. Свака база има ознаку publication OFF, а реплика приказује „not paired”.

After the restart
After the restart

Корак 6. Иницијализујте реплику

У реду базе, у колони реплике → Initialize. Дијалог има наслов „Initialize database?”.

Initialize dialog
Initialize dialog
  • Publication. Док је публикација базе искључена, Firebird не уписује измене у журнал, а реплика не добија ништа. Дијалог то наводи и приказује дугме Sync publication and initialize. Кликните га: RCM додаје све табеле са примарним или јединственим кључем у публикацију и одмах започиње иницијализацију. Дугме Initialize не помаже док је публикација искључена: мастер чвор одбија (publication_off).
  • Replica folder: дијалог предлаже /databases/replica/<replica node>, у извршавању /databases/replica/hq27d-r-replica. Сваком чвору реплике на хосту потребна је сопствена фасцикла. Задржите је. Ако поље приказује „✗ The folder does not exist”, кликните Create folder; тада видите „✓ The folder was created.” Копија иде у /databases/replica/hq27d-r-replica/hq27d-m-master/. За следеће базе фасцикла је већ подешена, и дијалог је не мења.
  • Method: Smooth (подразумевано). Проверава трансакције уписа пре закључавања. Standard одмах закључава базу.
  • Поља „Let … stop its Firebird for this reinit” и „Remove the old replica if space is short” нису потребна за нову реплику.

Поново повежите апликације после првог синхронизовања публикације. Веза са мастер базом која је отворена пре него што је публикација укључена не бележи се у журнал док се поново не повеже. У извршавању од 2026-11-17, веза отворена пре Sync publication and initialize уписала је око 9.500 редова после копирања, а реплика није добила ниједан од њих. RCM је приказао „Ok” за обе стране; само Verify (корак 9) приказао је „Not ok (desynced)”. Редови нове везе реплицирани су одмах. Зато, после првог Sync publication базе: поново повежите апликације (или поново покрените Firebird мастера), затим покрените Verify без уписа. Ако реплика пропушта редове, покрените reinit (корак 7).

Прва иницијализација под оптерећењем. Док архива мастера још нема сегмент журнала, Smooth може одбити ако се у базу уписује. Ред базе приказује long_transactions: … the archive holds no segment yet и напомену на језику корисничког интерфејса:

Refusal of the smooth method
Refusal of the smooth method

У извршавању, то се догодило и после Sync publication and initialize (налаз G-04 у извештају). Публикација је у овом тренутку већ укључена. Сачекајте док мастер база не прикаже „archive: 1 seg” или више (15 секунди у извршавању), и поново кликните Initialize са методом Smooth. Или изаберите Standard. У извршавању од 2026-11-17 (≈49 трансакција/с из једне везе), Smooth није одбијен.

Напредак се приказује у реду базе: SPACE CHECK → LOCKING → COPYING TO NODE (%) → UNLOCKING → SEEDING → RESTARTING REPLICA. Напредак је видљив и после поновног учитавања странице. Дугме Initialize је неактивно током овог времена.

Initialization progress
Initialization progress

После копирања, чвор реплике сам поново покреће Firebird реплике у планираном минуту. Ред наводи када; дугме Restart Firebird of the replica то чини одмах. Све везе са Firebird реплике прекидају се у том тренутку.

Waits for the restart of Firebird of the replica
Waits for the restart of Firebird of the replica

Велика база функционише на исти начин. У извршавању, bulk.fdb (3,13 GB) је иницијализована дугметом Sync publication and initialize, без оптерећења:

Copy of the large database
Copy of the large database

Готово је када мастер и реплика прикажу „Ok”, а „last applied seg” реплике достигне „last seg” мастера. База без нових уписа (овде bulk.fdb) приказује „Pending” са сегментом 0 за реплику: то је нормално.

Both databases ready
Both databases ready

Мерења извршавања (employee.fdb под оптерећењем од ≈55 трансакција/с):

База Величина Мастер: од почетка до краја Закључавање на мастеру Пар „Ok”
employee.fdb 4 MB 0,7 с 0,35 с после ≈1 мин (чекало се поновно покретање реплике)
bulk.fdb 3,13 GB 64 с (≈55 MB/s) 59 с после ≈2 мин

Извршавање од 2026-11-17 (комплет 2027.2.33): employee.fdb (3 MB) трајало је 3 секунде

на мастеру, bulk.fdb (167 MB) 15 секунди. Страна реплике је упарена ≈40 секунди након почетка (чекала је рестарт Firebird-а реплике).

Током закључавања мастер база ради: измене иду у .delta датотеку.

Касније објављивање. Потребно вам је дугме Sync publication мастер базе када се у бази појаве нове табеле. Оно усклађује публикацију са табелама у једној трансакцији; Firebird се не рестартује.

Sync publication
Sync publication

Publication tables приказује које се табеле репликују. Не можете објавити табелу без кључа: доделите јој примарни кључ.

Publication tables
Publication tables

Корак 7. Реиницијализација

Потребна вам је када се реплика разликује од мастера, или када чвор то затражи (NEEDS_REINIT). У реду реплике → Reinit, метод Smooth. Већ постоји архива сегмената, а smooth метод ради под оптерећењем. Он чека трансакције писања које су старије од историје журнала и приказује их.

Reinit, smooth method
Reinit, smooth method

Напредак је исти као при иницијализацији. Реинит обично не захтева рестарт Firebird-а реплике. У извршавању од 2026-11-17 реинит базе employee.fdb је ипак рестартовао Firebird реплике: рачунајте на прекид веза са репликом. Тај реинит је трајао 4 секунде на мастеру под ≈49 трансакција/с; након што су писања стала, бројеви редова су се поклопили (14.418 редова у табели оптерећења на обе стране).

Copy at the reinit
Copy at the reinit

Мерења извршавања:

База Оптерећење Време Закључавање Остало
employee.fdb ≈55 трансакција/с 1,7 с 0,32 с 417 трансакција поново извршено из сегмената
bulk.fdb нема 61 с 55 с без рестарта Firebird-а реплике

Након smooth реинита под оптерећењем, реплика може приказати info упозорење replication_conflict_resolved („Record being inserted … already exists, updating instead“): реплика је поново извршила трансакције које су већ биле у копији. Подаци се поклапају: у извршавању су се бројеви редова свих табела поклопили. Можете потврдити упозорење (налаз G-07 у извештају).

Корак 8. Мало простора на диску на реплици

Волумену реплике потребно је слободно ≥ 105 % величине базе плус 1 GB изнад старе копије: стара копија остаје до краја, а нова датотека одмах заузима своју пуну величину. Ако је простора мало, дијалог приказује колико је простора потребно, колико је слободно и колико заузима стара копија (процена RCM-а; одлучује чвор реплике). Ако је простора довољно без старе копије, дијалог предлаже поље Remove the old replica if space is short.

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

Са тим пољем, чвор реплике, након закључавања на мастеру, зауставља Firebird реплике, брише стару копију и поново покреће Firebird. У извршавању (2,97 GB слободно, нова копија захтева 3,29 GB, стара копија је 3,13 GB), реинит базе bulk.fdb са пољем је трајао 65 секунди. Без поља, чвор одбија са insufficient disk space on replica.

Дијалог може не приказати бројеве када недостаје само доњи праг од 1 GB. У извршавању од 2026-11-17 (1,1 GB слободно, база је 167 MB) дијалог није приказао процену, а реинит без поља није успео за 3 секунде. Ред базе и страница Commands приказали су разлог: 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. Исти реинит са пољем је трајао 9 секунди.

Ризик поља. Док копија траје, не постоји реплика ове базе. Ако реинит не успе, пар је NEEDS_REINIT, реплика има упозорење replica_removed_for_reinit (warn), а поновни покушај је нови потпуни реинит. Аутоматски реинит брише стару копију само ако је RCM кључ auto_reinit.remove_old_replica_when_short укључен (подразумевано искључен).

Корак 9. Верификација

Verify у реду реплике упоређује COUNT(*) табела праћења на мастеру и на реплици. Не упоређује саме редове. Ред „Table list source“ именује листу: сопствена листа базе, листа чвора, табеле публикације или RDB$FIELDS. Бројеви редова имају групе цифара.

Под оптерећењем, реплика касни неколико секунди, а Verify даје „Not ok“ за табеле у које се пише:

Verify under load
Verify under load

Без писања, бројеви се поклапају:

Verify without load
Verify without load

Табела које нема ни у једној бази је „not in the database“: то није непоклапање. Табела само на једној страни је „no table“: то је непоклапање.

Сигурнија провера је број редова свих табела на обе стране након што писања стану (скрипта је у hqbird2027-linux-cluster-runbook.md). У извршавању, свих 11 табела се поклопило (employee.fdb: 10, bulk.fdb: 1, са 2.800.000 редова).

Периодична провера (Data check) је подразумевано искључена. Кликните Turn on for all nodes и потврдите: сваки чвор броји своје редове, а мастер упоређује бројеве. Није потребан рестарт: RCM приказује „Saved and in force now: the node needs no restart.“ Прва провера се извршава један интервал касније (подразумевано 2 сата).

Periodic check
Periodic check

Шта даље пратите

  • Overview: чворови, њихово стање, корен базе и простор на диску.

    Overview
    Overview
  • Alerts: проблеми чворова и база. Извршавање је имало два упозорења, и можете потврдити оба: replication_conflict_resolved након smooth реинита (корак 7), и parse_no_observations на мастеру („no events parsed from /opt/firebird/replication.log“). Firebird мастера уписује само грешке у replication.log, тако да је празан лог нормалан (налаз G-06 у извештају).

    Alerts
    Alerts

    RCM 2027.5.12 и новији (комплет 2027.2.33) могу слати упозорења тежине warn и виших ка вашем Telegram боту, webhook-у или е-пошти. Канале подешавате у датотеци /opt/hqbirdrcm/rcm.json, кључ notify.channels, и рестартујете RCM (sudo systemctl restart hqbirdrcm). Блок Notification channels на овој страници затим приказује канале, сваки са дугметом Send test. Када нема канала, пише „No channel is configured: RCM sends its alerts nowhere.“ Telegram канал:

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

Покретање од 2026-11-17 проверило је блок без канала; порука није послата.

  • Услуге (RCM 2027.5.11 и новије, комплети од 2027.2.31): мастер, реплике и рутери услуге, и операције пребацивања, преузимања и поновног придруживања. Овај водич их не покрива: погледајте RCM кориснички приручник. Ажурирајте RCM и чворове на исту верзију пре него што их употребите.

  • Команде: свака RCM операција са својим резултатом. Време је локално време прегледача са његовом зоном (на пример, 17:59:45 UTC+1); опис при преласку показује време у UTC. Дневници чворова користе UTC.

    Commands
    Commands
  • HQ Monitor: http://<server>:23050/, корисничко име admin, лозинка је у /opt/hqbird/conf/access.properties. Приказује сервер и базе података. У комплетима са агентом 3.1.0 и новијим, HQ Monitor има страницу Clusters. На мастеру (домаћину RCM-а) приказује кластер преко агента, без RCM подешавања у HQ Monitor-у. На реплици наводи домаћина RCM-а и повезује се са његовом конзолом. HQ Monitor 1.49.0 нема стање репликације ни везу ка RCM-у. Од комплета 2027.2.33 (агент 3.4.0) агент шаље проблеме свог сервера и у ваше канале: Servers → Notifications.

Ажурирање кластера

Прво ажурирајте HQbird RCM, затим чворове. Од комплета 2027.2.31, сервер који није повезан ни са једним HQCenter-ом сам ажурира агента, HQ Monitor и fbmcp („Ажурирања без HQCenter-а“ у hqbird2027-linux-setup-guide.md); сервер повезан са HQCenter-ом преузима ажурирања од тог HQCenter-а.

Уклањање домаћина из кластера

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

Агент се зауставља и одјављује своје услуге чворова, затвара њихове портове чворова, брише своје сертификате кластера и поставља cluster.source на none. Фасцикла чвора остаје (--remove-data је брише). Агенту који покреће RCM се одбија. Агент такође сам одлази када га RCM опозове или му уклони последњег члана. Деинсталација увек напушта кластер: поновна инсталација у истој фасцикли почиње слободно. У покретању од 2026-11-17 команда је исписала Cluster: left <cluster id>, базе реплика су остале у својој фасцикли, а RCM је и даље приказивао чвор тог домаћина минут касније. Уклањање HQbird-а са сервера кластера, такође са сервера који покреће RCM: hqbird2027-removal-guide.md, одељак 4.

Уобичајене грешке

Шта видите Узрок Шта да радите
publication_off при иницијализацији публикација је искључена, или нема табелу иако база података има табеле са кључем дугме Sync publication and initialize (корак 6)
long_transactions … the archive holds no segment yet прва иницијализација глатком методом док се у базу података уписује, а архива мастера је празна сачекајте „archive: 1 seg“ и покушајте поново са Smooth, или изаберите Standard
reinit_pre_publication_transactions трансакција писања је почела пре него што је публикација укључена и отворена је дуже од једног минута завршите је (COMMIT или ROLLBACK) и покушајте поново
„✗ The folder does not exist on …“ у дијалогу нико није направио фасциклу реплике дугме Create folder у дијалогу, или install -d -o firebird -g firebird -m 0770 <folder> на реплици
„Not ok (desynced)“ у Verify у базу података се уписује, а реплика касни неколико секунди покушајте поново без оптерећења; погледајте колону Match
„Not ok (desynced)“ у Verify без уписивања; обе стране показују „Ok“ веза апликације је отворена пре него што је публикација укључена: није у дневнику поново повежите апликацију, затим Reinit (корак 6, напомена о првој синхронизацији публикације)
Домаћин „unreachable“ или „no agent“ у Link hosts прозор за упаривање домаћина је затворен (подразумевано искључен, или је истекло 24 ч), или заштитни зид између сервера затвара 7450–7459 отворите прозор на домаћину: HQ Monitor → Clusters → Open the pairing window for 24 hours, или fbagent --cluster-pairing on; отворите порт у заштитном зиду облака
insufficient disk space on replica при поновној иницијализацији стара реплика остаје до краја, а нова датотека заузима њену пуну величину ослободите ≥ 105 % величине базе података + 1 GB изнад старе датотеке на волумену реплике, или поље Remove the old replica if space is short (корак 8)
Чвор се не појављује након Link hosts RCM огледало нема потписано издање hqclusternode Releases in the mirror на страници Link hosts (корак 2)