Водич за администраторе репликационог кластера HQbird: hqclusternode и hqbirdrcm (RCM). Инсталери: Преузимање HQbird 2027.

Садржај


0. Увод

Овај водич описује како се инсталира и користи репликациони кластер HQbird: чворови hqclusternode и менаџер кластера hqbirdrcm (RCM).

Ово је водич за администратора Firebird-а. Полазимо од тога да познајете Firebird, gfix и nbackup. Не морате да познајете унутрашњи рад чвора.

Од чега се кластер састоји

Компонента Колико Где ради Шта ради
Firebird (HQbird) једна или више инстанци на сваком серверу база чува базе, пише сегменте репликације
fbagent један по инстанци Firebird-а поред Firebird-а зауставља и покреће Firebird на захтев чвора
hqclusternode (чвор) један по инстанци и улози поред Firebird-а подешава репликацију, преноси сегменте, врши иницијализацију реплике
hqbirdrcm (RCM) један по кластеру на било ком хосту који види све чворове веб-интерфејс, команде, упозорења, статистика

Чвор има улогу: master (мастер) или replica (реплика). На једној инстанци Firebird-а могу да раде два чвора: чвор мастера и чвор реплике. У том случају неке базе тог Firebird-а су мастери, а друге реплике.

Како то ради

  1. На мастеру Firebird записује измене базе у сегменте (фајлове дневника репликације).
  2. Чвор мастера шаље сегменте чвору реплике преко обезбеђеног канала (mTLS).
  3. Чвор реплике ставља сегменте у фолдер долазних сегмената. Firebird реплике примењује их на своју копију базе.
  4. Сам чвор мастера преноси прву копију базе на реплику. То се зове иницијализација (reinit). Иде преко nbackup, а мастер за то време наставља да ради.
  5. Чворови шаљу статистику у RCM. RCM приказује стање кластера и шаље команде оператера чворовима.
Како кластер ради: сегменти, иницијализација, статистика и команде оператера
Како кластер ради: сегменти, иницијализација, статистика и команде оператера

Подржане верзије

  • Firebird / HQbird 5.0 и 4.0 — све могућности.
  • HQbird 3.0 и 2.5 — репликација преко додатка replconf. Нема публикација; скуп табела одређују филтери. Разлике су описане у оквирима „HQbird 2.5/3.0“.

Главна верзија Firebird-а на мастеру и на реплици мора да се поклапа. У супротном чвор реплике одбија иницијализацију.

Портови

Порт Ко слуша Ко се повезује Чему служи
7051 чвор остали чворови и RCM API чвора, пренос сегмената и копија базе
7443 RCM сви чворови пријем статистике од чворова
7444 RCM оператер веб-интерфејс и API оператера. Инсталација преко RCM (поглавље 1.3): HTTPS на свим адресама. Инсталација преко HQCenter Admin или ручно: HTTP, само 127.0.0.1
7450–7459 fbagent, док је прозор повезивања отворен RCM повезивање хостова (поглавље 1.3)
13050 fbagent, само 127.0.0.1 чвор на истом хосту управљање Firebird-ом
3050 Firebird апликације обичан рад базе

Ако на једном хосту раде два чвора (мастер и реплика), други чвор има други порт. При инсталацији преко RCM други чвор добија порт 7061. У осталим случајевима порт задајете сами, на пример 7052.

Порт 13050 не сме да буде изложен мрежи. Ни порт 7444 са HTTP (инсталација преко HQCenter Admin или ручно): на веб-интерфејс RCM повежите се преко SSH тунела (поглавље 1). При инсталацији преко RCM порт 7444 ради преко HTTPS, а инсталер га отвара у заштитном зиду.

Главно правило: нема fbagent-а, нема измена

Чвор мења конфигурацију репликације само преко fbagent-а: треба да поново покрене Firebird. Ако fbagent није доступан, чвор одбија сваку радњу која мења конфигурацију. Не ради „делимично“.

Појмови

Појам Значење
Сегмент фајл дневника репликације са изменама базе
Публикација списак табела мастера чије измене иду у сегменте (Firebird 4/5)
Иницијализација (reinit) пренос копије базе са мастера на реплику преко nbackup
GUID базе идентификатор базе Firebird-а; RCM га користи да повеже мастер и реплику
Партнер чвор партнер: за мастер, његове реплике
Компањон други чвор на истој инстанци Firebird-а (мастер и реплика на једном хосту)
Упис регистрација база мастера у чвору

Како читати водич

Поглавље Тема
1. Инсталација инсталација чворова и RCM преко HQCenter Admin, преко RCM без HQCenter Admin и ручно, Linux и Windows
2. Конфигурација кластера везе мастер → реплика, подешавања чвора, корисници RCM
3. Додавање базе на мастер упис, поновно покретање Firebird-а, провера
4. Како базу учинити репликом фазе, припрема реплике, простор на диску
5. Иницијализација кораци reinit-а, утицај на рад, дуге трансакције, брзина, грешке
6. Подешавање публикације публикација Firebird 4/5, табеле, нове табеле, HQbird 2.5/3.0
7. Остале опције репликације параметри replication.conf, архива, пренос, упозорења, пауза, дневници
8. Превођење реплике у обичну базу Направи обичном, Унапреди у мастер, нови GUID, сервиси (пребацивање, преузимање при отказу), контролна листа пребацивања

У свим поглављима користи се један пример:

Шта Вредност
node-a чвор мастера, базе у /databases/master
node-b чвор реплике, базе у /databases/replica
RCM засебан хост (може да буде и један од сервера база)
база employee.fdb

1. Инсталација чворова и hqbirdrcm

Постоје три начина инсталације:

Начин Када га изабрати Шта радите сами
Преко HQCenter Admin (1.2) уобичајен пут: сервер ажурирања HQCenter Admin је доступан, потребна су аутоматска ажурирања покрећете скрипту за инсталацију fbagent-а, одобравате захтев, описујете кластер
Преко RCM, без HQCenter Admin (1.3) нема HQCenter Admin, али су потребни сертификати, конфигурација и ажурирања без ручног рада; до 3 сервера база инсталирате HQbird на сваки хост, пријављујете се у RCM и у Подешавања → Повежи хостове наводите адресе хостова
Ручно (1.4) нема приступа HQCenter Admin, затворена мрежа, посебни захтеви инсталирате фајлове, правите сертификате, пишете node.json и rcm.json, региструјете сервисе

Преко HQCenter Admin и преко RCM чворове и RCM не инсталирате сами. Инсталира их fbagent када га додате у кластер (поглавље 2). Сертификати и конфигурација такође се праве аутоматски.

Linux и Windows описани су у једном поглављу. Разлике за Windows су у оквирима „На Windows-у“.

1.1. Захтеви

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

  • Firebird / HQbird 5.0, 4.0, 3.0 или 2.5 (2.5 — само Linux).
  • fbagent поред сваке инстанце Firebird-а. Без fbagent-а чвор не ради.
  • Синхронизација времена (NTP, chrony, w32time) на свим серверима и на хосту RCM. Прозори поновног покретања и преноса, процена заостатка и провера „чвор не одговара“ зависе од сатова.
  • Слободан простор за архиву сегмената и за иницијализацију реплике (поглавље 4).
  • Мрежа према табели портова (поглавље 0).

Linux: привилегије root, x86_64, systemd, curl. Подржано: Ubuntu 20–26, Debian 11–13, Astra, CentOS 7–10, AlmaLinux, Rocky, Oracle Linux 8–10, RED OS, openSUSE 15.6, Fedora 44+.

Windows: администраторске привилегије, x64, Windows 10 / Server 2016 или новији, 64-битни Windows PowerShell 5.1. На Windows 10 и Server 2016–2022 потребан је 7-Zip.

Где ће RCM радити. По кластеру је потребан један RCM. Може да се инсталира на било који сервер који види све чворове, укључујући један од сервера база.

1.2. Инсталација преко HQCenter Admin

Корак 1. Покрените скрипту за инсталацију fbagent-а

Скрипта инсталира Firebird (изградња HQbird), fbagent и региструје fbagent на серверу HQCenter Admin. Изаберите скрипту која одговара верзији Firebird-а: fb25, fb30, fb40, fb50.

Linux (као root):

Command
sudo sh fbagent-fb50_known.sh --goafts <HQCenter-Admin-server> --enroll --cluster

На Windows-у (PowerShell као администратор):

Command
powershell -NoProfile -ExecutionPolicy Bypass -File .\fbagent-fb50_known.ps1 -Enroll

На Windows-у нема параметра -Cluster: fbagent ради као LocalSystem и сам прави фолдере кластера.

Главни параметри:

Linux Windows Значење
--goafts <name> -Goafts сервер HQCenter Admin са кога се преузима; име даје ваш добављач
--enroll -Enroll региструј fbagent у HQCenter Admin (захтев за сертификат)
--cluster — направи фолдере /opt/hqclusternode и /opt/hqbirdrcm (потребно само за fbagent 2.55.2 и старији; безопасно за новије верзије)
--channel -Channel канал ажурирања fbagent-а, подразумевано stable
--token -Token токен лиценце: HQCenter Admin ће захтев одобрити аутоматски
--port -Port порт Firebird-а
--yes -Yes не постављај питања (потребно кад нема терминала)

Пун списак параметара је у README скрипте за инсталацију fbagent-а.

Корак 2. Одобрите захтев fbagent-а

Са параметром --enroll fbagent шаље захтев за сертификат (CSR) у HQCenter Admin и чека одобрење до 30 минута. Можете да га одобрите овако:

  • аутоматски — ако је инсталација покренута са токеном лиценце (--token) и лиценца има слободно место;
  • у панелу HQCenter Admin — одељак захтева CSR, захтев овог хоста, дугме за одобрење и потписивање;
  • преко API-ја HQCenter Admin — POST /v1/admin/csr-requests/{id}/approve.

Ако регистрација није успела (на пример, истекло је време чекања), fbagent ипак ради, али скрипта излази са кодом 2. Покрените скрипту поново са истим параметрима: поновиће се само регистрација.

Неколико минута после регистрације fbagent сам инсталира HQ Monitor.

Корак 3. Опишите кластер

Чворови и RCM се појављују када fbagent додате у кластер HQCenter Admin. Како се кластер описује обрађено је у поглављу 2.

После чувања кластера:

  1. У року од 10 минута fbagent добија кластер од HQCenter Admin (после тога проверава измене сваких 60 секунди).
  2. fbagent на хосту RCM прави сертификационо тело кластера (CA) и потписује сертификате свих чворова.
  3. Сваки fbagent пише node.json или rcm.json за своје чланове кластера.
  4. На следећој провери производа (свака 3 минута) fbagent инсталира и покреће сервисе.

Шта се инсталира и где:

Шта Linux Windows
Чвор мастера /opt/hqclusternode/master/, сервис hqclusternode-master-p<port> <HQbird>\hqclusternode\master\, сервис HQClusterNode-master-p<port>
Чвор реплике /opt/hqclusternode/replica/, сервис hqclusternode-replica-p<port> <HQbird>\hqclusternode\replica\, сервис HQClusterNode-replica-p<port>
RCM /opt/hqbirdrcm/, сервис hqbirdrcm <HQbird>\hqbirdrcm\, сервис hqbirdrcm

<port> је порт Firebird-а, на пример 3050. Један fbagent може да има највише један чвор мастера, један чвор реплике, један RCM и један рутер (hqclusternode router, од HQbird 2027.2.30, поглавље 8.7).

На Windows-у. Верзије fbagent-а пре 2.83.0 инсталирале су чворове у C:\hqclusternode, а RCM у C:\hqbirdrcm. Ако ти фолдери постоје, fbagent наставља да их користи.

Ажурирања

  • fbagent проверава нове верзије чвора и RCM свака 3 минута; подразумевани канал је stable. Прво се ажурира чвор реплике, затим чвор мастера.
  • Ако после ажурирања сервис не успе да се покрене или пријави погрешну верзију, fbagent се враћа на претходну верзију и блокира нову. Списак блокираних: <fbagent folder>/update/<product>/blocked-versions.json. Да бисте верзију поново пробали, обришите њен ред из овог фајла.
  • Статус производа: fbagent --product-status hqclusternode (или hqbirdrcm).

1.3. Инсталација преко RCM (без HQCenter Admin)

Кластером управља RCM. fbagent сваког хоста добија опис кластера од RCM, fbagent на хосту RCM потписује сертификате, а чвор и RCM се ажурирају из издања која чува RCM.

Ограничења:

  • Један кластер по RCM.
  • Највише 3 места. Место је хост на коме ради чвор мастера или реплике. Мастер и реплика на истом хосту рачунају се као једно место. Хост на коме ради само RCM не заузима место. Четврти хост даје грешку seats_exceeded.
  • RCM не ажурира fbagent ни Firebird. fbagent их ажурира сам и не дира replication.conf, node.json, rcm.json ни сертификате.

Постоје два начина:

  • Повежи хостове у RCM — уобичајен начин. Три радње: инсталер на сваком хосту (RCM на једном хосту, режим откривања на осталима), пријава у RCM, образац Повежи хостове.
  • Ручно из командне линије — токени за придруживање и fbagent --cluster-join. Потребно када је порт 7450 затворен између хостова или је прозор упаривања већ затворен.

Лиценца. Пробна лиценца укључује могућност cluster. После пробног периода fbagent не инсталира чвор ни RCM ако лиценца нема cluster. Никада не блокира ажурирања већ инсталираних чворова и RCM. Без HQCenter Admin плутајућа лиценца престаје да ради после online_check_days плус дани одгоде. Зато на сваки fbagent инсталирајте везану лиценцу:

Command
fbagent --license-request --out license_request.json
# send the file to the vendor and receive license.json
fbagent --license-install license.json

Без лиценце мастер престаје да шаље сегменте (поглавље 2.8).

Портови:

Порт Где Ко се повезује
7443 хост RCM fbagent и чворови свих хостова кластера
7444 хост RCM прегледач оператера (конзола RCM, HTTPS)
7450 (на другом и следећим хостовима fbagent-а — 7451…7459) хост у режиму откривања, док је прозор упаривања отворен RCM на хосту RCM
7051 (други чвор истог fbagent-а — 7061) хостови чворова остали чворови и RCM (1.4, корак 7)

Повежи хостове у RCM

Пример од нуле. Два Linux сервера, инсталер .run, повезивање, регистрација, публикација, иницијализација и поновна иницијализација под оптерећењем — са снимцима екрана и мерењима: водич hqbird2027-linux-cluster-guide.ru.md и радни приручник hqbird2027-linux-cluster-runbook.ru.md (репозиторијум goafts, фолдер документације).

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

Инсталирајте HQbird пуним инсталером на сваки сервер база. Не региструјте се у HQCenter Admin (--enroll).

Подразумевано инсталер не подешава кластер. Програме чвора и RCM ставља у фолдер fbagent-а (update/<product>/staged/), али не инсталира RCM, не отвара прозор упаривања и не отвара портове кластера у заштитном зиду. Кластер се укључује са два параметра:

Command
sudo sh hqbird2027-fb50-linux-<version>.run --rcm on               # RCM host
sudo sh hqbird2027-fb50-linux-<version>.run --cluster-pairing on   # other hosts

--rcm on — на једном хосту, где ће радити RCM кластера. Инсталер:

  1. прави кластер овог хоста (fbagent --cluster-init), име кластера је име хоста;
  2. инсталира и покреће RCM, конзола RCM ради преко HTTPS на порту 7444;
  3. прави првог администратора RCM rcmadmin са насумичном лозинком;
  4. отвара портове 7443, 7444 и порт чвора 7051 у заштитном зиду.

--cluster-pairing on (режим откривања) — на сваком другом хосту. Инсталер отвара прозор упаривања fbagent-а на 24 часа: порт 7450 и порт чвора 7051. Док је прозор отворен, RCM из мреже може да позове овај хост у свој кластер. fbagent почиње да слуша на порту 7450 у року од минута.

Без ових параметара инсталер сам пита: у текстуалном интерфејсу то је страница Кластер, са --no-tui — два питања. Подразумевани одговор је „не“. --yes без параметара кластера такође одговара „не“ на оба питања.

На крају инсталер исписује редове RCM: и Pairing:. На хосту RCM:

text
RCM:        https://10.0.0.7:7444 (cluster db1)
CA hash:    sha256:7cfc1d4b…032d2582
Login:      rcmadmin
Password:   in /opt/hqbird/fbagent-fb50/clusterca/db1/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

На другом хосту:

text
RCM:        off; turn it on in HQbird Monitor or with fbagent --cluster-init <id>
Pairing:    port 7450 open until 2026-11-17T17:49:18Z (fingerprint sha256:0439e44a…91a2f9b9); an RCM may invite this host

У испису нема лозинке: она је у фајлу из реда Password:. Запишите fingerprint сваког хоста у режиму откривања.

Параметри кластера у Linux инсталеру:

Параметар Шта ради
--rcm on|off инсталира RCM и прави кластер на овом хосту; подразумевано off
--cluster-pairing on|off режим откривања: отвори прозор упаривања на 24 часа; подразумевано off
--pairing-port N порт упаривања новог fbagent-а, 7450–7459; подразумевано први слободан
--rcm-password-file F лозинка администратора RCM из првог реда фајла F, уместо насумичне
--cluster-id ID име кластера ID уместо имена хоста (уз --rcm on)
--cluster-node on|off инсталира програм чвора; подразумевано on
--rcm-allow A,B само ови RCM смеју да позову овај хост: адреса, CIDR мрежа или име

Први fbagent на хосту добија порт упаривања 7450 и портове чвора 7051 и 7061. Друга инстанца на истом хосту — 7451, 7052 и 7062.

RCM и прозор упаривања могу да се укључе и касније, без инсталера: у HQ Monitor, страница Кластери, или командама као корисник fbagent-а:

Command
cd <fbagent folder>                                    # /opt/hqbird/fbagent-fb50
sudo -u firebird ./fbagent --cluster-init <name>      # RCM host; open ports 7443 and 7444 yourself
sudo -u firebird ./fbagent --cluster-pairing on      # window for 24 hours
sudo -u firebird ./fbagent --cluster-pairing off
sudo -u firebird ./fbagent --cluster-pairing status

Стари инсталери (fbagent пре 3.1.0) не питају за кластер: они инсталирају RCM на сваки хост и свуда отварају прозор упаривања. Потребан вам је RCM једног хоста; RCM осталих хостова се сами заустављају после повезивања.

На Windows-у. Иста два избора постоје у Windows инсталеру: параметри /RCM и /DISCOVERY.

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

Отворите адресу из реда RCM: хоста RCM (https://<host>:7444). Пријавите се са пријавом rcmadmin и лозинком из фајла у реду Password:. RCM одмах тражи нову лозинку (1.5).

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

У RCM отворите Подешавања → Повежи хостове.

  1. У поље Хостови унесите адресе или имена хостова, један по реду. Први ред је хост RCM, он је већ у кластеру.
  2. Кликните Провери хостове. RCM испитује портове упаривања 7450–7459 сваког хоста и приказује платформу, верзију Firebird-а, отисак и стање. Хосту RCM није потребан прозор упаривања. Упоредите отиске са исписом инсталера (ред Pairing:).
  3. Изаберите Мастер (подразумевано први хост) и кликните Повежи.
Повежи хостове: резултат провере
Повежи хостове: резултат провере

RCM тражи потврду и приказује напредак у одељку Напредак. Када сви чворови раде, пише „Готово“ и приказује број ревизије кластера:

Повежи хостове: сви чворови раде
Повежи хостове: сви чворови раде

Исто из командне линије:

Command
cd /opt/hqbirdrcm
export RCM_USER=rcmadmin RCM_PASSWORD='<password>'
./hqbirdrcm cluster link -hosts db1,db2,db3 -master db1

Шта се даље дешава:

  1. RCM шаље позивницу сваком слободном хосту.
  2. fbagent хоста се придружује кластеру и затвара порт упаривања. Ако хост има сопствени RCM без чворова, fbagent га зауставља и искључује, и празан кластер премешта у cluster/left/ у фолдеру fbagent-а.
  3. RCM чува кластер: чвор <host>-master на мастеру, <host>-replica на осталим хостовима, порт 7051, везе мастер → реплика.
  4. fbagent сваког хоста инсталира и покреће чвор. RCM чека док сви чворови не раде и за сваки хост приказује Ради.

Стања хоста после Провери хостове:

Стање Шта урадити
Спреман за повезивање ништа. Ако испод пише „Сопствени RCM овог хоста ће се зауставити после повезивања“ — то је нормално
У кластеру хост је већ у овом кластеру
Грешка unreachable порт 7450 је затворен: прозор упаривања је искључен (као подразумевано) или је прошло 24 часа. Одмах после инсталације сачекајте минут и поново кликните Провери хостове. У супротном отворите прозор (--cluster-pairing on) и проверите заштитни зид
Грешка in_other_cluster хост је у другом кластеру
Грешка claimed други RCM управо повезује овај хост
Грешка seats_exceeded више од 3 места

Издања. fbagent инсталира чвор само из RCM. RCM узима потписана издања из свог фолдера import/ (поред rcm.json) при покретању и сваких 5 минута. Инсталер тамо ставља издања хоста RCM, а fbagent осталих хостова сам преузима издање за своју платформу. Списак издања је на дну странице Повежи хостове. Издање се може увести и ручно (корак 5 ниже).

Ручно из командне линије

Редослед: кораци 1–3 на хосту RCM, корак 4 на сваком другом хосту, кораци 5–6 у RCM.

Корак 1. Инсталирајте HQbird са fbagent-ом

Инсталирајте HQbird на сваки сервер база и на хост RCM пуним инсталером. На хосту RCM можете одмах да наведете --rcm on (тада корак 3 није потребан). На осталим хостовима не наводите параметре кластера: подразумевано нема RCM ни прозора упаривања. Не региструјте се у HQCenter Admin (--enroll).

На хосту RCM инсталер оставља програм RCM у фолдеру fbagent-а (update/hqbirdrcm/staged/). Без њега корак 3 пада са грешком no hqbirdrcm to install.

Корак 2. Инсталирајте везану лиценцу

Као на почетку одељка, „Лиценца“.

Корак 3. Направите кластер на хосту RCM

Ако је инсталер већ направио кластер (--rcm on: ред RCM: са адресом у испису), прескочите овај корак.

Команду покрените као корисник fbagent-а (на Linux-у — firebird), не као root: иначе ће фајлови CA и rcm.json припадати root-у.

Command
cd <fbagent folder>
sudo -u firebird ./fbagent --cluster-init shop-prod --address 10.0.0.7

На Windows-у (PowerShell као администратор): .\fbagent.exe --cluster-init shop-prod --address 10.0.0.7

  • shop-prod — име кластера: мала латинична слова, цифре и -.
  • --address — адреса хоста RCM преко које се други хостови повезују на њега. Може да се понови више пута. Без параметра користе се адресе и име хоста.

Команда:

  1. прави CA кластера и CA агента (у фолдеру fbagent-а, clusterca/<name>/);
  2. у фолдер RCM пише сертификат RCM, rcm.json и cluster-init.json;
  3. инсталира RCM и региструје сервис hqbirdrcm. На Linux-у сервис ради као засебан корисник hqbirdrcm;
  4. пребацује fbagent на RCM (cluster.source = rcm) и поново га покреће;
  5. исписује адресу RCM и отисак CA:
Code
Cluster:    shop-prod
RCM URL:    https://10.0.0.7:7443
CA hash:    sha256:9f86d0...

Запишите RCM URL и CA hash: потребни су на осталим хостовима. Поновно покретање за исти кластер је безбедно: CA и кључеви остају исти.

Одмах се пријавите у RCM и промените лозинку rcmadmin (1.5).

На Linux-у. Корисник hqbirdrcm је у групи fbagent. RCM чита rcm.json преко ове групе, али не може да га пише. Зато Подешавања → RCM не чува измене (грешка rcm_config_read_only). Уредите rcm.json на хосту као корисник fbagent-а и поново покрените RCM.

Корак 4. Повежите fbagent осталих хостова

  1. На хосту RCM направите токен за придруживање за сваки fbagent: у RCM Подешавања → Кластер, дугме Направи токен за придруживање. Или из командне линије:

    Command
    cd /opt/hqbirdrcm
    export RCM_USER=rcmadmin RCM_PASSWORD='<password>'
    ./hqbirdrcm cluster join-token -note db2

    Токен важи 24 часа, само за један fbagent и само једном. RCM га приказује једном, заједно са готовом командом.

  2. На хосту чвора покрените ову команду као корисник fbagent-а:

    Command
    cd <fbagent folder>
    sudo -u firebird ./fbagent --cluster-join https://10.0.0.7:7443 \
      --ca-hash sha256:9f86d0... --token-file token.txt

    Уместо --token-file можете да користите --token <token>. На Windows-у — исто са .\fbagent.exe у PowerShell-у као администратор.

fbagent проверава CA RCM по отиску. Ако се отисак не поклапа, он стаје и ништа не пише. Затим fbagent добија свој сертификат (90 дана, обнавља се аутоматски) и поново се покреће. Повезани fbagent се види у RCM у табели Агенти. Док нема чланова, на хосту се ништа не инсталира.

Корак 5. Увезите издања у RCM

fbagent узима чвор и RCM само из RCM. Ако потребно издање није на списку Издања у огледалу (Подешавања → Повежи хостове), увезите сваки производ (hqclusternode, hqbirdrcm) за сваку платформу ваших хостова (linux-amd64, windows-amd64). Фајл издања и потпис .sig даје добављач.

Command
cd /opt/hqbirdrcm
sudo -u hqbirdrcm ./hqbirdrcm release import -config rcm.json \
  -file hqclusternode-linux-amd64 -product hqclusternode \
  -platform linux-amd64 -version 2027.5.12
sudo -u hqbirdrcm ./hqbirdrcm release list -config rcm.json
  • RCM тражи потпис у <file>.sig, или га наведите са -sig. Без важећег потписа добављача RCM неће прихватити фајл.
  • Ново издање замењује претходно. Поновно покретање RCM није потребно.
  • fbagent проверава нове верзије свака 3 минута. Редослед ажурирања и блокирање су као преко HQCenter Admin (1.2, „Ажурирања“).

Корак 6. Опишите кластер

Чланове и везе поставите у RCM, Подешавања → Кластер (поглавље 2.3). После чувања fbagent инсталира чворове на исти начин као преко HQCenter Admin (1.2, корак 3): пише сертификате, node.json и rcm.json, инсталира и покреће сервисе.

Портови — на почетку одељка.

1.4. Ручна инсталација

Корак 1. Инсталирајте HQbird са fbagent-ом

Инсталирајте HQbird на сваки сервер база (истом скриптом, али без --enroll, или пуним инсталером HQbird). Проверите да fbagent ради.

Забележите три вредности из agent_config.json fbagent-а. Потребне су за node.json:

Поље fbagent-а Поље node.json Пример
local_api.listen firebird.fbagent_url http://127.0.0.1:13050
local_api.token firebird.fbagent_token —
local_api.instance_id firebird.instance_id —

Провера fbagent-а (одговор је JSON инстанце Firebird-а):

Command
curl -s -H "Authorization: Bearer <token>" http://127.0.0.1:13050/v1/instances/<instance_id>

Ако хост има неколико инстанци HQbird, у firebird.update.services конфигурације fbagent-а оставите само сервис своје инстанце (види 3.5).

Корак 2. Распоредите фајлове

Linux:

Code
/opt/hqclusternode/
  hqclusternode        # program
  node.json            # node configuration (permissions 0600)
  certs/               # ca.crt, <node_id>.crt, <node_id>.key
  work/                # working folder
/opt/hqbirdrcm/
  hqbirdrcm            # program
  rcm.json             # cluster configuration
  certs/               # ca.crt, rcm.crt, rcm.key
  rcm-data/            # state, users, audit log
Command
sudo mkdir -p /opt/hqclusternode/certs /opt/hqclusternode/work
sudo install -m 0755 hqclusternode-linux-amd64 /opt/hqclusternode/hqclusternode
# on the RCM host:
sudo mkdir -p /opt/hqbirdrcm/certs /opt/hqbirdrcm/rcm-data
sudo install -m 0755 hqbirdrcm-linux-amd64 /opt/hqbirdrcm/hqbirdrcm

На Windows-у. Подразумевани фолдер је C:\hqclusternode са истим распоредом. Путања која садржи размак је дозвољена.

Ако један хост има два чвора (мастер и реплика), сваком дајте сопствени фолдер, на пример /opt/hqclusternode/master и /opt/hqclusternode/replica.

Корак 3. Направите сертификате

Чворови и RCM комуницирају само преко mTLS. Потребни су један CA и сертификат за сваког учесника. Ово покрените једном на било којој машини:

Command
./hqclusternode gencerts -out certs \
  -nodes 'node-a:master,node-b:replica' \
  -hosts 'localhost,127.0.0.1,<ip-node-a>,<ip-node-b>,<ip-rcm>'

Команда прави ca.crt и ca.key, node-a.crt/.key, node-b.crt/.key и rcm.crt/.key. У -hosts наведите сва имена и адресе преко којих ће се учесници повезивати.

gencerts и фајлови које је направио
gencerts и фајлови које је направио

ca.key је кључ CA. Не копирајте га на хостове; чувајте га одвојено.

Нови чвор се касније додаје са -add: пар се потписује истим CA, а остали фајлови остају непромењени:

Command
./hqclusternode gencerts -out certs -add -nodes 'node-c:replica' -hosts '<ip-node-c>'

Сертификати важе 90 дана. gencerts -out certs -list приказује датуме истека, а gencerts -out certs -renew их обнавља истим кључем. Нови .crt копирајте на његов хост: чвор ће га преузети без поновног покретања.

На сваки хост копирајте ca.crt и само његов сертификат и кључ.

Корак 4. Напишите node.json

Један фајл по чвору. Пример за мастер (node-a):

json
{
  "node_id": "node-a",
  "role": "master",
  "listen_addr": ":7051",
  "rcm": { "url": "https://<ip-rcm>:7443", "ca_cert": "certs/ca.crt",
           "client_cert": "certs/node-a.crt", "client_key": "certs/node-a.key" },
  "firebird": {
    "root": "/opt/firebird",
    "user": "SYSDBA",
    "password": "<SYSDBA password>",
    "port": 3050,
    "replication_conf": "/opt/firebird/replication.conf",
    "replication_log": "/opt/firebird/replication.log",
    "firebird_log": "/opt/firebird/firebird.log",
    "fbagent_url": "http://127.0.0.1:13050",
    "fbagent_token": "<local_api.token>",
    "instance_id": "<local_api.instance_id>",
    "service_name": "<Firebird service name>"
  },
  "windows": { "restart_window": "22:00-05:00", "transfer_window": "23:00-05:00" },
  "peers": [ { "node_id": "node-b", "url": "https://<ip-node-b>:7051", "compress": "zstd" } ]
}

Чвор реплике (node-b) има исти фајл, али са "role": "replica", сопственим сертификатима и мастером node-a у peers.

Главна поља:

Поље Вредност
node_id име чвора; исто у сертификату, rcm.json и peers других чворова
role master или replica
listen_addr адреса API чвора; други чвор на истом хосту користи други порт (:7052)
rcm.url адреса за пријем статистике RCM; none — нема RCM
firebird.* Firebird и fbagent ове инстанце; вредности fbagent-а морају да се поклапају тачно
firebird.auto_restart да ли чвор реплике сме сам да поново покрене Firebird: auto (подразумевано), never, always
windows.restart_window прозор поновног покретања Firebird-а; за мастер је подразумевано 22:00-05:00, за реплику је увек
windows.transfer_window прозор у коме иницијализација иде пуном брзином
peers за мастер — његове реплике, за реплику — њен мастер
databases фолдер база; боље га не писати ручно, него поставити преко RCM (поглавље 3)

Остала поља имају подразумеване вредности. Чвор се неће покренути ако поља fbagent-а нису постављена.

Заштитите фајл: садржи лозинку и токен.

Command
chmod 600 /opt/hqclusternode/node.json

На Windows-у. Путање пишите у JSON формату: "C:\\HQbird\\replication.conf". service_name је име Windows сервиса за Firebird.

Корак 5. Напишите rcm.json

json
{
  "ingest_addr": "0.0.0.0:7443",
  "operator_addr": "127.0.0.1:7444",
  "users_file": "rcm-data/users.json",
  "data_dir": "./rcm-data",
  "tls": { "ca_cert": "certs/ca.crt", "cert": "certs/rcm.crt", "key": "certs/rcm.key" },
  "nodes": [
    { "node_id": "node-a", "url": "https://<ip-node-a>:7051", "role": "master",  "host": "A" },
    { "node_id": "node-b", "url": "https://<ip-node-b>:7051", "role": "replica", "host": "B" }
  ]
}
  • url — адреса чвора како је види хост RCM. Само https.
  • host — ознака инстанце Firebird-а. Чвор мастера и чвор реплике са истом ознаком раде на истом Firebird-у (компањон, потребан да се реплика унапреди у мастер, поглавље 8). Једна ознака — највише један мастер и једна реплика.
  • Релативне путање се разрешавају из фолдера rcm.json.

Корак 6. Региструјте сервисе

Редослед покретања: прво RCM, затим реплике, затим мастер.

RCM (Linux):

Command
cd /opt/hqbirdrcm
sudo ./hqbirdrcm svc install -config /opt/hqbirdrcm/rcm.json
sudo ./hqbirdrcm svc start

Чвор (Linux):

Command
cd /opt/hqclusternode
sudo ./hqclusternode svc install -config /opt/hqclusternode/node.json -certs /opt/hqclusternode/certs
sudo ./hqclusternode svc start -config /opt/hqclusternode/node.json
systemctl status hqclusternode-master-p3050

svc install прави сервис hqclusternode-<role>-p<port> који ради као корисник firebird. Ако је фолдер Firebird-а у власништву root-а, команда групи firebird даје право писања (са лепљивим битом) и исписује сваку измену: чвор треба да замени replication.conf.

За svc start, svc stop и svc uninstall наведите исти node.json: име сервиса се изводи из улоге и порта Firebird-а.

На Windows-у (PowerShell као администратор):

Command
cd C:\hqclusternode
.\hqclusternode.exe svc install -config C:\hqclusternode\node.json -certs C:\hqclusternode\certs

Сервис HQClusterNode-<role>-p<port> ради као LocalSystem, покреће се аутоматски и поново се покреће после отказа. Сервис чвора не зависи од сервиса Firebird. Ако је чвор инсталиран верзијом 2027.1.2–2027.1.9, зависност уклоните једном: .\hqclusternode.exe svc fix-deps -config C:\hqclusternode\node.json.

svc install и svc start на Windows-у
svc install и svc start на Windows-у

Корак 7. Отворите портове

На хосту чвора дозволите долазне везе на 7051 (порт listen_addr) од осталих чворова и од RCM. На хосту RCM дозволите долазне везе на 7443 од свих чворова. Портове 7444 и 13050 не излажите споља.

Пример ufw на хосту чвора:

Command
sudo ufw allow from <ip-rcm> to any port 7051 proto tcp
sudo ufw allow from <ip-partner-node> to any port 7051 proto tcp

Ручно ажурирање

Зауставите сервис, замените програм, покрените сервис:

Command
sudo systemctl stop hqclusternode-master-p3050
sudo install -m 0755 hqclusternode-linux-amd64 /opt/hqclusternode/hqclusternode
sudo systemctl start hqclusternode-master-p3050

Конфигурација и сертификати се овим не мењају.

1.5. Прва пријава у RCM

Адреса и лозинка зависе од тога како је RCM инсталиран.

Како је RCM инсталиран Адреса Пријава и лозинка
Инсталером HQbird или fbagent --cluster-init (1.3) https://<RCM host>:7444 са било ког рачунара rcmadmin и лозинка коју је исписао инсталер (или ваша из --rcm-password-file)
Преко HQCenter Admin (1.2) или ручно (1.4) http://127.0.0.1:7444, само на хосту RCM rcmadmin, лозинка strong password (са размаком)

HTTPS (1.3). Сертификат RCM потписује CA кластера, коју прегледач не познаје, па упозорава. На страници за пријаву RCM приказује отисак CA. Упоредите га са CA hash који је исписао инсталер и увезите CA у прегледач или у систем као поуздани корен: веза Преузми CA сертификат на страници за пријаву (https://<RCM host>:7444/ca.crt, фајл hqcluster-ca.crt). Да би RCM слушао само на localhost, у rcm.json поставите "operator_addr": "127.0.0.1:7444" и поново покрените RCM.

HTTP (1.2, 1.4). Са другог рачунара повежите се преко SSH тунела:

Command
ssh -L 7444:127.0.0.1:7444 <rcm-host>

Затим у прегледачу отворите http://127.0.0.1:7444.

Страница за пријаву у RCM
Страница за пријаву у RCM

Генерисана лозинка. RCM тражи да је промените при првој пријави: док је не промените, остале странице се неће отворити. Лозинку strong password промените одмах (веза Лозинка у заглављу).

Промена лозинке при првој пријави
Промена лозинке при првој пријави

Језик. У списку језика у заглављу странице изаберите Руски (доступан је и на страници за пријаву). Ако не изаберете, језик се узима из прегледача.

Промена лозинки и нови корисници

Сваки корисник мења своју лозинку: веза Лозинка у заглављу странице. Потребна је тренутна лозинка и нова од најмање 12 знакова. После промене, остале сесије тог корисника се затварају.

Ако је инсталер генерисао лозинку, она је уписана у фајл clusterca/<name>/rcm-initial-password у фолдеру fbagent-а. После промене лозинке fbagent сам брише овај фајл. Фајл initial-admin.json у фолдеру RCM не бришите: садржи само хеш. Ако се фајл корисника изгуби, а овај фајл не постоји, RCM ће направити корисника са подразумеваном лозинком.

Нови корисници. У интерфејсу нема странице корисника. Корисници су у фајлу rcm-data/users.json. Лозинка се чува као HA1 хеш: MD5("<name>:hqbirdrcm:<password>").

  1. Израчунајте хеш:

    Command
    printf '%s' 'rcmadmin:hqbirdrcm:<new password>' | md5sum
  2. Упишите га у поље ha1 корисника у users.json. Да бисте додали корисника, додајте још један елемент у users:

    json
    { "username": "ivanov", "ha1": "<hash>", "algo": "MD5", "created_at": "2026-11-03T00:00:00Z" }
  3. Одмах поново покрените RCM: фајл чита само при покретању. Када се лозинка промени у интерфејсу, RCM преписује фајл из меморије, и све измене које још није прочитао биће изгубљене.

Command
chmod 600 /opt/hqbirdrcm/rcm-data/users.json
sudo systemctl restart hqbirdrcm

Без поља role корисник има сва овлашћења. Од HQbird 2027.2.31 постоји улога "role": "viewer": само преглед, сваки захтев за измену добија 403.

1.6. Како проверити инсталацију

  • Сервиси чвора и RCM раде и не покрећу се у петљи: systemctl status hqclusternode-master-p3050, systemctl status hqbirdrcm.

    systemctl status чвора
    systemctl status чвора
systemctl status RCM
systemctl status RCM
  • RCM одговара (без лозинке): curl http://127.0.0.1:7444/healthz. Када је инсталиран преко RCM (1.3), конзола ради преко HTTPS: curl -k https://127.0.0.1:7444/healthz.

  • У RCM страница Преглед приказује све чворове, без ознаке „не одговара“.

  • Из командне линије на хосту RCM:

    Command
    export RCM_USER=rcmadmin RCM_PASSWORD='<password>'
    ./hqbirdrcm nodes
    ./hqbirdrcm status
  • Кластер преко RCM: Подешавања → Кластер, одељак Стање — сваки члан је применио најновију ревизију и не пријављује грешку. Из командне линије: ./hqbirdrcm cluster status.

1.7. Дневници

Шта Где
Дневник чвора <node.json folder>/logs/node-YYYYMMDD.jsonl
Излаз сервиса чвора (Linux) journalctl -u hqclusternode-<role>-p<port>
Излаз сервиса RCM (Linux) journalctl -u hqbirdrcm
Дневник репликације Firebird-а firebird.replication_log из node.json
Дневници са било ког чвора без SSH RCM, страница Дневници

1.8. Честе грешке

Шта видите Узрок Шта урадити
Чвор се не покреће: грешка о fbagent_url, fbagent_token или instance_id fbagent не ради или се вредности не поклапају са agent_config.json проверите fbagent командом curl из 1.4, корак 1
Скрипта инсталације је изашла са кодом 2 захтев fbagent-а није одобрен на време одобрите захтев и поново покрените скрипту
Чворови се не појављују преко HQCenter Admin fbagent није у кластеру, или кластер још није добијен проверите кластер (поглавље 2), сачекајте до 10 минута
Чвор у RCM је „не одговара“ порт 7051 је затворен, url у rcm.json је погрешан, адреса није у сертификату проверите портове и -hosts сертификата
Нема пријаве у RCM: „Превише неуспелих покушаја пријаве“ 10 неуспелих пријава у року од 5 минута сачекајте неколико минута
Нова верзија се неће инсталирати верзија је у blocked-versions.json уклоните ред верзије из фајла
--cluster-init: no hqbirdrcm to install инсталер није оставио програм RCM инсталирајте HQbird пуним инсталером (1.3, „Ручно“, корак 1)
--cluster-join: token_used, token_expired, token_revoked токен је већ искоришћен, старији је од 24 часа или је опозван направите нови токен (1.3, „Ручно“, корак 4)
--cluster-join: hostname_conflict кластер има fbagent са истим именом хоста и другим адресама дајте хостовима различита имена
--cluster-join: this agent is in cluster … from goafts fbagent је већ у кластеру HQCenter Admin уклоните га из кластера HQCenter Admin
Чвор се неће инсталирати преко RCM RCM нема издање за ову платформу hqbirdrcm release list, увезите издање (1.3, „Ручно“, корак 5)

2. Конфигурација кластера

У овом поглављу одређујете који су чворови у кластеру и који мастер шаље сегменте којој реплици. Затим подешавате чворове RCM и кориснике.

Односи се одређују на један од три начина:

Чворови инсталирани Где се односи одређују Одељак
преко HQCenter Admin у HQCenter Admin: страница Кластери у HQ Monitor или API HQCenter Admin 2.2
преко RCM, без HQCenter Admin у RCM: Подешавања → Кластер, hqbirdrcm cluster или страница Кластери у HQ Monitor 2.3
ручно у RCM: Подешавања → RCM и Подешавања → Чворови 2.3

На чворовима инсталираним преко HQCenter Admin или преко RCM односе мењајте само у опису кластера. fbagent преписује node.json и rcm.json према опису кластера. Уређивање односа у Подешавања → RCM или Подешавања → Чворови у RCM се одбија (409 cluster_managed). Раније верзије RCM су то прихватале, али се губило.

2.1. Улоге и шеме

Сваки чвор има једну улогу: мастер или реплика. Два чвора — мастер и реплика — могу да раде на једној инстанци Firebird-а.

Подржане шеме:

Code
1 → 1        node-a (master) ──▶ node-b (replica)

1 → N        node-a ──▶ node-b
                    └─▶ node-c

N → 1        node-a ──┐
                      ├─▶ node-b    (one replica for several masters)
             node-x ──┘

Both nodes   host-1: node-1m (master) + node-1r (replica)  ← one Firebird
on a host    host-2: node-2m (master) + node-2r (replica)  ← one Firebird
             node-1m ──▶ node-2r,  node-2m ──▶ node-1r

Веза увек иде од мастера ка реплици. RCM повезује базу мастера са њеном репликом по GUID базе, а не по имену чвора.

Компањон. Чвор мастера и чвор реплике на истој инстанци Firebird-а су компањони. Унапређење реплике у мастер (поглавље 8) ради само за такав пар. У rcm.json пар је означен истом вредношћу host.

2.2. Везе преко HQCenter Admin

Где описати кластер

  • HQ Monitor, страница Кластери (само администратори; испорука конфигурације мора да буде укључена). Уобичајен начин.
  • API HQCenter Admin: POST /v1/admin/clusters и PUT /v1/admin/clusters/{id}. Панел HQCenter Admin нема страницу кластера.

``

Кораци на страници Кластери

  1. Унесите Идентификатор новог кластера (мала латинична слова, цифре и -) и кликните Направи.
  2. Додајте чланове (Чланови). За сваког наведите:
    • fbagent хоста;
    • улогу: master, replica или rcm;
    • адресе хоста;
    • порт: за чвор — 7051 (други чвор на истом хосту — нпр. 7052), за RCM — порт пријема статистике 7443.
  3. Додајте везе (Везе репликације) од мастера ка реплици.
  4. Кликните Провери, затим Сачувај.

Ако је други администратор у исто време изменио кластер, страница ће тражити да поново учитате кластер и поновите измену.

Правила

  • fbagent може да припада само једном кластеру.
  • На једном fbagent-у — највише један мастер, једна реплика, један RCM и један рутер. Рутер (улога router, од HQbird 2027.2.30) нема веза и не заузима место лиценце (поглавље 8.7).
  • Кластер има тачно један RCM. fbagent на хосту RCM води сертификационо тело (CA) кластера.
  • Име члана (member_id) — латинична слова, цифре, -. Име, fbagent и улога члана не могу да се промене. Да бисте члана преместили на други хост, направите новог члана са новим именом. Старо име немојте поново да користите.
  • Свака реплика мора да има везу ка мастеру.
  • HQCenter Admin сам гради адресу чвора: https://<first address>:<port>.
  • HQbird 2.5/3.0: поставите датум replconf_valid_till кластера (YYYY-MM-DD) — конфигурација додатка replconf важи до тог датума.

Пример преко API-ја

json
{"contract":1,"cluster_id":"shop-prod","name":"Shop","pki":"managed",
 "cert_validity_days":90,"renew_before_days":30,
 "members":[
  {"member_id":"db1-m","agent_id":"<fbagent of host 1>","role":"master","addresses":["db1.lan"],"listen_port":7051},
  {"member_id":"db1-rcm","agent_id":"<fbagent of host 1>","role":"rcm","addresses":["db1.lan"],"listen_port":7443},
  {"member_id":"db2-r","agent_id":"<fbagent of host 2>","role":"replica","addresses":["db2.lan"],"listen_port":7052}],
 "links":[{"from":"db1-m","to":"db2-r"}]}
  • Направи: POST /v1/admin/clusters (документ може да се пошаље заједно са члановима). Замени цео документ: PUT /v1/admin/clusters/{id}.
  • PUT захтева заглавље If-Match: <revision> (ревизију дају GET и ETag). Без заглавља — 428, са старом ревизијом — 409, са грешком у документу — 422 са списком грешака.
  • POST /v1/admin/clusters/{id}/validate проверава документ без чувања.
  • GET /v1/admin/clusters/{id}/status приказује стање чланова и датуме истека сертификата.

Шта се дешава после чувања

  1. fbagent сваког члана добија кластер. Унутар кластера — провера сваких 60 секунди (fbagent на хосту RCM — сваких 30 секунди). Ван кластера fbagent сазнаје за кластер на следећем упиту конфигурације. Ако тај упит не стигне до сервера, провера иде сваких 10 минута.
  2. Сваки fbagent прави кључ и шаље захтев за сертификат. fbagent на хосту RCM га потписује. RCM потписује сопствени сертификат без захтева.
  3. fbagent у node.json пише: име, улогу, адресу, peers (из веза), адресу RCM, путање сертификата, податке Firebird-а и fbagent-а. У rcm.json: списак чворова (nodes), списак рутера (routers), адресу пријема статистике и путање сертификата. fbagent не дира остала поља фајлова.
  4. fbagent инсталира и покреће сервисе (поглавље 1).

Измена кластера:

Шта се променило Шта fbagent ради
само peers чвора који ради прослеђује их чвору без поновног покретања
остала поља чвора зауставља чвор, пише фајл, покреће чвор — унутар windows.transfer_window чвора (није постављено — одмах)
rcm.json одмах поново покреће RCM
сертификати или CA поново покреће сервис
члан је уклоњен зауставља и уклања сервис; cluster-managed.json → cluster-removed.json, програм → *.removed; конфигурација, сертификати и подаци остају

После уклањања чвора његов одељак # BEGIN managed-by:<name> … # END … остаје у заједничком replication.conf. Обришите га ручно и поново покрените Firebird преко RCM.

Одобравање сертификата кластера

Подразумевано fbagent на хосту RCM сам потписује захтеве (auto). Ручно одобравање може да се укључи. Команде на хосту RCM:

Command
fbagent --cluster-ca-approval manual     # or auto
fbagent --cluster-status                 # this fbagent's membership in the cluster (JSON)
fbagent --cluster-ca-approve <request_id>

У режиму manual нови члан или нови кључ чека одобрење. Обнављање сертификата са познатим кључем потписује се аутоматски.

2.3. Везе преко RCM

Кластер RCM (без HQCenter Admin)

Ако је кластер направио инсталер HQbird или команда fbagent --cluster-init (поглавље 1.3), опис кластера чува RCM. Најлакши начин да се додају хостови је на страници Подешавања → Повежи хостове (поглавље 1.3, „Повежи хостове у RCM“): RCM сам прави чланове и везе. Правила су иста као у HQCenter Admin (2.2, „Правила“), плус:

  • у RCM постоји један кластер; члан rcm увек постоји и не може да се обрише;
  • највише 3 места (хостови са чворовима мастера или реплике), иначе настаје грешка seats_exceeded;
  • члан може да се дода само на fbagent који се повезао на RCM (поглавље 1.3: „Повежи хостове“ или „Ручно“, корак 4).

Кораци на страници Подешавања → Кластер:

  1. У табели Агенти кликните Додај члана у реду fbagent-а.
  2. Наведите улогу (master, replica или router), member_id, адресе и порт. Страница предлаже име <host>-<role> и порт: 7051 за први чвор fbagent-а, 7061 за други. Порт који је већ заузет другим чланом хоста RCM одбија. Адресе fbagent-а су дугмад: кликните да додате адресу.
  3. У одељку Везе кликните Додај везу од мастера ка реплици.
  4. Кликните Провери: RCM ће приказати грешке и упозорења.
  5. Кликните Сачувај. Страница ће приказати списак измена и тражити потврду. Ако се чланови бришу, прозор је црвен.

Пре чувања измене постоје само на страници (ознака „Није сачувано“). Ако је неко у исто време сачувао кластер, страница ће понудити да га поново учита. Ако су се променила само поља RCM (ревизија, CA, комисије), страница ће сама сачувати вашу измену.

Остали одељци странице:

Одељак Шта је ту
заглавље име кластера, ревизија, CA кластера и CA агента; дугме Извези за стари CA
Токени за повезивање направите токен за нови fbagent, опозовите некоришћени
JSON документ цео документ у текстуалном пољу; Провери и Сачувај га користе
Кључеви и CA комисије: нови кључ члана (rekey), нови CA кластера (rotate_ca), нови CA агента (rotate_agent_ca); недоступно кад има несачуваних измена
Стање ревизија коју је сваки члан применио, истек сертификата, сервис, последња грешка

Из командне линије на хосту RCM:

Command
export RCM_USER=rcmadmin RCM_PASSWORD='<password>'
./hqbirdrcm cluster show > c.json        # document with revision
# edit c.json
./hqbirdrcm cluster validate -f c.json   # validate without saving anything
./hqbirdrcm cluster apply -f c.json      # save (If-Match = revision from the file)
./hqbirdrcm cluster agents               # connected fbagents and their members
./hqbirdrcm cluster status               # what the fbagents reported

Формат документа је као у 2.2, „Пример преко API-ја“. apply са старом ревизијом добија 409: поново покрените show. RCM чува последњих 20 ревизија у rcm-data/cluster/history/.

HQ Monitor. Страница Кластери ради и са RCM. На хосту RCM HQ Monitor приступа RCM преко fbagent-а тог хоста, са сертификатом fbagent-а: корисник и лозинка RCM нису потребни. У дневнику ревизије RCM такве радње се бележе као agent:<id> (<user>). Други начин, за раније верзије RCM: у конфигурацији HQ Monitor поставите rcm_admin_url (http://127.0.0.1:7444), rcm_admin_user (корисник RCM) и rcm_admin_password_file (фајл са његовом лозинком).

После чувања све иде као преко HQCenter Admin (2.2, „Шта се дешава после чувања“). RCM сам поново чита nodes у rcm.json, без поновног покретања.

Уклоните fbagent из кластера: обришите његове чланове и сачувајте, затим кликните Опозови у табели Агенти (или ./hqbirdrcm cluster revoke -agent <id>). Да бисте га вратили, потребан је нови токен. После опозива fbagent (од верзије 3.1.0) сам напушта кластер: зауставља своје чворове и брише податке кластера. Исто на хосту чвора ради команда fbagent --cluster-leave. На хосту RCM се одбија.

Ручна инсталација: додајте чвор у RCM

  1. Подешавања → RCM, табела Повезани чворови.
  2. Кликните Додај чвор. Попуните node_id, url (https://<address>:7051), улогу, host (ознака инстанце Firebird-а), server (само за груписање на екрану).
  3. Кликните Провери у реду чвора: RCM ће проверити везу и овлашћења.
  4. Кликните Сачувај. RCM ће уписати rcm.json и стари фајл сачувати као rcm.json.<UTC time>.bak (последњих 20).
  5. Поново покрените RCM. До поновног покретања важи стара конфигурација; страница показује која поља чекају поновно покретање.
Подешавања → RCM
Подешавања → RCM
Command
sudo systemctl restart hqbirdrcm

Може и без интерфејса: уредите rcm.json и поново покрените RCM.

Ручна инсталација: повежите мастер и реплику

Веза мора да буде забележена на обе стране:

  1. Подешавања → Чворови, изаберите чвор мастера.
  2. У одељку Партнери кликните Додај партнера: node_id реплике, њен url, компресија (zstd).
  3. Кликните Сачувај. RCM ће приказати списак измена и тражити потврду. Измена peers ступа на снагу одмах.
  4. Поновите за чвор реплике: њен партнер је мастер.
Одељак Партнери чвора мастера
Одељак Партнери чвора мастера

Ако партнер није забележен на једној од страна, RCM неће понудити тај чвор реплике при иницијализацији базе.

2.4. Подешавања чвора

Подешавања → Чворови приказује подешавања node.json која чвор дозвољава да се мењају из RCM. Чувају се само измењена поља, после прозора са списком измена.

Подешавања → Чворови: избор чвора
Подешавања → Чворови: избор чвора
Подешавања база чвора са ознакама „после скенирања“
Подешавања база чвора са ознакама „после скенирања“

Сваки ред је означен када ће измена ступити на снагу:

Када Која подешавања
Одмах channel_a_mbps, channel_a_burst_mbps, windows.restart_window, peers; од HQbird 2027.2.24 — подешавања провере података (limits.data_check_*); од HQbird 2027.2.31 — advertise_addr
После поновног покретања чвора остала ограничења, windows.transfer_window; страница их приказује у засебном реду док се чвор не покрене поново
После скенирања databases.*, exclude_filter; ако се replication.conf променио, потребно је поновно покретање Firebird-а (поглавље 3.5)

Само за читање (мења се у node.json на хосту чвора): firebird (укључујући лозинку и auto_restart), rcm, tls, segments, адреса listen_addr.

Главна подешавања:

Подешавање Подразумевано Значење
windows.restart_window мастер 22:00-05:00, реплика — увек када чвор сме да поново покрене Firebird; мастер Firebird се никада не покреће сам
windows.transfer_window 23:00-05:00 прозор у коме иницијализација иде брзином reinit_window_mbps
limits.channel_a_mbps 50 брзина преноса сегмената, MB/s (channel_a_burst_mbps — краткорочни врх, 200)
limits.reinit_window_mbps 100 брзина иницијализације унутар прозора преноса, MB/s
limits.reinit_day_disk_fraction 0.5 удео измерене брзине диска за иницијализацију ван прозора
limits.retention_days 2 колико дана чувати послате сегменте у архиви мастера
limits.free_space_floor_gb 1 најмање слободног простора, GB; испод тога реплика не прихвата сегменте
limits.max_concurrent_reinits 1 колико иницијализација чвор извршава истовремено

Детаљи о брзини и чувању архиве су у поглављима 5 и 7.

firebird.auto_restart (само у node.json) одређује да ли чвор реплике сме сам да поново покрене Firebird:

Вредност Понашање
auto (подразумевано) сме, ако овај Firebird не служи базе мастера
never никада
always увек, чак и ако овај Firebird држи базе мастера

Преко HQCenter Admin. windows.transfer_window чвора fbagent-а користи се и као прозор за поновно покретање самог сервиса чвора када се кластер промени. Ако прозор није постављен у node.json, fbagent одмах поново покреће сервис.

2.5. Више инстанци HQbird на једном хосту

fbagent поново покреће сервисе наведене у firebird.update.services своје конфигурације. Празан списак значи све сервисе HQbird на хосту. У списку оставите само сервис сопствене инстанце. Чвор не види ово подешавање и у дневник пише упозорење fbagent_shared ако fbagent зна за више од једне инстанце.

2.6. Лозинка SYSDBA

Чвор се повезује на Firebird корисником и лозинком из firebird.user и firebird.password у node.json. fbagent чува сопствену копију лозинке. Ако сте променили лозинку SYSDBA:

  1. Исправите firebird.password у node.json сваког чвора ове инстанце (мастер и реплика).
  2. Исправите лозинку у конфигурацији fbagent-а и поново је учитајте (види документацију fbagent-а).
  3. Поново покрените сервисе чворова.

У супротном странице публикације и провере у RCM ће приказати грешку пријаве (SQLSTATE 28000).

2.7. Корисници RCM и ревизија

  • Корисници су у фајлу rcm-data/users.json (поглавље 1.5). Без улоге корисник има сва права; улога viewer (од HQbird 2027.2.31) — само преглед.
  • Сесија траје 12 часова после последње радње.
  • После 10 неуспелих пријава у року од 5 минута пријава за тог корисника и адресу се привремено блокира. Успешна пријава ресетује бројач.
  • Дневник ревизије је фајл rcm-data/audit.jsonl: један JSON ред за сваку измену, пријаву и одјаву. У интерфејсу нема дневника ревизије.
  • Страница Команде приказује аутора сваке команде.

2.8. Лиценца

Једном у минуту чвор мастера чита лиценцу fbagent-а свог хоста. Ако лиценце нема (пробни период је истекао, лиценца је истекла или је неважећа), чвор престаје да шаље сегменте за све базе на мастеру. Firebird и базе настављају да раде, али реплике престају да примају измене.

Шта видите у RCM:

  • мастер је црвен (NEEDS_ATTENTION), са значком „нема лиценце: слање је заустављено“;
  • нема дугмета Настави: паузу скида само лиценца;
  • на реплици: „не прима од …: мастер нема лиценцу“;
  • у табели Чворови значка „нема лиценце“; у Подешавања → Чворови блок лиценце fbagent-а;
  • упозорења license_paused и license_pause_archive_released;
  • иницијализација је забрањена (license_paused).
Блок лиценце fbagent у Подешавања → Чворови
Блок лиценце fbagent у Подешавања → Чворови

Инсталирајте лиценцу у fbagent. Чвор сам скида паузу у року од минута. Мастер чува архиву за реплике limits.retention_days (подразумевано 2 дана) од почетка паузе. Ако лиценцу инсталирате касније, реплике ће морати поново да се иницијализују.

Кластер преко RCM, без HQCenter Admin. Плутајућа лиценца без HQCenter Admin престаје да ради после online_check_days плус дани одгоде. Сваком fbagent-у у кластеру потребна је везана лиценца (fbagent --license-request, затим fbagent --license-install, поглавље 1.3, „Лиценца“). После пробног периода fbagent неће додати нови чвор ни RCM без могућности cluster у лиценци; ажурирања никада не забрањује. За HQbird 2.5/3.0 датум replconf_valid_till у RCM не може да буде каснији од краја лиценце плус дани одгоде на чворовима fbagent-а (грешка replconf_after_license).

2.9. Како проверити

  • Преглед: сви чворови су присутни и груписани по серверу.

    Преглед кластера
    Преглед кластера
  • Подешавања → Чворови: мастер има реплику у Партнери, а реплика има мастера.

  • Подешавања → RCM: дугме Провери у реду сваког чвора пролази.

  • Извештај кластера као један фајл:

    Command
    ./hqbirdrcm report -o report.json

2.10 Честе грешке

Шта видите Узрок Шта урадити
Уређивање партнера у RCM одбијено (409 cluster_managed) или изгубљено после поновног покретања чвора чвор је инсталиран преко HQCenter Admin или преко RCM промените везе у опису кластера (2.2, 2.3)
seats_exceeded при чувању кластера у RCM чворови на четвртом хосту највише 3 хоста са чворовима
Подешавања → RCM: rcm_config_read_only кластер преко RCM на Linux-у: rcm.json припада fbagent-у уредите rcm.json као корисник fbagent-а и поново покрените RCM
Опозови агента не ради (agent_has_members) fbagent има чланове прво обришите чланове и сачувајте
Чвор реплике се не нуди при иницијализацији партнер није забележен на једној од страна додајте партнера на обе стране (2.3)
Измена у Подешавања → RCM не ступа на снагу RCM није поново покренут поново покрените RCM
422 при чувању кластера у HQCenter Admin грешка у документу исправите је према списку errors, проверите преко validate
409 при чувању кластера кластер је изменио неко други поново прочитајте кластер и покушајте опет
Нови члан кластера HQCenter Admin не добија сертификат ручно одобравање на хосту RCM fbagent --cluster-ca-approve <id>
Грешка SQLSTATE 28000 на страницама публикације лозинка SYSDBA је промењена 2.6

3. Додавање базе на мастер

У овом поглављу база мастера долази под контролу чвора. Чвор је бележи у replication.conf и прави фолдере за сегменте. После поновног покретања Firebird-а база је спремна за репликацију.

Прављење реплике су следећи кораци (публикација, иницијализација). Описани су у поглављима 4–6.

Називи дугмади дати су према руском интерфејсу RCM, са енглеским у заградама.

3.1. Како чвор открива базе

Чвор мастера тражи базе у једном фолдеру — корен база (databases.root). Шта долази под управљање одређују правила:

Правило Поље Подразумевано
Фолдер база root није постављено
Претрага потфолдера recursive да
Маска укључивања template *.fdb
Маска искључивања exclude_mask нема
Величина фајла, MB min_size_mb, max_size_mb без ограничења (0)
Табеле за поређење података sync_tables са HQbird 2027.2.24 — табеле из публикације базе, ако их нема — RDB$FIELDS; у 2027.5.7 — RDB$FIELDS
Списак укључивања include_paths празан (режим шаблона)
Списак искључивања exclude_paths празан

Путања root је путања на хосту чвора, а не на хосту RCM. Чвор прво примењује маску укључивања, затим маску искључивања, затим величину.

Правила су иста за цео чвор. Списак sync_tables је такође заједнички: провера (поглавље 5.10) тражи сваку табелу са списка у свакој бази чвора која нема сопствени списак.

Табеле за поређење, са HQbird 2027.2.24. Свака база може да има сопствени списак (Табеле за праћење синхронизације). Чвор га чува у databases.sync_tables_by_db. Провера узима први списак који је постављен:

  1. сопствени списак базе;
  2. заједнички списак sync_tables чвора;
  3. табеле из публикације базе;
  4. RDB$FIELDS.

Заједнички списак сачуван раније има предност над публикацијом: база без сопственог списка користи њега. Страница базе мастера показује који списак тренутно важи (3.3).

Табела која недостаје и у примарној бази и у реплици добија статус „није у бази“ (absent): не пореди се, и провера неће приказати „Није у реду“ због ње. Табела која недостаје само на једној страни је одступање.

RCM и чвор 2027.5.7. Постоји један списак за цео чвор (sync_tables); без списка провера користи RDB$FIELDS. Табела која недостаје је грешка, и провера базе ће приказати „Није у реду“.

Сва правила су у node.json чвора. Чвор их примењује при сваком скенирању.

Режим шаблона и режим списка:

  • Режим шаблона (списак укључивања празан): чвор узима све фајлове који одговарају маски, осим искључених. Нови фајл у фолдеру чвор ће сам покупити при следећем скенирању.
  • Режим списка (списак укључивања није празан): чвор узима само фајлове са списка. Нови фајл неће аутоматски доћи под управљање — мора да се дода.

Изаберите режим списка ако фолдер садржи копије база, тест базе или друге фајлове које не треба репликовати.

3.2. Пре него што почнете: проверите овлашћења

Корисник под којим раде Firebird и чвор (firebird на Linux-у, LocalSystem на Windows-у) мора да има права читања и писања на:

  • корени фолдер база и фајлове база;
  • replication.conf и његов фолдер (чвор замењује фајл преко привременог фајла);
  • фолдере сегмената <database>.ReplLog и <database>.LogArch (чвор их сам прави).

RCM проверава овлашћења пре регистрације (претходна провера). Ако провера не успе, команда се завршава грешком preflight failed on <node> и списком путања.

Провера на хосту чвора (Linux):

Command
sudo -u firebird /opt/hqclusternode/hqclusternode checkpermissions -config /opt/hqclusternode/node.json

3.3. Страница уписа базе

Упис базе: образац и преглед
Упис базе: образац и преглед
  1. Отворите страницу уписа чвора мастера. Веза је доступна на два места:

    • Базе → табела Чворови → колона радњи → Упиши;
    • Преглед → картица чвора мастера → Упиши базе.

    Чвор реплике нема ову страницу.

  2. Образац приказује тренутна правила чвора (чвор их је сам послао). Ако чвор не одговара, дугмад за преглед и упис су искључена: без тренутних правила она би ресетовала спискове укључивања и искључивања.

  3. Попуните или исправите поља: Путања до фолдера на овом серверу, рекурзивно, маске, Филтер величине, Табеле за праћење синхронизације.

    Поље Табеле за праћење синхронизације:

    • са HQbird 2027.2.24 и новијим — списак је по бази коју ће ова радња уписати. Празно поље: база користи табеле сопствене публикације. Упис не мења заједнички списак чвора (sync_tables). Ако постоји, образац то каже: база без сопственог списка користи њега, а не публикацију. Списак већ управљане базе поставља се на њеној страници: Базе → база мастера → блок Табеле за праћење синхронизације. Блок показује који списак тренутно важи. Празно поље уклања сопствени списак базе;
    • у RCM и чвору 2027.5.7 — један списак за све базе чвора (sync_tables).
  4. Кликните Преглед. Чвор ће приказати све фајлове који одговарају маски укључивања. Ништа не мења.

  5. Проверите списак. Сваки фајл има поље за потврду:

    • означено — фајл ће бити под управљањем;
    • означено, закључано, ознака већ под управљањем — база је већ уписана;
    • закључано са разлогом — фајл је искључен маском, величином или списком искључивања. Да бисте га узели, промените правило.
  6. Означите потребне базе и кликните Упиши изабране. RCM ће тражити потврду и приказати број фајлова.

Потврда уписа
Потврда уписа

Шта ово дугме ради:

  • у режиму шаблона — фајлови без потврде додају се на списак искључивања, фајлови са потврдом се уклањају са њега;
  • у режиму списка — фајлови са потврдом додају се на списак укључивања.

Дугме додаје базе онима које су већ под управљањем. Не мења закључане редове. 7. Дугме Упиши примењује образац без измене спискова. 8. Сачекајте поруку о завршетку и број додатих база. Ако дуго нема одговора, резултат проверите на страници Команде.

Са HQbird 2027.2.24 и новијим порука је „Уписано: N“. Ако Firebird мастера треба поново да се покрене, RCM каже које дугме да притиснете (обично Поново покрени мастер Firebird у реду базе) и даје везу ка базама мастера. RCM 2027.5.7 може да каже „Нема нових погодних база“, иако су базе додате: проверите страницу Базе.

Резултат уписа
Резултат уписа

Ако после уписа није пронађена ниједна база, а чвор је већ имао базе, чвор одбија (409) и враћа стара правила. Тако грешка у путањи не искључује репликацију свих база.

Исто из командне линије

Command
hqbirdrcm enroll-databases -node node-a -root /databases/master

Напомена: команда шаље само поља из својих параметара. Остала правила (маске, величине, спискови укључивања и искључивања, sync_tables) чвор ће ресетовати. Команда нема параметре за ова правила. Пре покретања команде проверите тренутна правила (hqbirdrcm getconfig -node node-a). Ако су постављена, користите страницу уписа.

3.4. Шта се дешава после регистрације

  1. Чвор пише правила у node.json.
  2. Чвор скенира фолдер (scansync).
  3. За сваку пронађену базу чвор пише блок у сопствену област replication.conf (између редова # BEGIN managed-by:node-a role:master и # END …) и прави фолдере <database>.ReplLog и <database>.LogArch. Чвор не мења текст ван сопствене области.
  4. Пре измене чвор чува копију фајла: replication_YYYYMMDD_hhmmss_NNN.conf.
  5. Ако се replication.conf променио, базе улазе у стање PENDING_RESTART: Firebird ће нови фајл прочитати тек после поновног покретања. У табели Чворови то се види у колони Чека поновно покретање.
Колона „Чека поновно покретање“ у табели „Чворови“
Колона „Чека поновно покретање“ у табели „Чворови“

Стања нове базе:

Стање Група у RCM Значење
UNCONFIGURED На чекању база је пронађена, конфигурација још није уписана
PENDING_RESTART На чекању конфигурација је уписана, потребно је поновно покретање Firebird-а
CONFIGURED На чекању Firebird је поново покренут, база је спремна за публикацију и иницијализацију

3.5. Поновно покретање Firebird-а мастера

Чвор мастера никада сам не покреће Firebird поново. Ни RCM. Поновно покретање мастера је одлука оператера: поновно покретање прекида све везе ка свим базама те инстанце Firebird-а.

Изаберите време слабог оптерећења и кликните једно од дугмади:

  • Поново покрени мастер Firebird — на страници Базе, у реду мастера базе која чека поновно покретање;
  • исто дугме у прозору Иницијализуј, поглавље 5;
  • Поново покрени Firebird — на страници базе.

RCM ће тражити потврду. Приказује име чвора и упозорење: Firebird ће се поново покренути одмах, без прозора поновног покретања, и све везе ће бити прекинуте.

Потврда поновног покретања Firebird-а мастера
Потврда поновног покретања Firebird-а мастера

Исто из командне линије

Command
hqbirdrcm restartfirebird -node node-a

И ова команда поново покреће одмах, без прозора поновног покретања.

Како чвор поново покреће Firebird:

  1. Проверава да fbagent одговара и управља истом инстанцом (идентификатор, порт, име сервиса из node.json). Ако се било која вредност не поклапа, чвор одбија.
  2. Тражи од fbagent-а да поново покрене Firebird.
  3. Чека да Firebird одговори на свом порту.
  4. Премешта базе из PENDING_RESTART у CONFIGURED.

Неколико инстанци HQbird на једном хосту. fbagent поново покреће сервисе наведене у firebird.update.services своје конфигурације. Празан списак значи све сервисе HQbird на хосту. Ако на хосту постоје две инстанце HQbird, у списку оставите само сервис своје инстанце. У супротном поновно покретање једног чвора зауставиће и другу инстанцу.

На Windows-у. Ако је replication.log нарастао до log_portion_mb или више, поновно покретање иде овако: заустави Firebird → архивирај дневник → покрени.

3.6. База која се већ репликује ручно

Ако је репликација за базу већ подешена ручно (сопствени блок у replication.conf, публикација укључена, сегменти теку), може да се стави под управљање без поновне иницијализације реплике. За то постоји режим detect_existing (само мастер).

  1. Покрените преглед:

    Command
    hqbirdrcm enroll-databases -node node-a -root /databases/master -detect-existing -dry-run

    У одговору taken_over наводи базе које ће бити пренете. Додајте -verbose да видите прескочене базе са разлогом.

  2. Ако је списак тачан, покрените команду без -dry-run.

Чвор преноси блок само ако:

  • фолдери сегмената се зову тачно <database>.ReplLog и <database>.LogArch;
  • сегменти већ постоје у архиви;
  • публикација је укључена у бази.

Чвор не преноси блок са другим путањама и пријављује га као „пронађено, али није подржано“.

После преноса базе добијају PENDING_RESTART, иако се подешавања репликације не мењају: мења се само положај блока у фајлу. Поново покрените Firebird у прозору одржавања.

3.7. Како проверити

  • Базе: база је видљива у реду чвора мастера, стање CONFIGURED (после поновног покретања).

  • Поред базе може да буде икона публикација ИСКЉУЧЕНА: публикација још није укључена. То је нормално, публикација је следећи корак (поглавље 6).

    Нова база у реду мастера
    Нова база у реду мастера
  • На хосту чвора: блок базе је присутан у replication.conf унутар области managed-by:node-a, а поред базе су фолдери .ReplLog и .LogArch.

3.8. Уклоните базу из управљања

Уобичајен начин је дугме. На страници Базе означите базе, изаберите групну радњу Уклони из управљања и кликните Примени на изабране. RCM:

  1. додаје фајлове на списак искључивања чвора;
  2. једном скенира фолдер: блокови базе се уклањају из replication.conf;
  3. брише записе базе у чвору.

Фајлови базе и фолдери сегмената остају на диску. Firebird се не покреће поново. Firebird наставља да пише сегменте базе до следећег поновног покретања; RCM ће рећи ако је поновно покретање потребно.

RCM ће одбити (has_replicas) за базу мастера која има живу реплику: иначе би реплика тихо стала. Прво реплику претворите у обичну базу или је уклоните (поглавље 8).

Не бришите блок базе из replication.conf ручно: при следећем скенирању чвор ће га поново уписати.

Ако је фајл базе нестао или је искључен правилом. Тада база добија стање ORPHANED (група Напуштене). Чвор чува њен запис и архиву сегмената: недостајућа база је чешће грешка него одлука. Ако се фајл врати, база поново ради и упозорење се скида. Да бисте такву базу трајно обрисали, урадите два корака овим редом:

Command
# 1. delete the segment archive (optional)
hqbirdrcm cleanuparchive -node node-a -db <db_id> -orphaned
# 2. delete the database record
hqbirdrcm forgetdatabase -node node-a -db <db_id>

После forgetdatabase команда cleanuparchive више неће наћи базу. Обе команде раде само за базу у стању ORPHANED и не дирају фајл базе.

Опрез. После унапређења реплике у мастер (поглавље 8) немојте да покрећете cleanuparchive -orphaned за стари запис: нови мастер користи исти фолдер .LogArch, и команда ће обрисати његову радну архиву.

3.9. Промена корена база

Регистрација са другом путањом је дозвољена. Чвор:

  • додаје базе из новог фолдера;
  • базе из старог фолдера које нису у новом премешта у ORPHANED (обавештење orphaned_database) и чува њихове архиве.

Ако сте изабрали погрешан фолдер, поново региструјте исправан фолдер. База са истом пуном путањом наставиће да ради под истим db_id. База на другој путањи је нова база (нови db_id); њена реплика мора поново да се иницијализује.

3.10. Честе грешке

Шта видите Узрок Шта урадити
preflight failed on node-a нема овлашћења на фолдерима исправите овлашћења, покушајте поново (3.2)
409 scan_would_empty_region нови фолдер не садржи базе, а чвор их је имао проверите путању и маску
Преглед је празан маска не одговара или је фолдер погрешан проверите путању, маску, „рекурзивно“
Дугмад су искључена, „Није успело читање конфигурације чвора“ чвор не одговара проверите сервис чвора и мрежу (поглавље 1)
База дуго остаје у PENDING_RESTART мастер сам не покреће Firebird поново поново покрените Firebird (3.5)
Поновно покретање одбијено због fbagent-а fbagent не ради или се његови подаци не поклапају са node.json поглавље 1, провера fbagent-а
Нови фајл се није појавио чвор је у режиму списка додајте фајл преко „Упиши изабране“

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

Ово поглавље покрива цео пут базе од примарне до радне реплике, плус рачун простора на диску. Сама иницијализација детаљно је описана у поглављу 5.

4.1. Главно правило

База се на реплици појављује само кроз иницијализацију са мастера (reinit): чвор мастера сам преноси копију преко nbackup.

Не правите копију ручно:

  • gbak прави нови GUID базе и ресетује број сегмента. Веза мастер — реплика се прекида.
  • Копија фајла базе која ради није доследна, и RCM ће видети две базе са истим GUID (duplicate_guid) и забраниће иницијализацију.

Већ радна реплика подешена ручно може да се стави под управљање без нове копије — види 4.6.

4.2. Фазе

Бр. Фаза Где Стање базе мастера после фазе
1 Регистрација базе на мастеру поглавље 3.3 PENDING_RESTART
2 Поновно покретање Firebird-а мастера поглавље 3.5 CONFIGURED
3 Усклађивање публикације поглавље 6 CONFIGURED, публикација УКЉУЧЕНА
4 Припрема реплике: фолдер, овлашћења, верзија Firebird-а 4.3 —
5 Провера слободног простора на мастеру и на реплици 4.4 —
6 Иницијализација поглавље 5 SEEDING → IN_SYNC
7 Поновно покретање Firebird-а реплике (ако је потребно) поглавље 5.6 реплика почиње да примењује сегменте
8 Провера података поглавље 5.10 —

Фаза 3 је обавезна за Firebird 4/5. Без публикације Firebird мастера не пише измене табела у сегменте, и реплика тихо заостаје за мастером. На страници Базе таква база је означена иконом публикација ИСКЉУЧЕНА. Кликните Усклади публикацију пре иницијализације.

Од HQbird 2027.2.24 прозор Иницијализуј упозорава на ово и нуди дугме Усклади публикацију и иницијализуј, док чвор мастера одбија иницијализацију грешком publication_off (поглавље 5.1). RCM и чвор 2027.5.7 не проверавају публикацију.

HQbird 2.5/3.0. Нема публикација, па се фаза 3 прескаче. Скуп табела одређују филтери додатка replconf (поглавље 6).

Стања базе:

Стање Група у RCM Значење
CONFIGURED На чекању Firebird је прочитао подешавања, реплике још нема
PUBLISHING На чекању усклађивање публикације је у току
SEEDING На чекању иницијализација је у току
IN_SYNC У реду реплика је примила све сегменте
LAGGING На чекању реплика заостаје, сегменти су у реду
NEEDS_REINIT Грешка реплика мора поново да се иницијализује
FAILED Грешка последња иницијализација није успела

4.3. Припрема реплике

Фолдер базе реплике

Чвор реплике ставља сваку базу у сопствени фолдер databases.root на путању:

Code
<databases.root>/<master node name>/<database path relative to the master root>

Пример: мастер node-a са кореном /databases/master и базом /databases/master/sales/employee.fdb. На реплици node-b са кореном /databases/replica база ће бити овде:

Code
/databases/replica/node-a/sales/employee.fdb

Тако се базе са истим именима са различитих мастера не сударају.

Нико не прави корени фолдер аутоматски — ни инсталер, ни HQCenter Admin, ни чвор при покретању. Направите га на један од следећих начина:

  • у прозору Иницијализуј: поље Фолдер реплике, дугме Направи фолдер. Дугме је видљиво само када фолдер не постоји. Са HQbird 2027.2.24, ако чвор реплике још нема databases.root, поље већ садржи /databases/replica/<replica node id>. За реплику на Windows-у поље је празно: унесите фолдер са словом диска. Сваком чвору реплике на истом хосту потребан је сопствени фолдер. Фолдер прави чвор реплике: власник — firebird (или корисник сервиса чвора), овлашћења 2770. Ако чвор не може да га направи, прозор ће приказати команду за хост реплике. Ако наведете други фолдер, RCM ће га уписати у databases.root чвора реплике пре иницијализације;

  • ручно на хосту реплике (Linux):

    Command
    sudo mkdir -p /databases/replica
    sudo chown firebird:firebird /databases/replica
    sudo chmod 2770 /databases/replica

    Бит setgid (2770) је потребан да сви фајлови унутра добију групу Firebird.

Корен реплике можете да промените само док нема база: иначе ће старе базе завршити ван скенирања. Да бисте једну базу ставили на друго место, користите Премести на страници базе.

Овлашћења

Чвор реплике и Firebird морају да могу да пишу у корен база. Чвор проверава да постављени фајлови добију групу фолдера. Ако не могу — одбија са ownership_unfixable и текстом како да се то поправи (обично сервис чвора ради са Group=root).

Са HQbird 2027.2.24 прозор Иницијализуј приказује и фолдер који постоји, али у који сервис чвора не може да пише: текст чвора са командом исправке и дугме Провери поново. RCM 2027.5.7 у том случају каже „Фолдер постоји“: овлашћења проверите сами (hqbirdrcm checkpermissions -node <replica> -root <folder>).

Верзија Firebird-а

Главна верзија Firebird-а на реплици мора да се поклапа са мастером (5.0 → 5.0, 4.0 → 4.0). У супротном реплика ће одбити пре било ког преноса података: incompatible_engine.

Повезаност

Чвор реплике мора да буде партнер мастера, а мастер партнер реплике (поглавље 2). У супротном RCM неће понудити овај чвор у прозору Иницијализуј.

4.4. Колико је простора потребно

Укратко

Где Шта Колико
Мастер, волумен базе слободно пре иницијализације ≥ 105 % величине базе
Реплика, волумен фолдера базе слободно пре иницијализације ≥ 105 % величине базе, са HQbird 2027.2.24 — плус free_space_floor_gb (плус стари фајл, ако је реплика већ постојала; са пољем Уклони стару реплику — без њега)
Мастер, <database>.ReplLog радни сегменти Firebird-а до 64 сегмента × величина сегмента (подразумевано 16 MB) ≈ 1 GB по бази
Мастер, <database>.LogArch архива сегмената за реплике измене током retention_days (подразумевано 2 дана) + оно што реплике још нису потврдиле
Реплика, <database>.Incoming ред сегмената за примену до 256 сегмената × 16 MB ≈ 4 GB по бази у најгорем случају
Реплика, цео волумен резерва најмање free_space_floor_gb (подразумевано 1 GB)

Провера простора пре иницијализације

Иницијализација проверава простор двапут и само пре закључавања базе:

  1. RCM — из најновије статистике чвора, пре слања команде. Ако простора очигледно нема довољно, RCM одмах враћа грешку 507.
  2. Чвор мастера — живо мерење на сопственом волумену, затим захтев реплици да измери свој. Ако на бар једној страни нема довољно, иницијализација се завршава на кораку SPACE CHECK грешком insufficient disk space on master или … on replica.

Захтев на обе стране је 105 % величине базе мастера.

Са HQbird 2027.2.24 чвор реплике рачуна овако:

  • потребно му је 105 % величине базе плус free_space_floor_gb реплике (7.3): после иницијализације на волумену остаје резерва за сегменте;
  • остаци претходних иницијализација (<database>.hqcluster-part, <database>.new) рачунају се као слободан простор: чвор их брише пре нове копије;
  • текст грешке наводи све бројеве. Наводи и фајлове <database>.pre-reinit-*.fdb и <database>.failed-seed-*.fdb са њиховом величином. Чвор их никада не брише: обришите их сами ако нису потребни.

force (принудно) прескаче само проверу у RCM. Провера чвора не може да се заобиђе: штити чвор од нестанка диска усред копирања. Ако простора нема довољно само због старе копије реплике, RCM 2027.2.24 у грешци 507 наводи поље Уклони стару реплику, а не force. За то оба чвора морају да буду HQbird 2027.2.24 или новији. У супротном грешка наводи чвор који треба ажурирати, и force.

Зашто толико

Мастер. Током копирања база је закључана са nbackup -L. Све измене се пишу у фајл <database>.delta поред базе. Величина .delta зависи од оптерећења писањем током копирања. Под великим оптерећењем и спорим преносом може знатно да нарасте — пратите простор током прве иницијализације.

Реплика. Копија се пише право у фајл <database>.hqcluster-part поред места базе. Чвор унапред резервише пуну величину. Фајл се затим проверава, поправља (nbackup -FIXUP -SEQUENCE) и преименује на место. Друга копија није потребна — величина базе је потребна једном, на волумену базе.

Ако је реплика већ постојала (поновљена иницијализација), стари фајл стоји на диску до последњег корака. То значи да су на волумену истовремено потребни стари фајл и нова копија. Слободан простор се рачуна без старог фајла — зато је захтев исти: 105 % величине базе слободно.

Уклони стару реплику (са HQbird 2027.2.24). Ако на волумену реплике нема простора за нову копију поред старе, означите ово поље у прозору иницијализације (поглавље 5.1). Чвор реплике тада брише стару копију и њене долазне сегменте (.Incoming) пре преноса, и волумен има довољно за 105 % величине базе плус free_space_floor_gb. Чвор брише копију само ако су сви услови тачни:

  • без брисања нема довољно простора, а са брисањем има;
  • то је копија коју је инсталирала иницијализација овог чвора: заглавље је читљиво, режим је реплика само за читање;
  • база није претворена у обичну (нема фајла <database>.hqcluster-normal.json, поглавље 8);
  • overwrite_non_replica није постављено (5.9).

У супротном чвор ништа не брише и одбија са разлогом у тексту. Да би обрисао, чвор зауставља Firebird реплике за време брисања (5.6).

Поље је подразумевано искључено. Ризик: док је пренос у току, на реплици нема копије базе. Ако база има само једну реплику, мастер је незаштићен цело то време. Док нема нове копије, база на реплици је у стању NEEDS_REINIT (не FAILED и не ORPHANED), а реплика издаје упозорење replica_removed_for_reinit (warn). Када нова копија буде на месту, упозорење се скида. Ако иницијализација не успе после брисања, пар остаје NEEDS_REINIT: поново покрените иницијализацију (или ће је покренути аутоматска поновна иницијализација, 5.8). Нова иницијализација преноси базу од почетка.

Архива мастера (.LogArch). Чвор чува послате сегменте retention_days дана да би реплика могла поново да их затражи. Сегменти које реплика још није применила чувају се дуже. Ако је простора мало, чвор чисти архиву у фазама:

  1. сегменти које су све реплике примениле, старији од retention_days;
  2. примењени сегменти који су новији (када је простора мало);
  3. непримењени сегменти — само у крајњем случају. Тада реплика губи сегменте који су јој потребни и добија NEEDS_REINIT.

Ако је реплика дуго недоступна, архива расте. Њен волумен = измене базе током периода застоја.

Пример рачуна

База 100 GB. Оптерећење — 5 GB сегмената дневно. Иницијализација иде ноћу, копирање траје 2 часа, током којих око 2 GB заврши у .delta.

Где Рачун Укупно слободно
Мастер, волумен базе 105 GB за провере (укључује раст .delta) + .ReplLog 1 GB + .LogArch 2 дана × 5 GB = 10 GB ≥ 116 GB
Реплика, нова база 105 GB + .Incoming до 4 GB + 1 GB резерве ≥ 110 GB
Реплика, поновљена иницијализација стари фајл 100 GB већ на диску + 110 GB слободно волумен ≥ 210 GB
Реплика, поновљена иницијализација са пољем Уклони стару реплику (са HQbird 2027.2.24) стари фајл обрисан пре преноса: 105 GB + .Incoming до 4 GB + 1 GB резерве волумен ≥ 110 GB

Додајте резерву за раст базе и за застој реплике (архива мастера расте за 5 GB по дану застоја).

Сегменти на засебном волумену

Фолдери .ReplLog, .LogArch и .Incoming подразумевано су поред базе. Могу да се преместе на други волумен: параметар segments.storage у node.json (са mirror_hierarchy: true чвор понавља структуру фолдера база). Тада архива не одузима простор базама. Провера од 105 % и даље важи за волумен базе.

Где гледати простор

  • Базе → Чворови и Преглед: икона слободног простора за волумен databases.root. Жуто — мање од 20 %, црвено — мање од 10 %.

    Страница Базе: колона Диск у табели Чворови
    Страница Базе: колона Диск у табели Чворови
  • Извештај кластера: hqbirdrcm report.

4.5. Више реплика једне базе

Друга и следеће реплике праве се на исти начин: Иницијализуј у реду мастера, избором слободног чвора реплике.

  • Док се нова реплика иницијализује, мастер не преноси ову базу ни већ радним репликама. Оне ће сустићи мастер после завршетка иницијализације. Прозор потврде то каже.
  • Једна база — једна иницијализација у исто време, чак и за различите реплике.
  • Простор на мастеру се проверава засебно за сваку иницијализацију.
База мастера са две реплике
База мастера са две реплике

4.6. Ручно подешена реплика

Ако реплика већ ради из ручно написаног replication.conf, можете да је ставите под управљање и не копирате базу поново:

  1. Мастер: региструјте базе са detect_existing (поглавље 3.6).
  2. Реплика: Базе → чвор реплике → Преузми, или hqbirdrcm takeover-replica. RCM ће наћи блокове реплике, упарити фајлове са базама мастера по GUID и за сваку приказати: in_sync, resumable или needs_reinit.
  3. Потврдите редове. Чвор ће преместити блокове у сопствену област replication.conf.
  4. Поново покрените Firebird реплике да прочита премештене блокове.
  5. Иницијализујте само редове needs_reinit: архива мастера више не садржи сегменте који су овим репликама потребни.

4.7. Честе грешке

Шта видите Узрок Шта урадити
insufficient disk space on master / on replica нема довољно простора (4.4). При поновној иницијализацији стара копија заузима простор до краја (4.4) ослободите простор, покушајте поново. Други излаз на реплици (од HQbird 2027.2.24) је поље Уклони стару реплику (4.4, 5.1)
507 од RCM одмах према статистици простора очигледно нема довољно исто. Ако има простора без старе копије, RCM 2027.2.24 наводи поље Уклони стару реплику
incompatible_engine различите главне верзије Firebird-а ажурирајте Firebird реплике
Недостаје фолдер на чвору реплике корен није направљен Направи фолдер у прозору иницијализације (4.3)
Фолдер постоји, али сервис чвора не може да пише у њега (од HQbird 2027.2.24) нема права писања покрените команду из прозора, кликните Провери поново (4.3)
publication_off (од HQbird 2027.2.24) публикација мастера је искључена или нема табела Усклади публикацију и иницијализуј (5.1)
ownership_unfixable сервис чвора има туђу групу поправите групу сервиса како пише у тексту грешке
duplicate_guid две базе са истим GUID (копија фајла) уклоните копију или јој дајте нови GUID (nbackup -F)
Чвор реплике није на списку Иницијализуј нема везе у партнерима поглавље 2
Реплика IN_SYNC, али се подаци разилазе публикација је била искључена ускладите публикацију, затим поновите иницијализацију

5. Иницијализација (reinit)

Иницијализација је пренос копије базе мастера на реплику. Први пренос зове се иницијализација (дугме Иницијализуј), поновљени пренос је поновна иницијализација (дугме Поново иницијализуј). Механизам је исти.

Пре почетка завршите кораке 1–5 из поглавља 4: база је регистрована, Firebird мастера је поново покренут, публикација је укључена, фолдер реплике постоји и има довољно простора. Колико је простора потребно на мастеру и на реплици описано је у поглављу 4.4.

5.1. Како почети

Прво публикација. Регистрација базе не укључује публикацију. Без публикације реплика не прима измене. Пре иницијализације покрените Усклади публикацију (поглавље 6) или hqbirdrcm setpublication -node <master>.

  • Са HQbird 2027.2.24 прозор иницијализације проверава публикацију. Ако је искључена или нема табела са кључем, прозор приказује упозорење и дугме Усклади публикацију и иницијализуј. RCM усклађује публикацију, чека да се команда заврши и покреће иницијализацију са избором из прозора.
  • Чвор мастера 2027.2.24 сам одбија такву иницијализацију (и прву такође) грешком publication_off и издаје обавештење master_publication_off (поглавље 6.1). После одбијања ћелија базе поново има дугме Усклади публикацију и иницијализуј.
  • Ако је оператер искључио публикацију (6.4) или из ње уклонио све табеле са кључем (6.3), усклађивање то чува. RCM не покреће иницијализацију и даје везу ка страници Табеле публикације.
  • RCM и чвор 2027.5.7 не проверавају публикацију: иницијализација успева, база у RCM показује „У реду“, али реплика не прима измене. Ако је публикација укључена после иницијализације — поново иницијализујте базу.
Прозор „Поново иницијализовати базу?“
Прозор „Поново иницијализовати базу?“
  1. Отворите Базе.
  2. У реду базе мастера, у колони чвора реплике, кликните Иницијализуј. Чвор реплике одређује колона: не бира се у прозору. За постојећи пар — Поновна иницијализација у проширеној картици мастера.
  3. У прозору (са HQbird 2027.2.24 наслов за нови пар је „Иницијализовати базу?“; у RCM 2027.5.7 — „Поново иницијализовати базу?“ и такође при првој иницијализацији):
    • проверите Фолдер реплике. Прозор показује да ли фолдер постоји. Ако не постоји, кликните Направи фолдер: чвор реплике ће га направити (4.3). Ако чвор не може да га направи, прозор приказује команду за хост реплике. Са HQbird 2027.2.24 прозор приказује и фолдер у који сервис чвора не може да пише: команду исправке и дугме Провери поново;
    • изаберите Метод поновне иницијализације: Глатко (препоручено) или Стандардно (5.4). Са HQbird 2027.2.24, ако архива мастера још нема сегмената (обично пре прве иницијализације), прозор приказује наговештај: на заузетој бази Стандардно је брже;
    • ако база мастера још чека поновно покретање Firebird-а, прозор ће то рећи и приказати дугме Поново покрени мастер Firebird. Без поновног покретања база се не репликује;
    • Уклони стару реплику (са HQbird 2027.2.24, подразумевано искључено) потребно је само за поновну иницијализацију када волумен реплике нема простора за нову копију поред старе (4.4). Прозор унапред приказује бројеве: колико је потребно, колико је слободно, колико стара копија заузима. Ако има простора без старе копије, прозор тражи да означите поље. Поље је неактивно ако је чвор мастера или реплике стара верзија: прозор наводи који чвор да ажурирате. Док нова копија није спремна, реплика нема копију ове базе (4.4).
  4. Потврдите. RCM ће навести да ће база бити закључана на мастеру и копирана на реплику.

Напредак иницијализације видљив је у проширеној картици мастера на страници Базе: кораци и проценти. Са HQbird 2027.2.24 напредак је видљив и после освежавања странице: при првој иницијализацији — у ћелији чвора реплике, и такође у реду Напредак поновне иницијализације на страници базе мастера. Дугме Иницијализуј је неактивно док чвор мастера копира базу. Ако RCM не прати ову иницијализацију (на пример, покренута је из командне линије чвора), кораци се узимају из стања чвора, без процената. У RCM 2027.5.7, после освежавања странице напредак прве иницијализације није видљив: сачекајте док база мастера не изађе из SEEDING.

Кораци иницијализације у реду мастера
Кораци иницијализације у реду мастера

Свака команда RCM (иницијализација, поновно покретање Firebird-а, усклађивање публикације) бележи се на страници Команде са резултатом.

Страница „Команде“
Страница „Команде“

Исто из командне линије

Command
# one database
hqbirdrcm reinit -node node-a -db <db_id> -to node-b
# all master databases
hqbirdrcm reinit -node node-a -all -to node-b

Параметри: -mode smooth|standard (подразумевано smooth), -hold=false (не задржавај архиву током дугих трансакција), -allow-restart (5.6), -force (5.9).

-remove-old-replica (са HQbird 2027.2.24) — исто као поље Обриши стару реплику. Само за једну базу: -db и -to су обавезни; са -all команда одбија. Ако је чвор мастера или реплике стара верзија, RCM одбија са node_too_old и ништа не шаље.

Command
hqbirdrcm reinit -node node-a -db <db_id> -to node-b -remove-old-replica

-all покушава све базе и сакупља грешке уместо да стане на првој.

5.2. Кораци

Бр. Корак (у RCM) Шта се дешава
1 SPACE CHECK проверава простор на мастеру и на реплици (поглавље 4.4); реплика унапред проверава да може да прихвати фајл
2 LOCKING nbackup -L: фајл базе мастера је замрзнут, измене иду у <database>.delta
3 COPYING TO NODE фајл се преноси у деловима: читање → контролни збир → компресија → слање
4 UNLOCKING nbackup -N одмах после преноса: измене из .delta се враћају у базу
5 SEEDING на реплици: провера контролног збира фајла, nbackup -FIXUP -SEQUENCE, постављање фајла, gfix -replica, упис блока у replication.conf
6 RESTARTING REPLICA поновно покретање Firebird-а реплике, ако је потребно (5.6)

После корака 6 база добија стање IN_SYNC. Мастер наставља да шаље сегменте од тачке где се копија завршава.

Шта је важно знати:

  • Мастер ради све време. Корисници пишу у базу, измене иду у .delta. Закључавање се скида одмах после преноса.
  • Трансакције које су се поклопиле са закључавањем се не губе. Чвор налази трансакције отворене у тренутку nbackup -L, а реплика их поново изводи из сегмената.
  • Пренос се наставља после прекида. Ако се веза или чвор реплике поново покренуо, мастер ће наставити од последњег примљеног дела. Недовршен пренос се на реплици чува 24 часа (reinit_partial_keep_hours).
  • При грешци чвор скида закључавање, брише недовршен фајл на реплици и поставља базу у FAILED. Следећи покушај почиње из познатог стања.
  • Са пољем „Обриши стару реплику“ (од HQbird 2027.2.24) реплика брише стару копију после корака LOCKING, пре преноса. Корак COPYING TO NODE у то време приказује „уклањање старе копије реплике да би се направио простор“. Грешка после брисања даје пару NEEDS_REINIT, а не FAILED (поглавље 4.4).
  • Само nbackup. gbak се не користи: мења GUID базе.

5.3. Утицај на рад

Шта Утицај
Корисници мастера настављају да раде; током копирања .delta расте, после -N измене се преносе у базу
Друге реплике ове базе не примају сегменте ове базе док је иницијализација у току; сустижу после
Друге базе мастера нису погођене
Firebird реплике, нова база није заустављен; поновно покретање према 5.6
Firebird реплике, поновљена иницијализација заустављен је док се фајл замењује: све базе овог Firebird-а недоступне су неколико секунди
Firebird реплике, чвор брише стару копију (поље „Обриши стару реплику“, од HQbird 2027.2.24) заустављен је раније, док је брисање у току, пре преноса. Чвор поставља нову копију без другог заустављања ако се блок базе у replication.conf није променио. Ако има довољно простора и брисање није потребно, чвор ништа не брише, и све иде као при обичној поновљеној иницијализацији
Мрежа и диск оптерећење према ограничењима брзине (5.5)

На Windows-у. Фајл који је Firebird отворио не може да се замени. Током поновљене иницијализације чвор зауставља Firebird реплике преко fbagent-а, поставља фајл и поново покреће Firebird. На Linux-у се Firebird такође зауставља пре замене: иначе би наставио да ради са старим обрисаним фајлом.

5.4. Глатки и стандардни метод

Глатко (подразумевано). Пре закључавања чвор тражи дуге трансакције: корисничке трансакције писања које су почеле пре најстаријег сегмента у архиви мастера. После иницијализације реплика неће моћи да их поново изведе и зауставиће се на њиховој првој измени („Трансакција … није пронађена“). Трансакције без измена се не рачунају.

Ако такве трансакције постоје, иницијализација не почиње: RCM приказује Глатка поновна иницијализација чека дуге трансакције и даје везу Отвори списак.

Страница дугих трансакција: нема дугих трансакција
Страница дугих трансакција: нема дугих трансакција

На страници Дуге трансакције:

  • сажетак: колико трансакција и веза, најстарији сегмент;
  • Првих 5 веза са најстаријим трансакцијама: корисник, клијент, почетак, старост, измене, тренутни упит;
  • Задржи сегменте / Отпусти задржавање — док је задржавање укључено, архива мастера се не чисти и историја се не скраћује;
  • Прекини изабране и понови иницијализацију — прекида везе (њихове трансакције се поништавају) и одмах покреће глатку поновну иницијализацију;
  • Понови иницијализацију, Провери поново.

Задржавање се укључује аутоматски када је поновна иницијализација одбијена због дугих трансакција. Скида се после успешне иницијализације, ручно, или када архива нарасте до reinit_hold_max_segments (подразумевано 1000 сегмената, обавештење retention_hold_released).

Стандардно одмах закључава базу, без провере. Користите га само ако знате да нема дугих трансакција писања.

Прва иницијализација под оптерећењем. Док је архива мастера празна, нема сегмента за поређење.

Са чвором мастера HQbird 2027.2.24: ако је чвор сам укључио публикацију и архива се од тада није променила, историја почиње у тренутку када је публикација укључена. Трансакција започета касније улази у дневник од своје прве измене и не смета глатком методу. Трансакција започета раније није ушла у дневник: поновна иницијализација је чека пре закључавања (6 покушаја сваких 10 s), а корак locking приказује њен број, везу и корисника. Ако се није завршила, поновна иницијализација се завршава грешком reinit_pre_publication_transactions: завршите је и покушајте поново. Страница Дуге трансакције такве трансакције приказује у табели Трансакције започете пре него што је публикација укључена.

Ако је публикација укључена ручно, не преко чвора, или се архива већ променила, почетак историје је непознат. У том случају глатки метод одбија ако је било која трансакција писања отворена, а порука каже да архива још не садржи сегмент. У том случају RCM 2027.2.24 не отвара списак, него у ћелију базе пише шта да се уради. Изаберите Стандардно или покушајте поново када Firebird архивира први сегмент.

Са чвором мастера 2027.5.7 глатки метод одмах одбија при првој иницијализацији базе у коју се тренутно пише: long_transactions … segment 0 (0001-01-01T00:00:00Z). За прву иницијализацију такве базе изаберите Стандардно.

За следеће поновне иницијализације глатки метод ради као обично (архива већ постоји).

Исто из командне линије

Command
hqbirdrcm longtx -node node-a -db <db_id>                       # list
hqbirdrcm longtx -node node-a -db <db_id> -disconnect 12,34 -retry-to node-b
hqbirdrcm longtx -node node-a -db <db_id> -hold false           # release hold

Трансакције старије од публикације. Firebird не пише у сегменте трансакцију која је почела пре него што је публикација укључена. Ако је чвор укључио публикацију, иницијализација чека (6 покушаја сваких 10 секунди) док се такве трансакције не заврше; у супротном се завршава грешком reinit_pre_publication_transactions која их наводи. После усклађивања публикације која је додала табеле, поново повежите апликације, затим покрените иницијализацију.

5.5. Брзина

Када Брзина Подешавање
Унутар прозора преноса windows.transfer_window (подразумевано 23:00-05:00) стална limits.reinit_window_mbps, подразумевано 100 MB/s
Ван прозора удео измерене брзине диска limits.reinit_day_disk_fraction, подразумевано 0.5

Чвор поново рачуна режим сваких 30 секунди: иницијализација започета дању сама ће убрзати ноћу.

Чвор мери брзину диска тестом. Да бисте тест поновили на хосту мастера:

Command
hqclusternode benchmark -config /opt/hqclusternode/master/node.json

Време иницијализације ≈ величина базе ÷ брзина. Пример: 100 GB при 100 MB/s — око 17 минута чистог преноса; у пракси ограничавају мрежа или диск.

5.6. Поновно покретање Firebird-а реплике

Нова база на реплици. Фајл се поставља без заустављања Firebird-а. Firebird ће нови блок replication.conf прочитати тек после поновног покретања. До тада реплика ништа не примењује. Корак RESTARTING REPLICA приказује чекање:

Ознака Шта значи
чека се поновно покретање Firebird-а на реплици, заказано је за … чвор ће сам поново покренути Firebird после последње иницијализације (reinit_restart_delay_sec), када се остале иницијализације заврше
… прозор поновног покретања је затворен, следећи ће се отворити у … чека се restart_window реплике
… последњи покушај није успео, следећи у … покушаће касније
реплика не може сама да поново покрене Firebird: покрените га ручно auto_restart: never, или овај Firebird такође служи базе мастера

Чвор поново покреће Firebird једном после низа иницијализација, а не после сваке базе.

Да бисте поново покренули ручно, кликните Поново покрени Firebird реплике. Чекање се завршава после било ког успешног поновног покретања Firebird-а или када реплика примени сегмент новији од копије.

Поновна иницијализација на Firebird-у који такође служи базе мастера. Чвор сам не зауставља такав Firebird и одбија са restart_not_allowed. Поново покрените иницијализацију и означите Дозволи <чвору> да заустави Firebird за ову поновну иницијализацију (-allow-restart у командној линији) — у време када везе овог Firebird-а могу да се прекину, укључујући ка његовим базама мастера. Такве иницијализације водите једну по једну по хосту.

Брисање старе копије (поље Уклони стару реплику, са HQbird 2027.2.24) такође зауставља Firebird реплике, по истим правилима. Ако чвор не може сам да заустави овај Firebird, ништа не брише и одбија са restart_not_allowed: такође означите Дозволи <чвору> да заустави Firebird за ову поновну иницијализацију. Ако у то време друга иницијализација завршава на реплици или се Firebird поново покреће, чвор ништа не брише и одбија са engine_busy: мастер скида закључавање, покушајте касније.

5.7. Ред и истовремене иницијализације

  • Једна база — једна иницијализација у исто време (чак и за различите реплике). Дугме Иницијализуј је искључено док је иницијализација ове базе у току.
  • Чвор мастера спроводи limits.max_concurrent_reinits иницијализација различитих база истовремено (подразумевано 1). Остале чекају у реду; одговор садржи место у реду.
  • Не покрећите сопствени nbackup -L (или ALTER DATABASE BEGIN BACKUP) на бази током њене иницијализације, и не покрећите иницијализацију током такве резервне копије: база може да има само једно закључавање. Иницијализација то проверава и одбија са nbackup backup lock already active.

Ред и тренутни преноси видљиви су на страници Пренос.

Страница Пренос / редови
Страница Пренос / редови
  • Ако после отказа остане фајл <database>.delta, уверите се да резервна копија не ради и покрените nbackup -N <database>. Не бришите .delta ручно.

5.8. Аутоматска поновна иницијализација

RCM може сам да поново иницијализује базу у стању NEEDS_REINIT, само унутар подешеног прозора. Подразумевано искључено.

Када база уђе у NEEDS_REINIT:

Узрок Где је видљиво
понављајућа непоправљива грешка примене (кршење PK, UNIQUE, FK) — 3 пута заредом реплика, упозорење replication_unrecoverable_error
GUID базе мастера се променио (обнова, замена фајла) реплика, упозорење replication_guid_mismatch
архива мастера више не садржи сегменте који су реплици потребни мастер
реплика је обрисала стару копију за иницијализацију и нове копије још нема (од HQbird 2027.2.24) реплика, упозорење replica_removed_for_reinit; мастер

Да бисте укључили — Подешавања → RCM (или rcm.json, одељак auto_reinit):

json
"auto_reinit": {
  "enabled": true,
  "default_window": "22:30-04:00",
  "max_concurrent": 1,
  "nodes": {
    "node-a": { "window": "23:00-05:00",
                "databases": { "sales/employee.fdb": "01:00-03:00" } }
  }
}
  • Прозор: по бази → по чвору → глобално. "always" — у било које време.
  • Прозори се рачунају по сату хоста RCM.
  • max_concurrent — колико иницијализација (ручних и аутоматских) сме да буде у току у кластеру да би RCM покренуо још једну аутоматску.
  • Аутоматска иницијализација пролази исте провере простора и GUID као ручна. Аутор команде је system:autoreinit.
  • remove_old_replica_when_short (од HQbird 2027.2.24, ред Обриши стару реплику када нема простора) — подразумевано искључено. Ако је укључено, аутоматска иницијализација шаље ознаку Обриши стару реплику (4.4). RCM је шаље само ако је сама реплика у NEEDS_REINIT или узрок NEEDS_REINIT мастера је наводи. За реплику која је IN_SYNC или LAGGING ознака се никада не шаље. Ако је чвор старија верзија, RCM покреће исту иницијализацију без ознаке.
  • После измене поново покрените RCM.

Одложи у картици мастера искључује аутоматску иницијализацију једне базе на 1 час, 4 часа, 24 часа или док се не откаже. Ручна иницијализација остаје доступна.

5.9. Грешке

Грешка Узрок Шта урадити
insufficient disk space on master / on replica, 507 нема довољно простора. Током поновне иницијализације стара копија заузима простор до краја поглавље 4.4; на реплици (од HQbird 2027.2.24) — поље Уклони стару реплику (5.1)
node_too_old (од HQbird 2027.2.24) поље Уклони стару реплику је означено, али је чвор мастера или реплике стара верзија ажурирајте чвор како пише у тексту грешке или покрените без поља
engine_busy, reclaim_in_progress (од HQbird 2027.2.24) реплика сада не може да обрише стару копију: Firebird или ова база је заузета покушајте касније (5.6)
replica_removed_for_reinit, пар NEEDS_REINIT (од HQbird 2027.2.24) реплика је обрисала стару копију, али се иницијализација није завршила поново покрените иницијализацију (4.4)
publication_off (од HQbird 2027.2.24) публикација мастера је искључена или не садржи табеле са кључем Усклади публикацију и иницијализуј (5.1)
long_transactions, „Глатка поновна иницијализација чека дуге трансакције“ отворене су дуге трансакције писања 5.4
long_transactions, „архива мастера још не садржи ниједан сегмент“ прва иницијализација под оптерећењем Стандардно (5.4)
reinit_pre_publication_transactions трансакције започете пре него што је публикација укључена поново повежите апликације, покушајте поново
duplicate_guid две базе мастера са истим GUID уклоните копију; ако је корак NEW GUID прескочен при унапређењу у мастер — -force (поглавље 8.4)
license_paused fbagent мастера нема лиценцу поглавље 2.8
409 orphaned база је ван скенирања мастера поглавље 3.8
incompatible_engine различите главне верзије Firebird-а поглавље 4.3
target_not_replica на месту реплике стоји радна база (претворена је у обичну) види ниже
target_other_replica (од HQbird 2027.2.24) на месту реплике стоји копија друге базе овог чвора види ниже
restart_not_allowed Firebird реплике такође служи базе мастера 5.6, поље „Дозволи … да заустави Firebird“
fbagent_required fbagent није инсталиран на реплици поглавље 1
nbackup backup lock already active у току је резервна копија nbackup 5.7
… -L did not finish in 2m0s and was stopped nbackup -L на мастеру није завршио за 2 минута, па га је чвор зауставио покушајте поново; ако се грешка понавља, проверите Firebird мастера (firebird.log)
reinit already in progress for this database иницијализација ове базе већ ради сачекајте да се заврши

target_not_replica. На месту копије стоји радна база: претворена је у обичну (постоји фајл <database>.hqcluster-normal.json) или није у режиму реплике. Чвор не преписује радну базу. Ако треба да се замени, захтев ка API чвора са overwrite_non_replica: true (у RCM нема дугмета за ово) замениће фајл и стари сачувати као <database>.pre-reinit-<UTC time>.fdb.

target_other_replica (од HQbird 2027.2.24). Реплика ставља копију у <databases.root>/<master id>/<database path>. Идентификатор мастера је јединствен само унутар сопственог кластера, па две базе могу да заврше на истој путањи. Чвор реплике не преписује копију која припада другој његовој бази: грешка наводи ту базу и њеног мастера. Чвор препознаје и копију чија је путања другачије записана (симболичка веза или спојница у путањи, кратко име Windows фолдера). overwrite_non_replica не скида ову грешку. Преместите једну од копија у други фолдер или уклоните ту базу са реплике, затим поново покрените иницијализацију. Чвор види само сопствене базе: два чвора реплике на истом хосту морају да имају различите фолдере реплике (databases.root).

5.10. Како проверити резултат

  1. Базе: пар мастер — реплика у групи је У реду, стање IN_SYNC.

  2. Провери у картици мастера: чворови броје редове табела са списка табела базе (поглавље 3.1) на мастеру и на реплици и пореде их. Проверавајте у мирном времену: при активном писању бројеви могу да се разликују.

    Са HQbird 2027.2.24 страница резултата наводи списак сваке стране (на пример, „сопствени списак ове базе“ или „табеле публикације (списак није постављен)“). RCM броји реплику списком мастера. Табела која недостаје у обе базе приказује се као „није у бази“ и не рачуна се као грешка. Ако ниједна табела није поређена, резултат је „Нема табела за поређење“, а не неслагање. Ако поређење није завршено у предвиђеном времену, резултат је „Није поређено (временско ограничење)“, што такође није неслагање.

Резултат провере
Резултат провере
Command
hqbirdrcm verifydata -master node-a -master-db <db_id> -replica node-b -replica-db <db_id>
  1. Периодична провера (опционо): страница Провера података, Укључи за све чворове. Са HQbird 2027.2.24 чвор примењује подешавања одмах, поновно покретање сервиса чвора није потребно: после Сачувај RCM пише „Сачувано и већ на снази“. Чвору 2027.5.7 потребно је поновно покретање сервиса hqclusternode, и RCM 2027.2.24 то каже. Чворови сами пореде број редова када су мастер и реплика на истом сегменту. Неслагање подиже упозорење data_mismatch; затим покрените Провери.

Табела коју је оператер уклонио из публикације приказује се као „није објављена“, а не као неслагање.

6. Подешавање публикације

Публикација каже мастеру Firebird-а измене којих табела да пише у сегменте. Без ње реплика не прима ништа.

6.1. Шта је публикација

У Firebird 4 и 5 табеле које се репликују одређује публикација RDB$DEFAULT:

  • Публикација укључена — у RDB$PUBLICATIONS има RDB$ACTIVE_FLAG = 1 (команда ALTER DATABASE ENABLE PUBLICATION).
  • Објављене табеле — списак у RDB$PUBLICATION_TABLES.

Firebird пише измене у сегменте само за објављене табеле и само када је публикација укључена. Регистрација базе (поглавље 3) не укључује публикацију. Укључује је Усклади публикацију (6.2).

Чвор мастера проверава публикацију сваки час (limits.publication_check_interval_sec, подразумевано 3600). Ако је искључена, чвор је проверава свака 2 минута.

На страници Базе база мастера има икону:

Икона Значење
публикација УКЉУЧЕНА публикација је укључена
публикација ИСКЉУЧЕНА Firebird ништа не пише у сегменте, реплике не примају измене
публикација непозната чвор није могао да прочита стање

Филтер Публикација искључена приказује базе са искљученом или непознатом публикацијом.

Ако база са искљученом публикацијом већ има реплику, мастер подиже упозорење master_publication_off.

Са HQbird 2027.2.24 мастер подиже ово упозорење и када је одбио да иницијализује базу грешком publication_off (поглавље 5.1): публикација је искључена или не садржи табелу са кључем. Ниво упозорења:

  • warn — база још нема реплику: иницијализација чека публикацију;
  • serious — база већ има реплику;
  • info — оператер је искључио публикацију.

Упозорење се скида када се публикација поправи или када је друга иницијализација почела.

6.2. Усклади публикацију

Ред мастера: публикација искључена
Ред мастера: публикација искључена

Где кликнути:

  • у реду базе мастера на страници Базе. Када је публикација искључена, дугме је поред иконе;
  • на страници базе;
  • за неколико база: означите редове, у списку Радња изаберите Усклади публикацију. RCM ће послати засебну команду за сваку базу.
Потврда усклађивања публикације
Потврда усклађивања публикације

Шта чвор ради (једна трансакција):

  1. Укључује публикацију. Ако ју је оператер сам искључио (6.4), не укључује је.
  2. У публикацију додаје све табеле са кључем којих још нема.
  3. Из публикације уклања табеле без кључа и табеле које је оператер искључио (6.3).
  4. Искључује аутоматско додавање нових табела (EXCLUDE ALL FROM PUBLICATION, затим додаје потребне табеле). Састав публикације одређује само чвор.
Ред мастера после усклађивања: публикација укључена
Ред мастера после усклађивања: публикација укључена

Табела са кључем — корисничка стална табела која има примарни кључ или активан јединствени индекс. Системске и привремене табеле се не објављују.

Усклађивање из публикације уклања и табеле без кључа које је DBA додао ручно.

Ако је састав већ исправан, чвор ништа не мења.

Када чвор одбија:

Код Разлог
no_publications HQbird 2.5/3.0 (6.6)
not_master чвор није мастер
reinit_in_progress иницијализација ове базе је у току
orphaned, database_failed, file_missing база је ван скенирања, у грешци, или нема фајл

Све базе чвора одједном — само из командне линије. На страници Команде резултат се приказује по бази: готово, прескочено или грешка. Базе у стању FAILED или SEEDING и базе без фајла се прескачу.

Исто из командне линије

Command
hqbirdrcm setpublication -node node-a -db <db_id>   # one database
hqbirdrcm setpublication -node node-a               # all node databases

Команда чека до 5 минута и исписује ред за сваку базу. При грешци излазни код је 1. -nowait — не чекај резултат.

6.3. Табеле публикације

Страница „Табеле публикације“
Страница „Табеле публикације“

Отворите Табеле публикације у реду базе мастера.

Страница приказује:

  • стање публикације (укључено/искључено, искључио оператер) и бројаче;
  • сваку табелу: име, кључ и стање.
Стање Значење
објављена измене иду у сегменте
још није објављена табела са кључем, биће додата при усклађивању
искључена оператер ју је уклонио из публикације
нема кључ не може да се објави

У колони кључа — примарни кључ, или, ако га нема, јединствени индекс са најмањим бројем поља.

Зашто табела без кључа не може да се објави. Реплика тражи ред за UPDATE и DELETE по кључу. Без кључа неће наћи ред. Додајте примарни кључ или јединствени индекс, затим ускладите публикацију.

Искључи из публикације / Врати у публикацију:

  1. Означите табеле.
  2. Кликните Искључи из публикације или Врати у публикацију.
  3. Чвор чува списак и одмах усклађује публикацију.
Потврда „Искључи из публикације“
Потврда „Искључи из публикације“

Списак искључених табела чува се на чвору мастера. Усклађивање га не мења. Када се реплика унапреди у мастер (поглавље 8), списак прелази на новог мастера.

Провера (поглавље 5.10) искључену табелу приказује као „није објављена“, а не као одступање.

6.4. Укључивање и искључивање публикације

На страници Табеле публикације: Искључи публикацију / Укључи публикацију.

  • Искључивање је избор оператера. Усклађивање не укључује публикацију поново.
  • Измене направљене док је публикација искључена (или док је табела искључена) се не шаљу реплици, чак ни после укључивања.
  • После укључивања кликните Провери (поглавље 5.10). Ако се подаци разилазе — поново иницијализујте реплику (поглавље 5).

6.5. Нова табела

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

После DDL:

  1. Направите примарни кључ или јединствени индекс на табели.
  2. Кликните Усклади публикацију.
  3. Замолите апликације да се поново повежу ако је потребна поновна иницијализација. Firebird не пише у сегменте трансакције које су почеле пре него што је публикација укључена; COMMIT RETAINING такву трансакцију држи отвореном. Иницијализација чека такве трансакције, а затим пада са reinit_pre_publication_transactions (поглавље 5.4).
Нова табела у стању „још није објављена“
Нова табела у стању „још није објављена“

Редови уписани у нову табелу пре усклађивања неће стићи до реплике. Ако их има, проверите податке и, ако је потребно, поново иницијализујте реплику.

6.6. HQbird 2.5 и 3.0

HQbird 2.5 и 3.0 немају публикације. Firebird пише сегменте ако фајл додатка replconf садржи блок мастера. Дугмад публикације на таквим чворовима су скривена, а API одговара са no_publications.

Скуп табела одређују параметри мотора:

Параметар Значење
include_filter које табеле репликовати: имена или обрасци раздвојени зарезима; празно — све
exclude_filter које табеле не репликовати

Параметри се мењају у Подешавања → Параметри репликације (поглавље 7.1). Страница Табеле публикације их приказује само за читање, са везом Измени у подешавањима мотора. Firebird нове вредности чита после поновног покретања.

Табеле публикације на HQbird 3.0: филтери мотора
Табеле публикације на HQbird 3.0: филтери мотора

Додатак replconf. Чвор пише сопствени фајл replconf.hqcluster.hqbird у фолдеру Firebird-а. Firebird га чита само када replconf.properties показује на њега. Додатак мора једном да се активира:

  1. Подешавања → Чворови, блок Додатак за репликацију (HQbird 2.5 / 3.0). Блок показује куда replconf.properties показује и проблеме које је чвор нашао.

Додатак није активиран: replconf.properties показује на фајл HQbird DataGuard
Додатак није активиран: replconf.properties показује на фајл HQbird DataGuard
  1. Активирај… Прозор наводи шта ће чвор урадити: инсталирати додатак, усмерити replconf.properties на фајл чвора, пренети ставке старог фајла. Изаберите када: Само унутар прозора поновног покретања чвора или Сада, занемарујући прозор поновног покретања.

Прозор активирања додатка
Прозор активирања додатка
  1. После поновног покретања Firebird-а поље Активирано показује „да: мотор чита фајл чвора“.

Додатак активиран
Додатак активиран

Активирање поново покреће Firebird и утиче на све базе овог Firebird-а. Урадите га у мирном периоду.

7. Остале опције репликације

7.1. Параметри репликације

Подешавања → Параметри репликације, образац чаробњака
Подешавања → Параметри репликације, образац чаробњака

Страница Подешавања → Параметри репликације мења кључеве у replication.conf за изабране базе или за чвор у целини.

  1. Додај мастер и реплике — изаберите базе. RCM их групише по верзији Firebird-а и улози: засебан образац за мастере и за реплике.

  2. За сваки параметар изаберите радњу:

    Радња Шта ради
    без измена вредност се не мења
    постави вредност нова вредност
    ресетуј (на следећи ниво) уклони сопствену вредност, узми вредност са нивоа изнад
    не уписуј (вредност Firebird-а) кључ се не пише, важи вредност Firebird-а
  3. Изаберите где да се примени: На изабране базе или Као подразумевано за њихове чворове.

  4. Преглед — чворови проверавају вредности без икакве измене.

Преглед измена
Преглед измена
  1. Примени. RCM шаље команду сваком чвору.

Одакле вредност долази (колона Тренутно):

Извор Вредност
ова база постављено за базу
вредност чвора постављено као подразумевано за чвор
уграђена вредност чвора вредност чвора из кода
вредност Firebird-а кључ није уписан
из фајла (још није постављено овде) вредност из replication.conf, RCM је још није мењао
поставио чвор само за читање (путање, префикси)

Чвор који не одговара приказује своје базе као недоступне за избор. Измене захтевају fbagent (иначе fbagent_required).

Ко поново покреће Firebird (Firebird чита replication.conf само при покретању):

Чвор Ко
мастер ви га поново покрећете: мастер никада сам не покреће Firebird поново
реплика са firebird.auto_restart: never ви
реплика чији Firebird такође служи базе мастера ви
остале реплике чвор га поново покреће у сопственом прозору поновног покретања

За ручно поновно покретање страница има дугме Поново покрени Firebird.

7.2. Главни параметри

Мастер, Firebird 4/5:

Параметар Ознака у RCM Вредност чвора Firebird Савет
journal_archive_timeout Истек архиве 10 s 60 s колико секунди Firebird чека пре затварања непотпуног сегмента. Ниже — реплика је ближа мастеру. Мора да буде мање од limits.data_check_quiet_sec (90)
journal_segment_count Број сегмената 64 8 колико сегмената може да стоји у .ReplLog. Мора да буде веће од limits.backlog_critical (48)
journal_segment_size Величина сегмента — 16 MB од 1 MB до 512 MB; прималац неће прихватити више од 512 MB
buffer_size — 1 MB

Чвор такође пише log_errors = true (не може да се промени) и disable_on_error = true.

Реплика, Firebird 4/5:

Параметар Ознака у RCM Firebird Вредност
apply_idle_timeout Пауза мировања 10 s пауза када нема нових сегмената
apply_error_timeout Пауза после грешке примене 60 s пауза пре поновног покушаја после грешке
verbose_logging чвор: true опширан replication.log; не препоручује се искључивање
skip_upddel_without_pk чвор: true прескочи UPDATE/DELETE на табелама без кључа

Само Firebird 5: include_filter, exclude_filter, cascade_replication.

HQbird 2.5/3.0 — кључеви log_* са истим значењем: log_archive_timeout, log_segment_count, log_segment_size (не мање од 2 × buffer_size). Кључ alert_command поставља се само у node.json.

Наговештај за сваки параметар доступан је у обрасцу RCM.

7.3. Складиште архиве

Архива <database>.LogArch на мастеру чисти се у фазама:

  1. Сегменти које су примениле све реплике и који су старији од retention_days.
  2. Ако је слободан простор мањи од free_space_floor_gb — примењени сегменти млађи од периода чувања. Упозорење disk_serious_cleanup.
  3. Ако је простора и даље мало — непримењени сегменти, почевши од најстаријих. Реплика добија NEEDS_REINIT, упозорење replication_paused_reinit_scheduled.
Параметар (Подешавања → Чворови, Складиште и фајлови) Подразумевано
limits.retention_days — Чување архиве, дана 2
limits.retention_min_kept_segments — Увек чувај последње сегменте 0 (искључено)
limits.free_space_floor_gb — Најмање слободног простора 1 GB
Подешавања → Чворови, „Складиште и фајлови“
Подешавања → Чворови, „Складиште и фајлови“

Очистите архиву ручно:

Command
hqbirdrcm cleanuparchive -node node-a              # stages for all databases on the node
hqbirdrcm cleanuparchive -node node-a -db <db_id>  # a single database

-orphaned (само заједно са -db) брише све сегменте базе у стању ORPHANED (поглавље 3.8). За било коју другу базу чвор ће одговорити not_orphaned. Никада не покрећите -orphaned на донору унапређења (поглавље 8.5).

7.4. Пренос: компресија, брзина, прозори

Компресија се поставља по партнеру: Подешавања → Чворови → Партнери, колона compress.

Вредност Значење
празно или none без компресије (подразумевано)
zstd компресија zstd

Измена ступа на снагу одмах. Компресија је корисна на спорој мрежи.

Брзина преноса сегмената (Подешавања → Чворови, Пренос и поновна иницијализација):

Параметар Подразумевано Када ступа на снагу
limits.channel_a_mbps — Брзина преноса сегмената 50 MB/s одмах
limits.channel_a_burst_mbps — Врх преноса сегмената 200 MB одмах

Јединица је мебибајт (MiB), иако име каже „mbps“. Врх не може да буде мањи од брзине.

Подешавања → Чворови, „Пренос и поновна иницијализација“
Подешавања → Чворови, „Пренос и поновна иницијализација“

Временски прозори (Временски прозори):

Параметар Подразумевано Када ступа на снагу На шта утиче
windows.restart_window — Прозор поновног покретања Firebird-а мастер 22:00-05:00, реплика always одмах када чвор реплике сме да поново покрене Firebird
windows.transfer_window — Прозор преноса 23:00-05:00 после поновног покретања чвора пуна брзина иницијализације (поглавље 5.5)

Ознака поред сваког поља показује када измена ступа на снагу: одмах или поновно покретање чвора.

Подешавања → Чворови, „Временски прозори“
Подешавања → Чворови, „Временски прозори“

7.5. Провера података

  • Провери — једнократно поређење броја редова на мастеру и реплици (поглавље 5.10).
  • Провера података — периодично поређење (поглавље 5.10). Чвор врши поређење када су мастер и реплика на истом сегменту.
  • Са HQbird 2027.2.24 подешавања провере ступају на снагу одмах после Сачувај; поновно покретање сервиса чвора није потребно. RCM приказује „Сачувано и већ на снази“. После укључивања прва провера иде после једног интервала. После искључивања провера у току се прекида и ништа не пише. Нови интервал се рачуна од краја последње провере. Чувај, дана, Ограничење упита, Тишина и Генератор напретка ступају на снагу од следеће провере.
  • Чвор 2027.5.7 ова подешавања чита само при покретању: после Сачувај поново покрените сервис hqclusternode на том чвору. RCM 2027.2.24 приказује „Сачувано, али још није на снази“ и наводи разлог.
  • Које табеле поредити одређује списак табела базе (поглавље 3.1). Са HQbird 2027.2.24 свака база може да има сопствени списак: поље при регистрацији или блок Табеле за праћење синхронизације на страници базе мастера (поглавље 3.3). Страница Провера података показује који списак је коришћен, и број табела „није у бази“. У 2027.5.7 списак је по чвору (sync_tables).
  • Табеле искључене из публикације приказују се као „није објављена“ (поглавље 6.3).
Страница провере података
Страница провере података

7.6. Упозорења

Страница упозорења
Страница упозорења

Страница Упозорења. Радње:

  • Потврди — упозорење остаје видљиво, али је означено потврђено;
  • Утишај на 60 мин — сакриј на сат;
  • Обриши / Обриши све са овим кодом — RCM прослеђује брисање чвору који је подигао упозорење. Ако узрок остане, упозорење ће се поново појавити.
Command
hqbirdrcm clearalerts -code backlog_warn   # also -id, -acked, -all

Од HQbird 2027.2.33 RCM шаље упозорења на Telegram, на webhook (Slack, Teams, JSON) и е-поштом. Канали се подешавају у одељку notify.channels фајла rcm.json. Блок Канали обавештења на страници Упозорења приказује канале и шаље пробну поруку. RCM пријављује проблеме нивоа warn и више: проблем се појавио, постао је озбиљнији или је скинут. Без канала RCM ништа не шаље. Раније верзије немају слање: пратите страницу Упозорења или упитујте API RCM.

Главни кодови:

Код Значење
backlog_warn / backlog_critical 32 / 48 неархивираних сегмената у .ReplLog
disk_serious_cleanup архива се чисти у фази 2 (7.3)
replication_paused_reinit_scheduled непримењени сегменти обрисани, потребна је иницијализација
shipping_paused слање партнеру је обустављено (7.7)
apply_error, replication_stopped, replication_unrecoverable_error реплика не може да примени сегмент
replication_guid_mismatch GUID базе мастера се променио
segment_missing, segment_rejected, sequence_gap проблеми са редоследом сегмената
firebird_down, firebird_log_error Firebird не ради или бележи грешке
firebird_not_answering од HQbird 2027.2.30: Firebird минут није одговорио на везу ка бази (застој). Ово укључује и везу која није успостављена због истека времена; firebird_down је само одбијање везе
master_publication_off публикација је искључена (поглавље 6); од HQbird 2027.2.24 и после неуспеха publication_off (поглавље 6.1)
replica_removed_for_reinit од HQbird 2027.2.24: реплика је обрисала стару копију за иницијализацију, а нове копије још нема (поглавље 4.4)
orphaned_database база ван скенирања (поглавље 3.8)
restart_required_after_reinit Firebird реплике треба поново да се покрене (поглавље 5.6)
data_mismatch периодична провера је нашла одступање
license_paused fbagent нема лиценцу (поглавље 2.8)

7.7. Паузирање слања

На страници Базе, у реду мастера: Паузирај слање / Настави слање. За више база — преко списка Радња.

Command
hqbirdrcm pauseshipping  -node node-a -db <db_id>
hqbirdrcm resumeshipping -node node-a -db <db_id>
Потврда паузирања слања
Потврда паузирања слања
Ред мастера током паузе
Ред мастера током паузе
  • Пауза остаје на снази до Настави слање или до иницијализације.
  • Firebird мастера наставља да пише сегменте. Архива .LogArch расте: док је реплика заустављена, фаза 1 (7.3) не брише њене сегменте.
  • Дуга пауза може да стигне до фазе 3 и NEEDS_REINIT. Пратите простор.
  • Дугмета нема ако база нема реплику или је публикација искључена. Икона Пауза: нема лиценце значи паузу због лиценце (поглавље 2.8); скида је само лиценца.

7.8. Дневници

Дневник Где
Чвор <installation folder>/logs/node-YYYYMMDD.jsonl (/opt/hqclusternode или C:\hqclusternode), по 32 MB, 20 фајлова
Firebird replication.log, firebird.log путање у node.json: firebird.replication_log, firebird.firebird_log
RCM Linux: journalctl -u hqbirdrcm
Ревизија RCM rcm-data/audit.jsonl

Удаљени дневник чвора — страница Дневници: изаберите чвор и извор (replication.log, firebird.log, агент чвора).

Страница дневника
Страница дневника
Command
hqbirdrcm getlogs -node node-b -source replication -tail 200

8. Како реплику превести у обичну базу

Постоје два пута:

Пут Када Шта добијате
Претвори у обичну, 8.1 потребна вам је засебна радна копија: извештаји, тестови, отказ без новог мастера обична база ван репликације
Унапреди у мастер, 8.3 реплика треба да постане нови мастер база којом управља чвор компањон са улогом мастера

Ниједан пут не може да се поништи кроз интерфејс.

8.1. Направи обичном

Списак „Радња“ реплике: ставка „Направи обичном“
Списак „Радња“ реплике: ставка „Направи обичном“
  1. Базе, страна реплике: означите редове реплике.

  2. У списку Радња изаберите Направи обичном и потврдите. У реду нема засебног дугмета. Нема ни команде у командној линији.

Потврда „Направи обичном“
Потврда „Направи обичном“
3. Чвор реплике: - покреће `gfix -replica none` (HQbird 2.5/3.0: `gfix -replica {}`). Ако је база заузета применом сегмената, чвор је ставља у `single`-искључење на неколико секунди (`gfix -shut single -force 0`), скида режим реплике и враћа је са `gfix -online normal`. **Све везе ка овој бази се прекидају**; - пише фајл ознаке `.hqcluster-normal.json` (време, аутор, db_id, GUID); - почиње да чисти ред `.Incoming` (8.2). 4. RCM приказује базу у групи **Није реплика (обична)**.
Страница „Базе“ после „Направи обичном“
Страница „Базе“ после „Направи обичном“

После овога база је отворена за писање.

Уклоните блок реплике из replication.conf. Чвор га уклања при следећем скенирању, а Firebird фајл чита при покретању:

Command
hqbirdrcm scansync -node node-b
hqbirdrcm restartfirebird -node node-b

До тада се грешке „база није у режиму реплике“ за ову базу не подижу као упозорења.

Фајл ознаке штити базу. Иницијализација неће преписати такву базу: одбија се са target_not_replica (поглавље 5.9). Брисање само ознаке није довољно: чвор такође проверава режим реплике у заглављу базе. Поље Обриши стару реплику (поглавље 4.4) такву базу такође не брише.

Са HQbird 2027.2.24, док реплика брише стару копију ове базе за иницијализацију, Направи обичном се одбија са reclaim_in_progress: покушајте касније.

Ако база треба поново да постане реплика — то може само нова иницијализација са преписивањем. То се ради преко API чвора (overwrite_non_replica: true); у RCM нема таквог дугмета. Стари фајл се чува као <database>.pre-reinit-<UTC time>.fdb, а ознака се брише.

8.2. Шта бива са сегментима

  • Док чвор не скенира базе, мастер наставља да шаље сегменте. Сваких 30 секунди чвор реплике брише старе сегменте и чува само последњих 100 (keep_segments).
  • После скенирања запис базе на реплици добија стање ORPHANED. Чвор реплике мастеру одговара са unknown_database. Мастер престаје да шаље сегменте овој реплици, престаје да чува архиву за њу и поново је проверава сваких 10 минута.
  • Остале реплике ове базе нису погођене.
  • Запис ORPHANED може да се обрише (поглавље 3.8): hqbirdrcm forgetdatabase. Сам фајл базе се не брише.

8.3. Унапреди у мастер

Реплика постаје нови мастер. Њен фајл остаје на месту, а контрола прелази на чвор компањон.

Услови:

Услов Одбијање
база је реплика bad_request
на истом хосту ради чвор са улогом мастера — компањон (иста ознака host у rcm.json, поглавље 2.1) no_companion
унапређење ове базе већ није у току already_running
нема иницијализације у ову базу нити са њеног мастера reinit_running

RCM не прави чвор компањон: инсталирајте га унапред (поглавље 1).

Како покренути:

  • у реду реплике, Унапреди у мастер, или у списку Радња;

  • из командне линије:

    Command
    hqbirdrcm promotetomaster -node node-b -db <db_id>   # -timeout 10m

RCM ће тражити потврду и навести чвор компањон.

Потврда „Унапредити у мастер?“
Потврда „Унапредити у мастер?“

Кораци (видљиви у реду реплике, називи на енглеском):

Бр. Корак Шта ради
1 TURN TO NORMAL као у 8.1; прескаче се ако је база већ обична
2 NEW GUID нови GUID базе на месту (8.4)
3 EXCLUDE ON DONOR чвор реплике (донор) искључује фајл из свог скенирања (exclude_paths)
4 ENROLL ON <компањон> чвор компањон региструје фајл као базу мастера
5 PUBLICATION SYNC усклађивање публикације; списак искључених табела преноси се са старог мастера (поглавље 6.3)
6 RESTART DONOR FIREBIRD поновно покретање Firebird-а донора, без чекања прозора
7 RESTART <компањон> FIREBIRD поновно покретање Firebird-а компањона, без чекања прозора
8 FINALIZE ред донора постаје Реплика-дух; стари мастер може да постане Мастер деградиран (8.5)
Кораци унапређења у реду реплике
Кораци унапређења у реду реплике

На HQbird 2.5 и 3.0 нема публикација: корак PUBLICATION SYNC завршава се текстом „овај мотор нема публикацију“.

Кораци унапређења на HQbird 3.0 (Windows)
Кораци унапређења на HQbird 3.0 (Windows)

Ако донор и компањон користе исти Firebird, тај Firebird се поново покреће: везе ка свим његовим базама се прекидају.

Ако корак не успе, посао добија failed са текстом грешке. Исправите узрок и поново кликните Унапреди у мастер: завршени кораци се не понављају. Ако се RCM поново покрене током унапређења, посао ће такође постати failed — проверите стање чворова и покушајте поново.

Лиценца. Ако fbagent на хосту мастера нема лиценцу, мастер је паузирао слање. Унапређење је ипак могуће. RCM ће вас упозорити: измене направљене после почетка паузе биће изгубљене.

8.4. Нови GUID

После унапређења база мора да добије сопствени GUID. У супротном нови мастер пише сегменте под GUID старог мастера, а његове реплике се одбијају са duplicate_guid.

Корак NEW GUID на чвору:

  1. gfix -shut single -force 0 — све везе ка бази се прекидају;
  2. nbackup -L, затим nbackup -F без -SEQUENCE;
  3. брише <database>.delta;
  4. проверава заглавље: нови GUID, REPLICATION_SEQUENCE = 0;
  5. gfix -online normal.

Firebird се не покреће поново. Метод ради на свим верзијама (2.5, 3.0, 4.0, 5.0).

Ако је корак прекинут, чвор издаје упозорење newguid_interrupted. База може да остане у single-искључењу. Поновите Унапреди у мастер: корак ће се наставити.

Корак се прескаче (текст почиње са skipped:) ако је чвор донора стара верзија или фајл већ има сопствени GUID.

После новог GUID стари ланац nbackup више није погодан. Направите нову копију nbackup нивоа 0.

Ако је база направљена са ADD DIFFERENCE FILE, њен .delta је на другом месту: обришите га ручно.

8.5. После унапређења

Запис донора. На чвору реплике база остаје ORPHANED, путања остаје у exclude_paths, а фолдер .Incoming и ознака остају. У RCM то је ред Реплика-дух са дугмадима Отвори на новом мастеру и Обриши.

Ред донора: «Реплика-дух»
Ред донора: «Реплика-дух»
  • Да бисте уклонили ред, кликните Обриши. Ово мења само RCM.
  • Да бисте уклонили запис донора са чвора реплике, покрените forgetdatabase. Фајл и фолдер .Incoming остају. HQbird 2027.2.30 и новији не одбија команду (mailbox_active), јер је путања донора у exclude_paths. Чворови ранијих верзија је одбијају док су фајл и фолдер .Incoming присутни.
  • Никада не покрећите cleanuparchive -orphaned на донору. Донор и компањон деле исти фолдер <database>.LogArch. Команда ће обрисати живу архиву новог мастера.

Стари мастер.

  • Ако је донор био његова последња радна реплика, RCM поставља старог мастера на Мастер деградиран и паузира слање донору („слање паузирано: … (унапређење у мастер)“). Не настављајте слање донору: он већ држи радну базу. Да бисте ово стање скинули, иницијализујте базу на другу реплику.

    Стари мастер: «Мастер деградиран», слање паузирано
    Стари мастер: «Мастер деградиран», слање паузирано
  • Иницијализација са старог мастера на чвор донора биће одбијена (target_not_replica): он већ држи радну базу.
  • Ако је корак NEW GUID прескочен, стари и нови мастер имају исти GUID. У том случају иницијализација са старог мастера захтева -force (поглавље 5.9).
  • После ручног унапређења RCM не претвара старог мастера у реплику новог мастера. Зауставите апликације на старом мастеру и уклоните његову базу из управљања (поглавље 3.8). За базу описану као сервис то ради Поновно придруживање (8.7).

Нови мастер. Поставите му реплику: чвор реплике, партнери (поглавље 2), публикација (поглавље 6), иницијализација (поглавље 5).

Нови мастер: база са новим GUID, још без реплике
Нови мастер: база са новим GUID, још без реплике

8.6. Планско пребацивање: контролна листа

Ово је поступак за ручно пребацивање. За базу описану као сервис RCM сам пребацује мастера (8.7). Ручно унапређење не проверава да ли апликације пишу у старог мастера. Поступак:

  1. Унапред. На хосту реплике ради чвор компањон са улогом мастера, и оба чвора имају исту ознаку host (поглавље 2.1). Чвор за будућу реплику спреман је за новог мастера.
  2. Зауставите писање апликација у базу старог мастера.
  3. Сачекајте док реплика не прими и не примени све: Базе → IN_SYNC, нема реда.
  4. Провери (поглавље 5.10): број редова се поклапа.
  5. Унапреди у мастер (8.3). Сачекајте корак FINALIZE.
  6. Проверите: база је на списку мастера компањона, публикација укључена.
  7. Пребаците апликације на новог мастера.
  8. Направите nbackup копију нивоа 0 нове базе (8.4).
  9. Обришите запис духа за ред донора (8.5).
  10. Повежите реплику са новим мастером и иницијализујте је (поглавље 5).
  11. Стари мастер: уклоните базу из управљања или је оставите као архиву (8.5).

8.7. Сервиси: пребацивање и преузимање при отказу у RCM

Са HQbird 2027.2.30 RCM сам премешта мастера на други хост. За то се база описује као сервис: једна логичка база на неколико хостова. На сваком хосту сервиса постоје чвор мастера и чвор реплике, а путања до фајла базе је иста. Сервис се прави на страници Сервиси (од HQbird 2027.2.31) или командом hqbirdrcm services put -id <id> -file <file>.json.

Радња Шта ради Команде
Пребацивање плански пренос мастера без губитка података. После тога стари мастер аутоматски постаје реплика новог мастера hqbirdrcm switchover -service <id> -check, затим hqbirdrcm switchover -service <id> -to <host>
Преузимање при отказу хост мастера је изгубљен: RCM унапређује реплику. Најновије измене мастера могу да се изгубе hqbirdrcm failover -service <id> -check, затим hqbirdrcm failover -service <id> -to <host> -accept-data-loss
Поновно придруживање после преузимања при отказу враћа стари хост као реплику новог мастера hqbirdrcm rejoin -service <id>
Наставак изводи сервис из стања failed hqbirdrcm resume -service <id> -check, затим hqbirdrcm resume -service <id>

Исте радње су доступне на страници сервиса: дугмад Пребацивање…, Преузимање при отказу…, Поновно придруживање… и Наставак….

  • Аутоматско преузимање при отказу је подразумевано искључено. Укључује се за сваки сервис засебно: hqbirdrcm policy -service <id> -auto-failover on -max-data-loss 30. Захтева рутере. RCM покреће преузимање при отказу само када чвор мастера ћути, већина рутера не види Firebird мастера, а заостатак реплике није већи од max_data_loss_sec.
  • Рутер (hqclusternode router, Linux) држи HAProxy на тренутном мастеру сервиса. Апликације се повезују на <router host>:<router_port> и не мењају стринг везе када дође до пребацивања.
  • После преузимања при отказу RCM изолује старог мастера (улога fenced) чим поново одговори. Вратите га командом rejoin.