Уклањање 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 агент (сервис или јединица, програми) | уклоњено | уклоњено |
| HQbird Monitor (сервис или јединица, правило заштитног зида) | уклоњено | уклоњено |
| Firebird који је HQbird 2027 инсталирао нови | уклоњено (сервис, програмске датотеке, правило заштитног зида) | остаје |
| Firebird који је постојао раније и само је ажуриран | остаје | остаје |
Датотеке базе података (*.fdb, *.gdb, *.fbk, *.nbk) |
увек остају | увек остају |
| Конфигурација агента, дневници, стање лиценце, подаци HQbird Monitor-а | остају; уклањају се са опцијом за податке | остају; уклањају се са --remove-data |
Безбедносна база података и *.conf датотеке Firebird-а |
остају; уклањају се са опцијом за податке | остају |
| Сервиси старијег HQbird-а (2024 и раније) које је ажурирање искључило | остају искључени | остају искључени |
Опција за податке на Windows-у уклања само оно што је направио инсталациони програм HQbird 2027. Подаци агента који је постојао пре првог инсталационог програма HQbird 2027 остају.
3. Windows
Један унос у Apps & features = једна Firebird линија. Деинсталатер линије уклања све инстанце те линије. Покрените га као администратор.
3.1. Уклањање целе линије
- Отворите Settings → Apps → Apps & features (или Programs and Features).
- Изаберите HQbird 2027 (Firebird 5.0) и кликните на Uninstall.
- Потврдите уклањање.
- Одговорите на питање о подацима: No задржава конфигурацију и безбедносну базу података, Yes их такође уклања.
- Сачекајте поруку да је HQbird уклоњен.
Поновите ове кораке за сваку Firebird линију на серверу (један унос по линији).
3.2. Уклањање једне инстанце
Користите ово када линија има више инстанци и уклањате само једну.
- Отворите Start → 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 уноса у Apps-у:
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.” Одговорите Yes.
- 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Команда зауставља и уклања јединице 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 фасцикле.
Називи 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 је изгубљена |
Поново преузмите инсталатер исте линије; новија верзија исте линије такође ради |