Установка и обновления
Установка без сюрпризов
Один установщик на линию 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. Выберите ту, на которой работают ваши базы. Установку делает агент, который лежит внутри комплекта: он проверяет сервер, строит план и выполняет его.
| Компонент | Что делает | Windows | Linux |
|---|---|---|---|
| Firebird, сборка HQbird | Новый сервер или обновление на месте. В firebird.conf уже установленного сервера добавляется одна строка: MonitoringPlugin = fblwmon. Новому серверу установщик ещё задаёт порт. databases.conf, security DB и пароль 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. Окно сопряжения на 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Проверка сервераправа, разрядность; на 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, 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задаёт слот явно.
Образы · 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, конфиги, 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 не включает старые службы обратно: это решает администратор по файлу состояния.
sudo sh hqbird2027-fb50-linux-<версия>.run --uninstall --agent-dir /opt/hqbird/fbagent-fb50-2