Встановлення та оновлення
Встановлення без сюрпризів
Один інсталятор на кожну лінійку Firebird. Він знаходить Firebird, старий HQbird і агентів на сервері, показує план і нічого не змінює, доки ви не скажете «Так». Після цього агент оновлює себе, консоль і Firebird самостійно, з перевірками та відкатом.
- 4 інсталятори: Firebird 2.5 · 3.0 · 4.0 · 5.0
- 0 змін до підтвердження плану
- інтернет не потрібен усе в одному файлі
- Windows і Linux майстер, тихий режим, .run
- відкат якщо встановлення чи оновлення не вдалося
setup.exe · .run
Що входить до комплекту
Інсталятор — це один файл: hqbird2027-fb50-setup-<version>.exe для Windows або hqbird2027-fb50-linux-<version>.run для Linux. Він містить усе, що потрібно серверу. Нічого не завантажується.
Кожен інсталятор встановлює одну лінійку Firebird. Виберіть лінійку, на якій працюють ваші бази даних. Встановлення виконує агент із комплекту: він перевіряє сервер, будує план і виконує його.
| Компонент | Що робить | Windows | Linux |
|---|---|---|---|
| Firebird, збірка HQbird | Новий сервер або оновлення на місці. Для вже встановленого сервера до firebird.conf додається один рядок: MonitoringPlugin = fblwmon. Для нового сервера інсталятор також задає порт. databases.conf, база безпеки та пароль SYSDBA не змінюються. | служба FirebirdServer… | /opt/firebird |
| агент fbagent | Резервні копії, моніторинг, обслуговування, оновлення. | HQbirdFBAgent-fb50 | hqbirdfbagent-fb50, користувач firebird |
| HQbird Monitor | Вебконсоль для цього сервера. Порт = 20000 + порт Firebird: для 3050 це 23050. Порт вибирається під час встановлення і не змінюється згодом, навіть якщо ви зміните порт Firebird. | HQbirdMonitor-fb50 | hqbirdmonitor-fb50 |
| Компоненти кластера | Програми кластера розміщуються на сервері, але не вмикаються: RCM і вікно сполучення вимкнені за замовчуванням. RCM робить сервер центром нового кластера і відкриває порти 7443 і 7444. Вікно сполучення відкриває порти 7450–7459 на 24 години: через нього RCM іншого сервера може запросити цей сервер. Обидва можна ввімкнути й після встановлення. | сторінка майстра «Replication and cluster setup»; /RCM, /DISCOVERY | --rcm on, --cluster-pairing on |
| MCP-сервер fbmcp | Доступ для AI-клієнтів до Firebird. За замовчуванням лише з цього сервера. | прапорець у майстрі або /NOFBMCP | --no-fbmcp |
| Файли налагодження Firebird | Символи для аналізу збоїв Firebird. | — | так, --no-debug вимикає |
- WindowsПідтримуються: Windows 10 і 11, Windows Server 2016 і новіші, 64-бітні. Права адміністратора. Інсталятор підписано IBSurgeon Software: Windows показує видавця в запиті прав.
- Майстер або тихий режимКожна сторінка майстра також доступна як перемикач:
/VERYSILENT /YES /LOG=…. Добре для скриптів і для сотні серверів. - Майстер 8 мовамиАнглійська, португальська (Бразилія), німецька, російська, іспанська, польська, турецька, китайська спрощена. За замовчуванням — мова Windows. Перемикач:
/LANG=en|pt_BR|de|ru|es|pl|tr|zh_CN. - Ім'я сервераМайстер запитує ім'я нового агента; HQCenter показує сервер під цим ім'ям. За замовчуванням — ім'я комп'ютера. Тихий режим:
/AGENTID=, на Linux--agent-id. Уже встановлений агент зберігає своє ім'я.
- Linuxx86_64, ядро 3.2 або новіше, systemd, root. Ubuntu, Debian, AlmaLinux, Rocky, RHEL, Oracle Linux, openSUSE, RED OS та інші з apt, dnf, yum або zypper.
- Сервер без інтернетуІнсталятор бере кілька бібліотек ОС (libtommath, ICU) з репозиторію. Якщо репозиторію немає, він друкує точні команди і нічого не змінює.
Комплект перевіряється двічі. Перед розпакуванням: sha256 усього комплекту. Перед встановленням Firebird і агента: підпис кожного файлу. Пошкоджене завантаження зупиняє встановлення до будь-яких змін Firebird, агента чи консолі.
fbagent --install-plan
Спочатку план, зміни потім
Спочатку інсталятор лише читає: служби, реєстр, папки Firebird і HQbird. Потім він показує, що знайшов і що зробить. Зміни починаються після того, як ви скажете «Так».
Виберіть, що є на сервері, і подивіться на план. Тексти скорочені й перекладені; порядок і рішення ті самі, що в інсталяторі Firebird 5.0.
- 1Перевірка сервераправа, розрядність; на Linux також systemd і ядро
- 2Перевірка комплектуsha256 перед розпакуванням; підписи файлів перед встановленням
- 3Планщо знайдено і що буде зроблено
- 4Запитанняім'я сервера для HQCenter; зупинити Firebird? інша версія?
- 5ВстановленняFirebird, агент, консоль, служби
- 6✓ Результатслужби, адреса консолі, вхід
Якщо щось пішло не так
Відмова на етапі планування (порт зайнятий, папка не порожня) нічого не змінює: інсталятор називає причину. У майстрі не можна залишити сторінку, поки значення неправильне.
Збій під час встановлення, до запуску служби агента: служби повертаються до попереднього стану. Старий HQbird, якщо його було зупинено, запускається знову.
| Код | Значення (Linux .run) |
|---|---|
| 0 | Готово |
| 1 | Відмова: сервер, ключ або план. Нічого не змінено |
| 2 | Встановлення не вдалося, зміни відкочено |
| 3 | Відкат неповний: у результаті вказано, що перевірити |
| 4 | Потрібна відповідь: немає термінала й немає --yes |
| 5 | Комплект не пройшов перевірку: завантажте його знову |
| 6 | Немає бібліотек ОС і немає репозиторію |
| 7 | Firebird з пакетів дистрибутива |
| Код | Значення (Windows setup.exe) |
|---|---|
| 0 | Встановлено |
| 1 | Відмова до встановлення: неправильний ключ або файл, встановлено новішу версію, немає прав адміністратора |
| 4 | В інсталятора було питання, але немає ключа /YES |
| 7 | Перевірка сервера або встановлення не вдалися. Причина в журналі та у файлі результату |
| 10 | Встановлено, але з'єднання з HQCenter не вдалося |
-p3050); нові встановлення отримують -fb50.FBDataGuard → fbagent
Перехід з HQbird 2024
Інсталятор знаходить старий HQbird і Firebird, якому він служить. Цей Firebird оновлюється на місці, завдання FBDataGuard переходять до агента, старі служби зупиняються. Бази даних, конфігурації та паролі залишаються.
- Що не змінюється
databases.confабоaliases.conf, база безпеки, пароль SYSDBA, бази даних, резервні копії та файли старого HQbird. Уfirebird.confдодається лише рядокMonitoringPlugin = fblwmon, якщо його немає. - Копія старого FirebirdПапка програми старого Firebird зберігається поруч як
<folder>.old_<time>. - ЗавданняРезервні копії gbak і nbackup, sweep, статистика індексів. Імпорт виконується один раз і проходить перевірку нової конфігурації; стара конфігурація зберігається.
- Старі резервні копіїАгент переносить резервні копії з журналів FBDataGuard у власні записи. Правила зберігання та відновлення бачать їх так само, як нові. Назви рівнів nbackup залишаються тими самими.
- Назви завданьНазва завдання закінчується назвою бази даних з FBDataGuard, наприклад "Verified backup - MANUAL". Групові завдання повторюють дерево вихідних папок.
- Старі служби: три варіантиАвтоматично (рекомендовано): вимкнути їх, коли кожен Firebird, якому служить FBDataGuard, має агента. Вимкнути всі:
/DISABLEHQBIRD. Залишити як є:/NOHQBIRD. - Можна повернутися назадСтан кожної служби до її вимкнення зберігається в
fbagent-hqbird-takeover.json. За допомогою цього файлу старий HQbird можна знову ввімкнути. - ЛіцензіяЛіцензія старого HQbird не переноситься. Пробний період діє, доки ви не отримаєте нову ліцензію або не підключитеся до HQCenter.
- Неясний шляхЯкщо імпорт не може розгорнути підстановку в шляху FBDataGuard, він залишає його як є й залишає завдання вимкненим. Виправте шлях і ввімкніть завдання.
Якщо завдання імпортовано, але старі служби все ще працюють (наприклад, на сервері два сервери Firebird під FBDataGuard), завдання надходять вимкненими. Так одне завдання не виконується двічі.
Порти · папки · служби
Кілька серверів Firebird на одній машині
Один агент на один Firebird. Новий екземпляр встановлюється поруч з іншими, на власному порту, з власним агентом і власною консоллю. Встановлені екземпляри не змінюються.
Додавайте сервери Firebird і дивіться, які назви та порти вибирає інсталятор.
- Порти за лінієюПерший Firebird на сервері отримує 3050. Наступний: 3052 для 2.5, 3053 для 3.0, 3054 для 4.0, 3055 для 5.0. Інсталятор не займає порт, який уже використовується.
- Другий екземпляр тієї самої лініїНомер
-2у назвах папок і служб. У Windows це опція майстра «Встановити інший екземпляр»; порт — перший вільний у діапазоні лінії.
- Оновлення лише в межах лінії5.0.x → 5.0.y. Перехід з 3.0 на 5.0 означає другий екземпляр поряд із першим; бази даних переносять резервним копіюванням і відновленням.
- XNET у WindowsFirebird, що не на порту 3050, отримує власну назву
IpcName = FIREBIRD_<port>. Локальні з'єднання XNET до другого сервера працюють. - Одна консоль на агентаHQbird Monitor на 20000 + порт Firebird: 23050, 23055. Один файл входу для всіх екземплярів на сервері.
- Порти фіксованіПорти консолі та локального API агента записуються під час встановлення. Якщо пізніше змінити порт Firebird, вони залишаться тими самими. Агент не приймає однакові порти.
- Кластер: слот для кожного агентаКожен агент на сервері отримує власний слот від 0 до 9: порт сполучення 7450 + слот, порти вузла 7051 + слот і 7061 + слот. Так два агенти одного сервера можуть приєднатися до кластера. Перемикач
--pairing-portзадає слот явно.
Образи · compose · порти
HQbird у Docker
Для кожної лінії Firebird є готовий образ. Firebird, агент і HQbird Monitor працюють у контейнері. Агент встановлює вузол кластера всередині самого контейнера, коли сервер приєднується до кластера. Він встановлює RCM лише тоді, коли цей сервер призначено як RCM кластера.
| Образ | Firebird | Порт Firebird | HQbird Monitor |
|---|---|---|---|
ghcr.io/ibsurgeon/hqbird2027-fb50 | 5.0 | 3050 | 23050 |
ghcr.io/ibsurgeon/hqbird2027-fb40 | 4.0 | 3050 | 23050 |
ghcr.io/ibsurgeon/hqbird2027-fb30 | 3.0 | 3050 | 23050 |
ghcr.io/ibsurgeon/hqbird2027-fb25 | 2.5 | 3050 | 23050 |
- Перший запускСкопіюйте
compose.yamlз комплекту, помістіть пароль SYSDBA у файл секрету, приберіть#з рядківsecrets:і виконайтеdocker compose up -d. Сервер готовий, колиdocker compose psпоказуєhealthy. - Порт FirebirdЗмінна
HQBIRD_FB_PORT, за замовчуванням 3050. HQbird Monitor слухає на 20000 + цей порт. - Підпис образуОбрази підписані інструментом cosign. Публічний ключ для перевірки ще не опубліковано.
- Кілька екземплярів на одному хостіFirebird на 3050 + N, HQbird Monitor на 20000 + порт Firebird, вузол кластера на 7051 + N. Лише один екземпляр на хості може мати RCM.
- Однаковий номер порту зовні й усерединіПублікуйте
3051:3051, а не3051:3050. Агент і кластер повідомляють порт, який вони бачать усередині контейнера. - КластерАдреса учасника — це адреса хоста Docker. Опублікуйте порт вузла і, для RCM, порти 7443 і 7444.
Docker публікує порти в обхід ufw. Правило ufw «лише порт 22» не закриває порти контейнера. Публікуйте порт на одній адресі хоста або закрийте його зовнішнім фаєрволом.
Хмара та Docker: налаштування, томи, порти, оновленняАгент · консоль · кластер · Firebird
Оновлення після встановлення
Після підключення до HQCenter агент самостійно оновлює себе, HQbird Monitor, компоненти кластера, fbmcp і Firebird. Сервер без HQCenter також оновлюється самостійно: агент бере нові версії з сервера оновлень IBSurgeon.
Агент бачить нову версію себе в HQCenter протягом хвилини. Нові версії HQbird Monitor, fbmcp і Firebird: протягом години. Кожне оновлення відбувається за однією схемою: перевірка, збереження точки відкату, заміна, перевірка працездатності. Якщо не працює — відновлення старої версії.
Оновлення без HQCenter
- Що оновлюється самостійноАгент, HQbird Monitor і сервер MCP. Перевірка виконується раз на 6 годин.
- Firebird чекає командиПакет Firebird завантажується й чекає. Адміністратор застосовує його: кнопкою на сторінці Updates або командою
fbagent --firebird-update --apply. - Ви вибираєте режимПеремикач встановлення
--auto-update all|agent|off, у Windows/AUTOUPDATE=all|agent|off.agent— за замовчуванням.allтакож встановлює Firebird у вікні оновлення.offнічого не перевіряє.
- Сторінка Updates у HQbird MonitorПоказує, звідки агент бере версії, режим і останню відповідь сервера, стан оновлень Firebird, консолі та сервера MCP. Адміністратор змінює режим і застосовує пакет Firebird.
- Перевірка джерелаСервер оновлень перевіряється за закріпленим ключем. Підпис постачальника потрібен завжди.
- Кластер — через центрВузол кластера та RCM не оновлюються в такий спосіб: їх оновлює HQCenter або RCM.
Самооновлення агента
- Лише впередАгент не встановлює версію, старішу за власну, навіть обов’язкову. Перевірка виконується до завантаження першого байта. Таким чином, підроблений сервер не може повернути стару вразливу збірку. Виняток — одна стара версія, дозволена у власному конфігу агента (
allow_downgrade_to). - ПідписРелізи підписані ключем Ed25519; публічний ключ вбудований в агент. Неправильний підпис завжди відхиляється. Режим “лише підписані” вмикається у власному конфігу агента, а не з сервера.
- Ручний відкатПоруч з агентом є скрипт
rollback_to_version_NNN: він відновлює попередній агент і конфіг та блокує невдалу версію. Зберігаються дві останні точки відкату; старіші видаляються автоматично. - Linux: root запускає лише власну копіюАгент працює як
firebird. Заміну виконує перевірена копія в теці, до якої може писати лише root.
Оновлення Firebird
Firebird оновлюється лише в межах своєї лінійки і лише до новішої збірки. Агент може завантажити й підготувати пакет у будь-який час, але зупиняє Firebird лише у вікні оновлення.
- 1Підготовказавантаження, підпис, збірка не старіша за рушій
- 2Вікнощоденне вікно; обов’язковий реліз також чекає на вікно
- 3Завданнявиконується gbak, nbackup або SQL-скрипт: спробу відкладено
- 4Замінастарі файли рушія відкладаються, конфіги залишаються
- 5ПеревіркаFirebird запускається і відповідає на своєму порту
- 6✓ або відкатстарі файли повертаються, збірка блокується
| Що оновлюється | Захист | У разі збою |
|---|---|---|
| агент fbagent | Підпис, лише новіше, готовність протягом 180 с і 45 с роботи | Відкат, пауза 30 хвилин; другий збій блокує версію |
| HQbird Monitor, кластер, fbmcp | Підпис, лише новіше за встановлене | Попередня версія залишається; зберігаються 2 останні копії |
| Firebird | Вікно, очікування резервних копій, перевірка після запуску | Старий рушій повертається, збірка потрапляє до списку блокування |
Заблокована версія більше не встановлюється, але наступна версія встановлюється як зазвичай. Таким чином, сервер не зациклюється на “оновлення → відкат → оновлення”.
Теки · журнали · видалення
Де розташовані файли та як видалити
Windows
C:\HQbird\ Firebird50\ Firebird 5.0, конфіги, БД безпеки fbagent-fb50\ агент і HQbird Monitor agent_config.json конфіг агента logs\ bak\ update\ журнали, копії, кеш оновлень C:\HQbirdData\ робочі дані агента та консолі config\access.properties вхід до консолі C:\ProgramData\fbagent\ результат встановлення та журнал
Linux
/opt/firebird/ Firebird 5.0 (друга лінійка: /opt/fb50) /opt/hqbird/ conf/access.properties вхід до консолі, 0600 fbagent-fb50/ агент і HQ Monitor agent_config.json конфіг агента logs/ bak/ update/ журнали, копії, кеш оновлень /var/lib/hqmonitor/ дані консолі /var/log/fbagent/install.log журнал встановлення, без паролів
- Видалення не торкається ваших баз данихВаші бази даних і резервні копії (
*.fdb,*.gdb,*.fbk,*.nbk) завжди залишаються. Видалення даних видаляє лише БД безпеки та зразки з пакета Firebird. - Windows"Програми": видаляє агент, консоль, RCM цього агента, правила брандмауера та Firebird, який цей інсталятор встановив як новий. Якщо інші агенти використовують RCM цього агента, майстер запитує "Видалити цей екземпляр усе одно?"; для тихого видалення потрібен
/FORCE. Оновлений Firebird залишається. Конфіги та БД безпеки видаляються, лише якщо ви виберете "видалити дані".
- Linux
--uninstallвидаляє служби агента й консолі, RCM цього агента, правила sudoers та порти, які інсталятор відкрив у firewalld або ufw. Агент спершу виходить з кластера. Якщо інші агенти використовують його RCM, потрібен перемикач--force. Firebird залишається.--remove-dataтакож видаляє конфіг, журнали та дані консолі. - Старий HQbirdВидалення HQbird 2027 не вмикає старі служби знову: адміністратор вирішує це за допомогою файлу стану.
sudo sh hqbird2027-fb50-linux-<version>.run --uninstall --agent-dir /opt/hqbird/fbagent-fb50-2