Эта страница переведена машинным переводом. Читайте английский оригинал. English

Это руководство предназначено для администратора, который удаляет 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. Перед началом

  1. Сделайте резервную копию каждой базы данных (gbak или nbackup) и скопируйте её на другой диск или сервер. Удаление не удаляет файлы баз данных, но резервная копия защитит вас от ошибки.
  2. Остановите приложения, которые используют базы данных. В Windows при удалении останавливается Firebird, установленный установщиком.
  3. Кластерные серверы: если на этом сервере работает консоль кластера RCM, сначала удалите кластер в RCM и отвяжите его агентов (раздел 4).
  4. HQCenter: удаление не удаляет запись сервера в вашем HQCenter. Удалите там агента после удаления, если вы не планируете снова устанавливать HQbird.
  5. Лицензия: удаление вместе с данными удаляет состояние лицензии агента. Сохраните файл лицензии, если планируете снова установить 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. Удаление всей линейки

  1. Откройте Параметры → Приложения → Приложения и компоненты (или Программы и компоненты).
  2. Выберите HQbird 2027 (Firebird 5.0) и нажмите Удалить.
  3. Подтвердите удаление.
  4. Ответьте на вопрос о данных: Нет сохраняет конфигурацию и базу безопасности, Да удаляет их тоже.
  5. Дождитесь сообщения о том, что HQbird удалён.

Повторите эти шаги для каждой линейки Firebird на сервере (одна запись на линейку).

3.2. Удаление одного экземпляра

Используйте это, когда в линейке несколько экземпляров и вы удаляете только один.

  1. Откройте Пуск → HQbird 2027 (Firebird 5.0) maintenance.
  2. Выберите Remove an instance и выберите экземпляр.
  3. Подтвердите, затем ответьте на вопрос о данных.

Когда вы удаляете последний экземпляр, HQbird 2027 этой линейки удаляется.

3.3. Тихое удаление

Command
# 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 записи в Приложениях:

Command
Get-ItemProperty 'HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\*' | Where-Object DisplayName -like 'HQbird 2027*' | Select-Object DisplayName, InstallLocation, UninstallString

3.4. Проверка результата

Command
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, удаление отклоняется и ничего не меняется.

Рекомендуемый порядок:

  1. Удалите кластер в консоли RCM и отвяжите его агентов.
  2. Удалите HQbird с серверов-участников.
  3. Удалите 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

Command
# the agent and HQbird Monitor; Firebird, databases, configuration and logs stay
sudo sh hqbird2027-fb50-linux-2027.2.33.run --uninstall
Command
# 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 и перечисляет их папки. Укажите папку:

Command
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:

Command
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. Проверка результата

Command
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 потерян Скачайте установщик той же линии снова; более новая версия той же линии также подойдёт