Установка без сюрпризов

Один установщик на линию Firebird. Он сам находит на сервере Firebird, старый HQbird и агентов, показывает план и ничего не меняет до вашего «Да». Потом агент сам обновляет себя, консоль и Firebird — с проверкой и откатом.

  • 4 установщика: Firebird 2.5 · 3.0 · 4.0 · 5.0
  • 0 изменений до подтверждения плана
  • без интернета всё в одном файле
  • Windows и Linux мастер, тихий режим, .run
  • откат при сбое установки и обновления

setup.exe · .run

Что в комплекте

Установщик — один файл: hqbird2027-fb50-setup-<версия>.exe для Windows или hqbird2027-fb50-linux-<версия>.run для Linux. Внутри всё, что нужно серверу. Ничего не скачивается.

Каждый установщик ставит одну линию Firebird. Выберите ту, на которой работают ваши базы. Установку делает агент, который лежит внутри комплекта: он проверяет сервер, строит план и выполняет его.

КомпонентЧто делаетWindowsLinux
Firebird, сборка HQbirdНовый сервер или обновление на месте. В firebird.conf уже установленного сервера добавляется одна строка: MonitoringPlugin = fblwmon. Новому серверу установщик ещё задаёт порт. databases.conf, security DB и пароль SYSDBA не меняются.служба FirebirdServer…/opt/firebird
Агент fbagentБэкапы, мониторинг, обслуживание, обновления.HQbirdFBAgent-fb50hqbirdfbagent-fb50, пользователь firebird
HQbird MonitorВеб-консоль этого сервера. Порт = 20000 + порт Firebird: для 3050 это 23050. Порт выбирается при установке и потом не меняется, даже если изменить порт Firebird.HQbirdMonitor-fb50hqbirdmonitor-fb50
Компоненты кластераПрограммы кластера кладутся на сервер, но не включаются: RCM и окно сопряжения выключены по умолчанию. RCM делает сервер центром нового кластера и открывает порты 7443 и 7444. Окно сопряжения на 24 часа открывает порт 7450–7459: через него 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, РЕД ОС и другие с 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 не удалось
План в мастере. «Найдено на сервере» и «Установщик сделает». Внизу: ничего не меняется до кнопки Install.
Итог. Что установлено, адрес консоли с этого и с другого компьютера, где пароль входа. Снято ранней сборкой: имена служб и папок агента там по порту (-p3050), новые установки получают -fb50.

FBDataGuard → fbagent

Переход с HQbird 2024

Установщик находит старый HQbird и Firebird, который тот обслуживает. Этот Firebird обновляется на месте, задания FBDataGuard переходят в агента, старые службы останавливаются. Базы, конфиги и пароли остаются.

Переход с HQbird 2024: задания FBDataGuard переходят в агент HQbird 2027, Firebird обновляется на месте, службы старого HQbird отключаются
  • Что не меняетсяdatabases.conf или aliases.conf, security DB, пароль SYSDBA, базы, бэкапы и файлы старого HQbird. В firebird.conf добавляется только строка MonitoringPlugin = fblwmon, если её нет.
  • Копия старого FirebirdПапка программ старого Firebird сохраняется рядом как <папка>.old_<время>.
  • ЗаданияБэкапы 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 это пункт мастера «Install another instance», порт — первый свободный в диапазоне линии.
  • Обновление только внутри линии5.0.x → 5.0.y. Переход 3.0 → 5.0 — это второй экземпляр рядом; базы переносит человек, через backup и restore.
  • XNET на WindowsFirebird не на порту 3050 получает своё имя IpcName = FIREBIRD_<порт>. Локальные подключения 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 минут и блокировка версии после второго сбоя
  • Только вперёдАгент не ставит версию старше своей, даже обязательную. Проверка идёт до загрузки первого байта. Так подменённый сервер не вернёт старую уязвимую сборку. Исключение — одна старая версия, которую разрешили в конфиге самого агента (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, конфиги, security DB
  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) остаются всегда. С удалением данных уходят только security DB и примеры из пакета Firebird.
  • Windows«Приложения»: удаляются агент, консоль, RCM этого агента, правила брандмауэра и Firebird, который этот установщик поставил новым. Если RCM этого агента используют другие агенты, мастер спрашивает «Remove this instance anyway?»; тихое удаление требует /FORCE. Обновлённый Firebird остаётся. Конфиги и security DB — только если выбрать «удалить данные».
  • Linux--uninstall удаляет службы агента и консоли, RCM этого агента, правила sudoers и порты, которые установщик открыл в firewalld или ufw. Агент сначала выходит из кластера. Если его RCM используют другие агенты, нужен ключ --force. Firebird остаётся. --remove-data удаляет ещё конфиг, журналы и данные консоли.
  • Старый HQbirdУдаление HQbird 2027 не включает старые службы обратно: это решает администратор по файлу состояния.
Linux, удаление одного экземпляра (Firebird и базы остаются):
sudo sh hqbird2027-fb50-linux-<версия>.run --uninstall --agent-dir /opt/hqbird/fbagent-fb50-2

← Вернуться к обзору HQbird 2027 · Состояние сервера →