Кластер HQbird 2027 на Linux: master і replica з RCM
Інші мови: Русский, Português.
Цей посібник веде від двох чистих серверів до робочої репліки Firebird 5.0.
Усе робиться в браузері, у консолі RCM, окрім
встановлення та однієї папки. Скріншоти походять із прогону
2026-11-17: комплект 2027.2.33, RCM і вузли 2027.5.12, Ubuntu 24.04,
англійський інтерфейс. Звіт про попередній прогін 2026-11-08:
hqbird2027-rcm-cluster-check-report.ru.md
(російською, розділ «Прогон 2»). Лише команди, без скріншотів:
hqbird2027-linux-cluster-runbook.md. Кожна сторінка RCM докладно:
посібник користувача RCM (репозиторій hqcluster-node, docs/user-guide/).
Цей посібник призначений для комплекту 2027.2.24 і новіших. Для комплекту 2027.2.22 дивіться версію цього файлу від 2026-11-07 в історії git.
Комплект для завантаження — 2027.2.33 (2026-11-16): агент 3.4.0, HQ Monitor 1.57.0, RCM і вузли 2027.5.12, Firebird 5.0.5.1917. Цей посібник перевірено з ним 2026-11-17 (два сервери, Ubuntu 24.04, бази даних розміром 3 МБ і 167 МБ): усі кроки пройдено. У тексті результати того прогону названо «прогін 2026-11-17». Скріншоти походять із другого проходу того ж дня з тим самим комплектом (бази даних розміром 3 МБ і 2,88 ГБ). Інші числа досі походять із прогону 2026-11-08. Що комплекти після 2027.2.27 змінили для кластера:
| Комплект | Зміна |
|---|---|
| 2027.2.29 (агент 3.1.0, RCM 2027.5.9) | Кластер не створюється за замовчуванням (див. нижче). Кілька агентів одного хоста можуть приєднатися до кластера: кожен має власний порт сполучення (7450–7459) і порт вузла. fbagent --cluster-leave. Сторінка Clusters у HQ Monitor |
| 2027.2.30 (RCM 2027.5.10) | Перемикання та відмовостійкість сервісу, маршрутизатори |
| 2027.2.31 (агент 3.3.0, RCM 2027.5.11) | Інсталятор відкриває текстовий інтерфейс у терміналі (крок 1). Сторінки Services у RCM. Сервер, не приєднаний до жодного HQCenter, оновлює агент, HQ Monitor і fbmcp самостійно |
| 2027.2.33 (агент 3.4.0, RCM 2027.5.12) | RCM надсилає свої сповіщення до Telegram, webhook або e-mail («Що дивитися далі»). Кластер із двох контейнерів Docker: посібник з Docker |
Усі зміни: What’s New.
Комплекти з агентом (fbagent) 3.1.0 і новішими (від 2027.2.29) не створюють кластер за замовчуванням: без RCM, без вікна сполучення, і порти кластера залишаються закритими в брандмауері. На кроці 1 ви вмикаєте RCM на майстрі та режим виявлення на репліці.
Час: ≈30 хвилин плюс копіювання баз даних (≈1 хвилина на 3 ГБ у мережі 1 Гбіт/с).
Що ви отримаєте
| Сервер 1 | Сервер 2 | |
|---|---|---|
| Роль | майстер + консоль RCM | репліка |
| Бази даних | /databases/master/*.fdb |
/databases/replica/<replica node>/<master node>/*.fdb |
| Сервіси | firebird, hqbirdfbagent-fb50, hqbirdmonitor-fb50, fbmcp, hqbirdrcm, hqclusternode-master-p3050 |
те саме, але hqclusternode-replica-p3050 і без hqbirdrcm (старіший комплект залишає там власний RCM, зупинений) |
Що вам потрібно
- Два сервери Linux x86-64 (перевірено на Ubuntu 24.04), 2 ядра, 4 ГБ пам’яті.
- Місце на диску. Майстер: вільно ≥ 105 % розміру бази даних (файл
.deltaзростає під час блокування). Репліка: вільно ≥ 105 % розміру бази даних плюс мінімумlimits.free_space_floor_gb(за замовчуванням 1 ГБ). Повторна ініціалізація поверх наявної репліки зберігає старий файл до кінця, тому обсяг репліки потребує близько 2 × розміру бази даних. З прапорцем Remove the old replica if space is short (крок 8) достатньо 105 % плюс мінімум. - Мережа між серверами: порти 3050, 7051, 7443, 7444, 7450. Це порти першого екземпляра сервера (слот 0). Другий екземпляр сервера використовує порт сполучення 7451 і порт вузла 7052.
- Ваш ПК може дістатися порту 7444 майстра (консоль RCM), напряму або через SSH-тунель.
- Користувач із
sudo.
Брандмауер. Інсталятор відкриває порти в увімкненому firewalld або ufw (з будь-якою системною мовою): 3050 і 23050 завжди, порти кластера лише для опцій кроку 1. Майстер: 7443, 7444, 7051. Репліка: 7450, 7051. Агент знову закриває 7450, коли вікно сполучення завершується або хост приєднано. На Ubuntu ufw зазвичай вимкнено. Тоді інсталятор пише один рядок, наприклад на майстрі:
no active firewall (firewalld or ufw): ports 3050, 23050, 7443, 7444, 7051/tcp are not opened by this install; they are reachable from every network; close them or enable a firewall. У хмарі закрийте порти хмарним брандмауером: ззовні — лише ваша адреса; між серверами — внутрішня мережа.
Нижче наведено адреси прогону: майстер 10.114.0.5, репліка
10.114.0.6 (приватна мережа). Використовуйте власні адреси.
Крок 1. Встановлення на обох серверах
На кожному сервері:
V=2027.2.33
wget https://ib-aid.com/download/hqbird/v2027/hqbird2027-fb50-linux-$V.run
wget https://ib-aid.com/download/hqbird/v2027/hqbird2027-fb50-linux-$V.run.sha256
sha256sum -c hqbird2027-fb50-linux-$V.run.sha256
sudo sh hqbird2027-fb50-linux-$V.runУ терміналі інсталятор відкриває свій текстовий інтерфейс (комплекти від
2027.2.31). Перша сторінка має рядок Cluster RCM off, discovery mode off. Відкрийте Cluster і змініть один рядок:
| Рядок сторінки Cluster | Майстер | Репліка |
|---|---|---|
| Cluster manager (RCM) | on |
off |
| Discovery mode (24 h) | off (цей агент запускає RCM) |
on |
Рядки Cluster id (за замовчуванням: ім’я хоста), RCM admin password
(за замовчуванням: згенерований) і Pairing port (за замовчуванням: перший вільний,
7450) можна залишити як є. Поверніться назад (Esc) і виберіть Install.
Інсталятор показує план: натисніть Enter. Потім він запитує Nothing on this host was changed yet. Start the install now?. Курсор на No: перемістіть його
на Yes і натисніть Enter. Інсталятор додає відсутні бібліотеки (наприклад,
libtommath1) сам. Текстовий інтерфейс повністю:
hqbird2027-linux-setup-guide.md.
З --no-tui, а також у комплектах 2027.2.29–2027.2.30 інсталятор ставить
запитання. Перше — Install as planned? Yes/No: дайте відповідь y. Потім
він ставить два запитання про кластер. Відповідь за замовчуванням — No (Enter):
| Запитання | Майстер | Репліка |
|---|---|---|
Install the cluster manager (RCM) on this host and make a new cluster? [y/N] |
y |
Enter (No) |
Turn on discovery mode for 24 hours (an RCM on the network may invite this agent into its cluster; port 7450)? [y/N] |
не запитується: цей агент запускає RCM | y |
Або задайте відповіді як опції: у терміналі вони встановлюють значення
сторінки Cluster до її відкриття. Використовуйте їх також для запуску без термінала:
--yes сам по собі означає No для обох.
sudo sh hqbird2027-fb50-linux-$V.run --rcm on # master
sudo sh hqbird2027-fb50-linux-$V.run --cluster-pairing on # replicaВстановлення триває близько однієї хвилини (прогін 2026-11-17: 61 секунда
на майстрі, 43 секунди на репліці). Кінець виводу на
майстрі з комплектом 2027.2.33 (хеш тут скорочено; ідентифікатор кластера
в прикладах нижче — hq27d-m, із прогону 2026-11-08):
Done: agent hqbirdfbagent-fb50 in /opt/hqbird/fbagent-fb50, Firebird 5.0.5.1917 in /opt/firebird (port 3050).
HQ Monitor: http://localhost:23050/ (login admin; password in /opt/hqbird/conf/access.properties)
RCM: https://10.114.0.5:7444 (cluster hq27d-m)
CA hash: sha256:9754e0be…087cb195
Login: rcmadmin
Password: in /opt/hqbird/fbagent-fb50/clusterca/hq27d-m/rcm-initial-password (read it with sudo; RCM asks for a new one at the first login)
Pairing: not needed: this agent runs the RCM; other agents link through it
fbmcp: 2027.2.24, service running; local only (remote mode: sudo fbmcp ctl hqbird-install --allow-from CIDR)На репліці:
RCM: off; turn it on in HQbird Monitor or with fbagent --cluster-init <id>
Pairing: port 7450 open until 2026-11-09T16:25:27Z (fingerprint sha256:0d137a71…09fe44cf); an RCM may invite this hostСтарий комплект виводить на master рядок Pairing: not opened (this agent runs the RCM).
Запишіть рядки RCM: і CA hash: з master та рядок
Pairing: з репліки. Вам потрібен fingerprint на кроці 3.
Старіші комплекти (агент до 3.1.0, наприклад комплект 2027.2.27) не ставлять жодних запитань про кластер. Вони встановлюють RCM на кожен сервер і відкривають вікно спаровування всюди. Використовуйте RCM master; RCM другого сервера зупиняється сам після з’єднання.
Пізніше, без інсталятора. У HQ Monitor сервера відкрийте Clusters, розділ Cluster on this server. На master: Enable the cluster console (RCM); HQ Monitor відкриває 7443 і 7444 у фаєрволі. На репліці: Open the pairing window for 24 hours. Те саме командами, від імені користувача агента:
cd /opt/hqbird/fbagent-fb50
sudo -u firebird ./fbagent --cluster-init hq27d-m # master; open 7443 and 7444 yourself
sudo -u firebird ./fbagent --cluster-pairing on # replicaПоки вікно спаровування відкрите, агент відкриває свій порт спаровування у фаєрволі. Він закриває порт, коли вікно завершується або хост з’єднується.
У виводі немає паролів. Пароль RCM — у файлі з рядка
Password:, пароль SYSDBA — у
/root/fbagent-install-sysdba.txt, а пароль HQ Monitor — у
/opt/hqbird/conf/access.properties.
Встановлювати ліцензію не потрібно: новий агент сам запускає 7-денний пробний період, і вузли кластера працюють.
Крок 2. Увійдіть у RCM
Відкрийте адресу з рядка RCM: master. Якщо порт 7444 закритий
для вашого ПК, скористайтеся SSH-тунелем і https://localhost:7444:
ssh -L 7444:127.0.0.1:7444 <user>@<master>Якщо порт 7444 зайнятий на вашому ПК, використайте інший локальний порт, наприклад
-L 17444:127.0.0.1:7444 і https://localhost:17444.
Браузер попереджає про сертифікат: сертифікат RCM підписано CA кластера. Сторінка входу показує Cluster CA hash: порівняйте його з
рядком CA hash: у виводі інсталятора. Якщо вони збігаються, встановіть сертифікат CA
(посилання Download the CA certificate (hqcluster-ca.crt) на
тій самій сторінці) як довірений або прийміть попередження. Якщо вони не збігаються,
не входьте й перевірте адресу.
Ім’я користувача — rcmadmin. Пароль — у файлі з рядка Password:
:
# the path is from the Password: line of your output
sudo cat /opt/hqbird/fbagent-fb50/clusterca/hq27d-m/rcm-initial-passwordRCM одразу просить новий пароль (щонайменше 12 символів):
RCM до 2027.5.12 міг завантажувати цю сторінку знову й знову. RCM 2027.5.12 (комплект 2027.2.33) містить виправлення.
Після зміни пароля агент master сам видаляє файл
rcm-initial-password протягом однієї хвилини. Зі старішим комплектом
другий сервер також має власний RCM. Після з’єднання агент переміщує
той попередній кластер до теки cluster/left/. Агент 3.1.0 видаляє
там свій rcm-initial-password; старіший агент цього не робить. Тоді видаліть
файл самостійно:
# on server 2, after step 3
sudo find /opt/hqbird -name rcm-initial-password
sudo rm <path from the find output>Не видаляйте файл /opt/hqbirdrcm/initial-admin.json: він містить
лише хеш старого пароля, і без нього RCM, що втратив свій
файл користувача, запускається з типовим паролем.
Після зміни пароля RCM одразу відкриває Settings → Link hosts:
кластер ще не має вузлів. Список Releases in the mirror показує
випуски hqbirdrcm і hqclusternode, з яких агенти встановлюють
вузли.
Крок 3. З’єднайте хости
Перший рядок списку вже заповнено (хост RCM). Додайте другий рядок: адресу репліки, до якої може дістатися master. Введіть IP, якщо сервери не мають спільного DNS: RCM зберігає рядок як є, і вузли знаходять одне одного за ним.
Натисніть Check hosts. Для хоста без порту RCM читає порти
спаровування 7450–7459 і показує по одному рядку для кожного агента, що відповідає, як
host:port (тут 10.114.0.6:7450). Запишіть host:port, щоб читати лише один порт. Хосту RCM не потрібне вікно спаровування: RCM знаходить свого агента у власному
реєстрі. Порівняйте Certificate fingerprint з виводом інсталятора
(рядок Pairing: репліки): вони мають збігатися. Стан
другого хоста — Ready to link.
Стовпець Member ID показує ім’я, яке хост отримає в кластері:
<host name>-<role>, наприклад hq27d-m-master. Суфікс екземпляра
(-fb50) додається лише тоді, коли хост має кілька агентів.
Кожен рядок має прапорець, порт, екземпляр і порт вузла. Link бере лише
позначені рядки. Рядок із помилкою не можна позначити, і він не зупиняє
інші. Під таблицею RCM 2027.5.12 пише рядки на кшталт 10.114.0.6, no agent: closed or no answer: 7451-7459: вони називають порти спаровування
хоста, де не відповідає жоден інший агент. Це не помилки.
master — це хост, де будуть робочі бази даних. Натисніть Link і підтвердьте:
Перебіг: “Joining → Joined → The node starts → Running”. У цьому запуску з’єднання тривало 56 секунд (запуск 2026-11-17: 47 секунд).
Overview тепер показує два вузли: master і репліку. Одразу після з’єднання репліка може хвилину бути “stale”; потім вона “online”.
Якщо ви натиснете Check hosts знову для хоста, який уже з’єднано, він покаже, що на портах спаровування не відповідає жоден агент, або що хост недоступний: вікно спаровування на тому хості закрите, як і його порт спаровування у фаєрволі. Це не помилка.
Один хост у кластер, що має master. З’єднання одного рядка відхиляється
з lone_master: вкажіть, чим стане рядок. Додайте -replica-of <master member>
для репліки того master або -new-master (прапорець на сторінці Link hosts)
для власного master.
Крок 4. Тека бази даних на master
На master база даних має бути в теці, до якої
користувач firebird має доступ:
sudo install -d -o firebird -g firebird -m 0770 /databases/master
# example: the sample database from the kit
sudo cp /opt/firebird/examples/empbuild/employee.fdb /databases/master/
sudo chown firebird:firebird /databases/master/employee.fdbНа репліці нічого готувати не потрібно: Create folder
Кнопка в діалозі Initialize створює папку для копій (крок 6).
Крок 5. Зареєструйте бази даних на master
Databases → у таблиці Nodes, у рядку master → Enroll.
- Folder path on that server:
/databases/master, recursive. - Include file mask:
*.fdb. - Sync tracking tables: таблиці, кількість рядків яких порівнює кнопка Verify. Ви задаєте список для кожної бази даних, яку реєструєте. Залиште поле порожнім: тоді база даних рахує свої таблиці публікації. Для бази даних, яка вже керується, змініть список на сторінці master-бази даних.
Preview → виберіть бази даних → Enroll selected і підтвердьте.
Результат — «Enrolled: 2.» і підказка: Firebird master-вузла потрібно перезапустити. Текст «No new databases matched.» під ним не є помилкою: бази даних уже зареєстровані.
Бази даних очікують перезапуску:
Натисніть Restart Firebird of the master у рядку будь-якої бази даних master-вузла (одного перезапуску достатньо для всіх) і підтвердьте. Усі з’єднання з Firebird master-вузла розриваються на кілька секунд (4 секунди в прогоні): виберіть слушний час.
Після перезапуску вузол master має стан CONFIGURED. Кожна база даних має
бейдж publication OFF, а репліка показує «not paired».
Крок 6. Ініціалізуйте репліку
У рядку бази даних, у стовпці репліки → Initialize. Діалог має заголовок «Initialize database?».
- Publication. Поки публікація бази даних вимкнена, Firebird
не записує зміни до журналу, і репліка нічого не отримує.
Діалог повідомляє про це й показує кнопку Sync publication and initialize.
Натисніть її: RCM додає всі таблиці з первинним або унікальним ключем до
публікації й одразу починає ініціалізацію. Кнопка Initialize
не допомагає, поки публікація вимкнена: вузол master
відмовляє (
publication_off). - Replica folder: діалог пропонує
/databases/replica/<replica node>, у прогоні/databases/replica/hq27d-r-replica. Кожному вузлу репліки на хості потрібна власна папка. Залиште її. Якщо поле показує «✗ The folder does not exist», натисніть Create folder; тоді ви побачите «✓ The folder was created.» Копія потрапляє до/databases/replica/hq27d-r-replica/hq27d-m-master/. Для наступних баз даних папка вже задана, і діалог її не змінює. - Method: Smooth (типово). Він перевіряє транзакції запису перед блокуванням. Standard блокує базу даних одразу.
- Для нової репліки вам не потрібні прапорці «Let … stop its Firebird for this reinit» і «Remove the old replica if space is short».
Перепідключіть застосунки після першої синхронізації публікації. З’єднання з master-базою даних, відкрите до того, як публікацію було ввімкнено, не журналюється, доки воно не підключиться знову. У прогоні 2026-11-17 з’єднання, відкрите до Sync publication and initialize, записало близько 9 500 рядків після копіювання, і репліка не отримала жодного з них. RCM показував «Ok» для обох сторін; лише Verify (крок 9) показав «Not ok (desynced)». Рядки нового з’єднання реплікувалися одразу. Отже, після першого Sync publication бази даних: перепідключіть застосунки (або перезапустіть Firebird master-вузла), потім запустіть Verify без записів. Якщо репліка пропускає рядки, запустіть reinit (крок 7).
Перша ініціалізація під навантаженням. Поки архів master-вузла
ще не має сегмента журналу, Smooth може відмовити, якщо в базу даних виконується
запис. Рядок бази даних показує
long_transactions: … the archive holds no segment yet і підказку мовою
інтерфейсу:
У прогоні це сталося також після Sync publication and initialize (знахідка G-04 у звіті). Публікація на цей момент уже ввімкнена. Зачекайте, доки master-база даних покаже «archive: 1 seg» або більше (15 секунд у прогоні), і натисніть Initialize знову з методом Smooth. Або виберіть Standard. У прогоні 2026-11-17 (≈49 транзакцій/с з одного з’єднання) Smooth не відмовив.
Прогрес показується в рядку бази даних: SPACE CHECK → LOCKING → COPYING TO NODE (%) → UNLOCKING → SEEDING → RESTARTING REPLICA. Прогрес видно також після перезавантаження сторінки. Кнопка Initialize неактивна протягом цього часу.
Після копіювання вузол репліки сам перезапускає Firebird репліки у заплановану хвилину. Рядок повідомляє, коли; кнопка Restart Firebird of the replica робить це одразу. Усі з’єднання з Firebird репліки розриваються в цей момент.
Велика база даних працює так само. У прогоні bulk.fdb (3.13 GB) було
ініціалізовано кнопкою Sync publication and initialize, без
навантаження на неї:
Готово, коли master і репліка показують «Ok», а «last applied
seg» репліки досягає «last seg» master-вузла. База даних без
нових записів (тут bulk.fdb) показує «Pending» із сегментом 0 для
репліки: це нормально.
Вимірювання прогону (employee.fdb під навантаженням ≈55
транзакцій/с):
| База даних | Розмір | Master: від початку до кінця | Блокування на master | Пара «Ok» |
|---|---|---|---|---|
employee.fdb |
4 MB | 0.7 s | 0.35 s | після ≈1 min (очікування перезапуску репліки) |
bulk.fdb |
3.13 GB | 64 s (≈55 MB/s) | 59 s | після ≈2 min |
Прогін 2026-11-17 (kit 2027.2.33): employee.fdb (3 MB) тривав 3 секунди
на master bulk.fdb (167 MB) — 15 секунд. Сторону репліки було спарено
≈40 секунд після старту (вона чекала на перезапуск Firebird
репліки).
Під час блокування база даних master працює: зміни йдуть у файл .delta.
Публікація пізніше. Вам потрібна кнопка Sync publication бази даних master, коли в базі з’являються нові таблиці. Вона приводить публікацію у відповідність до таблиць в одній транзакції; Firebird не перезапускається.
Publication tables показує, які таблиці реплікуються. Ви не можете публікувати таблицю без ключа: задайте їй первинний ключ.
Крок 7. Реініціалізація
Вона потрібна, коли репліка відрізняється від master або коли вузол просить
її (NEEDS_REINIT). У рядку репліки → Reinit, метод
Smooth. Архів сегментів уже є, і плавний метод працює
під навантаженням. Він чекає на транзакції запису, старші за
історію журналу, і показує їх.
Перебіг такий самий, як під час ініціалізації. Реініт зазвичай
не потребує перезапуску Firebird репліки. У прогоні 2026-11-17
реініт employee.fdb таки перезапустив Firebird репліки: плануйте
переривання з’єднань із реплікою. Цей реініт тривав 4 секунди на
master під ≈49 транзакцій/с; після зупинки записів кількості рядків
збіглися (14 418 рядків у таблиці навантаження з обох боків).
Вимірювання прогону:
| База даних | Навантаження | Час | Блокування | Інше |
|---|---|---|---|---|
employee.fdb |
≈55 транзакцій/с | 1.7 с | 0.32 с | 417 транзакцій відтворено із сегментів |
bulk.fdb |
немає | 61 с | 55 с | без перезапуску Firebird репліки |
Після плавного реініту під навантаженням репліка може показувати сповіщення info
replication_conflict_resolved («Record being inserted … already exists,
updating instead»): репліка відтворила транзакції, які вже були в
копії. Дані збігаються: у прогоні кількості рядків усіх таблиць збіглися.
Ви можете підтвердити сповіщення (знахідка G-07 у звіті).
Крок 8. Мало місця на диску репліки
Тому репліки потрібно вільно ≥ 105 % розміру бази даних плюс 1 ГБ понад стару копію: стара копія залишається до кінця, а новий файл одразу займає свій повний розмір. Якщо місця бракує, діалог показує, скільки місця потрібно, скільки вільно і скільки займає стара копія (оцінка RCM; вирішує вузол репліки). Якщо місця достатньо без старої копії, діалог пропонує прапорець Remove the old replica if space is short.
З цим прапорцем вузол репліки після блокування на master зупиняє
Firebird репліки, видаляє стару копію і знову запускає Firebird.
У прогоні (2.97 ГБ вільно, новій копії потрібно 3.29 ГБ, стара копія —
3.13 ГБ) реініт bulk.fdb з прапорцем тривав 65 секунд. Без
прапорця вузол відмовляє з insufficient disk space on replica.
Діалог може не показувати жодних чисел, коли бракує лише нижньої межі 1 ГБ. У
прогоні 2026-11-17 (1.1 ГБ вільно, база даних 167 MB) діалог не показав
жодної оцінки, і реініт без прапорця завершився невдачею за 3 секунди. Рядок
бази даних і сторінка Commands показали причину: insufficient disk space on replica: need 184125850 bytes (105% of the database) + 1073741824 bytes free_space_floor_gb; free 1152950272 … Removing the old replica copy would free 175357952 bytes: ask again with remove_old_replica. Той самий реініт з прапорцем тривав 9 секунд.
Ризик прапорця. Поки триває копіювання, репліки цієї бази даних немає. Якщо реініт зазнає невдачі, пара стає
NEEDS_REINIT, у репліки з’являється сповіщенняreplica_removed_for_reinit(warn), і повторна спроба — це новий повний реініт. Автоматичний реініт видаляє стару копію, лише якщо ключ RCMauto_reinit.remove_old_replica_when_shortувімкнено (вимкнено за замовчуванням).
Крок 9. Перевірка
Verify у рядку репліки порівнює COUNT(*) таблиць відстеження на
master і на репліці. Він не порівнює самі рядки. Рядок
«Table list source» називає список: власний список бази даних,
список вузла, таблиці публікації або RDB$FIELDS. Кількості рядків мають
групи цифр.
Під навантаженням репліка відстає на кілька секунд, і Verify дає «Not ok» для таблиць, у які йде запис:
Без записів кількості збігаються:
Таблиця, якої немає в жодній базі даних, — це «not in the database»: це не розбіжність. Таблиця лише з одного боку — це «no table»: це розбіжність.
Безпечніша перевірка — кількість рядків усіх таблиць з обох боків після зупинки
записів (скрипт є в
hqbird2027-linux-cluster-runbook.md). У
прогоні всі 11 таблиць збіглися (employee.fdb: 10, bulk.fdb: 1, з
2 800 000 рядків).
Періодична перевірка (Data check) вимкнена за замовчуванням. Натисніть Turn on for all nodes і підтвердьте: кожен вузол рахує свої рядки, а master порівнює кількості. Перезапуск не потрібен: RCM показує «Saved and in force now: the node needs no restart.» Перша перевірка запускається через один інтервал (за замовчуванням 2 години).
За чим стежити далі
-
Overview: вузли, їхній стан, корінь бази даних і дисковий простір.
Overview -
Alerts: проблеми вузлів і баз даних. У прогоні було два сповіщення, і ви можете підтвердити обидва:
replication_conflict_resolvedпісля плавного реініту (крок 7) іparse_no_observationsна master («no events parsed from /opt/firebird/replication.log»). Firebird master записує вreplication.logлише помилки, тож порожній журнал — це нормально (знахідка G-06 у звіті).
Alerts RCM 2027.5.12 і новіші (комплект 2027.2.33) можуть надсилати сповіщення рівня
warnі вище до вашого власного Telegram-бота, webhook або e-mail. Ви задаєте канали у файлі/opt/hqbirdrcm/rcm.json, ключnotify.channels, і перезапускаєте RCM (sudo systemctl restart hqbirdrcm). Блок Notification channels на цій сторінці тоді перелічує канали, кожен із кнопкою Send test. Без каналу він каже «No channel is configured: RCM sends its alerts nowhere.» Канал Telegram:
"notify": { "channels": [ { "name": "ops", "type": "telegram",
"token_file": "secrets/telegram-ops.token", "chat_id": "-1001234567890" } ] }Запуск 2026-11-17 перевірив блок без каналу; жодного повідомлення не надіслано.
-
Сервіси (RCM 2027.5.11 і новіші, комплекти від 2027.2.31): master, репліки та маршрутизатори сервісу, а також операції switchover, failover і rejoin. Цей посібник їх не охоплює: див. посібник користувача RCM. Оновіть RCM і вузли до однієї версії, перш ніж використовувати їх.
-
Команди: кожна операція RCM з її результатом. Час — локальний час браузера з його зоною (наприклад,
17:59:45 UTC+1); підказка показує час в UTC. Журнали вузлів використовують UTC.
Commands -
HQ Monitor:
http://<server>:23050/, ім’я користувачаadmin, пароль міститься в/opt/hqbird/conf/access.properties. Він показує сервер і бази даних. У комплектах з агентом 3.1.0 і новішими HQ Monitor має сторінку Clusters. На master (хості RCM) він показує кластер через агента, без налаштувань RCM у HQ Monitor. На репліці він називає хост RCM і посилається на його консоль. HQ Monitor 1.49.0 не має стану реплікації та посилання на RCM. З комплекту 2027.2.33 (агент 3.4.0) агент також надсилає проблеми свого сервера до ваших каналів: Servers → Notifications.
Оновлення кластера
Спочатку оновіть HQbird RCM, потім вузли. З комплекту 2027.2.31 сервер, який не під’єднано до жодного HQCenter, оновлює агент, HQ Monitor і fbmcp самостійно (“Updates without HQCenter” у hqbird2027-linux-setup-guide.md); а сервер, під’єднаний до HQCenter, отримує оновлення з цього HQCenter.
Виведення хоста з кластера
cd /opt/hqbird/fbagent-fb50
sudo ./fbagent --cluster-leaveАгент зупиняється та скасовує реєстрацію своїх служб вузла, закриває їхні порти вузла,
видаляє свої сертифікати кластера та встановлює cluster.source у none. Папка вузла
залишається (--remove-data видаляє її). Агенту, який запускає RCM, відмовлено. Агент також виходить самостійно, коли RCM відкликає його або забирає його останнього
учасника. Видалення завжди виводить з кластера: перевстановлення в тій самій
папці починається вільно. У запуску 2026-11-17 команда вивела Cluster: left <cluster id>, бази даних реплік залишилися у своїй папці, а RCM
все ще показував вузол того хоста хвилину потому. Видалення HQbird
з сервера кластера, також із
сервера, який запускає RCM:
hqbird2027-removal-guide.md, розділ 4.
Поширені помилки
| Що ви бачите | Причина | Що робити |
|---|---|---|
publication_off під час ініціалізації |
публікація вимкнена, або вона не має таблиці, хоча база даних має таблиці з ключем | кнопка Sync publication and initialize (крок 6) |
long_transactions … the archive holds no segment yet |
перша ініціалізація плавним методом, поки в базу даних виконується запис, а архів master порожній | дочекайтеся “archive: 1 seg” і повторіть Smooth, або виберіть Standard |
reinit_pre_publication_transactions |
транзакція запису почалася до ввімкнення публікації та залишається відкритою довше однієї хвилини | завершіть її (COMMIT або ROLLBACK) і повторіть |
| “✗ The folder does not exist on …” у діалозі | ніхто не створив папку репліки | кнопка Create folder у діалозі, або install -d -o firebird -g firebird -m 0770 <folder> на репліці |
| “Not ok (desynced)” у Verify | у базу даних виконується запис, і репліка відстає на секунди | повторіть без навантаження; подивіться на стовпець Match |
| “Not ok (desynced)” у Verify без записів; обидві сторони показують “Ok” | з’єднання застосунку було відкрите до ввімкнення публікації: воно не журналюється | перепідключіть застосунок, потім Reinit (крок 6, примітка про першу синхронізацію публікації) |
| Хост “unreachable” або “no agent” у Link hosts | вікно сполучення хоста закрите (вимкнене за замовчуванням, або 24 год минули), або брандмауер між серверами закриває 7450–7459 | відкрийте вікно на хості: HQ Monitor → Clusters → Open the pairing window for 24 hours, або fbagent --cluster-pairing on; відкрийте порт у хмарному брандмауері |
insufficient disk space on replica під час reinit |
стара репліка залишається до кінця, і новий файл займає її повний розмір | звільніть ≥ 105 % розміру бази даних + 1 ГБ понад старий файл на томі репліки, або позначте Remove the old replica if space is short (крок 8) |
| Вузол не з’являється після Link hosts | дзеркало RCM не має підписаного випуску hqclusternode |
Releases in the mirror на сторінці Link hosts (крок 2) |