HQbird 2027 для Linux: посібник зі встановлення
Цей посібник призначено для адміністратора, який встановлює 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. Що встановлює інсталятор
- 2. Встановлення стисло
- 3. Нове встановлення
- 4. Після встановлення
- 5. Оновлення старішого HQbird (2024 і раніше)
- 6. Оновлення HQbird 2027 до нової версії
- 7. Команди обслуговування
- 8. Підключення до вашого HQCenter
- 9. Неінтерактивна інсталяція та скрипти
- 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): модуль systemdhqbirdfbagent-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. Встановлення стисло
Перевірку сервера й саме встановлення виконує агент HQbird, який несе інсталятор (fbagent --install-plan, fbagent --setup-install). Нічого не завантажується, крім відсутніх системних пакетів. Нічого не змінюється, доки план не підтверджено: системні пакети встановлюються після підтвердження. У терміналі комплекти після 2027.2.30 відкривають текстовий інтерфейс (крок 3 розділу 3); --no-tui запускає звичайний інсталятор, який ставить свої запитання рядками тексту. Без термінала й без --yes інсталятор зупиняється на підтвердженні з кодом виходу 4. Якщо встановлення не вдається до запуску модуля агента, агент повертає модулі до стану, який вони мали раніше (код виходу 2; код 3, коли відкат був неповним, підсумок вказує, що перевірити).
3. Нове встановлення
Крок 1: Завантажте інсталятор і перевірте його
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: Перевірте хост, не змінюючи його (необов’язково)
sudo sh hqbird2027-fb50-linux-2027.2.9.run --check--check запускає перевірку хоста, повідомляє про відсутні бібліотеки ОС (і
команди, щоб отримати їх на сервері без Інтернету), показує, що знайшов агент
і що він зробив би, та завершується. Нічого не встановлюється.
Крок 3: Запустіть інсталятор
sudo sh hqbird2027-fb50-linux-2027.2.9.runКомплекти після 2027.2.30 відкривають текстовий інтерфейс, коли ви запускаєте їх у терміналі: повноекранні сторінки з планом і налаштуваннями. Комплекти до 2027.2.30, а також випадки в розділі “Звичайний інсталятор” нижче, ставлять свої запитання як рядки тексту. Обидва виконують те саме встановлення з тими самими параметрами.
Текстовий інтерфейс
Інсталятор перевіряє хост, розпаковує себе, читає план і показує першу сторінку. Ніщо на хості не змінюється, доки ви не почнете встановлення на сторінці Install.
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:
[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 і пізнішим та без вибраного кластера вони такі:
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). Інсталятор вибирає
мову в такому порядку:
- опція
--lang en|ru|pt-BR|de; - змінна
HQBIRD_LANG; - локаль консолі (
LC_ALL, потімLC_MESSAGES, потімLANG), коли це локаль UTF-8; - англійська.
Другий рядок виводу повідомляє, яка це мова і як її змінити. Цей рядок завжди англійською:
[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, … Він називає випадок, який інсталятор знайшов
на хості. Інсталятор виводить, що означає код:
[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: Перевірте результат
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).
/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:
Що ви бачите на терміналі:
[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 не вмикає
їх назад.
Форма без нагляду:
sudo sh hqbird2027-fb50-linux-2027.2.9.run --yes --disable-hqbird6. Оновлення HQbird 2027 до нової версії
Новіший інсталятор тієї ж лінійки, запущений на хості з HQbird 2027, оновлює встановлений екземпляр на місці: Firebird, файли налагодження, агент і HQ Monitor. Конфігурація, бази даних, стан пробного режиму чи ліцензії, порт і вхід HQ Monitor зберігаються.
sudo sh hqbird2027-fb50-linux-2027.2.9.runУ текстовому інтерфейсі перша сторінка показує Plan M10: Update of an installed HQbird 2027, агент з його id (kept), і без рядка Agent id; Install
запускає оновлення. Звичайний інсталятор виводить:
[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] |
Інший екземпляр
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, сервери в кластері та те, що залишається на диску, повністю описано в посібнику з видалення. Коротко:
# 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:
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:
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 $B8. Підключення до вашого HQCenter
HQCenter — це центральний сервер вашої компанії, який керує агентами HQbird: ліцензіями, конфігурацією, оновленнями, оглядом резервних копій. Без HQCenter агент працює самостійно з версіями інсталятора та пробним або ліцензійним файлом.
- У панелі адміністратора HQCenter відкрийте Tokens
(
https://<hqcenter>:8443/admin/tokens). У формі Install script виберіть ліцензію (або жодної), режим, кількість серверів і термін дії (від 1 до 365 днів); поля платформи та Firebird не використовуються. Натисніть Download connection file і збережітьattach.json. Файл містить секретний токен: зберігайте його безпечно (chmod 600), видаліть його після використання та відкличте токен у списку на тій самій сторінці. Форма показується лише коли встановленоadmin_panel.install_script_url. - Скопіюйте
attach.jsonна сервер. - Підключіться одним із двох способів:
# 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. Відносні шляхи
відраховуються від поточної папки.
Приклади
Нове встановлення з типовими налаштуваннями:
sudo sh hqbird2027-fb50-linux-2027.2.9.run --yes
echo "exit code $?"Нове встановлення в обрану папку та порт, із паролем SYSDBA з файлу та входом до HQ Monitor:
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Нове встановлення з пробною електронною поштою, файлом ліцензії та файлом приєднання:
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 вимкнено:
sudo sh hqbird2027-fb50-linux-2027.2.9.run --yes --disable-hqbirdОновлення HQbird 2027 до нової версії (один екземпляр; якщо їх кілька, додайте
--fb-root і --port):
sudo sh hqbird2027-fb50-linux-2027.2.9.run --yesДругий екземпляр Firebird 5.0 на порту 3056:
sudo sh hqbird2027-fb50-linux-2027.2.9.run --yes --fb-root /opt/fb50-2 --port 3056Видалення:
sudo sh hqbird2027-fb50-linux-2027.2.9.run --uninstall
sudo sh hqbird2027-fb50-linux-2027.2.9.run --uninstall --remove-dataСкрипт, який зупиняється на невдалому встановленні:
#!/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, і нічого не змінюється:
[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: інсталятор відновлює контексти файлів, які записує; нічого робити не потрібно |