Цю сторінку перекладено машинним перекладом. Читайте англійський оригінал. English

Встановлення без сюрпризів

Один інсталятор на кожну лінійку 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. Виберіть лінійку, на якій працюють ваші бази даних. Встановлення виконує агент із комплекту: він перевіряє сервер, будує план і виконує його.

КомпонентЩо робитьWindowsLinux
Firebird, збірка HQbirdНовий сервер або оновлення на місці. Для вже встановленого сервера до firebird.conf додається один рядок: MonitoringPlugin = fblwmon. Для нового сервера інсталятор також задає порт. databases.conf, база безпеки та пароль SYSDBA не змінюються.служба FirebirdServer…/opt/firebird
агент fbagentРезервні копії, моніторинг, обслуговування, оновлення.HQbirdFBAgent-fb50hqbirdfbagent-fb50, користувач firebird
HQbird MonitorВебконсоль для цього сервера. Порт = 20000 + порт Firebird: для 3050 це 23050. Порт вибирається під час встановлення і не змінюється згодом, навіть якщо ви зміните порт Firebird.HQbirdMonitor-fb50hqbirdmonitor-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. 1Перевірка сервераправа, розрядність; на Linux також systemd і ядро
  2. 2Перевірка комплектуsha256 перед розпакуванням; підписи файлів перед встановленням
  3. 3Планщо знайдено і що буде зроблено
  4. 4Запитанняім'я сервера для HQCenter; зупинити Firebird? інша версія?
  5. 5ВстановленняFirebird, агент, консоль, служби
  6. 6✓ Результатслужби, адреса консолі, вхід

Якщо щось пішло не так

Відмова на етапі планування (порт зайнятий, папка не порожня) нічого не змінює: інсталятор називає причину. У майстрі не можна залишити сторінку, поки значення неправильне.

Збій під час встановлення, до запуску служби агента: служби повертаються до попереднього стану. Старий HQbird, якщо його було зупинено, запускається знову.

КодЗначення (Linux .run)
0Готово
1Відмова: сервер, ключ або план. Нічого не змінено
2Встановлення не вдалося, зміни відкочено
3Відкат неповний: у результаті вказано, що перевірити
4Потрібна відповідь: немає термінала й немає --yes
5Комплект не пройшов перевірку: завантажте його знову
6Немає бібліотек ОС і немає репозиторію
7Firebird з пакетів дистрибутива
КодЗначення (Windows setup.exe)
0Встановлено
1Відмова до встановлення: неправильний ключ або файл, встановлено новішу версію, немає прав адміністратора
4В інсталятора було питання, але немає ключа /YES
7Перевірка сервера або встановлення не вдалися. Причина в журналі та у файлі результату
10Встановлено, але з'єднання з HQCenter не вдалося
План у майстрі. «Знайдено на цьому комп'ютері» та «Програма встановлення виконає таке». Внизу: нічого не змінюється, доки ви не натиснете «Встановити».
Результат. Що встановлено, адреса консолі з цього комп'ютера та з іншого, де пароль для входу. Взято з ранньої збірки: там назви служби агента й папок використовують порт (-p3050); нові встановлення отримують -fb50.

FBDataGuard → fbagent

Перехід з HQbird 2024

Інсталятор знаходить старий HQbird і Firebird, якому він служить. Цей Firebird оновлюється на місці, завдання FBDataGuard переходять до агента, старі служби зупиняються. Бази даних, конфігурації та паролі залишаються.

Перехід з HQbird 2024: завдання FBDataGuard переходять до агента HQbird 2027, Firebird оновлюється на місці, старі служби HQbird вимикаються
  • Що не змінюється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 задає слот явно.
Два екземпляри однієї лінії. План бачить обидва сервери Firebird і обох агентів і змінює лише вибраний екземпляр.

Образи · compose · порти

HQbird у Docker

Для кожної лінії Firebird є готовий образ. Firebird, агент і HQbird Monitor працюють у контейнері. Агент встановлює вузол кластера всередині самого контейнера, коли сервер приєднується до кластера. Він встановлює RCM лише тоді, коли цей сервер призначено як RCM кластера.

ОбразFirebirdПорт FirebirdHQbird Monitor
ghcr.io/ibsurgeon/hqbird2027-fb505.0305023050
ghcr.io/ibsurgeon/hqbird2027-fb404.0305023050
ghcr.io/ibsurgeon/hqbird2027-fb303.0305023050
ghcr.io/ibsurgeon/hqbird2027-fb252.5305023050
  • Перший запускСкопіюйте 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.

Самооновлення агента

Самоновлення агента: перевірки, точка відкату, заміна, готовність протягом 180 с, 45 с роботи; у разі збою: відкат, пауза 30 хв, версія заблокована після 2-го збою
  • Лише впередАгент не встановлює версію, старішу за власну, навіть обов’язкову. Перевірка виконується до завантаження першого байта. Таким чином, підроблений сервер не може повернути стару вразливу збірку. Виняток — одна стара версія, дозволена у власному конфігу агента (allow_downgrade_to).
  • ПідписРелізи підписані ключем Ed25519; публічний ключ вбудований в агент. Неправильний підпис завжди відхиляється. Режим “лише підписані” вмикається у власному конфігу агента, а не з сервера.
  • Ручний відкатПоруч з агентом є скрипт rollback_to_version_NNN: він відновлює попередній агент і конфіг та блокує невдалу версію. Зберігаються дві останні точки відкату; старіші видаляються автоматично.
  • Linux: root запускає лише власну копіюАгент працює як firebird. Заміну виконує перевірена копія в теці, до якої може писати лише root.

Оновлення Firebird

Firebird оновлюється лише в межах своєї лінійки і лише до новішої збірки. Агент може завантажити й підготувати пакет у будь-який час, але зупиняє Firebird лише у вікні оновлення.

  1. 1Підготовказавантаження, підпис, збірка не старіша за рушій
  2. 2Вікнощоденне вікно; обов’язковий реліз також чекає на вікно
  3. 3Завданнявиконується gbak, nbackup або SQL-скрипт: спробу відкладено
  4. 4Замінастарі файли рушія відкладаються, конфіги залишаються
  5. 5ПеревіркаFirebird запускається і відповідає на своєму порту
  6. 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 не вмикає старі служби знову: адміністратор вирішує це за допомогою файлу стану.
Linux, видалення одного екземпляра (Firebird і бази даних залишаються):
sudo sh hqbird2027-fb50-linux-<version>.run --uninstall --agent-dir /opt/hqbird/fbagent-fb50-2

← Назад до огляду HQbird 2027 · Стан сервера →