Цю сторінку перекладено машинним перекладом. Читайте англійський оригінал. English

Інші мови: Русский, Português.

Цей посібник веде від двох чистих серверів до робочої репліки Firebird 5.0. Усе робиться в браузері, у консолі RCM, окрім встановлення та однієї папки. Скріншоти походять із прогону 2026-11-17: комплект 2027.2.33, RCM і вузли 2027.5.12, Ubuntu 24.04, англійський інтерфейс. Звіт про попередній прогін 2026-11-08: hqbird2027-rcm-cluster-check-report.ru.md (російською, розділ «Прогон 2»). Лише команди, без скріншотів: hqbird2027-linux-cluster-runbook.md. Кожна сторінка RCM докладно: посібник користувача RCM (репозиторій hqcluster-node, docs/user-guide/).

Цей посібник призначений для комплекту 2027.2.24 і новіших. Для комплекту 2027.2.22 дивіться версію цього файлу від 2026-11-07 в історії git.

Комплект для завантаження — 2027.2.33 (2026-11-16): агент 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. Встановлення на обох серверах

На кожному сервері:

Command
V=2027.2.33
wget https://ib-aid.com/download/hqbird/v2027/hqbird2027-fb50-linux-$V.run
wget https://ib-aid.com/download/hqbird/v2027/hqbird2027-fb50-linux-$V.run.sha256
sha256sum -c hqbird2027-fb50-linux-$V.run.sha256
sudo sh hqbird2027-fb50-linux-$V.run

У терміналі інсталятор відкриває свій текстовий інтерфейс (комплекти від 2027.2.31). Перша сторінка має рядок Cluster RCM off, discovery mode off. Відкрийте Cluster і змініть один рядок:

Рядок сторінки Cluster Майстер Репліка
Cluster manager (RCM) on off
Discovery mode (24 h) off (цей агент запускає 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 для обох.

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

Встановлення триває близько однієї хвилини (прогін 2026-11-17: 61 секунда на майстрі, 43 секунди на репліці). Кінець виводу на майстрі з комплектом 2027.2.33 (хеш тут скорочено; ідентифікатор кластера в прикладах нижче — hq27d-m, із прогону 2026-11-08):

text
Done: agent hqbirdfbagent-fb50 in /opt/hqbird/fbagent-fb50, Firebird 5.0.5.1917 in /opt/firebird (port 3050).
HQ Monitor: http://localhost:23050/ (login admin; password in /opt/hqbird/conf/access.properties)
RCM:        https://10.114.0.5:7444 (cluster hq27d-m)
CA hash:    sha256:9754e0be…087cb195
Login:      rcmadmin
Password:   in /opt/hqbird/fbagent-fb50/clusterca/hq27d-m/rcm-initial-password (read it with sudo; RCM asks for a new one at the first login)
Pairing:    not needed: this agent runs the RCM; other agents link through it
fbmcp:      2027.2.24, service running; local only (remote mode: sudo fbmcp ctl hqbird-install --allow-from CIDR)

На репліці:

text
RCM:        off; turn it on in HQbird Monitor or with fbagent --cluster-init <id>
Pairing:    port 7450 open until 2026-11-09T16:25:27Z (fingerprint sha256:0d137a71…09fe44cf); an RCM may invite this host

Старий комплект виводить на 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. Те саме командами, від імені користувача агента:

Command
cd /opt/hqbird/fbagent-fb50
sudo -u firebird ./fbagent --cluster-init hq27d-m     # master; open 7443 and 7444 yourself
sudo -u firebird ./fbagent --cluster-pairing on       # replica

Поки вікно спаровування відкрите, агент відкриває свій порт спаровування у фаєрволі. Він закриває порт, коли вікно завершується або хост з’єднується.

У виводі немає паролів. Пароль RCM — у файлі з рядка Password:, пароль SYSDBA — у /root/fbagent-install-sysdba.txt, а пароль HQ Monitor — у /opt/hqbird/conf/access.properties.

Встановлювати ліцензію не потрібно: новий агент сам запускає 7-денний пробний період, і вузли кластера працюють.

Крок 2. Увійдіть у RCM

Відкрийте адресу з рядка RCM: master. Якщо порт 7444 закритий для вашого ПК, скористайтеся SSH-тунелем і https://localhost:7444:

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

Якщо порт 7444 зайнятий на вашому ПК, використайте інший локальний порт, наприклад -L 17444:127.0.0.1:7444 і https://localhost:17444.

Браузер попереджає про сертифікат: сертифікат RCM підписано CA кластера. Сторінка входу показує Cluster CA hash: порівняйте його з рядком CA hash: у виводі інсталятора. Якщо вони збігаються, встановіть сертифікат CA (посилання Download the CA certificate (hqcluster-ca.crt) на тій самій сторінці) як довірений або прийміть попередження. Якщо вони не збігаються, не входьте й перевірте адресу.

RCM sign-in
RCM sign-in

Ім’я користувача — rcmadmin. Пароль — у файлі з рядка Password: :

Command
# the path is from the Password: line of your output
sudo cat /opt/hqbird/fbagent-fb50/clusterca/hq27d-m/rcm-initial-password

RCM одразу просить новий пароль (щонайменше 12 символів):

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

RCM до 2027.5.12 міг завантажувати цю сторінку знову й знову. RCM 2027.5.12 (комплект 2027.2.33) містить виправлення.

Після зміни пароля агент master сам видаляє файл rcm-initial-password протягом однієї хвилини. Зі старішим комплектом другий сервер також має власний RCM. Після з’єднання агент переміщує той попередній кластер до теки cluster/left/. Агент 3.1.0 видаляє там свій rcm-initial-password; старіший агент цього не робить. Тоді видаліть файл самостійно:

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

Не видаляйте файл /opt/hqbirdrcm/initial-admin.json: він містить лише хеш старого пароля, і без нього RCM, що втратив свій файл користувача, запускається з типовим паролем.

Після зміни пароля RCM одразу відкриває Settings → Link hosts: кластер ще не має вузлів. Список Releases in the mirror показує випуски hqbirdrcm і hqclusternode, з яких агенти встановлюють вузли.

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

Крок 3. З’єднайте хости

Перший рядок списку вже заповнено (хост RCM). Додайте другий рядок: адресу репліки, до якої може дістатися master. Введіть IP, якщо сервери не мають спільного DNS: RCM зберігає рядок як є, і вузли знаходять одне одного за ним.

List of hosts
List of hosts

Натисніть Check hosts. Для хоста без порту RCM читає порти спаровування 7450–7459 і показує по одному рядку для кожного агента, що відповідає, як host:port (тут 10.114.0.6:7450). Запишіть host:port, щоб читати лише один порт. Хосту RCM не потрібне вікно спаровування: RCM знаходить свого агента у власному реєстрі. Порівняйте Certificate fingerprint з виводом інсталятора (рядок Pairing: репліки): вони мають збігатися. Стан другого хоста — Ready to link. Стовпець Member ID показує ім’я, яке хост отримає в кластері: <host name>-<role>, наприклад hq27d-m-master. Суфікс екземпляра (-fb50) додається лише тоді, коли хост має кілька агентів.

Check of the hosts
Check of the hosts

Кожен рядок має прапорець, порт, екземпляр і порт вузла. Link бере лише позначені рядки. Рядок із помилкою не можна позначити, і він не зупиняє інші. Під таблицею RCM 2027.5.12 пише рядки на кшталт 10.114.0.6, no agent: closed or no answer: 7451-7459: вони називають порти спаровування хоста, де не відповідає жоден інший агент. Це не помилки.

master — це хост, де будуть робочі бази даних. Натисніть Link і підтвердьте:

Confirmation
Confirmation

Перебіг: “Joining → Joined → The node starts → Running”. У цьому запуску з’єднання тривало 56 секунд (запуск 2026-11-17: 47 секунд).

Link progress
Link progress
Done
Done

Overview тепер показує два вузли: master і репліку. Одразу після з’єднання репліка може хвилину бути “stale”; потім вона “online”.

Overview: two nodes
Overview: two nodes

Якщо ви натиснете Check hosts знову для хоста, який уже з’єднано, він покаже, що на портах спаровування не відповідає жоден агент, або що хост недоступний: вікно спаровування на тому хості закрите, як і його порт спаровування у фаєрволі. Це не помилка.

Один хост у кластер, що має master. З’єднання одного рядка відхиляється з lone_master: вкажіть, чим стане рядок. Додайте -replica-of <master member> для репліки того master або -new-master (прапорець на сторінці Link hosts) для власного master.

Крок 4. Тека бази даних на master

На master база даних має бути в теці, до якої користувач firebird має доступ:

Command
sudo install -d -o firebird -g firebird -m 0770 /databases/master
# example: the sample database from the kit
sudo cp /opt/firebird/examples/empbuild/employee.fdb /databases/master/
sudo chown firebird:firebird /databases/master/employee.fdb

На репліці нічого готувати не потрібно: Create folder

Кнопка в діалозі 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-бази даних.
Enroll form
Enroll form

Preview → виберіть бази даних → Enroll selected і підтвердьте.

Confirmation of the enrollment
Confirmation of the enrollment

Результат — «Enrolled: 2.» і підказка: Firebird master-вузла потрібно перезапустити. Текст «No new databases matched.» під ним не є помилкою: бази даних уже зареєстровані.

Result of the enrollment
Result of the enrollment

Бази даних очікують перезапуску:

Waits for the restart
Waits for the restart

Натисніть Restart Firebird of the master у рядку будь-якої бази даних master-вузла (одного перезапуску достатньо для всіх) і підтвердьте. Усі з’єднання з Firebird master-вузла розриваються на кілька секунд (4 секунди в прогоні): виберіть слушний час.

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

Після перезапуску вузол master має стан CONFIGURED. Кожна база даних має бейдж publication OFF, а репліка показує «not paired».

After the restart
After the restart

Крок 6. Ініціалізуйте репліку

У рядку бази даних, у стовпці репліки → Initialize. Діалог має заголовок «Initialize database?».

Initialize dialog
Initialize dialog
  • Publication. Поки публікація бази даних вимкнена, Firebird не записує зміни до журналу, і репліка нічого не отримує. Діалог повідомляє про це й показує кнопку Sync publication and initialize. Натисніть її: RCM додає всі таблиці з первинним або унікальним ключем до публікації й одразу починає ініціалізацію. Кнопка Initialize не допомагає, поки публікація вимкнена: вузол 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 і підказку мовою інтерфейсу:

Refusal of the smooth method
Refusal of the smooth method

У прогоні це сталося також після 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 неактивна протягом цього часу.

Initialization progress
Initialization progress

Після копіювання вузол репліки сам перезапускає Firebird репліки у заплановану хвилину. Рядок повідомляє, коли; кнопка Restart Firebird of the replica робить це одразу. Усі з’єднання з Firebird репліки розриваються в цей момент.

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

Велика база даних працює так само. У прогоні bulk.fdb (3.13 GB) було ініціалізовано кнопкою Sync publication and initialize, без навантаження на неї:

Copy of the large database
Copy of the large database

Готово, коли master і репліка показують «Ok», а «last applied seg» репліки досягає «last seg» master-вузла. База даних без нових записів (тут bulk.fdb) показує «Pending» із сегментом 0 для репліки: це нормально.

Both databases ready
Both databases ready

Вимірювання прогону (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 не перезапускається.

Sync publication
Sync publication

Publication tables показує, які таблиці реплікуються. Ви не можете публікувати таблицю без ключа: задайте їй первинний ключ.

Publication tables
Publication tables

Крок 7. Реініціалізація

Вона потрібна, коли репліка відрізняється від master або коли вузол просить її (NEEDS_REINIT). У рядку репліки → Reinit, метод Smooth. Архів сегментів уже є, і плавний метод працює під навантаженням. Він чекає на транзакції запису, старші за історію журналу, і показує їх.

Reinit, smooth method
Reinit, smooth method

Перебіг такий самий, як під час ініціалізації. Реініт зазвичай не потребує перезапуску Firebird репліки. У прогоні 2026-11-17 реініт employee.fdb таки перезапустив Firebird репліки: плануйте переривання з’єднань із реплікою. Цей реініт тривав 4 секунди на master під ≈49 транзакцій/с; після зупинки записів кількості рядків збіглися (14 418 рядків у таблиці навантаження з обох боків).

Copy at the reinit
Copy at the reinit

Вимірювання прогону:

База даних Навантаження Час Блокування Інше
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.

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

З цим прапорцем вузол репліки після блокування на 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), і повторна спроба — це новий повний реініт. Автоматичний реініт видаляє стару копію, лише якщо ключ RCM auto_reinit.remove_old_replica_when_short увімкнено (вимкнено за замовчуванням).

Крок 9. Перевірка

Verify у рядку репліки порівнює COUNT(*) таблиць відстеження на master і на репліці. Він не порівнює самі рядки. Рядок «Table list source» називає список: власний список бази даних, список вузла, таблиці публікації або RDB$FIELDS. Кількості рядків мають групи цифр.

Під навантаженням репліка відстає на кілька секунд, і Verify дає «Not ok» для таблиць, у які йде запис:

Verify under load
Verify under load

Без записів кількості збігаються:

Verify without load
Verify without load

Таблиця, якої немає в жодній базі даних, — це «not in the database»: це не розбіжність. Таблиця лише з одного боку — це «no table»: це розбіжність.

Безпечніша перевірка — кількість рядків усіх таблиць з обох боків після зупинки записів (скрипт є в hqbird2027-linux-cluster-runbook.md). У прогоні всі 11 таблиць збіглися (employee.fdb: 10, bulk.fdb: 1, з 2 800 000 рядків).

Періодична перевірка (Data check) вимкнена за замовчуванням. Натисніть Turn on for all nodes і підтвердьте: кожен вузол рахує свої рядки, а master порівнює кількості. Перезапуск не потрібен: RCM показує «Saved and in force now: the node needs no restart.» Перша перевірка запускається через один інтервал (за замовчуванням 2 години).

Periodic check
Periodic check

За чим стежити далі

  • Overview: вузли, їхній стан, корінь бази даних і дисковий простір.

    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
    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:

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

Запуск 2026-11-17 перевірив блок без каналу; жодного повідомлення не надіслано.

  • Сервіси (RCM 2027.5.11 і новіші, комплекти від 2027.2.31): master, репліки та маршрутизатори сервісу, а також операції switchover, failover і rejoin. Цей посібник їх не охоплює: див. посібник користувача RCM. Оновіть RCM і вузли до однієї версії, перш ніж використовувати їх.

  • Команди: кожна операція RCM з її результатом. Час — локальний час браузера з його зоною (наприклад, 17:59:45 UTC+1); підказка показує час в UTC. Журнали вузлів використовують UTC.

    Commands
    Commands
  • HQ Monitor: http://<server>:23050/, ім’я користувача admin, пароль міститься в /opt/hqbird/conf/access.properties. Він показує сервер і бази даних. У комплектах з агентом 3.1.0 і новішими HQ Monitor має сторінку Clusters. На 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.

Виведення хоста з кластера

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

Агент зупиняється та скасовує реєстрацію своїх служб вузла, закриває їхні порти вузла, видаляє свої сертифікати кластера та встановлює cluster.source у none. Папка вузла залишається (--remove-data видаляє її). Агенту, який запускає RCM, відмовлено. Агент також виходить самостійно, коли RCM відкликає його або забирає його останнього учасника. Видалення завжди виводить з кластера: перевстановлення в тій самій папці починається вільно. У запуску 2026-11-17 команда вивела Cluster: left <cluster id>, бази даних реплік залишилися у своїй папці, а RCM все ще показував вузол того хоста хвилину потому. Видалення HQbird з сервера кластера, також із сервера, який запускає RCM: hqbird2027-removal-guide.md, розділ 4.

Поширені помилки

Що ви бачите Причина Що робити
publication_off під час ініціалізації публікація вимкнена, або вона не має таблиці, хоча база даних має таблиці з ключем кнопка Sync publication and initialize (крок 6)
long_transactions … the archive holds no segment yet перша ініціалізація плавним методом, поки в базу даних виконується запис, а архів 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)