Удаление HQbird 2027
Это руководство предназначено для администратора, который удаляет HQbird 2027 с сервера.
Оно охватывает установщик Windows hqbird2027-fbNN-setup-<version>.exe и
установщик Linux hqbird2027-fbNN-linux-<version>.run.
В примерах показан Firebird 5.0 (fb50). Для Firebird 2.5, 3.0 и 4.0 используйте
fb25, fb30, fb40 в именах файлов, папок и служб. Установка
описана в разделах
Установка в Windows и
Установка в Linux.
HQbird 2024 удаляется по предыдущим инструкциям.
1. Перед началом
- Сделайте резервную копию каждой базы данных (
gbakилиnbackup) и скопируйте её на другой диск или сервер. Удаление не удаляет файлы баз данных, но резервная копия защитит вас от ошибки. - Остановите приложения, которые используют базы данных. В Windows при удалении останавливается Firebird, установленный установщиком.
- Кластерные серверы: если на этом сервере работает консоль кластера RCM, сначала удалите кластер в RCM и отвяжите его агентов (раздел 4).
- HQCenter: удаление не удаляет запись сервера в вашем HQCenter. Удалите там агента после удаления, если вы не планируете снова устанавливать HQbird.
- Лицензия: удаление вместе с данными удаляет состояние лицензии агента. Сохраните файл лицензии, если планируете снова установить HQbird.
2. Что удаляется, а что остаётся
| Элемент | Windows | Linux |
|---|---|---|
| Агент HQbird (служба или unit, программы) | удаляется | удаляется |
| HQbird Monitor (служба или unit, правило брандмауэра) | удаляется | удаляется |
| Firebird, который HQbird 2027 установил заново | удаляется (служба, файлы программ, правило брандмауэра) | остаётся |
| Firebird, который существовал раньше и был только обновлён | остаётся | остаётся |
Файлы баз данных (*.fdb, *.gdb, *.fbk, *.nbk) |
всегда остаются | всегда остаются |
| Конфигурация агента, журналы, состояние лицензии, данные HQbird Monitor | остаются; удаляются с параметром данных | остаются; удаляются с --remove-data |
База безопасности и файлы *.conf Firebird |
остаются; удаляются с параметром данных | остаются |
| Службы более старого HQbird (2024 и ранее), которые отключило обновление | остаются отключёнными | остаются отключёнными |
Параметр данных в Windows удаляет только то, что создал установщик HQbird 2027. Данные агента, который существовал до первого установщика HQbird 2027, остаются.
3. Windows
Одна запись в Приложениях и компонентах = одна линейка Firebird. Деинсталлятор линейки удаляет все экземпляры этой линейки. Запускайте его от имени администратора.
3.1. Удаление всей линейки
- Откройте Параметры → Приложения → Приложения и компоненты (или Программы и компоненты).
- Выберите HQbird 2027 (Firebird 5.0) и нажмите Удалить.
- Подтвердите удаление.
- Ответьте на вопрос о данных: Нет сохраняет конфигурацию и базу безопасности, Да удаляет их тоже.
- Дождитесь сообщения о том, что HQbird удалён.
Повторите эти шаги для каждой линейки Firebird на сервере (одна запись на линейку).
3.2. Удаление одного экземпляра
Используйте это, когда в линейке несколько экземпляров и вы удаляете только один.
- Откройте Пуск → HQbird 2027 (Firebird 5.0) maintenance.
- Выберите Remove an instance и выберите экземпляр.
- Подтвердите, затем ответьте на вопрос о данных.
Когда вы удаляете последний экземпляр, HQbird 2027 этой линейки удаляется.
3.3. Тихое удаление
# programs and services; databases, configs and the security database stay
& 'C:\HQbird\setup\fb50\unins000.exe' /VERYSILENT
# the same, and the agent data, HQbird Monitor data, the security database and *.conf too
& 'C:\HQbird\setup\fb50\unins000.exe' /VERYSILENT /REMOVEDATA
# remove also an instance that runs the RCM of a cluster (section 4)
& 'C:\HQbird\setup\fb50\unins000.exe' /VERYSILENT /FORCEПапка деинсталлятора — <HQbird folder>\setup\fb50. У линеек, установленных
установщиками до 2027.2.8, она находится в
C:\Program Files\IBSurgeon\HQbird 2027\fb50. Точная папка — это
значение InstallLocation записи в Приложениях:
Get-ItemProperty 'HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\*' | Where-Object DisplayName -like 'HQbird 2027*' | Select-Object DisplayName, InstallLocation, UninstallString3.4. Проверка результата
Get-Service | Where-Object Name -match 'HQbird|Firebird|hqbirdrcm|hqclusternode'
Test-Path 'HKLM:\SOFTWARE\IBSurgeon\HQbird2027\fb50'
Get-NetFirewallRule -DisplayName 'HQbird Monitor*', 'Firebird *' -ErrorAction SilentlyContinueОжидается: нет служб HQbird этой линейки и False для ключа реестра.
Деинсталлятор удаляет ключ реестра только после полного удаления. Если
ключ всё ещё там, запустите деинсталлятор снова.
3.5. Что остаётся на диске
| Папка | Содержимое | Удалить вручную? |
|---|---|---|
C:\HQbird\Firebird50\ |
Файлы баз данных, а без параметра данных — база безопасности и *.conf |
После того как вы перенесли базы данных |
C:\HQbird\fbagent-fb50\ |
Конфигурация и журналы агента, если вы сохранили данные | Да, если они вам не нужны |
C:\HQbirdData\ |
Рабочие данные агента, данные HQbird Monitor и файл входа, если вы сохранили данные | Да, если они вам не нужны |
C:\HQbird\hqbirdrcm\ |
Данные RCM (удаляются только с параметром данных) | Да, после того как кластер удалён |
C:\ProgramData\fbagent\ |
install.log, результат последнего запуска установщика |
Да |
C:\ProgramData\HQbird\fbagent\ |
Файл пароля SYSDBA тихой установки | Да |
<Firebird folder>.old_<time> |
Копия старой папки программ Firebird от обновления | Да, когда обновление подтверждено |
Служба fbmcp используется совместно всеми линейками сервера. Она остаётся, пока её использует другая линейка, и удаляется вместе с последней линейкой.
4. Серверы в кластере
Агент, который запускает RCM, хранит CA кластера. Когда другие агенты используют этот RCM, удаление отклоняется и ничего не меняется.
Рекомендуемый порядок:
- Удалите кластер в консоли RCM и отвяжите его агентов.
- Удалите HQbird с серверов-участников.
- Удалите HQbird с сервера, который запускает RCM.
Чтобы всё же удалить владельца RCM:
- Windows, диалог: деинсталлятор спрашивает “Remove this instance anyway? The cluster loses its RCM CA.” Ответьте Да.
- Windows, тихий режим: добавьте
/FORCE. Без него экземпляр, который запускает RCM, остаётся, а в журнале указывается причина. - Linux: установщик останавливается с кодом выхода 5. Запустите его снова с
--force.
После принудительного удаления у кластера нет CA: ни новых сертификатов, ни
новых участников. Чтобы сделать другой агент владельцем нового RCM, запустите там
fbagent --cluster-init <id> --rcm-takeover и снова привяжите участников.
5. Linux
Запустите тот же файл .run, который устанавливал HQbird (или более новый той же
линейки), от имени root. В примерах используется версия 2027.2.33.
5.1. Удаление агента и HQbird Monitor
# the agent and HQbird Monitor; Firebird, databases, configuration and logs stay
sudo sh hqbird2027-fb50-linux-2027.2.33.run --uninstall# the same, and the agent folder (configuration, logs, license state) and HQbird Monitor data too
sudo sh hqbird2027-fb50-linux-2027.2.33.run --uninstall --remove-dataКоманда останавливает и удаляет unit-файлы hqbirdfbagent-fb50 и
hqbirdmonitor-fb50, программы fbagent и hqmonitor, а также
правила sudoers агента. Она закрывает порт HQbird Monitor, который
установка открыла в firewalld или ufw.
5.2. Несколько экземпляров на одном хосте
Без --agent-dir установщик удаляет единственного агента в
/opt/hqbird. При нескольких агентах он останавливается с кодом выхода 1 и перечисляет
их папки. Укажите папку:
sudo sh hqbird2027-fb50-linux-2027.2.33.run --uninstall --agent-dir /opt/hqbird/fbagent-fb50-2Запустите команду один раз для каждого агента. Общий файл входа HQbird Monitor остаётся до удаления последнего агента.
5.3. Удаление Firebird (необязательно, вручную)
Установщик никогда не удаляет Firebird в Linux. Делайте это вручную только после того, как сделали резервные копии и перенесли базы данных из папки Firebird.
Имена unit-файлов Firebird:
| Папка Firebird | Линия | Юнит |
|---|---|---|
/opt/firebird |
2.5, 4.0, 5.0 | firebird |
/opt/firebird |
3.0 | firebird-superserver |
другая папка, например /opt/fb50-2 |
4.0, 5.0 | firebird.opt_fb50-2 |
другая папка, например /opt/fb30 |
3.0 | firebird.opt_fb30-superserver |
Пример для 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 $BВнимание: rm -rf удаляет всё в папке, включая базы данных
и базу безопасности, которые находятся внутри неё. Сначала проверьте папку.
5.4. Проверка результата
systemctl list-unit-files 'hqbird*' 'hqclusternode*' 'firebird*' --no-legend
ls /opt/hqbird /var/lib/hqmonitor 2>/dev/nullОжидается: нет юнитов hqbirdfbagent-fb50 и hqbirdmonitor-fb50. Юнит
Firebird по-прежнему на месте, если вы не удалили Firebird вручную.
5.5. Что остаётся на диске
| Путь | Содержимое | Удалить вручную? |
|---|---|---|
/opt/hqbird/fbagent-fb50/ |
Конфигурация и логи агента (без --remove-data) |
Да, если они вам не нужны |
/var/lib/hqmonitor/ |
Данные HQbird Monitor (без --remove-data) |
Да, если они вам не нужны |
/opt/hqbirdrcm/ |
RCM, пока другие агенты хоста его используют | После удаления кластера |
/opt/fbagent-update-backup/ |
Программные файлы Firebird, заменённые обновлениями | Да, когда обновления подтверждены |
/opt/hqbird/fbagent-hqbird-takeover.json |
Состояние более старых юнитов HQbird до обновления | Сохраните, если планируете вернуться к более старому HQbird |
/opt/firebird (или ваша папка Firebird) |
Firebird и его базы данных | Раздел 5.3 |
5.6. Коды выхода --uninstall
| Код | Значение | Что делать |
|---|---|---|
| 0 | Удалено | — |
| 1 | Отказано: на хосте несколько агентов или неверная опция | Добавьте --agent-dir с папкой из списка |
| 5 | Отказано: этот агент запускает RCM хоста, и другие агенты его используют | Раздел 4 |
6. Более старый HQbird после удаления
Когда HQbird 2027 заменил более старый HQbird (2024 и ранее), обновление отключило службы более старого HQbird. Удаление HQbird 2027 не включает их снова. Их состояние до обновления сохранено в:
- Windows:
<HQbird folder>\fbagent-hqbird-takeover.json - Linux:
/opt/hqbird/fbagent-hqbird-takeover.json
Используйте этот файл, чтобы увидеть, какие службы были активны, и запустите их вручную, если вы возвращаетесь к более старому HQbird.
7. Устранение неполадок
| Проблема | Что делать |
|---|---|
| Windows: запись в Apps & features остаётся после удаления | Один экземпляр не был удалён (часто тот, который запускает RCM). Запустите деинсталлятор снова; о владельце RCM см. раздел 4 |
| Windows: общая ошибка и команда от старого деинсталлятора | Агент обновился до 3.1.0 или новее и отказывается удалять владельца RCM. Добавьте --force к показанной команде или запустите деинсталлятор более новой установки |
| Windows: тестовые сборки 2027.0.1 и 2027.0.2 | Они использовали одну запись для всех линий. Удалите их их собственным деинсталлятором |
Linux: --uninstall отказано, код выхода 1 |
Несколько агентов на хосте: добавьте --agent-dir (раздел 5.2) |
Linux: --uninstall отказано, код выхода 5 |
Агент запускает RCM хоста: раздел 4 |
Linux: run as root (sudo sh ...) |
Запустите установщик с sudo или от имени root |
Linux: файл .run потерян |
Скачайте установщик той же линии снова; более новая версия той же линии также подойдёт |