Ова страница је машински преведена. Прочитајте енглески оригинал. 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 агент (сервис или јединица, програми) уклоњено уклоњено
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. Уклањање целе линије

  1. Отворите Settings → Apps → Apps & features (или Programs and Features).
  2. Изаберите HQbird 2027 (Firebird 5.0) и кликните на Uninstall.
  3. Потврдите уклањање.
  4. Одговорите на питање о подацима: No задржава конфигурацију и безбедносну базу података, Yes их такође уклања.
  5. Сачекајте поруку да је HQbird уклоњен.

Поновите ове кораке за сваку Firebird линију на серверу (један унос по линији).

3.2. Уклањање једне инстанце

Користите ово када линија има више инстанци и уклањате само једну.

  1. Отворите Start → 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 уноса у Apps-у:

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.” Одговорите 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-а

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

Команда зауставља и уклања јединице 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 фасцикле.

Називи 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 је изгубљена Поново преузмите инсталатер исте линије; новија верзија исте линије такође ради