Кластер HQbird 2027 на Linux: мастер и реплика через RCM
Другие языки: English, Português.
Руководство ведёт от двух чистых серверов до работающей реплики Firebird 5.0.
Всё делается в браузере, в консоли RCM, кроме установки и одной папки.
Снимки сняты на прогоне 2026-11-17: кит 2027.2.33, RCM и узлы 2027.5.12,
Ubuntu 24.04. На снимках английский интерфейс RCM; в тексте названия кнопок
и полей даны по-русски. Язык меняется в списке в шапке консоли. Отчёт
более раннего прогона 2026-11-08 —
hqbird2027-rcm-cluster-check-report.ru.md
(раздел «Прогон 2»). Только команды, без снимков:
hqbird2027-linux-cluster-runbook.ru.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) | По умолчанию кластера нет (см. ниже). В кластер могут войти несколько агентов одного хоста: у каждого свой порт pairing (7450–7459) и свой порт узла. fbagent --cluster-leave. Страница Кластеры в HQ Monitor |
| 2027.2.30 (RCM 2027.5.10) | Switchover и failover сервиса, роутеры |
| 2027.2.31 (агент 3.3.0, RCM 2027.5.11) | Установщик в терминале открывает текстовый интерфейс (шаг 1). Страницы Сервисы в 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, нет окна pairing, порты кластера в брандмауэре закрыты. На шаге 1 вы включаете RCM на мастере и режим обнаружения на реплике.
Время: ≈30 минут плюс копирование баз (≈1 минута на 3 ГБ в сети 1 Гбит/с).
Что получится
| Сервер 1 | Сервер 2 | |
|---|---|---|
| Роль | мастер + консоль RCM | реплика |
| Базы | /databases/master/*.fdb |
/databases/replica/<узел реплики>/<узел мастера>/*.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 размеров базы. С флажком «Удалить старую реплику» (шаг 8) хватает 105 % плюс порог. - Сеть между серверами: порты 3050, 7051, 7443, 7444, 7450. Это порты первого экземпляра сервера (слот 0). Второй экземпляр сервера берёт порт pairing 7451 и порт узла 7052.
- Ваш ПК видит порт 7444 мастера (консоль RCM) — прямо или через SSH-туннель.
- Пользователь с
sudo.
Брандмауэр. Установщик открывает порты во включённом firewalld или ufw (при любом языке системы): 3050 и 23050 всегда, порты кластера — только для опций шага 1. Мастер: 7443, 7444, 7051. Реплика: 7450, 7051. Порт 7450 агент снова закрывает, когда окно pairing кончилось или хост связан. На 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).
Язык интерфейса он берёт из системы. На первой странице есть строка
Кластер RCM off, режим обнаружения off (Cluster RCM off, discovery mode off). Откройте Кластер (Cluster) и измените одну строку:
| Строка страницы «Кластер» | Мастер | Реплика |
|---|---|---|
| Менеджер кластера (RCM) (Cluster manager (RCM)) | on |
off |
| Режим обнаружения (24 ч) (Discovery mode (24 h)) | off (этот агент ведёт RCM) |
on |
Строки Id кластера (по умолчанию — имя хоста), Пароль администратора
RCM (по умолчанию создаётся) и порт pairing (по умолчанию первый
свободный, 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. Затем
два вопроса о кластере. Ответ по умолчанию — «нет» (Enter):
| Вопрос | Мастер | Реплика |
|---|---|---|
Install the cluster manager (RCM) on this host and make a new cluster? [y/N] |
y |
Enter («нет») |
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 |
Или задайте ответы опциями: в терминале они задают значения страницы
«Кластер» до её открытия. Так же и для запуска без терминала: один --yes
означает «нет» для обоих.
sudo sh hqbird2027-fb50-linux-$V.run --rcm on # мастер
sudo sh hqbird2027-fb50-linux-$V.run --cluster-pairing on # репликаУстановка занимает около минуты (прогон 2026-11-17: 61 секунда на мастере,
43 секунды на реплике). Конец вывода на мастере с китом 2027.2.33 (хэш
здесь сокращён; id кластера в примерах ниже — 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Старый кит на мастере пишет Pairing: not opened (this agent runs the RCM).
Запишите строки RCM: и CA hash: мастера и строку Pairing: реплики.
Отпечаток (fingerprint) пригодится на шаге 3.
Старые киты (агент до 3.1.0, например кит 2027.2.27) вопросов о кластере не задают. Они ставят RCM на каждый сервер и везде открывают окно pairing. Нужен RCM мастера; RCM второго сервера после связывания остановится сам.
Позже, без установщика. В HQ Monitor сервера откройте Кластеры, раздел Кластер на этом сервере. На мастере: Включить консоль кластера (RCM); HQ Monitor открывает 7443 и 7444 в брандмауэре. На реплике: Открыть окно pairing на 24 часа. То же командами, от пользователя агента:
cd /opt/hqbird/fbagent-fb50
sudo -u firebird ./fbagent --cluster-init hq27d-m # мастер; 7443 и 7444 откройте сами
sudo -u firebird ./fbagent --cluster-pairing on # репликаПока окно pairing открыто, агент держит свой порт pairing открытым в брандмауэре. Он закрывает порт, когда окно кончилось или хост связан.
Паролей в выводе нет. Пароль RCM — в файле из строки Password:, пароль
SYSDBA — в /root/fbagent-install-sysdba.txt, пароль HQ Monitor — в
/opt/hqbird/conf/access.properties.
Лицензию ставить не нужно: новый агент начинает 7-дневный триал сам, узлы кластера работают.
Шаг 2. Вход в RCM
Откройте адрес из строки RCM: мастера. Если порт 7444 закрыт для вашего ПК,
используйте SSH-туннель и https://localhost:7444:
ssh -L 7444:127.0.0.1:7444 <пользователь>@<мастер>Если порт 7444 на вашем ПК занят, возьмите другой локальный порт, например
-L 17444:127.0.0.1:7444 и https://localhost:17444.
Браузер предупредит о сертификате: RCM подписан CA кластера. На странице
входа есть «Хэш CA кластера»: сравните его со строкой CA hash: вывода
установщика. Совпадают — установите сертификат CA (ссылка «Скачать
сертификат CA (hqcluster-ca.crt)» там же) в доверенные или примите
предупреждение. Не совпадают — не входите и проверьте адрес.
Логин rcmadmin. Пароль — в файле из строки Password::
# путь — из строки Password: вашего вывода
sudo cat /opt/hqbird/fbagent-fb50/clusterca/hq27d-m/rcm-initial-passwordRCM сразу просит новый пароль (не меньше 12 символов):
RCM до 2027.5.12 мог загружать эту страницу снова и снова. В RCM 2027.5.12 (кит 2027.2.33) это исправлено.
После смены пароля агент мастера сам удаляет файл rcm-initial-password в
течение минуты. Со старым китом на втором сервере тоже есть свой RCM.
После связывания агент переносит этот прежний кластер в папку
cluster/left/. Агент 3.1.0 удаляет там его rcm-initial-password,
старый агент — нет. Тогда удалите файл сами:
# на сервере 2, после шага 3
sudo find /opt/hqbird -name rcm-initial-password
sudo rm <путь из вывода find>Файл /opt/hqbirdrcm/initial-admin.json не удаляйте: в нём только хэш
старого пароля, а без него RCM, потерявший файл пользователей, запустится с
паролем по умолчанию.
После смены пароля RCM сразу открывает Настройки → Связать хосты: в
кластере ещё нет узлов. В списке «Выпуски в зеркале» — выпуски hqbirdrcm
и hqclusternode, из которых агенты ставят узлы.
Шаг 3. Связать хосты
Первая строка списка уже заполнена (хост RCM). Добавьте вторую — адрес реплики, который видит мастер. Вводите IP, если у серверов нет общего DNS: RCM хранит строку как есть, и узлы находят друг друга по ней.
Нажмите Проверить хосты. Для хоста без порта RCM опрашивает порты
pairing 7450–7459 и показывает строку для каждого ответившего агента, в
виде хост:порт (здесь 10.114.0.6:7450). Ввод хост:порт опрашивает
только этот порт. Хосту RCM окно pairing не нужно: RCM находит его агента
в своём реестре. Сравните отпечаток сертификата с выводом установщика
(строка Pairing: реплики) — должен совпасть. Состояние второго хоста —
«Готов к связыванию». Столбец
«ID участника» показывает имя, которое хост получит в кластере:
<имя хоста>-<роль>, например hq27d-m-master. Суффикс экземпляра
(-fb50) добавляется, только если на хосте несколько агентов.
В каждой строке есть галочка, порт, экземпляр и порт узла. Связать берёт только отмеченные
строки. Строку с ошибкой отметить нельзя, и она не мешает остальным. Под
таблицей RCM 2027.5.12 пишет строки вида 10.114.0.6, no agent: closed or no answer: 7451-7459: это порты pairing хоста, на которых не отвечает другой
агент. Это не ошибки.
Мастер — хост, где будут рабочие базы. Нажмите Связать и подтвердите:
Ход: «Вступает → Вступил → Узел запускается → Работает». На прогоне связывание заняло 56 секунд (прогон 2026-11-17: 47 секунд).
На Обзоре теперь два узла: мастер и реплика. Сразу после связывания реплика может минуту быть «устарело»; потом — «в сети».
Повторная «Проверить хосты» для уже связанного хоста покажет, что на портах pairing агент не отвечает или хост недоступен: окно pairing на нём закрыто, порт pairing в брандмауэре тоже. Это не ошибка.
Один хост в кластер, где уже есть master. Связь одной строки отклоняется
с кодом lone_master: укажите роль строки. -replica-of <member мастера> —
реплика этого мастера, -new-master (флажок на странице Link hosts) — свой master.
Шаг 4. Папка баз на мастере
На мастере база должна лежать в папке, доступной пользователю firebird:
sudo install -d -o firebird -g firebird -m 0770 /databases/master
# пример: учебная база из комплекта
sudo cp /opt/firebird/examples/empbuild/employee.fdb /databases/master/
sudo chown firebird:firebird /databases/master/employee.fdbНа реплике ничего готовить не нужно: папку для копий создаёт кнопка «Создать папку» в окне инициализации (шаг 6).
Шаг 5. Регистрация баз на мастере
Базы данных → в таблице «Узлы», в строке мастера → Зарегистрировать.
- Путь к папке на этом сервере:
/databases/master, рекурсивно. - Маска включения файлов:
*.fdb. - Таблицы отслеживания синхронизации — таблицы, число строк которых сравнит кнопка «Проверить». Список задаётся для каждой регистрируемой базы. Оставьте поле пустым: тогда база считает свои таблицы публикации. Список уже управляемой базы меняют на странице базы мастера.
Предпросмотр → отметьте базы → Зарегистрировать выбранные и подтвердите.
Итог — «Зарегистрировано: 2.» и подсказка: нужен перезапуск Firebird мастера. Надпись «Новых подходящих баз данных нет» под ним не означает ошибку: базы уже зарегистрированы.
Базы — в состоянии ожидания перезапуска:
Нажмите Перезапустить Firebird мастера в строке любой из баз мастера (одного раза хватит на все) и подтвердите. Все подключения к Firebird мастера оборвутся на несколько секунд (на прогоне — 4 секунды) — выберите время.
После перезапуска узел мастера — CONFIGURED. У каждой базы значок
публикация ВЫКЛ., у реплики — «не связано».
Шаг 6. Инициализация реплики
В строке базы, в столбце реплики → Инициализировать. Окно называется «Инициализировать базу данных?».
- Публикация. Пока публикация базы выключена, Firebird не пишет
изменения в журнал, и реплика ничего не получит. Окно говорит об этом и
даёт кнопку Синхронизировать публикацию и инициализировать. Нажмите
её: RCM включит в публикацию все таблицы с первичным или уникальным
ключом и сразу начнёт инициализацию. Кнопка Инициализировать при
выключенной публикации не поможет: узел мастера откажет (
publication_off). - Папка реплики: окно предлагает
/databases/replica/<узел реплики>, на прогоне/databases/replica/hq27d-r-replica. Каждому узлу-реплике на хосте нужна своя папка. Оставьте её. Если под полем «✗ Папки нет» — нажмите Создать папку, появится «✓ Папка создана». Копия ляжет в/databases/replica/hq27d-r-replica/hq27d-m-master/. Для следующих баз папка уже задана, и окно её не меняет. - Способ: Плавный (по умолчанию). Он проверяет пишущие транзакции перед блокировкой. Обычный блокирует базу сразу.
- Флажки «Разрешить … остановить Firebird» и «Удалить старую реплику» для новой реплики не нужны.
После первой синхронизации публикации переподключите приложения. Соединение с базой мастера, открытое до включения публикации, не пишется в журнал, пока не подключится снова. На прогоне 2026-11-17 соединение, открытое до синхронизации публикации и инициализации, записало после копирования около 9 500 строк, и реплика не получила ни одной. RCM показывал «Ок» с обеих сторон; расхождение показала только кнопка Проверить (шаг 9): «Не ок (рассинхронизировано)». Строки нового соединения реплицировались сразу. Поэтому после первой синхронизации публикации базы переподключите приложения (или перезапустите Firebird мастера), затем выполните Проверить без записи. Если на реплике не хватает строк, сделайте reinit (шаг 7).
Первая инициализация под нагрузкой. Пока в архиве мастера нет ни одного
сегмента журнала, «Плавный» может отказать, если в базу пишут. В строке базы
появится long_transactions: … the archive holds no segment yet и подсказка
на русском:
На прогоне так вышло и после «Синхронизировать публикацию и инициализировать» (находка G-04 в отчёте). Публикация при этом уже включена. Подождите, пока у базы мастера появится «архив: 1 сегм.» или больше (на прогоне — через 15 секунд), и нажмите Инициализировать снова со способом «Плавный». Или выберите «Обычный». На прогоне 2026-11-17 (≈49 транзакций/с из одного соединения) «Плавный» отказа не дал.
Ход — в строке базы: SPACE CHECK → LOCKING → COPYING TO NODE (%) → UNLOCKING → SEEDING → RESTARTING REPLICA. Ход виден и после обновления страницы. Кнопка «Инициализировать» на это время неактивна.
После копирования узел реплики сам перезапускает Firebird реплики в запланированную минуту. Строка пишет, когда; кнопка Перезапустить Firebird реплики делает это сразу. Все подключения к Firebird реплики при этом оборвутся.
Большая база — так же. На прогоне bulk.fdb (3,13 ГБ) инициализировали
кнопкой «Синхронизировать публикацию и инициализировать» без нагрузки на неё:
Готово, когда у мастера и реплики «Ок», а «последний применённый сегмент»
реплики догоняет «последний сегмент» мастера. База без новых записей (здесь
bulk.fdb) показывает у реплики «Ожидание» с сегментом 0 — это норма.
Замеры прогона (employee.fdb под нагрузкой ≈55 транзакций/с):
| База | Размер | Мастер: от начала до конца | Блокировка на мастере | Пара «Ок» |
|---|---|---|---|---|
employee.fdb |
4 МБ | 0,7 с | 0,35 с | через ≈1 мин (ждала перезапуска реплики) |
bulk.fdb |
3,13 ГБ | 64 с (≈55 МБ/с) | 59 с | через ≈2 мин |
Прогон 2026-11-17 (кит 2027.2.33): employee.fdb (3 МБ) — 3 секунды на
мастере, bulk.fdb (167 МБ) — 15 секунд. Сторона реплики стала парой через
≈40 секунд после старта (ждала перезапуска Firebird реплики).
Во время блокировки база мастера работает: изменения идут в файл .delta.
Публикация потом. Кнопка Синхронизировать публикацию у базы мастера нужна, когда в базе появились новые таблицы. Она приводит публикацию в соответствие с таблицами в одной транзакции, Firebird не перезапускается.
Таблицы публикации показывает, какие таблицы реплицируются. Таблицу без ключа опубликовать нельзя: дайте ей первичный ключ.
Шаг 7. Реинициализация
Нужна, когда реплика разошлась с мастером или узел просит её сам
(NEEDS_REINIT). В строке реплики → Реинициализировать, способ
Плавный. Архив сегментов уже есть, и плавный режим проходит под
нагрузкой. Пишущие транзакции старше истории журнала он ждёт и показывает.
Ход — как при инициализации. Перезапуск Firebird реплики при реинициализации
обычно не нужен. На прогоне 2026-11-17 reinit базы employee.fdb перезапустил
Firebird реплики: учитывайте разрыв соединений с репликой. Этот reinit занял
4 секунды на мастере при ≈49 транзакциях/с; после остановки записи число
строк совпало (14 418 строк в таблице нагрузки с обеих сторон).
Замеры прогона:
| База | Нагрузка | Время | Блокировка | Что ещё |
|---|---|---|---|---|
employee.fdb |
≈55 транзакций/с | 1,7 с | 0,32 с | повторено 417 транзакций из сегментов |
bulk.fdb |
нет | 61 с | 55 с | без перезапуска Firebird реплики |
После плавного reinit под нагрузкой на реплике может появиться оповещение
info replication_conflict_resolved («Record being inserted … already
exists, updating instead»): реплика повторила транзакции, которые уже были в
копии. Данные совпадают — на прогоне числа строк всех таблиц совпали.
Оповещение можно подтвердить (находка G-07 в отчёте).
Шаг 8. Мало места на реплике
На томе реплики нужно свободно ≥ 105 % размера базы плюс 1 ГБ сверх старой копии: старая копия лежит до конца, а новый файл сразу занимает полный размер. Если места мало, окно показывает, сколько нужно, сколько свободно и сколько занимает старая копия (оценка RCM; решает узел реплики). Если без старой копии места хватает, окно советует флажок Удалить старую реплику.
С флажком узел реплики после блокировки мастера останавливает Firebird
реплики, удаляет старую копию и запускает Firebird снова. На прогоне
(свободно 2,97 ГБ, новой копии нужно 3,29 ГБ, старая копия 3,13 ГБ)
реинициализация bulk.fdb с флажком прошла за 65 секунд. Без флажка узел
откажет с insufficient disk space on replica.
Окно может не показать чисел, когда не хватает только запаса в 1 ГБ. На
прогоне 2026-11-17 (свободно 1,1 ГБ, база 167 МБ) окно оценки не показало, а
reinit без флажка завершился ошибкой за 3 секунды. Причину показали строка
базы и страница Команды: 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. Тот же reinit с
флажком занял 9 секунд.
Риск флажка. Пока идёт копирование, реплики этой базы нет. Если reinit не удался, пара —
NEEDS_REINIT, на реплике — оповещениеreplica_removed_for_reinit(warn), повтор — новый полный reinit. Автоматический reinit удаляет старую копию, только если включён ключ RCMauto_reinit.remove_old_replica_when_short(по умолчанию выключен).
Шаг 9. Проверка
Проверить в строке реплики сравнивает COUNT(*) таблиц отслеживания на
мастере и реплике. Это не сверка строк. Строка «Источник списка таблиц»
называет список: собственный список базы, список узла, таблицы публикации
или RDB$FIELDS. Числа — с разделителями разрядов.
Под нагрузкой реплика отстаёт на несколько секунд, и «Проверить» даёт «Не ок» по таблицам, в которые пишут:
Без записи числа совпадают:
Таблица, которой нет ни в одной из баз, — «нет в базе», это не расхождение. Таблица только на одной стороне — «нет таблицы», это расхождение.
Надёжнее — число строк всех таблиц на обеих сторонах после остановки записи
(скрипт — в hqbird2027-linux-cluster-runbook.ru.md). На
прогоне совпали все 11 таблиц (employee.fdb — 10, bulk.fdb — 1,
2 800 000 строк).
Периодическая проверка (Проверка данных) выключена по умолчанию. Нажмите Включить на всех узлах и подтвердите: каждый узел считает свои строки, а мастер сравнивает числа. Перезапуск не нужен: RCM пишет «Сохранено и уже действует: перезапуск узла не нужен». Первая проверка — через один интервал (по умолчанию 2 часа).
Что смотреть дальше
-
Обзор — узлы, их состояние, корень баз и место на диске.
Обзор -
Оповещения — проблемы узлов и баз. На прогоне было два оповещения, оба можно подтвердить:
replication_conflict_resolvedпосле плавного reinit (шаг 7) иparse_no_observationsна мастере («no events parsed from /opt/firebird/replication.log»). Firebird мастера пишет вreplication.logтолько ошибки, поэтому пустой журнал — норма (находка G-06 в отчёте).
Оповещения RCM 2027.5.12 и новее (кит 2027.2.33) может отправлять оповещения уровня
warnи выше в ваш Telegram-бот, на webhook или по e-mail. Каналы задаются в файле/opt/hqbirdrcm/rcm.json, ключnotify.channels; затем перезапустите RCM (sudo systemctl restart hqbirdrcm). После этого блок Каналы уведомлений этой страницы показывает каналы, у каждого есть кнопка Отправить тест. Без каналов блок пишет, что RCM никуда не отправляет оповещения. Канал 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) — мастер, реплики и роутеры сервиса и операции switchover, failover и rejoin. Это руководство их не описывает: смотрите руководство RCM. Перед работой с ними обновите RCM и узлы до одной версии.
-
Команды — каждая операция RCM с результатом. Время — местное время браузера с поясом (например,
17:59:45 UTC+1), во всплывающей подсказке — UTC. Журналы узлов — в UTC.
Команды -
HQ Monitor —
http://<сервер>:23050/, логинadmin, пароль в/opt/hqbird/conf/access.properties. Показывает сервер и базы. В китах с агентом 3.1.0 и новее в HQ Monitor есть страница Кластеры. На мастере (хосте 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 <id кластера>, базы реплики остались в своей папке, а RCM через минуту ещё
показывал узел этого хоста. Удаление HQbird с сервера кластера, в том числе с
сервера, который ведёт RCM:
hqbird2027-removal-guide.md, раздел 4.
Частые ошибки
| Что видно | Причина | Что делать |
|---|---|---|
publication_off при инициализации |
публикация выключена, или в ней нет таблиц, хотя в базе есть таблицы с ключом | кнопка «Синхронизировать публикацию и инициализировать» (шаг 6) |
long_transactions … the archive holds no segment yet |
первая инициализация в плавном режиме, в базу пишут, архив мастера пуст | дождаться «архив: 1 сегм.» и повторить «Плавный» или выбрать «Обычный» |
reinit_pre_publication_transactions |
пишущая транзакция начата до включения публикации и открыта дольше минуты | завершить её (COMMIT или ROLLBACK) и повторить |
| «✗ Папки нет на …» в окне | папку реплики не создали | кнопка «Создать папку» в окне или install -d -o firebird -g firebird -m 0770 <папка> на реплике |
| «Не ок (рассинхронизировано)» в «Проверить» без записи; обе стороны показывают «Ок» | соединение приложения открыто до включения публикации: оно не пишется в журнал | переподключить приложение, затем Reinit (шаг 6, заметка о первой синхронизации публикации) |
| «Не ок (рассинхронизировано)» в «Проверить» | в базу пишут, реплика отстаёт на секунды | повторить без нагрузки; смотреть столбец «Совпадение» |
| Хост «unreachable» или «нет агента» в «Связать хосты» | окно pairing хоста закрыто (выключено по умолчанию или 24 ч прошли) или брандмауэр между серверами закрывает 7450–7459 | открыть окно на хосте: HQ Monitor → Кластеры → Открыть окно pairing на 24 часа или fbagent --cluster-pairing on; открыть порт в брандмауэре облака |
insufficient disk space on replica при реинициализации |
старая реплика лежит до конца, новый файл занимает полный размер | освободить на томе реплики ≥ 105 % размера базы + 1 ГБ сверх старого файла или флажок «Удалить старую реплику» (шаг 8) |
| Узел не появился после «Связать хосты» | в зеркале RCM нет подписанного выпуска hqclusternode |
«Выпуски в зеркале» на странице «Связать хосты» (шаг 2) |