Цю сторінку перекладено машинним перекладом. Читайте англійський оригінал. 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).

Покроковий runbook для двох екземплярів на портах 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-денна пробна версія за електронною поштою (адреса, повідомлення про конфіденційність, зона) або файл ліцензії --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 задає ваш власний ідентифікатор (1-128 літер, цифр, ., _ або -; перший — літера або цифра).
  • Інсталятор відхиляє ідентифікатор, який уже має інший агент хоста.
  • У текстовому інтерфейсі сторінка Agent id пропонує автоматичний ідентифікатор, ім’я хоста, ім’я хоста з екземпляром і ваше власне значення, а також перелічує ідентифікатори, які хост уже має.
  • Встановлений агент зберігає свій ідентифікатор. Повторний запуск показує його в плані (id srv1 (kept)), тоді в текстовому інтерфейсі немає рядка Agent id, а --agent-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 або електронною поштою (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 не можуть його перемістити (його unit уже зайнятий).
  • Питання Підтвердити зупинку запущеного Firebird? ставиться, коли двигун потрібно зупинити; рядок перед ним показує відкриті з’єднання. Another version ставиться, коли старіший HQbird керує Firebird іншої версії (оновіть той, або новий поряд із ним). --yes відповідає Так на всі питання; без термінала і без --yes інсталятор зупиняється з кодом виходу 4 і нічого не змінює.
  • --disable-hqbird вимикає unit’и старішого 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 старішого 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) вимикають їх для наступного імпорту; в інсталятора немає опції для них.

Стан unit’ів старішого 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).

Оновлення не змінює назви папки агента та unit’ів: екземпляр у цьому прикладі було встановлено до 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.
  • Повторний запуск того ж інсталятора поверх встановленої версії — це ремонт: програмні файли та unit’и записуються знову, дані залишаються.
  • Після підключення до 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
Ремонт / оновлення 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
Надіслати пробний email 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] Пробна електронна адреса (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 (“Звичайний інсталятор” у розділі 3) | текстовий інтерфейс у терміналі | | --lang en\|ru\|pt-BR\|de | Мова інсталятора; також змінна HQBIRD_LANG (“Мова інсталятора” у розділі 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

Нове встановлення з пробною електронною поштою, файлом ліцензії та файлом приєднання:

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 Готово (попередження про пробну електронну пошту, приєднання або ліцензію є в підсумку) так
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 | Запустіть інсталятор знову (відновлення) з --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: інсталятор відновлює контексти файлів, які записує; нічого робити не потрібно |