Цю сторінку перекладено машинним перекладом. Читайте англійський оригінал. 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).
  2. Виберіть Видалити екземпляр і виберіть екземпляр.
  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 втрачено Завантажте інсталятор тієї ж лінії знову; новіша версія тієї ж лінії також працює