Другие языки: 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. Установка на оба сервера

На каждом сервере:

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). Язык интерфейса он берёт из системы. На первой странице есть строка Кластер 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 означает «нет» для обоих.

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

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

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

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

Command
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)» там же) в доверенные или примите предупреждение. Не совпадают — не входите и проверьте адрес.

Вход в RCM
Вход в RCM

Логин rcmadmin. Пароль — в файле из строки Password::

Command
# путь — из строки Password: вашего вывода
sudo cat /opt/hqbird/fbagent-fb50/clusterca/hq27d-m/rcm-initial-password

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

Смена пароля при первом входе
Смена пароля при первом входе

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

После смены пароля агент мастера сам удаляет файл rcm-initial-password в течение минуты. Со старым китом на втором сервере тоже есть свой RCM. После связывания агент переносит этот прежний кластер в папку cluster/left/. Агент 3.1.0 удаляет там его rcm-initial-password, старый агент — нет. Тогда удалите файл сами:

Command
# на сервере 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:

Command
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 секунды) — выберите время.

Перезапуск Firebird мастера
Перезапуск Firebird мастера

После перезапуска узел мастера — 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 реплики при этом оборвутся.

Ждёт перезапуска 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 удаляет старую копию, только если включён ключ RCM auto_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:

    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) — мастер, реплики и роутеры сервиса и операции 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.

Вывести хост из кластера

Command
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)