Овај водич описује како се инсталира и користи репликациони кластер HQbird:
чворови hqclusternode и менаџер кластера hqbirdrcm (RCM).
Ово је водич за администратора Firebird-а. Полазимо од тога да познајете Firebird,
gfix и nbackup. Не морате да познајете унутрашњи рад чвора.
Од чега се кластер састоји
Компонента
Колико
Где ради
Шта ради
Firebird (HQbird)
једна или више инстанци
на сваком серверу база
чува базе, пише сегменте репликације
fbagent
један по инстанци Firebird-а
поред Firebird-а
зауставља и покреће Firebird на захтев чвора
hqclusternode (чвор)
један по инстанци и улози
поред Firebird-а
подешава репликацију, преноси сегменте, врши иницијализацију реплике
hqbirdrcm (RCM)
један по кластеру
на било ком хосту који види све чворове
веб-интерфејс, команде, упозорења, статистика
Чвор има улогу: master (мастер) или replica (реплика). На једној
инстанци Firebird-а могу да раде два чвора: чвор мастера и чвор реплике.
У том случају неке базе тог Firebird-а су мастери, а друге реплике.
Како то ради
На мастеру Firebird записује измене базе у сегменте (фајлове
дневника репликације).
Чвор мастера шаље сегменте чвору реплике преко обезбеђеног канала (mTLS).
Чвор реплике ставља сегменте у фолдер долазних сегмената. Firebird реплике
примењује их на своју копију базе.
Сам чвор мастера преноси прву копију базе на реплику. То се зове
иницијализација (reinit). Иде преко nbackup, а мастер за то време
наставља да ради.
Чворови шаљу статистику у 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-а (мастер и реплика на једном хосту)
Направи обичном, Унапреди у мастер, нови 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).
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-у нема параметра -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.
После чувања кластера:
У року од 10 минута fbagent добија кластер од HQCenter Admin (после тога проверава
измене сваких 60 секунди).
fbagent на хосту RCM прави сертификационо тело кластера (CA) и потписује
сертификате свих чворова.
Сваки fbagent пише node.json или rcm.json за своје чланове
кластера.
На следећој провери производа (свака 3 минута) fbagent инсталира и
покреће сервисе.
<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.jsonfbagent --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 hostsudo sh hqbird2027-fb50-linux-<version>.run --cluster-pairing on # other hosts
--rcm on — на једном хосту, где ће радити RCM кластера. Инсталер:
прави кластер овог хоста (fbagent --cluster-init), име кластера је
име хоста;
инсталира и покреће RCM, конзола RCM ради преко HTTPS на порту 7444;
прави првог администратора RCM rcmadmin са насумичном лозинком;
отвара портове 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-fb50sudo -u firebird ./fbagent --cluster-init <name> # RCM host; open ports 7443 and 7444 yourselfsudo -u firebird ./fbagent --cluster-pairing on # window for 24 hourssudo -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 отворите Подешавања → Повежи хостове.
У поље Хостови унесите адресе или имена хостова, један по реду.
Први ред је хост RCM, он је већ у кластеру.
Кликните Провери хостове. RCM испитује портове упаривања
7450–7459 сваког хоста и приказује платформу, верзију Firebird-а,
отисак и стање. Хосту RCM није потребан прозор упаривања. Упоредите
отиске са исписом инсталера (ред Pairing:).
Изаберите Мастер (подразумевано први хост) и кликните Повежи.
Повежи хостове: резултат провере
RCM тражи потврду и приказује напредак у одељку Напредак. Када сви чворови
раде, пише „Готово“ и приказује број ревизије кластера:
Повежи хостове: сви чворови раде
Исто из командне линије:
Command
cd /opt/hqbirdrcm
exportRCM_USER=rcmadmin RCM_PASSWORD='<password>'./hqbirdrcm cluster link -hosts db1,db2,db3 -master db1
Шта се даље дешава:
RCM шаље позивницу сваком слободном хосту.
fbagent хоста се придружује кластеру и затвара порт упаривања. Ако
хост има сопствени RCM без чворова, fbagent га зауставља и искључује, и
празан кластер премешта у cluster/left/ у фолдеру fbagent-а.
RCM чува кластер: чвор <host>-master на мастеру, <host>-replica на
осталим хостовима, порт 7051, везе мастер → реплика.
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-у.
На Windows-у (PowerShell као администратор):
.\fbagent.exe --cluster-init shop-prod --address 10.0.0.7
shop-prod — име кластера: мала латинична слова, цифре и -.
--address — адреса хоста RCM преко које се други
хостови повезују на њега. Може да се понови више пута. Без параметра користе се адресе и име
хоста.
Команда:
прави CA кластера и CA агента (у фолдеру fbagent-а, clusterca/<name>/);
у фолдер RCM пише сертификат RCM, rcm.json и cluster-init.json;
инсталира RCM и региструје сервис hqbirdrcm. На Linux-у сервис ради као
засебан корисник hqbirdrcm;
пребацује fbagent на RCM (cluster.source = rcm) и поново га покреће;
исписује адресу 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 осталих хостова
На хосту RCM направите токен за придруживање за сваки fbagent: у RCM
Подешавања → Кластер, дугме Направи токен за придруживање. Или из
командне линије:
Command
cd /opt/hqbirdrcm
exportRCM_USER=rcmadmin RCM_PASSWORD='<password>'./hqbirdrcm cluster join-token -note db2
Токен важи 24 часа, само за један fbagent и само једном. RCM
га приказује једном, заједно са готовом командом.
На хосту чвора покрените ову команду као корисник fbagent-а:
Уместо --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 даје
добављач.
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-а):
Команда прави ca.crt и ca.key, node-a.crt/.key, node-b.crt/.key и rcm.crt/.key. У -hosts наведите сва имена и адресе преко којих ће се учесници повезивати.
gencerts и фајлови које је направио
ca.key је кључ CA. Не копирајте га на хостове; чувајте га одвојено.
Нови чвор се касније додаје са -add: пар се потписује истим CA, а остали фајлови остају непромењени:
Сертификати важе 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.
url — адреса чвора како је види хост RCM. Само https.
host — ознака инстанце Firebird-а. Чвор мастера и чвор реплике са истом ознаком раде на истом Firebird-у (компањон, потребан да се реплика унапреди у мастер, поглавље 8). Једна ознака — највише један мастер и једна реплика.
Релативне путање се разрешавају из фолдера rcm.json.
Корак 6. Региструјте сервисе
Редослед покретања: прво RCM, затим реплике, затим мастер.
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-у
Корак 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
Адреса и лозинка зависе од тога како је 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 тражи да је промените при првој пријави: док је не промените, остале странице се неће отворити. Лозинку strong password промените одмах (веза Лозинка у заглављу).
Промена лозинке при првој пријави
Језик. У списку језика у заглављу странице изаберите Руски (доступан је и на страници за пријаву). Ако не изаберете, језик се узима из прегледача.
Промена лозинки и нови корисници
Сваки корисник мења своју лозинку: веза Лозинка у заглављу странице. Потребна је тренутна лозинка и нова од најмање 12 знакова. После промене, остале сесије тог корисника се затварају.
Ако је инсталер генерисао лозинку, она је уписана у фајл clusterca/<name>/rcm-initial-password у фолдеру fbagent-а. После промене лозинке fbagent сам брише овај фајл. Фајл initial-admin.json у фолдеру RCM не бришите: садржи само хеш. Ако се фајл корисника изгуби, а овај фајл не постоји, RCM ће направити корисника са подразумеваном лозинком.
Нови корисници. У интерфејсу нема странице корисника. Корисници су у фајлу rcm-data/users.json. Лозинка се чува као HA1 хеш: MD5("<name>:hqbirdrcm:<password>").
Одмах поново покрените RCM: фајл чита само при покретању. Када се лозинка промени у интерфејсу, RCM преписује фајл из меморије, и све измене које још није прочитао биће изгубљене.
Без поља role корисник има сва овлашћења. Од HQbird 2027.2.31 постоји улога "role": "viewer": само преглед, сваки захтев за измену добија 403.
1.6. Како проверити инсталацију
Сервиси чвора и RCM раде и не покрећу се у петљи:
systemctl status hqclusternode-master-p3050, systemctl status hqbirdrcm.
systemctl status чвора
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
exportRCM_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: „Превише неуспелих покушаја пријаве“
У овом поглављу одређујете који су чворови у кластеру и који мастер шаље
сегменте којој реплици. Затим подешавате чворове 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 нема
страницу кластера.
``
Кораци на страници Кластери
Унесите Идентификатор новог кластера (мала латинична слова, цифре и -) и кликните
Направи.
Додајте чланове (Чланови). За сваког наведите:
fbagent хоста;
улогу: master, replica или rcm;
адресе хоста;
порт: за чвор — 7051 (други чвор на истом хосту — нпр. 7052),
за RCM — порт пријема статистике 7443.
Додајте везе (Везе репликације) од мастера ка реплици.
Кликните Провери, затим Сачувај.
Ако је други администратор у исто време изменио кластер, страница ће тражити
да поново учитате кластер и поновите измену.
Правила
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 приказује стање чланова и датуме
истека сертификата.
Шта се дешава после чувања
fbagent сваког члана добија кластер. Унутар кластера — провера сваких
60 секунди (fbagent на хосту RCM — сваких 30 секунди). Ван кластера fbagent
сазнаје за кластер на следећем упиту конфигурације. Ако тај упит не
стигне до сервера, провера иде сваких 10 минута.
Сваки fbagent прави кључ и шаље захтев за сертификат. fbagent на
хосту RCM га потписује. RCM потписује сопствени сертификат без захтева.
fbagent у node.json пише: име, улогу, адресу, peers (из веза),
адресу RCM, путање сертификата, податке Firebird-а и fbagent-а. У rcm.json: списак
чворова (nodes), списак рутера (routers), адресу пријема статистике и
путање сертификата. fbagent не дира остала поља фајлова.
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 autofbagent --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).
Кораци на страници Подешавања → Кластер:
У табели Агенти кликните Додај члана у реду fbagent-а.
Наведите улогу (master, replica или router), member_id, адресе и порт.
Страница предлаже име <host>-<role> и порт: 7051 за први чвор fbagent-а,
7061 за други. Порт који је већ заузет другим чланом хоста RCM одбија. Адресе
fbagent-а су дугмад: кликните да додате адресу.
У одељку Везе кликните Додај везу од мастера ка реплици.
Кликните Провери: RCM ће приказати грешке и упозорења.
Кликните Сачувај. Страница ће приказати списак измена и тражити
потврду. Ако се чланови бришу, прозор је црвен.
Пре чувања измене постоје само на страници (ознака „Није сачувано“). Ако је
неко у исто време сачувао кластер, страница ће понудити да га поново учита.
Ако су се променила само поља RCM (ревизија, CA, комисије), страница ће сама
сачувати вашу измену.
Остали одељци странице:
Одељак
Шта је ту
заглавље
име кластера, ревизија, CA кластера и CA агента; дугме Извези за стари CA
Токени за повезивање
направите токен за нови fbagent, опозовите некоришћени
JSON документ
цео документ у текстуалном пољу; Провери и Сачувај га користе
Кључеви и CA
комисије: нови кључ члана (rekey), нови CA кластера (rotate_ca), нови CA агента (rotate_agent_ca); недоступно кад има несачуваних измена
Стање
ревизија коју је сваки члан применио, истек сертификата, сервис, последња грешка
Из командне линије на хосту RCM:
Command
exportRCM_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
Подешавања → RCM, табела Повезани чворови.
Кликните Додај чвор. Попуните node_id, url
(https://<address>:7051), улогу, host (ознака инстанце Firebird-а),
server (само за груписање на екрану).
Кликните Провери у реду чвора: RCM ће проверити везу и овлашћења.
Кликните Сачувај. RCM ће уписати rcm.json и стари фајл сачувати као
rcm.json.<UTC time>.bak (последњих 20).
Поново покрените RCM. До поновног покретања важи стара конфигурација;
страница показује која поља чекају поновно покретање.
Подешавања → RCM
Command
sudo systemctl restart hqbirdrcm
Може и без интерфејса: уредите rcm.json и поново покрените RCM.
Ручна инсталација: повежите мастер и реплику
Веза мора да буде забележена на обе стране:
Подешавања → Чворови, изаберите чвор мастера.
У одељку Партнери кликните Додај партнера: node_id реплике, њен url,
компресија (zstd).
Кликните Сачувај. RCM ће приказати списак измена и тражити
потврду. Измена peers ступа на снагу одмах.
Поновите за чвор реплике: њен партнер је мастер.
Одељак Партнери чвора мастера
Ако партнер није забележен на једној од страна, 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:
Исправите firebird.password у node.jsonсваког чвора ове
инстанце (мастер и реплика).
Исправите лозинку у конфигурацији fbagent-а и поново је учитајте (види
документацију fbagent-а).
Поново покрените сервисе чворова.
У супротном странице публикације и провере у 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. Чвор сам скида паузу у року од минута. Мастер чува архиву за реплике 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. Провера узима први списак који је постављен:
сопствени списак базе;
заједнички списак sync_tables чвора;
табеле из публикације базе;
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> и списком путања.
Отворите страницу уписа чвора мастера. Веза је доступна на два места:
Базе → табела Чворови → колона радњи →
Упиши;
Преглед → картица чвора мастера → Упиши базе.
Чвор реплике нема ову страницу.
Образац приказује тренутна правила чвора (чвор их је сам послао). Ако чвор
не одговара, дугмад за преглед и упис су искључена: без тренутних
правила она би ресетовала спискове укључивања и искључивања.
Попуните или исправите поља: Путања до фолдера на овом серверу,
рекурзивно, маске, Филтер величине, Табеле за праћење
синхронизације.
Поље Табеле за праћење синхронизације:
са HQbird 2027.2.24 и новијим — списак је по бази коју ће ова радња
уписати. Празно поље: база користи табеле сопствене публикације. Упис не мења заједнички
списак чвора (sync_tables). Ако постоји, образац то каже: база без сопственог списка користи њега,
а не публикацију.
Списак већ управљане базе поставља се на њеној страници: Базе →
база мастера → блок Табеле за праћење синхронизације. Блок
показује који списак тренутно важи. Празно поље уклања сопствени
списак базе;
у RCM и чвору 2027.5.7 — један списак за све базе чвора
(sync_tables).
Кликните Преглед. Чвор ће приказати све фајлове који одговарају маски
укључивања. Ништа не мења.
Проверите списак. Сваки фајл има поље за потврду:
означено — фајл ће бити под управљањем;
означено, закључано, ознака већ под управљањем — база је већ
уписана;
закључано са разлогом — фајл је искључен маском, величином или списком
искључивања. Да бисте га узели, промените правило.
Означите потребне базе и кликните Упиши
изабране. RCM ће тражити потврду и приказати број фајлова.
Потврда уписа
Шта ово дугме ради:
у режиму шаблона — фајлови без потврде додају се на списак искључивања, фајлови са
потврдом се уклањају са њега;
у режиму списка — фајлови са потврдом додају се на списак укључивања.
Дугме додаје базе онима које су већ под управљањем. Не мења
закључане редове.
7. Дугме Упиши примењује образац без измене
спискова.
8. Сачекајте поруку о завршетку и број додатих база. Ако дуго нема
одговора, резултат проверите на страници Команде.
Са HQbird 2027.2.24 и новијим порука је „Уписано: N“. Ако Firebird мастера
треба поново да се покрене, RCM каже које дугме да притиснете (обично
Поново покрени мастер Firebird у реду базе) и даје везу ка базама
мастера.
RCM 2027.5.7 може да каже „Нема нових погодних база“, иако су базе
додате: проверите страницу Базе.
Резултат уписа
Ако после уписа није пронађена ниједна база, а чвор је већ имао базе, чвор
одбија (409) и враћа стара правила. Тако грешка у путањи не искључује
репликацију свих база.
Напомена: команда шаље само поља из својих параметара. Остала
правила (маске, величине, спискови укључивања и искључивања, sync_tables) чвор ће ресетовати.
Команда нема параметре за ова правила. Пре
покретања команде проверите тренутна правила (hqbirdrcm getconfig -node node-a). Ако
су постављена, користите страницу уписа.
3.4. Шта се дешава после регистрације
Чвор пише правила у node.json.
Чвор скенира фолдер (scansync).
За сваку пронађену базу чвор пише блок у сопствену област
replication.conf (између редова # BEGIN managed-by:node-a role:master и
# END …) и прави фолдере <database>.ReplLog и <database>.LogArch. Чвор не мења текст ван сопствене области.
Пре измене чвор чува копију фајла:
replication_YYYYMMDD_hhmmss_NNN.conf.
Ако се replication.conf променио, базе улазе у
стање PENDING_RESTART: Firebird ће нови фајл прочитати тек после
поновног покретања. У табели Чворови то се види у колони Чека
поновно покретање.
Колона „Чека поновно покретање“ у табели „Чворови“
Стања нове базе:
Стање
Група у RCM
Значење
UNCONFIGURED
На чекању
база је пронађена, конфигурација још није уписана
PENDING_RESTART
На чекању
конфигурација је уписана, потребно је поновно покретање Firebird-а
CONFIGURED
На чекању
Firebird је поново покренут, база је спремна за публикацију и иницијализацију
3.5. Поновно покретање Firebird-а мастера
Чвор мастера никада сам не покреће Firebird поново. Ни RCM. Поновно покретање
мастера је одлука оператера: поновно покретање прекида све везе ка
свим базама те инстанце Firebird-а.
Изаберите време слабог оптерећења и кликните једно од дугмади:
Поново покрени мастер Firebird — на страници Базе, у реду
мастера базе која чека поновно покретање;
исто дугме у прозору Иницијализуј, поглавље 5;
Поново покрени Firebird — на страници базе.
RCM ће тражити потврду. Приказује име чвора и упозорење: Firebird
ће се поново покренути одмах, без прозора поновног покретања, и све везе ће бити прекинуте.
Потврда поновног покретања Firebird-а мастера
Исто из командне линије
Command
hqbirdrcm restartfirebird -node node-a
И ова команда поново покреће одмах, без прозора поновног покретања.
Како чвор поново покреће Firebird:
Проверава да fbagent одговара и управља истом инстанцом
(идентификатор, порт, име сервиса из node.json). Ако се било која вредност не
поклапа, чвор одбија.
Тражи од fbagent-а да поново покрене Firebird.
Чека да Firebird одговори на свом порту.
Премешта базе из PENDING_RESTART у CONFIGURED.
Неколико инстанци HQbird на једном хосту. fbagent поново покреће сервисе наведене у
firebird.update.services своје конфигурације. Празан списак значи све
сервисе HQbird на хосту. Ако на хосту постоје две инстанце HQbird, у списку оставите
само сервис своје инстанце. У супротном поновно покретање једног чвора
зауставиће и другу инстанцу.
На Windows-у. Ако је replication.log нарастао до log_portion_mb или више,
поновно покретање иде овако: заустави Firebird → архивирај дневник → покрени.
3.6. База која се већ репликује ручно
Ако је репликација за базу већ подешена ручно (сопствени блок у
replication.conf, публикација укључена, сегменти теку), може да се стави под
управљање без поновне иницијализације реплике. За то постоји
режим detect_existing (само мастер).
У одговору taken_over наводи базе које ће бити пренете. Додајте -verbose
да видите прескочене базе са разлогом.
Ако је списак тачан, покрените команду без -dry-run.
Чвор преноси блок само ако:
фолдери сегмената се зову тачно <database>.ReplLog и <database>.LogArch;
сегменти већ постоје у архиви;
публикација је укључена у бази.
Чвор не преноси блок са другим путањама и пријављује га као „пронађено, али
није подржано“.
После преноса базе добијају PENDING_RESTART, иако се подешавања репликације
не мењају: мења се само положај блока у фајлу. Поново покрените Firebird у
прозору одржавања.
3.7. Како проверити
Базе: база је видљива у реду чвора мастера, стање CONFIGURED
(после поновног покретања).
Поред базе може да буде икона публикација ИСКЉУЧЕНА: публикација још
није укључена. То је нормално, публикација је следећи корак (поглавље 6).
Нова база у реду мастера
На хосту чвора: блок базе је присутан у replication.conf унутар
области managed-by:node-a, а поред базе су фолдери .ReplLog и .LogArch.
3.8. Уклоните базу из управљања
Уобичајен начин је дугме. На страници Базе означите базе,
изаберите групну радњу Уклони из управљања и
кликните Примени на изабране. RCM:
додаје фајлове на списак искључивања чвора;
једном скенира фолдер: блокови базе се уклањају из replication.conf;
брише записе базе у чвору.
Фајлови базе и фолдери сегмената остају на диску. Firebird се не покреће поново.
Firebird наставља да пише сегменте базе до следећег поновног покретања;
RCM ће рећи ако је поновно покретање потребно.
RCM ће одбити (has_replicas) за базу мастера која има живу реплику:
иначе би реплика тихо стала. Прво реплику претворите у обичну базу или
је уклоните (поглавље 8).
Не бришите блок базе из replication.conf ручно: при следећем
скенирању чвор ће га поново уписати.
Ако је фајл базе нестао или је искључен правилом. Тада база добија
стање ORPHANED (група Напуштене). Чвор чува њен запис и архиву
сегмената: недостајућа база је чешће грешка него одлука. Ако се фајл врати, база
поново ради и упозорење се скида. Да бисте такву базу трајно обрисали,
урадите два корака овим редом:
После 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 чвора реплике
пре иницијализације;
Бит 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)
Провера простора пре иницијализације
Иницијализација проверава простор двапут и само пре закључавања базе:
RCM — из најновије статистике чвора, пре слања команде. Ако простора
очигледно нема довољно, RCM одмах враћа грешку 507.
Чвор мастера — живо мерење на сопственом волумену, затим захтев реплици да
измери свој. Ако на бар једној страни нема довољно, иницијализација
се завршава на кораку 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 дана да би реплика могла поново да их затражи. Сегменти
које реплика још није применила чувају се дуже. Ако је простора мало, чвор
чисти архиву у фазама:
сегменти које су све реплике примениле, старији од retention_days;
примењени сегменти који су новији (када је простора мало);
непримењени сегменти — само у крајњем случају. Тада реплика
губи сегменте који су јој потребни и добија NEEDS_REINIT.
Ако је реплика дуго недоступна, архива расте. Њен волумен = измене базе током
периода застоја.
Пример рачуна
База 100 GB. Оптерећење — 5 GB сегмената дневно. Иницијализација иде
ноћу, копирање траје 2 часа, током којих око
2 GB заврши у .delta.
стари фајл обрисан пре преноса: 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, можете да је ставите под управљање и не копирате базу поново:
Мастер: региструјте базе са detect_existing (поглавље 3.6).
Реплика:Базе → чвор реплике → Преузми, или hqbirdrcm takeover-replica. RCM ће наћи блокове реплике, упарити фајлове са базама мастера по GUID и за сваку приказати: in_sync, resumable или needs_reinit.
Потврдите редове. Чвор ће преместити блокове у сопствену област replication.conf.
Поново покрените Firebird реплике да прочита премештене блокове.
Иницијализујте само редове 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 показује „У реду“, али реплика не прима измене. Ако је
публикација укључена после иницијализације — поново иницијализујте базу.
Прозор „Поново иницијализовати базу?“
Отворите Базе.
У реду базе мастера, у колони чвора реплике, кликните Иницијализуј.
Чвор реплике одређује колона: не бира се у прозору. За
постојећи пар — Поновна иницијализација у проширеној картици мастера.
У прозору (са 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).
Потврдите. RCM ће навести да ће база бити закључана на мастеру и
копирана на реплику.
Напредак иницијализације видљив је у проширеној картици мастера на страници Базе:
кораци и проценти. Са HQbird 2027.2.24 напредак је видљив и после освежавања
странице: при првој иницијализацији — у ћелији чвора реплике, и такође у
реду Напредак поновне иницијализације на страници базе мастера. Дугме
Иницијализуј је неактивно док чвор мастера копира базу. Ако RCM не
прати ову иницијализацију (на пример, покренута је из командне линије чвора),
кораци се узимају из стања чвора, без процената. У RCM 2027.5.7, после
освежавања странице напредак прве иницијализације није видљив: сачекајте док база
мастера не изађе из SEEDING.
Кораци иницијализације у реду мастера
Свака команда RCM (иницијализација, поновно покретање Firebird-а, усклађивање
публикације) бележи се на страници Команде са резултатом.
Страница „Команде“
Исто из командне линије
Command
# one databasehqbirdrcm reinit -node node-a -db <db_id> -to node-b
# all master databaseshqbirdrcm 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 и ништа не шаље.
-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-а недоступне су неколико секунди
заустављен је раније, док је брисање у току, пре преноса. Чвор поставља нову копију без другог заустављања ако се блок базе у 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). За прву иницијализацију такве базе изаберите Стандардно.
За следеће поновне иницијализације глатки метод ради као обично (архива већ постоји).
Трансакције старије од публикације. Firebird не пише у сегменте трансакцију која је почела пре него што је публикација укључена. Ако је чвор укључио публикацију, иницијализација чека (6 покушаја сваких 10 секунди) док се такве трансакције не заврше; у супротном се завршава грешком reinit_pre_publication_transactions која их наводи. После усклађивања публикације која је додала табеле, поново повежите апликације, затим покрените иницијализацију.
5.5. Брзина
Када
Брзина
Подешавање
Унутар прозора преноса windows.transfer_window (подразумевано 23:00-05:00)
Време иницијализације ≈ величина базе ÷ брзина. Пример: 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, само унутар
подешеног прозора. Подразумевано искључено.
Прозор: по бази → по чвору → глобално. "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)
публикација мастера је искључена или не садржи табеле са кључем
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. Како проверити резултат
Базе: пар мастер — реплика у групи је У реду, стање
IN_SYNC.
Провери у картици мастера: чворови броје редове табела са
списка табела базе (поглавље 3.1) на мастеру и на реплици и пореде их.
Проверавајте у мирном времену: при активном писању бројеви могу да се разликују.
Са HQbird 2027.2.24 страница резултата наводи списак сваке стране
(на пример, „сопствени списак ове базе“ или „табеле публикације
(списак није постављен)“). RCM броји реплику списком мастера. Табела
која недостаје у обе базе приказује се као „није у бази“ и не рачуна се као
грешка. Ако ниједна табела није поређена, резултат је „Нема табела за
поређење“, а не неслагање. Ако поређење није завршено у предвиђеном времену,
резултат је „Није поређено (временско ограничење)“, што такође није неслагање.
Периодична провера (опционо): страница Провера података,
Укључи за све чворове. Са 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 ће послати засебну команду за сваку
базу.
Потврда усклађивања публикације
Шта чвор ради (једна трансакција):
Укључује публикацију. Ако ју је оператер сам искључио (6.4), не укључује је.
У публикацију додаје све табеле са кључем којих још нема.
Из публикације уклања табеле без кључа и табеле које је оператер
искључио (6.3).
Искључује аутоматско додавање нових табела (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 databasehqbirdrcm setpublication -node node-a # all node databases
Команда чека до 5 минута и исписује ред за сваку базу. При грешци излазни
код је 1. -nowait — не чекај резултат.
6.3. Табеле публикације
Страница „Табеле публикације“
Отворите Табеле публикације у реду базе мастера.
Страница приказује:
стање публикације (укључено/искључено, искључио оператер) и бројаче;
сваку табелу: име, кључ и стање.
Стање
Значење
објављена
измене иду у сегменте
још није објављена
табела са кључем, биће додата при усклађивању
искључена
оператер ју је уклонио из публикације
нема кључ
не може да се објави
У колони кључа — примарни кључ, или, ако га нема, јединствени индекс са
најмањим бројем поља.
Зашто табела без кључа не може да се објави. Реплика тражи ред за
UPDATE и DELETE по кључу. Без кључа неће наћи ред. Додајте
примарни кључ или јединствени индекс, затим ускладите публикацију.
Искључи из публикације / Врати у публикацију:
Означите табеле.
Кликните Искључи из публикације или Врати у публикацију.
Чвор чува списак и одмах усклађује публикацију.
Потврда „Искључи из публикације“
Списак искључених табела чува се на чвору мастера. Усклађивање га
не мења. Када се реплика унапреди у мастер (поглавље 8), списак прелази на
новог мастера.
Провера (поглавље 5.10) искључену табелу приказује као „није објављена“,
а не као одступање.
6.4. Укључивање и искључивање публикације
На страници Табеле публикације: Искључи публикацију /
Укључи публикацију.
Искључивање је избор оператера. Усклађивање не
укључује публикацију поново.
Измене направљене док је публикација искључена (или док је табела
искључена) се не шаљу реплици, чак ни после укључивања.
После укључивања кликните Провери (поглавље 5.10). Ако се подаци
разилазе — поново иницијализујте реплику (поглавље 5).
6.5. Нова табела
Нова табела сама не улази у публикацију: чвор искључује
аутоматско додавање.
После DDL:
Направите примарни кључ или јединствени индекс на табели.
Кликните Усклади публикацију.
Замолите апликације да се поново повежу ако је потребна поновна иницијализација. 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: филтери мотора
Додатак replconf. Чвор пише сопствени фајл replconf.hqcluster.hqbird у
фолдеру Firebird-а. Firebird га чита само када replconf.properties показује на
њега. Додатак мора једном да се активира:
Подешавања → Чворови, блок Додатак за репликацију (HQbird 2.5 / 3.0). Блок
показује куда replconf.properties показује и проблеме које је чвор
нашао.
Додатак није активиран: replconf.properties показује на фајл HQbird DataGuard
Активирај… Прозор наводи шта ће чвор урадити: инсталирати додатак,
усмерити replconf.properties на фајл чвора, пренети ставке старог фајла.
Изаберите када: Само унутар прозора поновног покретања чвора или Сада, занемарујући
прозор поновног покретања.
Прозор активирања додатка
После поновног покретања Firebird-а поље Активирано показује „да: мотор
чита фајл чвора“.
Додатак активиран
Активирање поново покреће Firebird и утиче на све базе овог Firebird-а.
Урадите га у мирном периоду.
Страница Подешавања → Параметри репликације мења кључеве у
replication.conf за изабране базе или за чвор у целини.
Додај мастер и реплике — изаберите базе. RCM их групише по
верзији Firebird-а и улози: засебан образац за мастере и за реплике.
За сваки параметар изаберите радњу:
Радња
Шта ради
без измена
вредност се не мења
постави вредност
нова вредност
ресетуј (на следећи ниво)
уклони сопствену вредност, узми вредност са нивоа изнад
не уписуј (вредност Firebird-а)
кључ се не пише, важи вредност Firebird-а
Изаберите где да се примени: На изабране базе или Као подразумевано
за њихове чворове.
Преглед — чворови проверавају вредности без икакве измене.
Преглед измена
Примени. 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 на мастеру чисти се у фазама:
Сегменти које су примениле све реплике и који су старији од
retention_days.
Ако је слободан простор мањи од free_space_floor_gb — примењени сегменти
млађи од периода чувања. Упозорење disk_serious_cleanup.
Ако је простора и даље мало — непримењени сегменти, почевши од најстаријих.
Реплика добија 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 nodehqbirdrcm 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“. Врх не може да буде
мањи од брзине.
Подешавања → Чворови, „Пренос и поновна иницијализација“
Ознака поред сваког поља показује када измена ступа на снагу: одмах или
поновно покретање чвора.
Подешавања → Чворови, „Временски прозори“
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
непримењени сегменти обрисани, потребна је иницијализација
од 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. Паузирање слања
На страници Базе, у реду мастера: Паузирај слање /
Настави слање. За више база — преко списка Радња.
Пауза остаје на снази до Настави слање или до иницијализације.
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, агент чвора).
потребна вам је засебна радна копија: извештаји, тестови, отказ без новог мастера
обична база ван репликације
Унапреди у мастер, 8.3
реплика треба да постане нови мастер
база којом управља чвор компањон са улогом мастера
Ниједан пут не може да се поништи кроз интерфејс.
8.1. Направи обичном
Списак „Радња“ реплике: ставка „Направи обичном“
Базе, страна реплике: означите редове реплике.
У списку Радња изаберите Направи обичном и потврдите.
У реду нема засебног дугмета. Нема ни команде у командној линији.
Потврда „Направи обичном“
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 фајл чита при покретању:
До тада се грешке „база није у режиму реплике“ за ову базу не
подижу као упозорења.
Фајл ознаке штити базу. Иницијализација неће преписати такву базу:
одбија се са 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).
Како покренути:
у реду реплике, Унапреди у мастер, или у списку Радња;
Кораци (видљиви у реду реплике, називи на енглеском):
Бр.
Корак
Шта ради
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)
Ако донор и компањон користе исти Firebird, тај Firebird се
поново покреће: везе ка свим његовим базама се прекидају.
Ако корак не успе, посао добија failed са текстом грешке. Исправите
узрок и поново кликните Унапреди у мастер: завршени кораци се не
понављају. Ако се RCM поново покрене током унапређења, посао ће такође постати
failed — проверите стање чворова и покушајте поново.
Лиценца. Ако fbagent на хосту мастера нема лиценцу, мастер
је паузирао слање. Унапређење је ипак могуће. RCM ће вас упозорити:
измене направљене после почетка паузе биће изгубљене.
8.4. Нови GUID
После унапређења база мора да добије сопствени GUID. У супротном нови мастер пише
сегменте под GUID старог мастера, а његове реплике се одбијају са
duplicate_guid.
Корак NEW GUID на чвору:
gfix -shut single -force 0 — све везе ка бази се прекидају;
nbackup -L, затим nbackup -F без -SEQUENCE;
брише <database>.delta;
проверава заглавље: нови GUID, REPLICATION_SEQUENCE = 0;
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, још без реплике
8.6. Планско пребацивање: контролна листа
Ово је поступак за ручно пребацивање. За базу описану као сервис RCM сам пребацује мастера (8.7). Ручно унапређење не проверава да ли апликације пишу у старог мастера. Поступак:
Унапред. На хосту реплике ради чвор компањон са улогом мастера, и оба чвора имају исту ознаку host (поглавље 2.1). Чвор за будућу реплику спреман је за новог мастера.
Зауставите писање апликација у базу старог мастера.
Сачекајте док реплика не прими и не примени све: Базе → IN_SYNC, нема реда.
Провери (поглавље 5.10): број редова се поклапа.
Унапреди у мастер (8.3). Сачекајте корак FINALIZE.
Проверите: база је на списку мастера компањона, публикација укључена.
Пребаците апликације на новог мастера.
Направите nbackup копију нивоа 0 нове базе (8.4).
Обришите запис духа за ред донора (8.5).
Повежите реплику са новим мастером и иницијализујте је (поглавље 5).
Стари мастер: уклоните базу из управљања или је оставите као архиву (8.5).
8.7. Сервиси: пребацивање и преузимање при отказу у RCM
Са HQbird 2027.2.30 RCM сам премешта мастера на други хост. За то се база описује као сервис: једна логичка база на неколико хостова. На сваком хосту сервиса постоје чвор мастера и чвор реплике, а путања до фајла базе је иста. Сервис се прави на страници Сервиси (од HQbird 2027.2.31) или командом hqbirdrcm services put -id <id> -file <file>.json.
Радња
Шта ради
Команде
Пребацивање
плански пренос мастера без губитка података. После тога стари мастер аутоматски постаје реплика новог мастера
после преузимања при отказу враћа стари хост као реплику новог мастера
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.
Овај сајт користи колачиће како би побољшао ваше искуство и запамтио поставке.