Эта страница переведена машинным переводом. Читайте английский оригинал. English

Это руководство предназначено для администратора, который устанавливает HQbird 2027 на сервер Linux с помощью офлайн-установщика hqbird2027-fbNN-linux-<version>.run. Оно охватывает новую установку, обновление более старой версии HQbird и более ранней версии HQbird 2027, команды обслуживания, подключение к вашему HQCenter, автоматическую (скриптовую) установку и расположение файлов после установки.

В примерах показан установщик для Firebird 5.0 на Ubuntu 24.04. Установщики для Firebird 2.5, 3.0 и 4.0 работают так же; отличаются только версия, порт по умолчанию и имена папок. Установка в Windows описана в разделе Windows installation.

Содержание

  1. 1. Что устанавливает установщик
  2. 2. Установка вкратце
  3. 3. Новая установка
  4. 4. После установки
  5. 5. Обновление более старого HQbird (2024 и ранее)
  6. 6. Обновление HQbird 2027 до новой версии
  7. 7. Команды обслуживания
  8. 8. Подключение к вашему HQCenter
  9. 9. Автоматическая установка и скрипты
  10. 10. Устранение неполадок

1. Что устанавливает установщик

Один файл .run = одна линейка Firebird. Выберите установщик той версии Firebird, которую используют ваши базы данных:

Установщик Какой Firebird устанавливает или обновляет Первый Firebird на хосте Размер
hqbird2027-fb50-linux-<version>.run Firebird 5.0 (сборка HQbird) /opt/firebird, порт 3050 около 250 МБ
hqbird2027-fb40-linux-<version>.run Firebird 4.0 (сборка HQbird) /opt/firebird, порт 3050 около 220 МБ
hqbird2027-fb30-linux-<version>.run Firebird 3.0 (сборка HQbird) /opt/firebird, порт 3050 около 130 МБ
hqbird2027-fb25-linux-<version>.run Firebird 2.5 (сборка HQbird) /opt/firebird, порт 3050 около 80 МБ

Каждый установщик содержит и устанавливает без доступа к Интернету:

  • Firebird (сборка HQbird этой линейки): новый сервер или обновление на месте Firebird этой линейки, уже присутствующего на хосте. Ваши firebird.conf, databases.conf (aliases.conf для 2.5), база данных безопасности и пароль SYSDBA сохраняются.
  • Отладочные файлы Firebird (символы для анализа сбоев), устанавливаемые в папку Firebird. --no-debug пропускает их.
  • Агент HQbird (fbagent): юнит systemd hqbirdfbagent-fb50, работающий от пользователя firebird, который выполняет резервное копирование, мониторинг, задачи обслуживания и обновления. Имя оканчивается на линейку Firebird (-fb25 … -fb50); второй экземпляр этой линейки имеет -fb50-2.
  • HQ Monitor: веб-консоль этого экземпляра HQbird, юнит hqbirdmonitor-fb50, адрес http://<server>:<20000 + Firebird port>/ (для Firebird на порту 3050: http://localhost:23050/).
  • Компоненты кластера: консоль кластера RCM (hqbirdrcm) и узел кластера (hqclusternode) копируются в кэш агента. Комплекты с агентом (fbagent) 3.1.0 и новее по умолчанию не создают кластер: нет RCM, нет окна сопряжения, нет порта кластера в брандмауэре. Два вопроса (или --rcm on, --cluster-pairing on) включают их («Далее: кластер» в разделе 3). С RCM он устанавливается в /opt/hqbirdrcm и работает как юнит hqbirdrcm; сводка выводит его адрес в строке RCM:. Узел получает свой юнит (например, hqclusternode-master-p3050), когда вы связываете хост в RCM. Комплекты с 2027.2.19 со старым агентом устанавливают RCM на каждом сервере (--rcm off оставляет его в кэше) и открывают окно сопряжения. Комплекты до 2027.2.19 только копируют оба компонента в кэш агента: нет юнита hqbirdrcm и нет строки RCM:.

Экземпляры, установленные до 2027.2.9, имеют порт Firebird в именах агента: папка /opt/hqbird/fbagent-p3050, юниты hqbirdfbagent-p3050 и hqbirdmonitor-p3050. Обновление не меняет эти имена. Только новые экземпляры получают имена -fb<NN>, поэтому на одном хосте могут быть обе формы.

Требования: x86_64, ядро 3.2 или новее, systemd; Linux с apt, dnf/yum или zypper (Ubuntu, Debian, AlmaLinux, Rocky, RHEL, Oracle Linux, openSUSE, RED OS и другие); root. Около 300 МБ свободного места в /var/tmp во время установки (папка, где могут выполняться программы; см. --tmpdir). Несколько библиотек ОС (libtommath, ICU) берутся из репозитория дистрибутива; сервер без Интернета получает точные команды для их подготовки (раздел 9).

Не поддерживается: Firebird, установленный из пакетов дистрибутива (firebird3.0-server, rpm firebird). Установщик останавливается до внесения каких-либо изменений (код выхода 7); сначала удалите пакеты (сохраните резервную копию gbak ваших баз данных) или используйте онлайн-установщик с --import-firebird.

Несколько линеек Firebird на одном сервере: каждая линейка имеет свой установщик. Первый Firebird на хосте устанавливается в /opt/firebird; вторая линейка — в /opt/fb<NN> (/opt/fb50, /opt/fb40, /opt/fb30) на порту своей линейки: 3053 для 3.0, 3054 для 4.0, 3055 для 5.0. Если этот порт занят, установщик останавливается и запрашивает --port N. Несколько экземпляров одной линейки (второй Firebird 5.0 на другом порту) устанавливаются с помощью --fb-root <new folder> --port <port> (раздел 7). Firebird 2.5 имеет только один экземпляр, в /opt/firebird; для второго сервера рядом с ним используйте другую линейку (например, Firebird 5.0 в /opt/fb50).

Пошаговое руководство для двух экземпляров на портах 3050 и 3051 для каждой линейки с командами для копирования и вставки находится в hqbird2027-linux-two-instances-runbook.ru.md (русский) и hqbird2027-linux-two-instances-runbook.pt.md (португальский).

Пробный период: без лицензии агент работает в 7-дневном пробном режиме. Пробный email (--email) продлевает его до 30 дней. Файл лицензии (--license) или подключение к вашему HQCenter (раздел 8) заменяет пробный режим.

Обновления: начиная с комплекта 2027.2.31 (агент 3.3.0) сервер, не подключённый ни к одному HQCenter, проверяет сервер обновлений производителя. По умолчанию агент, HQ Monitor и fbmcp обновляются сами, а новый пакет Firebird загружается и ждёт вас. --auto-update all|agent|off или строка Updates текстового интерфейса изменяет это («Обновления без HQCenter» в разделе 4). Сервер, подключённый к HQCenter, получает обновления из этого HQCenter.

2. Установка вкратце

Diagram

Проверка сервера и сама установка выполняются агентом HQbird, который несёт установщик (fbagent --install-plan, fbagent --setup-install). Ничего не загружается, кроме отсутствующих пакетов ОС. Ничего не изменяется до подтверждения плана: пакеты ОС устанавливаются после подтверждения. В терминале комплекты после 2027.2.30 открывают текстовый интерфейс (шаг 3 раздела 3); --no-tui запускает обычный установщик, который задаёт свои вопросы строками текста. Без терминала и без --yes установщик останавливается на подтверждении с кодом выхода 4. Если установка завершается неудачей до запуска юнита агента, агент откатывает юниты к состоянию, которое они имели до этого (код выхода 2; код 3, когда откат был неполным, сводка сообщает, что проверить).

3. Новая установка

Шаг 1: Загрузите установщик и проверьте его

Command
KIT=hqbird2027-fb50-linux-2027.2.9.run
curl -fL -O https://ib-aid.com/download/hqbird/v2027/$KIT -O https://ib-aid.com/download/hqbird/v2027/$KIT.sha256
sha256sum -c $KIT.sha256

Другие линейки имеют те же имена с fb40, fb30, fb25. Ожидается: hqbird2027-fb50-linux-2027.2.9.run: OK. Сервер без Интернета: загрузите два файла на ПК по тем же ссылкам и скопируйте их на сервер (scp, USB-накопитель, общий ресурс).

Установщик также проверяет свою собственную полезную нагрузку, прежде чем что-либо распаковать: обрезанный

или поврежденная загрузка прерывается с кодом выхода 5 («скачайте заново»).

Шаг 2: Проверьте хост, не изменяя его (необязательно)

Command
sudo sh hqbird2027-fb50-linux-2027.2.9.run --check

--check выполняет проверку хоста, сообщает об отсутствующих системных библиотеках (и о командах для их получения на сервере без интернета), показывает, что обнаружил агент и что он собирается делать, и завершается. Ничего не устанавливается.

Шаг 3: Запустите установщик

Command
sudo sh hqbird2027-fb50-linux-2027.2.9.run

Комплекты после 2027.2.30 открывают текстовый интерфейс, когда вы запускаете их в терминале: полноэкранные страницы с планом и настройками. Комплекты до 2027.2.30 включительно и случаи, описанные ниже в разделе «Простой установщик», задают свои вопросы строками текста. Оба выполняют одну и ту же установку с одними и теми же параметрами.

Текстовый интерфейс

Установщик проверяет хост, распаковывает себя, читает план и показывает первую страницу. На хосте ничего не меняется, пока вы не запустите установку на странице Install.

text
 HQbird 2027 setup <version> | Firebird 5.0 (5.0.5.1917)

 Plan M1: New Firebird and HQbird agent
   Firebird: new /opt/firebird (unit firebird, port 3050)
   Agent: new, in /opt/hqbird/fbagent-fb50
   OS packages to install: libtommath1 (see Plan details)

   Language         English (auto)
   Firebird folder  automatic (/opt/firebird)
   Firebird port    automatic (3050)
   Agent id         automatic (srv1261114-fb50)
   SYSDBA password  generated (for a new Firebird)
   HQ Monitor       port automatic, login admin
   License          not now (add it later in HQ Monitor)
   HQCenter         not attached
   Cluster          RCM off, discovery mode off
   Components       debug files: yes, fbmcp: yes
   Updates          HQbird only (recommended)

 > Install
   Plan details
   About plans
   Quit

 Up/Down: move   Enter: change or start   Esc: quit

Верхние строки — это план для текущих настроек: его код и то, что установщик сделает с Firebird и агентом. Невозможный план выделен красным, с указанием причины, а курсор стоит на настройке, которая это исправляет. После каждого изменения установщик заново читает план.

Клавиша Что делает
Up, Down Перемещает курсор (также k, j)
Enter Открывает настройку под курсором, выбирает пункт, принимает введенное значение
Space Включает или выключает компонент (страница Components)
Esc Возврат на предыдущую страницу; на первой странице: выход из установщика (сначала спрашивает)
Ctrl+C Немедленно останавливает установщик (код выхода 2). До страницы Install ничего не было изменено

На странице, где вы вводите значение (папку, порт, адрес), Enter принимает его, а пустое значение означает «автоматически». Esc не покидает такую страницу.

Настройка Что вы выбираете То же, что параметр
Language English, Russian, Brazilian Portuguese, German; страницы меняются сразу --lang
Firebird folder Папка нового Firebird или Firebird, который нужно обновить. У Firebird 2.5 одна папка, поэтому в его установщике такой строки нет --fb-root
Firebird port TCP-порт Firebird --port
Agent id Автоматически, имя хоста, имя хоста и экземпляр или ваше собственное значение. Только для нового агента: установленный агент сохраняет свой id, и строка не показывается --agent-id
SYSDBA password Для нового Firebird: сгенерированный или ваш собственный --sysdba-pass-file
HQ Monitor Порт и вход в веб-консоль --hqmonitor-port, --hqmonitor-login, --hqmonitor-password-file
License Не сейчас, 30-дневная пробная версия по e-mail (адрес, уведомление о конфиденциальности, зона) или файл лицензии --email --accept-privacy --trial-zone, --license
HQCenter Файл attach.json вашего HQCenter --attach
Cluster Менеджер кластера RCM (id кластера, пароль администратора), режим обнаружения, порт сопряжения --rcm, --cluster-id, --rcm-password-file, --cluster-pairing, --pairing-port
Components Отладочные файлы Firebird; fbmcp и адреса его удаленного режима --no-debug, --no-fbmcp, --fbmcp-allow-from
Updates Только HQbird (агент, HQ Monitor и fbmcp обновляются сами, новый Firebird ждет вас), HQbird и Firebird (Firebird также обновляется сам, ночью с 03:30 до 04:00, с перезапуском Firebird) или Off. Комплекты с 2027.2.31; только для нового агента без файла attach.json: обновлениями присоединенного агента управляет HQCenter --auto-update

Параметры командной строки — это значения, с которых начинают страницы: sudo sh hqbird2027-fb50-linux-<ver>.run --rcm on --port 3055 открывает первую страницу с включенным RCM и портом 3055.

Четыре строки под настройками:

  • Install показывает план полностью, затем спрашивает Start the install now? с курсором на No. Вопросы плана (более старый HQbird, работающий Firebird, который нужно остановить) находятся на той же странице: Yes отвечает на все. После Yes страницы закрываются, и установка выводит свой журнал и сводку на обычный экран, как в простом установщике ниже.
  • Plan details показывает, что означает код плана, что установщик обнаружил на хосте, предупреждения и системные пакеты, которые он установит.
  • About plans перечисляет все коды (M1 … M17). Enter на коде объясняет его. * отмечает код текущего плана.
  • Quit выходит из установщика (код выхода 1). Ничего не было изменено.

Простой установщик

Простой установщик запускается, когда верно одно из следующего:

  • параметр --no-tui или переменная HQBIRD_NO_TUI=1;
  • --yes, --check, --uninstall, --extract, --plan-help, --help;
  • stdin или stdout не является терминалом: скрипт, ssh host 'command' без терминала или конвейер, например ... 2>&1 | tee install.log;
  • TERM равен dumb или не задан;
  • окно меньше 80 столбцов на 24 строки (внутри tmux со своей строкой состояния у терминала 80x24 всего 23 строки: сделайте окно больше или используйте --no-tui);
  • bash на хосте старше 4.4 (RHEL 7, CentOS 7);
  • комплект версии 2027.2.30 или старше.

Для окна и для bash первая строка вывода сообщает, почему страницы не открылись.

Типичный запуск простого установщика на сервере без Firebird:

text
[install] HQbird 2027 setup 2027.2.9, Firebird 5.0 (5.0.5.1916)
[install] host: Ubuntu 24.04.5 LTS, kernel 6.8.0-142-generic
[install] checking the payload (sha256) ...
[install] unpacking into /var/tmp/hqbird2027.k3Qf1x ...
[install] OS libraries missing: libtommath.so.1 (packages: libtommath1)
[install] plan M1: Firebird new /opt/firebird (unit firebird, port 3050)
[install]              agent new in /opt/hqbird/fbagent-fb50 (unit hqbirdfbagent-fb50), HQ Monitor hqbirdmonitor-fb50
[install]              OS packages to install: libtommath1
[install] Install as planned? Yes/No y
[install] installing from the package repository: libtommath1
[install] OS libraries: installed
[install] installing (fbagent --setup-install; log /var/log/fbagent/install.log) ...
...
Done: agent hqbirdfbagent-fb50 in /opt/hqbird/fbagent-fb50, Firebird 5.0.5.1916 in /opt/firebird (port 3050).
HQ Monitor: http://localhost:23050/ (login admin; password in /opt/hqbird/conf/access.properties)
[install] done. Uninstall: sudo sh hqbird2027-fb50-linux-2027.2.9.run --uninstall

Этот пример из комплекта 2027.2.9. Начиная с комплекта 2027.2.19 в сводке также есть строки RCM: и Pairing: консоли кластера (см. «Далее: кластер» ниже). С агентом 3.1.0 и новее и без выбранного кластера они такие:

text
RCM:        off; turn it on in HQbird Monitor or with fbagent --cluster-init <id>
Pairing:    off; turn it on in HQbird Monitor or with fbagent --cluster-pairing on (port 7450)

Что означают строки:

  • host: дистрибутив и ядро; установщик отказывается от хоста, который не x86_64, не имеет systemd или работает на ядре старше 3.2.
  • OS libraries: что Firebird этой линейки требует от ОС (раздел 9). План перечисляет отсутствующие пакеты (OS packages to install); после подтверждения установщик берет их из репозитория дистрибутива. Без репозитория он останавливается с кодом выхода 6

и выводит команды.

  • plan: что нашёл агент (строки found Firebird ..., HQbird: ...) и что он будет делать: Firebird new (новый сервер), update (Firebird этой линии обновляется на месте) или отказ с причиной (код выхода 1, ничего не изменено).
  • Install as planned? Yes/No: последний вопрос перед тем, как что-либо будет изменено. Ответьте y. Когда у плана есть свои вопросы (более старый HQbird, другая версия), вместо него задаются они (раздел 5). Без терминала передайте --yes; иначе установщик останавливается с кодом выхода 4.
  • Вопросы о кластере (агент 3.1.0 и новее): Install the cluster manager (RCM) on this host and make a new cluster? [y/N] и Turn on discovery mode for 24 hours (an RCM on the network may invite this agent into its cluster; port 7450)? [y/N]. По умолчанию — No. Первый задаётся только когда на хосте нет RCM и агент не входит ни в один кластер; второй — не задаётся, когда агент входит в кластер или запускает RCM. --yes и запуск без терминала отвечают No (без кода выхода 4).
  • HQ Monitor: адрес и логин. Новая установка получает логин admin; его сгенерированный пароль находится в /opt/hqbird/conf/access.properties (режим 0600, доступен для чтения root и только агенту). Все экземпляры HQbird 2027 на хосте используют этот файл. Смените пароль в HQ Monitor.

Пароль SYSDBA нового Firebird генерируется и сохраняется в /root/fbagent-install-sysdba.txt (режим 0600): строка комментария, затем строка SYSDBA_PASS=<password>. Другой Firebird, установленный на том же хосте позже, получает тот же пароль из этого файла. Чтобы задать свой, передайте --sysdba-pass-file <file> (первая строка файла) или --sysdba-pass <password>.

Язык установщика

Комплекты после 2027.2.30 говорят на четырёх языках: английском, русском (ru), бразильском португальском (pt-BR) и немецком (de). Установщик выбирает язык в таком порядке:

  1. опция --lang en|ru|pt-BR|de;
  2. переменная HQBIRD_LANG;
  3. локаль консоли (LC_ALL, затем LC_MESSAGES, затем LANG), когда это локаль UTF-8;
  4. английский.

Вторая строка вывода сообщает, какой это язык и как его изменить. Эта строка всегда на английском:

text
[install] Language: Русский (auto). Use --lang en to change.

Примечания:

  • PuTTY не передаёт LANG на сервер. Учитывается собственная локаль сервера, поэтому язык часто английский. Используйте --lang.
  • С --yes и без терминала автоматический язык — английский: скрипты читают этот вывод. --lang там всё равно работает.
  • Установщику нужна локаль UTF-8 на хосте для других языков (C.UTF-8 или en_US.UTF-8). Он устанавливает её для себя. Без неё он говорит на английском.
  • В текстовом интерфейсе строка Language на первой странице меняет язык сразу. Терминал должен отображать UTF-8 (PuTTY: Window, Translation, Remote character set UTF-8, что является его значением по умолчанию).
  • Английский остаётся в: строках прогресса самой установки, сводке Done:, /var/log/fbagent/install.log и предупреждениях сканирования хоста.

Код плана

У плана есть код: M1, M2, … Он называет случай, который установщик нашёл на хосте. Установщик выводит, что означает код:

text
[install] plan M1: New Firebird and HQbird agent
[install]              This host has no Firebird and no older HQbird. Setup installs a new Firebird and a new HQbird agent.
[install] plan M1: Firebird new /opt/firebird (unit firebird, port 3050)

--plan-help выводит все коды и завершает работу. Он ничего не меняет. В текстовом интерфейсе первая страница показывает код и его заголовок, «Plan details» показывает текст, а «About plans» перечисляет все коды.

Код Что нашёл установщик Firebird Агент Более старый HQbird
M1 ничего новый новый —
M2 Firebird этой линии, более старого HQbird нет обновление новый —
M3 Firebird другой линии, более старого HQbird нет новый, порт 305N новый —
M4 более старый HQbird, обслуживающий Firebird этой линии обновление новый выключен, его задания импортированы как включённые
M5 более старый HQbird другой линии; Firebird этой линии присутствует обновление, после вопроса новый продолжает работать
M6 более старый HQbird другой линии; Firebird этой линии отсутствует новый, после вопроса новый продолжает работать
M7 более старый HQbird без локального Firebird известной версии обновление или новый новый продолжает работать, предупреждение
M8 агент HQbird 2027 для другого Firebird обновление или новый новый, рядом с первым не изменён
M9 как M8, и более старый HQbird обслуживает эту линию обновление новый, рядом с первым выключен, его задания импортированы как включённые
M10 агент уже обслуживает этот Firebird (повторный запуск) обновление на месте выключен, когда он запущен
M11 --fb-root — это Firebird этой линии обновление новый или на месте как выше
M13 --fb-root — пустая или новая папка новый в этой папке новый как выше

Коды отказа (код выхода 1, ничего не изменено): M12 в папке есть Firebird, который установщик не может обновить (другая линия, версия, которую он не может прочитать, отключённая служба); M14 папка не пуста и не содержит Firebird; M16 несколько серверов Firebird этой линии, укажите --fb-root; M17 Firebird 2.5 работает только в /opt/firebird. M15 — это комплект только с агентом: Firebird не устанавливается и не обновляется.

Идентификатор агента

Идентификатор агента называет агента в HQCenter, в лицензии и в кластере. Он задаётся только при первой установке:

  • По умолчанию: имя хоста + дата + экземпляр, например srv1261114-fb50.
  • --agent-id ID задаёт ваш собственный id (1-128 букв, цифр, ., _ или -; первый символ — буква или цифра).
  • Установщик отклоняет id, который уже есть у другого агента хоста.
  • В текстовом интерфейсе страница Agent id предлагает автоматический id, имя хоста, имя хоста с экземпляром и ваше собственное значение, а также перечисляет id, которые уже есть на хосте.
  • Установленный агент сохраняет свой id. Повторный запуск показывает его в плане (id srv1 (kept)), в текстовом интерфейсе тогда нет строки Agent id, а --agent-id там даёт только предупреждение. Новый агент в папке, которую более ранняя установка оставила со своей конфигурацией, также сохраняет id этой конфигурации.

Шаг 4: Проверьте результат

Command
systemctl status firebird hqbirdfbagent-fb50 hqbirdmonitor-fb50 --no-pager
ss -ltnp | grep -E ':3050|:23050'
ISC_PASSWORD="$(sed -n 's/^SYSDBA_PASS=//p' /root/fbagent-install-sysdba.txt)" \
  /opt/firebird/bin/isql -user SYSDBA localhost/3050:/opt/firebird/examples/empbuild/employee.fdb

Используйте полный путь к образцу базы данных: он работает для любой линии и также после обновления, тогда как сохранённый databases.conf более старой установки может не иметь псевдонима employee (новая установка 2027.2.3 его имеет).

Откройте http://<server>:23050/ в браузере и войдите как admin с паролем из /opt/hqbird/conf/access.properties. Порт Firebird и порт HQ Monitor открываются в firewalld (зона public), когда он работает, иначе в ufw, когда он активен; при другом брандмауэре откройте их сами. Порты кластера открываются только для опции кластера: 7443, 7444 и порт узла с --rcm on; порт узла и порт сопряжения с --cluster-pairing on. Без активного брандмауэра установщик выводит одну строку с портами, которые он не открыл. Порт, который был открыт до установки, остаётся как есть.

Далее: кластер

Чтобы реплицировать ваши базы данных с главного сервера на сервер-реплику, свяжите два сервера в консоли кластера RCM. С агентом 3.1.0 и новее устанавливайте RCM только на главном сервере (--rcm on или ответьте y) и включите режим обнаружения на реплике (--cluster-pairing on). Режим обнаружения открывает окно сопряжения на 24 часа: порт сопряжения слота агента (7450 для первого экземпляра, 7451 для второго, вплоть до 7459) открыт в брандмауэре, и RCM может пригласить агента. На одном хосте один RCM (порты 7443 и 7444); агент, который его создал, запускает его и не открывает окно сопряжения.

Позже, без установщика: HQ Monitor → Clusters → Cluster on this server, или fbagent --cluster-init <id> и fbagent --cluster-pairing on. Комплекты с 2027.2.19 с более старым агентом запускают RCM на каждом сервере и печатают его адрес в строке RCM: сводки; установка до 2027.2.19 получает RCM при обновлении более новым комплектом (раздел 6). Руководство по кластеру (для комплекта 2027.2.33) проходит шаг за шагом от двух новых серверов до работающей реплики, со скриншотами: Руководство по кластеру Linux (также на русском и португальском). Те же шаги только командами: hqbird2027-linux-cluster-runbook.md (hqbird2027-linux-cluster-runbook.ru.md, hqbird2027-linux-cluster-runbook.pt.md).

4. После установки

Юниты

Юнит Что Запускается от
firebird (2.5, 4.0, 5.0 в /opt/firebird); firebird-superserver (3.0 в /opt/firebird); для другой папки — имя папки с / → _: firebird.opt_fb50, firebird.opt_fb40-2 (4.0, 5.0 в /opt/fb50, /opt/fb40-2), firebird.opt_fb30-superserver (3.0 в /opt/fb30) Сервер Firebird firebird
hqbirdfbagent-fb50 (второй экземпляр hqbirdfbagent-fb50-2; до 2027.2.9 hqbirdfbagent-p<порт Firebird>) Агент HQbird firebird
hqbirdmonitor-fb50 (hqbirdmonitor-fb50-2; до 2027.2.9 hqbirdmonitor-p<порт Firebird>) HQ Monitor firebird

Все три включены и запускаются при загрузке. journalctl -u hqbirdfbagent-fb50 показывает журнал юнита агента. В Firebird 3.0 также есть юниты firebird-classic.socket и [email protected] (firebird.opt_fb30-classic.* в другой папке), а в Firebird 2.5 — firebird.socket: они остаются inactive, это нормально. Процесс Firebird 2.5 — fb_smp_server (SuperClassic).

Где находятся файлы

Пример — первый экземпляр Firebird 5.0 в /opt/firebird на порту 3050. Второй экземпляр линейки имеет -2 в именах агента (fbagent-fb50-2, hqbirdfbagent-fb50-2, hqbirdmonitor-fb50-2). Экземпляры, установленные до 2027.2.9, имеют порт в этих именах (fbagent-p3050, hqbirdfbagent-p3050, hqbirdmonitor-p3050).

text
/opt/firebird/                         Firebird 5.0 server: bin/, lib/, plugins/, firebird.conf,
                                       databases.conf, security5.fdb, *.debug files (symbols)
/opt/fb50/                             a Firebird 5.0 next to another line (/opt/fb40, /opt/fb30)
/opt/hqbird/                           root of the HQbird agents
  conf/access.properties               HQ Monitor sign-in, shared by all instances of the host (0600)
  fbagent-fb50/                        HQbird agent of this Firebird
    fbagent                            the agent (unit hqbirdfbagent-fb50)
    hqmonitor                          HQ Monitor (unit hqbirdmonitor-fb50)
    agent_config.json                  agent configuration (encrypted secrets: config_secret.key)
    config.properties                  HQ Monitor configuration
    hqbird2027-firebird.json           the Firebird this installer installed
    hqbird2027-hqmonitor-firewall.json the HQ Monitor port this installer opened in firewalld or ufw
    conf/                              trace and job settings
    logs/                              agent log (firebird-agent_<date>.jsonl), license_state.json;
                                       journal.log and server_status.json after the first checks
    bak/                               backups of the configuration
    outcoming/                         status reports for HQCenter
    update/                            update cache: hqmonitor/, hqclusternode/, hqbirdrcm/
    certs/                             certificates after the attach to HQCenter
  fbagent-hqbird-takeover.json         state of the older HQbird units before the takeover (section 5)
/opt/hqbirdrcm/                        the cluster console RCM (unit hqbirdrcm, owner firebird):
                                       with agent 3.1.0 only after --rcm on (or HQ Monitor);
                                       kits 2027.2.19+ with an older agent: unless --rcm off
/opt/hqclusternode/                    the cluster node (owner firebird), empty until the host is
                                       linked in RCM or HQCenter adds it to a cluster
/var/lib/hqmonitor/<server id>/        HQ Monitor data
/var/log/fbagent/install.log           log of the installer's steps (passwords are hidden)
/root/fbagent-install-sysdba.txt       SYSDBA password of a new Firebird (root only, 0600)
/etc/sysctl.d/90-hqbird-firebird.conf  kernel settings for Firebird (vm.max_map_count), only when
                                       the system value is lower (Ubuntu 24.04 needs none)
/etc/sudoers.d/                        the agent's sudoers rules for its root helpers (updates, HQ Monitor)

Установщик ничего не оставляет в /var/tmp: его рабочая папка /var/tmp/hqbird2027.XXXXXX удаляется в конце, в том числе после ошибки.

Журналы

Журнал Где
Установщик терминал; /var/log/fbagent/install.log
Агент /opt/hqbird/fbagent-fb50/logs/firebird-agent_<date>.jsonl, journal.log; journalctl -u hqbirdfbagent-fb50
HQ Monitor journalctl -u hqbirdmonitor-fb50; журнал аудита /opt/hqbird/fbagent-fb50/hqmonitor_audit.log
Firebird /opt/firebird/firebird.log

Обновления без HQCenter

Начиная с комплекта 2027.2.31 (агент 3.3.0) агент, не подключённый ни к одному HQCenter, берёт новые версии с сервера обновлений производителя. Режим обновления — ключ update.mode в agent_config.json:

Режим Что обновляется само
agent (по умолчанию) Агент, HQ Monitor и fbmcp. Новый пакет Firebird скачивается и ждёт администратора
all То же, и Firebird тоже, в его окне применения (ночью с 03:30 до 04:00; обновление перезапускает Firebird)
off Ничего: агент не проверяет обновления. Для обновления запустите установщик новой версии (раздел 6)
  • При установке: строка Updates текстового интерфейса, или --auto-update all|agent|off. Без них установщик не меняет режим.
  • Позже: страница Updates в HQ Monitor, или снова установщик с --auto-update <mode>.
  • Состояние: sudo /opt/hqbird/fbagent-fb50/fbagent --update-status (добавьте --json для скрипта). Он печатает источник релиза, зону и последний ответ сервера обновлений.

Агент открывает исходящие HTTPS-соединения только к этим адресам. Входящий порт не нужен.

Назначение Адрес
Обновления, зона EU liceu.ibsurgeon.com:9443
Обновления, зона BR licbr.ibsurgeon.com:9443
Обновления, зона RU licru.ibsurgeon.com:20943
Пробная лицензия trialeu.ibsurgeon.com:9443, trialbr.ibsurgeon.com:19443, trialru.ibsurgeon.com:23943

Сервер, подключённый к HQCenter, не использует адреса обновлений: он берёт обновления из этого HQCenter (раздел 8).

Уведомления

Начиная с комплекта 2027.2.33 (агент 3.4.0) агент отправляет сообщения о проблемах сервера в ваш собственный бот Telegram, webhook или по e-mail (SMTP). Установщик не задаёт канал, и ничего не отправляется, пока вы не добавите его: HQ Monitor → Servers → Notifications. Чтобы проверить канал из командной строки: sudo -u firebird /opt/hqbird/fbagent-fb50/fbagent --notify-test <channel>; --notify-history печатает последние доставки.

5. Обновление более старого HQbird (2024 и ранее)

Установщик находит установленный HQbird (FBDataGuard) в /opt/hqbird и его юниты, а также серверы Firebird, которыми он управляет. Затем он следует тем же правилам, что и скрипты установки HQbird:

Diagram

Что вы видите в терминале:

text
[install]   found Firebird 5.0.5.1878: /opt/firebird, port 3050, unit firebird, no agent
[install] plan M4: Firebird update /opt/firebird (unit firebird, port 3050)
[install]              agent new in /opt/hqbird/fbagent-fb50 (unit hqbirdfbagent-fb50), HQ Monitor hqbirdmonitor-fb50
[install]              HQbird services to turn off: hqbird
[install] Firebird 5.0.5.1878: unit firebird, port 3050, 0 TCP connections
[install] Confirm to stop running Firebird 5.0.5.1878? Yes/No y
  • План называет обновляемый Firebird; --fb-root и --port не могут его переместить (его юнит занят).
  • Вопрос Подтвердить остановку работающего Firebird? задаётся, когда движок нужно остановить; строка перед ним показывает открытые соединения. Another version задаётся, когда старый HQbird управляет Firebird другой версии (обновить его или создать новый рядом с ним). --yes отвечает на все вопросы «Да»; без терминала и без --yes установщик останавливается с кодом выхода 4 и ничего не меняет.
  • --disable-hqbird в любом случае отключает юниты старого HQbird; --no-hqbird оставляет старый HQbird нетронутым (он продолжает работать рядом с HQbird 2027).
  • Пароль SYSDBA не запрашивается: агент берёт его из старого HQbird.
  • HQ Monitor использует учётные данные старого HQbird: его файл /opt/hqbird/conf/access.properties сохраняется, поэтому входите с логином и паролем, которые вы использовали раньше. Установщик передаёт файл пользователю firebird с режимом 0600 (старый HQbird оставлял его читаемым для всех пользователей). Гостевой вход старого HQbird (access.guest-login) не используется HQ Monitor.

Что сохраняется: firebird.conf, databases.conf / aliases.conf, база данных безопасности, пароль SYSDBA, базы данных, резервные копии и файлы старого HQbird. Обновление заменяет программные файлы Firebird на месте; заменённые файлы сохраняются в /opt/fbagent-update-backup/<folder name>-<id>/<time>_<old version>_to_<new version>/ (два последних обновления остаются). Задания HQbird (резервные копии, sweep, мониторинг) импортируются в новый агент. Лицензия старого HQbird не переносится: новый агент работает в пробном режиме, пока не установлена лицензия или сервер не подключён к вашему HQCenter.

Начиная с комплекта 2027.2.33 (агент 3.4.0) импорт конфигурации старого HQbird делает ещё две вещи:

  • Он регистрирует базы данных старого HQbird в файле псевдонимов Firebird (databases.conf или aliases.conf для 2.5) в виде строк name = path. Сначала старый файл копируется. База данных пропускается, если её путь уже есть в файле или если её файл не существует. Файл с директивой include не изменяется.
  • Он удаляет старые журналы мониторинга старого HQbird: содержимое папок mon/outcoming и mon/outtrace его выходной папки (папки остаются). Ничего не удаляется, пока работает какая-либо служба старого HQbird. Удаление нельзя отменить: если вам нужны эти журналы, скопируйте их перед установкой.

Обе функции включены по умолчанию. Ключи hqbird_import.register_databases и hqbird_import.clean_mon_logs в agent_config.json (оба есть в редакторе конфигурации HQ Monitor) отключают их для последующего импорта; у установщика нет опции для них.

Состояние юнитов старого HQbird перед перехватом сохраняется в /opt/hqbird/fbagent-hqbird-takeover.json. --uninstall не включает их обратно.

Неинтерактивная форма:

Command
sudo sh hqbird2027-fb50-linux-2027.2.9.run --yes --disable-hqbird

6. Обновление HQbird 2027 до новой версии

Более новый установщик той же линейки, запущенный на хосте с HQbird 2027, обновляет установленный экземпляр на месте: Firebird, отладочные файлы, агент и HQ Monitor. Конфигурация, базы данных, состояние пробного периода или лицензии, порт HQ Monitor и учётные данные сохраняются.

Command
sudo sh hqbird2027-fb50-linux-2027.2.9.run

В текстовом интерфейсе первая страница показывает Plan M10: Update of an installed HQbird 2027, агент с его id (kept) и без строки Agent id; Install запускает обновление. Обычный установщик выводит:

text
[install] HQbird 2027 setup 2027.2.9, Firebird 5.0 (5.0.5.1916)
[install]   found Firebird 5.0.5.1880: /opt/firebird, port 3050, unit firebird, agent hqbirdfbagent-p3050
[install] plan M10: Firebird update /opt/firebird (unit firebird, port 3050)
[install]              agent in_place in /opt/hqbird/fbagent-p3050 (unit hqbirdfbagent-p3050), HQ Monitor hqbirdmonitor-p3050
[install] Firebird 5.0.5.1880: unit firebird, port 3050, 2 TCP connections
[install] Confirm to stop running Firebird 5.0.5.1880? Yes/No y
...
Firebird updated: 5.0.5.1880 -> 5.0.5.1916
HQ Monitor updated 1.31.0 -> 1.33.0 (...)
Done: agent hqbirdfbagent-p3050 in /opt/hqbird/fbagent-p3050, Firebird 5.0.5.1916 in /opt/firebird (port 3050).

Обновление не меняет имена папки агента и юнитов: экземпляр в этом примере был установлен до 2027.2.9 и сохраняет fbagent-p3050.

Когда сборка Firebird в установщике — та же, что уже установлена (например, Firebird 2.5.9.27194 в каждом HQbird 2027 для 2.5), обновляются только агент и HQ Monitor: Firebird не останавливается и вопрос Confirm to stop не задаётся.

Сохранённый databases.conf экземпляра, установленного более старым HQbird 2027, может не иметь псевдонима employee; подключайтесь к демонстрационной базе по её полному пути (раздел 3, шаг 4). На Firebird 3.0 обновление с 2027.2.0 оставляет /opt/firebird/examples/empbuild/employee.fdb с режимом 0444, и Firebird не может его открыть (no permission for read-write access); если вам нужна демонстрационная база: sudo chmod 660 /opt/firebird/examples/empbuild/employee.fdb. Ваши собственные базы данных не затрагиваются.

  • При наличии нескольких экземпляров линейки укажите тот, который нужно обновить: --fb-root /opt/fb50-2 --port 3056.
  • Повторный запуск того же установщика поверх установленной версии — это repair: программные файлы и юниты записываются заново, данные сохраняются.
  • После подключения к HQCenter (раздел 8) агент, HQ Monitor, Firebird и компоненты кластера обновляются из каталога HQCenter; новый установщик тогда не нужен.
  • Сервер, не подключённый ни к какому HQCenter, с агентом 3.3.0 или новее (комплекты с 2027.2.31) обновляет агент, HQ Monitor и fbmcp самостоятельно, если режим обновления не off («Updates without HQCenter» в разделе 4). Установка, сделанная до 2027.2.31, получает это после одного обновления более новым установщиком. Обновление установщиком сохраняет режим обновления; --auto-update <mode> изменяет его.

7. Команды обслуживания

Каждое действие обслуживания — это запуск установщика с опциями или команда агента в папке агента. В терминале запуск без --yes открывает текстовый интерфейс с уже заданными этими опциями (комплекты после 2027.2.30): проверьте план на первой странице, затем выберите Install.

Действие Команда
Другой экземпляр этой линейки sudo sh hqbird2027-fb50-linux-<ver>.run --fb-root /opt/fb50-2 --port 3056
Repair / обновление sudo sh hqbird2027-fb50-linux-<ver>.run (при нескольких экземплярах: --fb-root <folder> --port <port>)
Подключить к HQCenter sudo sh hqbird2027-fb50-linux-<ver>.run --attach attach.json во время установки или позже cd /opt/hqbird/fbagent-fb50 && sudo ./fbagent --attach --file /path/attach.json
Отправить письмо для пробного периода cd /opt/hqbird/fbagent-fb50 && sudo -u firebird ./fbagent --trial-email [email protected] --accept-privacy
Подтвердить код пробного периода из письма cd /opt/hqbird/fbagent-fb50 && sudo -u firebird ./fbagent --trial-confirm <code> (или в HQ Monitor)
Установить файл лицензии --license <file> во время установки или cd /opt/hqbird/fbagent-fb50 && sudo -u firebird ./fbagent --license-install /path/license.json
Состояние установки sudo /opt/hqbird/fbagent-fb50/fbagent --install-state --json
Состояние обновлений (без HQCenter) sudo /opt/hqbird/fbagent-fb50/fbagent --update-status
Изменить режим обновления (без HQCenter) HQ Monitor, страница Updates; или sudo sh hqbird2027-fb50-linux-<ver>.run --auto-update all|agent|off
Удалить sudo sh hqbird2027-fb50-linux-<ver>.run --uninstall [--remove-data] [--force] [--agent-dir /opt/hqbird/fbagent-fb50]

Ещё один экземпляр

Command
sudo sh hqbird2027-fb50-linux-2027.2.9.run --fb-root /opt/fb50-2 --port 3056

Новый Firebird устанавливается в /opt/fb50-2 (новая или пустая папка), юнит firebird.opt_fb50-2, со своим агентом (/opt/hqbird/fbagent-fb50-2, юнит hqbirdfbagent-fb50-2) и своим HQ Monitor (http://localhost:23056/, юнит hqbirdmonitor-fb50-2). Агент получает наименьший свободный номер линейки: fb50-2 для второго экземпляра, в том числе рядом с агентом, установленным до 2027.2.9 (fbagent-p3050). Файл учётных данных HQ Monitor /opt/hqbird/conf/access.properties является общим для экземпляров хоста: новый экземпляр без --hqmonitor-login сохраняет существующие учётные данные, а --hqmonitor-login/--hqmonitor-password-file на любом экземпляре меняют учётные данные всех экземпляров (старый файл сохраняется как access.properties.bak-<time>). Firebird 2.5 не поддерживает второй экземпляр: установщик останавливается с сообщением refused (M17): Firebird 2.5 works only in /opt/firebird, not in <folder> (код выхода 1, ничего не изменено). Установите Firebird другой линейки рядом с ним, например sudo sh hqbird2027-fb50-linux-<ver>.run --fb-root /opt/fb50 --port 3051.

Удаление

Удаление в Windows и Linux, серверы в кластере и то, что остаётся на диске, подробно описаны в руководстве по удалению. Кратко:

Command
# the agent and HQ Monitor of this instance; Firebird, the databases, configs and logs stay
sudo sh hqbird2027-fb50-linux-2027.2.9.run --uninstall
# the same, and the agent's configuration, logs, license state and HQ Monitor data too
sudo sh hqbird2027-fb50-linux-2027.2.9.run --uninstall --remove-data

Без --agent-dir установщик удаляет единственного агента в /opt/hqbird. Если на хосте несколько агентов, он останавливается (код выхода 1), перечисляет их папки и запрашивает --agent-dir:

Command
sudo sh hqbird2027-fb50-linux-2027.2.9.run --uninstall --agent-dir /opt/hqbird/fbagent-fb50-2

--uninstall останавливает и удаляет юниты агента и его HQ Monitor (hqbirdfbagent-fb50, hqbirdmonitor-fb50), правила sudoers агента и его программ (fbagent, hqmonitor), а также закрывает порт HQ Monitor, который установка открыла в firewalld или ufw. Папка агента остаётся вместе с конфигурацией и логами; --remove-data удаляет папку и данные HQ Monitor в /var/lib/hqmonitor/ тоже. Firebird остаётся установленным (юнит, папка программ, базы данных); более старые юниты HQbird, которые были отключены, остаются отключёнными. Если на хосте несколько агентов, общий файл учётных данных HQ Monitor остаётся до удаления последнего агента.

Если агент запускает RCM хоста и другие агенты используют этот RCM, --uninstall отказывается с кодом выхода 5 и ничего не меняет: this agent runs the RCM of the host, and other agents use it: remove the cluster in the RCM console, or run again with --force. --force удаляет агента в любом случае; кластер при этом теряет свой CA (никаких новых сертификатов, никаких новых участников). Юнит RCM остаётся, пока другие агенты хоста его используют. Чтобы сделать другого агента владельцем нового RCM, когда старый владелец отсутствует: fbagent --cluster-init <id> --rcm-takeover (новый CA: свяжите участников заново).

Подсказка в конце установки (Uninstall: sudo sh ... --uninstall) не содержит --agent-dir: при наличии нескольких экземпляров добавьте его, как показано выше.

Чтобы удалить также Firebird экземпляра (установщик этого не делает; сначала сделайте резервные копии его баз данных с помощью gbak), например Firebird в /opt/fb50-2:

Command
B=/opt/fb50-2
U=firebird.$(echo ${B#/} | tr / _)          # /opt/fb50-2 -> firebird.opt_fb50-2
systemctl list-unit-files "$U*"             # the units that will be removed
sudo systemctl disable --now $(systemctl list-unit-files "$U*" --no-legend | awk '$1 !~ /@/ {print $1}')
sudo rm -f /usr/lib/systemd/system/$U* /etc/systemd/system/$U*
sudo systemctl daemon-reload
sudo rm -rf $B

8. Подключение к вашему HQCenter

HQCenter — это центральный сервер вашей компании, который управляет агентами HQbird: лицензиями, конфигурацией, обновлениями, обзором резервных копий. Без HQCenter агент работает самостоятельно с версиями установщика и пробной или лицензионной файлом.

Diagram
  1. В панели администратора HQCenter откройте Tokens (https://<hqcenter>:8443/admin/tokens). В форме Install script выберите лицензию (или ни одной), режим, количество серверов и срок действия (от 1 до 365 дней); поля платформы и Firebird не используются. Нажмите Download connection file и сохраните attach.json. Файл содержит секретный токен: храните его в безопасности (chmod 600), удалите его после использования и отзовите токен в списке на той же странице. Форма отображается только когда задан admin_panel.install_script_url.
  2. Скопируйте attach.json на сервер.
  3. Подключитесь одним из двух способов:
Command
# during the installation
sudo sh hqbird2027-fb50-linux-2027.2.9.run --yes --attach /root/attach.json
# later, for an installed agent
cd /opt/hqbird/fbagent-fb50 && sudo ./fbagent --attach --file /root/attach.json

С обычным токеном команда ждёт, пока администратор HQCenter одобрит запрос (до 30 минут). С лицензионным токеном агент подключается сразу и получает лицензию. После подключения пробный период заканчивается, когда HQCenter выдаёт агенту лицензию; агент, HQ Monitor, Firebird и компоненты кластера затем обновляются из каталога HQCenter. Неудачное подключение во время установки не отменяет установку: в сводке об этом сказано, и команда выше повторяет его.

Требования: HQCenter (goafts) 1.15.0 или новее (в более старых версиях нет кнопки файла подключения); сервер один раз достигает bootstrap-порта HQCenter для подключения, а затем порта агентов (443 по умолчанию). HQCenter может работать без Интернета. Повторное подключение того же сервера к тому же HQCenter требует одобрения администратора даже с лицензионным токеном.

9. Автоматическая установка и скрипты

Каждая опция работает и в терминале. Для автоматического запуска нужен --yes (отвечает на вопросы плана; без терминала и без --yes установщик останавливается с кодом выхода 4). --yes никогда не открывает текстовый интерфейс. Скрипт, который запускает установщик в терминале и сам отвечает на его вопросы (например, с помощью expect), должен добавить --no-tui или установить HQBIRD_NO_TUI=1: комплекты после 2027.2.30 открывают там страницы. Код выхода сообщает результат; подробности — в терминале и в /var/log/fbagent/install.log.

Опции

Опция Значение По умолчанию
--fb-root DIR Папка нового Firebird (новая или пустая); или папка Firebird для обновления /opt/firebird, затем /opt/fb<NN>
--port N Порт Firebird 3050 для первого Firebird; для другой линейки — порт линейки (3053 для 3.0, 3054 для 4.0, 3055 для 5.0)
--sysdba-pass-file F, --sysdba-pass P Пароль SYSDBA нового Firebird (первая строка F; P записывается в файл с правами 0600) генерируется, сохраняется в /root/fbagent-install-sysdba.txt; ещё один Firebird на хосте берёт пароль из этого файла
--agent-id ID agent.id нового агента; только при первой установке, установленный агент сохраняет свой id («The agent id» в разделе 3) имя хоста + дата + экземпляр
--hqmonitor-port N Порт HQ Monitor 20000 + порт Firebird
--hqmonitor-login L --hqmonitor-password-file F Учётные данные HQ Monitor, общие для всех экземпляров хоста: заданные на одном экземпляре, они меняют учётные данные всех admin + сгенерированный пароль; обновление или ещё один экземпляр сохраняет существующие учётные данные
--email ADDR --accept-privacy [--trial-zone RU|EU|BR] Email для пробного периода (30 дней); адрес отправляется на пробный сервер поставщика нет
--auto-update all|agent|off Обновления сервера, не подключённого ни к какому HQCenter (комплекты с 2027.2.31): agent = агент, HQ Monitor и fbmcp обновляются сами, пакет Firebird ждёт вас; all = Firebird тоже, в своём окне; off = проверки обновлений нет («Updates without HQCenter» в разделе 4) режим не меняется; у нового агента — agent

| --license F | Файл лицензии для установки | нет | | --attach F | Присоединить к вашему HQCenter (attach.json) | нет | | --no-hqbird, --disable-hqbird | Оставить старый HQbird без изменений / отключить все его юниты | автоматически | | --no-debug | Не устанавливать отладочные файлы Firebird | устанавливаются | | --no-fbmcp | Не устанавливать fbmcp (MCP-сервер для AI-клиентов) и не изменять fbmcp этого хоста | устанавливается | | --fbmcp-allow-from A,B | Включить удалённый режим fbmcp для этих административных адресов (IP или CIDR) | только локально | | --fbmcp-port N, --fbmcp-dns NAME,..., --fbmcp-ip ADDR | Удалённый порт fbmcp; дополнительные имена для его сертификата; адрес для сертификата и слушателя | порт 8650 | | --rcm on\|off | Установить консоль кластера RCM на этом хосте и создать новый кластер (агент 3.1.0 и новее) | спрашивается; Нет | | --rcm-password-file F | Пароль администратора RCM при --rcm on (первая строка F) | генерируется, показывается в конце | | --cluster-id ID | Идентификатор кластера при --rcm on | имя хоста | | --cluster-pairing on\|off | Режим обнаружения: окно сопряжения на 24 часа, RCM может пригласить этого агента | спрашивается; Нет | | --rcm-allow A,B,... | Только эти RCM могут пригласить этот хост в режиме обнаружения (IP, CIDR или имя хоста) | любой RCM | | --pairing-port N | Порт сопряжения 7450–7459 нового агента; он выбирает слот (порты узла 7051+k, 7061+k). Последующая установка сохраняет слот | первый свободный слот | | --cluster-node on\|off | Поместить службу узла кластера в кэш агента | вкл | | --yes | Отвечать «Да» на вопросы плана («Нет» на вопросы кластера) | спрашивать | | --check | Только проверки, библиотеки и план; ничего не изменяется | — | | --plan-help | Вывести значения кодов плана (M1, M2, …) и выйти | — | | --no-tui | Простой установщик, без текстового интерфейса; также переменная HQBIRD_NO_TUI=1 («The plain installer» в разделе 3) | текстовый интерфейс в терминале | | --lang en\|ru\|pt-BR\|de | Язык установщика; также переменная HQBIRD_LANG («Language of the installer» в разделе 3) | UTF-8 локаль консоли, иначе английский | | --tmpdir DIR | Распаковать сюда (папка, где могут выполняться программы) | /var/tmp | | --extract DIR | Только распаковать полезную нагрузку в DIR/payload и выйти | — | | --uninstall [--remove-data] [--force] [--agent-dir DIR] | Удалить агент и HQ Monitor (Firebird остаётся); --force также удаляет агент, который запускает RCM хоста, пока другие агенты его используют | — |

Опции можно записывать как --port 3055 или --port=3055. Относительные пути отсчитываются от текущей папки.

Примеры

Новая установка со значениями по умолчанию:

Command
sudo sh hqbird2027-fb50-linux-2027.2.9.run --yes
echo "exit code $?"

Новая установка в выбранную папку и на выбранный порт, с паролем SYSDBA из файла и входом в HQ Monitor:

Command
umask 077
printf '%s\n' 'S3cret-Sysdba' > /root/sysdba.txt
printf '%s\n' 'S3cret-Monitor' > /root/hqm.txt
sudo sh hqbird2027-fb50-linux-2027.2.9.run --yes \
  --fb-root /opt/firebird --port 3050 \
  --sysdba-pass-file /root/sysdba.txt \
  --hqmonitor-port 24000 --hqmonitor-login ops --hqmonitor-password-file /root/hqm.txt
rm -f /root/sysdba.txt /root/hqm.txt

Новая установка с trial-email, файлом лицензии и файлом attach:

Command
sudo sh hqbird2027-fb50-linux-2027.2.9.run --yes \
  --email [email protected] --accept-privacy --trial-zone EU \
  --license /root/hqbird-license.json \
  --attach /root/attach.json

Обновление старого HQbird, все юниты старого HQbird отключены:

Command
sudo sh hqbird2027-fb50-linux-2027.2.9.run --yes --disable-hqbird

Обновление HQbird 2027 до новой версии (один экземпляр; при нескольких добавьте --fb-root и --port):

Command
sudo sh hqbird2027-fb50-linux-2027.2.9.run --yes

Второй экземпляр Firebird 5.0 на порту 3056:

Command
sudo sh hqbird2027-fb50-linux-2027.2.9.run --yes --fb-root /opt/fb50-2 --port 3056

Удаление:

Command
sudo sh hqbird2027-fb50-linux-2027.2.9.run --uninstall
sudo sh hqbird2027-fb50-linux-2027.2.9.run --uninstall --remove-data

Скрипт, который останавливается при неудачной установке:

Command
#!/bin/sh
set -e
sh hqbird2027-fb50-linux-2027.2.9.run --yes || {
  rc=$?
  echo "HQbird setup failed with code $rc, see /var/log/fbagent/install.log" >&2
  exit $rc
}
echo "HQbird 2027 installed"

Сервер без интернета: библиотеки ОС

Firebird линейки нуждается в этих библиотеках ОС (помимо glibc):

Линейка Пакеты (Debian/Ubuntu) Пакеты (семейство RHEL)
5.0 libtommath1, libicu<NN>, libgssapi-krb5-2 libtommath (EPEL), libicu, krb5-libs
4.0 libtommath1, libicu<NN> libtommath (EPEL), libicu
3.0 libtommath1, libicu<NN> libtommath (EPEL), libicu
2.5 обычно ничего (libstdc++6 есть в базовой системе) обычно ничего

Комплекты после 2027.2.30 линеек 3.0, 4.0 и 5.0 также нуждаются в программе colrm, которую использует установочный скрипт Firebird: пакет bsdextrautils (bsdmainutils на старых Debian и Ubuntu). В минимальном Debian его нет; в семействе RHEL он входит в util-linux, который есть всегда.

Когда пакет отсутствует и репозиторий недоступен, установщик останавливается с кодом выхода 6, и ничего не изменяется:

text
[install] ERROR: no access to the package repository, or a package is not there; nothing was changed.
[install] Missing: libtommath1
[install] Install them, then run this file again:
[install]   apt-get install -y libtommath1
[install] On a server without internet: on a PC with the same Ubuntu 24.04.5 LTS
[install]   apt-get download libtommath1
[install] copy the .deb files here and run:  apt-get install -y ./*.deb

В семействе RHEL libtommath находится в EPEL: при доступном репозитории установщик сам добавляет epel-release. Без него команды: dnf install -y epel-release, dnf download --resolve <packages> и dnf install -y ./*.rpm. --check заранее выводит тот же список, чтобы пакеты можно было подготовить до окна установки.

Коды выхода

Код Значение Изменения на хосте
0 Готово (предупреждения о trial-email, attach или лицензии — в сводке) да
1 Отказано: хост, опция, файл или план (причина выводится). Также: Выход в текстовом интерфейсе нет
2 Установка не удалась и была откачена. Также: установщик остановлен сигналом (Ctrl+C) откачено; нет, если остановлен до установки
3 Установка не удалась, и откат был неполным (в сводке сказано, что проверить) частично
4 Вопрос плана не был подтверждён (нет терминала, нет --yes). нет
5 Полезная нагрузка не прошла проверку (sha256, подписи): скачайте файл заново. С --uninstall: отказано, агент запускает RCM хоста, и другие агенты его используют (раздел 7) нет
6 Отсутствуют библиотеки ОС, и репозиторий пакетов недоступен нет
7 Установлен Firebird из пакетов дистрибутива нет

10. Устранение неполадок

Проблема Что делать
run as root (sudo sh ...) Запустите установщик с sudo или от имени root
Страницы текстового интерфейса не открываются Первая строка говорит почему: needs a window of 80x24 or larger (сделайте окно больше; tmux со строкой статуса занимает одну строку) или needs bash 4.4 or newer. Простой установщик, который запускается затем, выполняет ту же установку
Неправильные символы или сломанные строки на страницах Настройте терминал на UTF-8 или запустите с --lang en; --no-tui запускает простой установщик
/var/tmp is mounted noexec Запустите снова с --tmpdir /root (любая папка, где могут выполняться программы)
is damaged or cut (код выхода 5) Скопируйте файл .run заново и сравните его sha256sum с опубликованным значением
Код выхода 6, отсутствуют библиотеки Подготовьте пакеты, как показано (раздел 9), затем запустите установщик снова
Код выхода 7, Firebird из пакетов дистрибутива Удалите пакеты (apt-get remove firebird3.0-server, сохранив резервную копию gbak) или используйте онлайн-установщик с --import-firebird

| refused (M17): Firebird 2.5 works only in /opt/firebird | Второй Firebird 2.5 невозможен; установите другую линейку рядом с ним (раздел 7) | | --uninstall отклонён (код выхода 1) при нескольких агентах | Добавьте --agent-dir с папкой из списка, например --agent-dir /opt/hqbird/fbagent-fb50-2 | | --uninstall отклонён (код выхода 5): this agent runs the RCM of the host | Сначала удалите кластер в консоли RCM или запустите снова с --force (раздел 7) | | no permission for read-write access к employee.fdb после обновления (3.0) | sudo chmod 660 /opt/firebird/examples/empbuild/employee.fdb (раздел 6) | | refused (M14): the folder is not empty | Выберите пустую или новую папку с помощью --fb-root или укажите Firebird для обновления | | Код выхода 2 или 3 | Прочитайте /var/log/fbagent/install.log; юниты возвращены в состояние до запуска (код 2) или требуют проверки (код 3) | | HQ Monitor не открывается | systemctl status hqbirdmonitor-fb50 (hqbirdmonitor-p<port> до 2027.2.9); проверьте, что порт не занят другим процессом; откройте порт в файрволе; --hqmonitor-port для другого порта | | Утерян пароль HQ Monitor | Запустите установщик снова (repair) с --hqmonitor-login admin --hqmonitor-password-file <file>; старый /opt/hqbird/conf/access.properties сохраняется как access.properties.bak-<time>. Новые учётные данные действуют для всех экземпляров на хосте | | Пробное письмо не отправлено (нет сети) | Отправьте позже: cd /opt/hqbird/fbagent-fb50 && sudo -u firebird ./fbagent --trial-email <address> --accept-privacy | | SELinux (AlmaLinux, RHEL) | Поддерживается в режиме enforcing: установщик восстанавливает контексты записываемых им файлов; ничего делать не нужно |