Tato stránka byla strojově přeložena. Přečtěte si anglický originál. English

Tento návod je pro administrátora, který odstraňuje HQbird 2027 ze serveru. Pokrývá instalátor pro Windows hqbird2027-fbNN-setup-<version>.exe a linuxový instalátor hqbird2027-fbNN-linux-<version>.run.

Příklady ukazují Firebird 5.0 (fb50). Pro Firebird 2.5, 3.0 a 4.0 použijte fb25, fb30, fb40 v názvech souborů, složek a služeb. Instalace je popsána v instalace pro Windows a nastavení pro Linux.

HQbird 2024 se odstraňuje podle předchozích pokynů.

1. Než začnete

  1. Vytvořte zálohu každé databáze (gbak nebo nbackup) a zkopírujte ji na jiný disk nebo server. Odstranění nesmaže databázové soubory, ale záloha vás ochrání před chybou.
  2. Zastavte aplikace, které databáze používají. Ve Windows odstranění zastaví Firebird, který nainstaloval instalátor.
  3. Servery v clusteru: pokud tento server provozuje konzoli clusteru RCM, nejprve smažte cluster v RCM a odpojte jeho agenty (část 4).
  4. HQCenter: odstranění nesmaže záznam serveru ve vašem HQCenter. Odstraňte tam agenta po odstranění, pokud neplánujete znovu nainstalovat HQbird.
  5. Licence: odstranění s daty smaže licenční stav agenta. Uschovejte si licenční soubor, pokud plánujete znovu nainstalovat HQbird.

2. Co se odstraní a co zůstane

Položka Windows Linux
Agent HQbird (služba nebo unit, programy) odstraněno odstraněno
HQbird Monitor (služba nebo unit, pravidlo firewallu) odstraněno odstraněno
Firebird, který HQbird 2027 nainstaloval nově odstraněno (služba, programové soubory, pravidlo firewallu) zůstává
Firebird, který existoval dříve a byl pouze aktualizován zůstává zůstává
Databázové soubory (*.fdb, *.gdb, *.fbk, *.nbk) vždy zůstávají vždy zůstávají
Konfigurace agenta, logy, licenční stav, data HQbird Monitor zůstávají; odstraněno s volbou dat zůstávají; odstraněno s --remove-data
Bezpečnostní databáze a soubory *.conf Firebirdu zůstávají; odstraněno s volbou dat zůstávají
Služby staršího HQbird (2024 a dřívější), které aktualizace vypnula zůstávají vypnuté zůstávají vypnuté

Volba dat ve Windows odstraní pouze to, co vytvořil instalátor HQbird 2027. Data agenta, který existoval před prvním instalátorem HQbird 2027, zůstávají.

3. Windows

Jedna položka v Aplikace a funkce = jedna řada Firebird. Odinstalátor řady odstraní všechny instance této řady. Spusťte jej jako správce.

3.1. Odstranění celé řady

  1. Otevřete Nastavení → Aplikace → Aplikace a funkce (nebo Programy a funkce).
  2. Vyberte HQbird 2027 (Firebird 5.0) a klikněte na Odinstalovat.
  3. Potvrďte odstranění.
  4. Odpovězte na otázku ohledně dat: Ne zachová konfiguraci a bezpečnostní databázi, Ano je také odstraní.
  5. Počkejte na zprávu, že HQbird byl odstraněn.

Tyto kroky opakujte pro každou řadu Firebird na serveru (jedna položka na řadu).

3.2. Odstranění jedné instance

Použijte, když má řada několik instancí a vy odstraňujete pouze jednu.

  1. Otevřete Start → Údržba HQbird 2027 (Firebird 5.0).
  2. Vyberte Odstranit instanci a vyberte instanci.
  3. Potvrďte a poté odpovězte na otázku ohledně dat.

Když odstraníte poslední instanci, HQbird 2027 této řady se odstraní.

3.3. Tiché odstranění

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

Složka odinstalátoru je <HQbird folder>\setup\fb50. Řady nainstalované instalátory před 2027.2.8 ji mají v C:\Program Files\IBSurgeon\HQbird 2027\fb50. Přesná složka je hodnota InstallLocation položky v Aplikacích:

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

3.4. Kontrola výsledku

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

Očekáváno: žádné služby HQbird této řady a False pro klíč registru. Odinstalátor smaže klíč registru až po úplném odstranění. Pokud klíč stále existuje, spusťte odinstalátor znovu.

3.5. Co zůstává na disku

Složka Obsah Smazat ručně?
C:\HQbird\Firebird50\ Databázové soubory a bez volby dat bezpečnostní databáze a *.conf Poté, co přesunete databáze
C:\HQbird\fbagent-fb50\ Konfigurace agenta a logy, když jste zachovali data Ano, pokud je nepotřebujete
C:\HQbirdData\ Pracovní data agenta, data HQbird Monitor a přihlašovací soubor, když jste zachovali data Ano, pokud je nepotřebujete
C:\HQbird\hqbirdrcm\ Data RCM (odejdou pouze s volbou dat) Ano, poté co cluster zmizí
C:\ProgramData\fbagent\ install.log, výsledek posledního spuštění instalátoru Ano
C:\ProgramData\HQbird\fbagent\ Soubor s heslem SYSDBA tiché instalace Ano
<Firebird folder>.old_<time> Kopie staré programové složky Firebirdu z aktualizace Ano, když je aktualizace potvrzena

Službu fbmcp sdílejí všechny řady serveru. Zůstává, dokud ji používá jiná řada, a odstraní se s poslední řadou.

4. Servery v clusteru

Agent, který provozuje RCM, drží CA clusteru. Když tento RCM používají jiní agenti, odstranění je odmítnuto a nic se nezmění.

Doporučené pořadí:

  1. Smažte cluster v konzoli RCM a odpojte jeho agenty.
  2. Odstraňte HQbird z členských serverů.
  3. Odstraňte HQbird ze serveru, který provozuje RCM.

Chcete-li vlastníka RCM přesto odstranit:

  • Windows, dialog: odinstalátor se zeptá „Remove this instance anyway? The cluster loses its RCM CA.“ Odpovězte Ano.
  • Windows, tiché: přidejte /FORCE. Bez něj instance, která provozuje RCM, zůstane a log uvede důvod.
  • Linux: instalátor se zastaví s návratovým kódem 5. Spusťte jej znovu s --force.

Po vynuceném odstranění nemá cluster žádnou CA: žádné nové certifikáty a žádné nové členy. Chcete-li, aby se jiný agent stal vlastníkem nového RCM, spusťte tam fbagent --cluster-init <id> --rcm-takeover a znovu propojte členy.

5. Linux

Spusťte stejný soubor .run, který nainstaloval HQbird (nebo novější ze stejné řady) jako root. Příklady používají verzi 2027.2.33.

5.1. Odstranění agenta a 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

Příkaz zastaví a odstraní unity hqbirdfbagent-fb50 a hqbirdmonitor-fb50, programy fbagent a hqmonitor a pravidla sudoers agenta. Zavře port HQbird Monitor, který instalace otevřela v firewalld nebo ufw.

5.2. Několik instancí na jednom hostiteli

Bez --agent-dir instalátor odstraní jediného agenta v /opt/hqbird. Při několika agentech se zastaví s návratovým kódem 1 a vypíše jejich složky. Uveďte složku:

Command
sudo sh hqbird2027-fb50-linux-2027.2.33.run --uninstall --agent-dir /opt/hqbird/fbagent-fb50-2

Spusťte příkaz jednou pro každého agenta. Sdílený přihlašovací soubor HQbird Monitor zůstává, dokud není odstraněn poslední agent.

5.3. Odstranění Firebirdu (volitelné, ručně)

Instalátor na Linuxu nikdy neodstraní Firebird. Udělejte to ručně až poté, co jste vytvořili zálohy a přesunuli databáze z složky Firebirdu.

Názvy unitů Firebirdu:

Složka Firebirdu Řada Unit
/opt/firebird 2.5, 4.0, 5.0 firebird
/opt/firebird 3.0 firebird-superserver
jiná složka, například /opt/fb50-2 4.0, 5.0 firebird.opt_fb50-2
jiná složka, například /opt/fb30 3.0 firebird.opt_fb30-superserver

Příklad pro Firebird v /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

Upozornění: rm -rf smaže vše ve složce, také databáze a bezpečnostní databázi, které jsou v ní. Nejprve složku zkontrolujte.

5.4. Kontrola výsledku

Command
systemctl list-unit-files 'hqbird*' 'hqclusternode*' 'firebird*' --no-legend
ls /opt/hqbird /var/lib/hqmonitor 2>/dev/null

Očekáváno: žádné unity hqbirdfbagent-fb50 a hqbirdmonitor-fb50. Unit Firebirdu je stále tam, pokud jste Firebird neodstranili ručně.

5.5. Co zůstává na disku

Cesta Obsah Smazat ručně?
/opt/hqbird/fbagent-fb50/ Konfigurace agenta a logy (bez --remove-data) Ano, pokud je nepotřebujete
/var/lib/hqmonitor/ Data HQbird Monitor (bez --remove-data) Ano, pokud je nepotřebujete
/opt/hqbirdrcm/ RCM, dokud jej používají jiní agenti hostitele Poté co cluster zmizí
/opt/fbagent-update-backup/ Programové soubory Firebirdu, které aktualizace nahradily Ano, když jsou aktualizace potvrzeny
/opt/hqbird/fbagent-hqbird-takeover.json Stav starších unitů HQbird před aktualizací Ponechte, pokud plánujete návrat ke staršímu HQbird
/opt/firebird (nebo vaše složka Firebirdu) Firebird a jeho databáze Část 5.3

5.6. Návratové kódy --uninstall

Kód Význam Co dělat
0 Odstraněno —
1 Odmítnuto: několik agentů na hostiteli nebo nesprávná volba Přidejte --agent-dir se složkou ze seznamu
5 Odmítnuto: tento agent provozuje RCM hostitele a používají jej jiní agenti Část 4

6. Starší HQbird po odstranění

Když HQbird 2027 nahradil starší HQbird (2024 a dřívější), aktualizace vypnula služby staršího HQbird. Odstranění HQbird 2027 je nezapne znovu. Jejich stav před aktualizací je uložen v:

  • Windows: <HQbird folder>\fbagent-hqbird-takeover.json
  • Linux: /opt/hqbird/fbagent-hqbird-takeover.json

Pomocí tohoto souboru zjistíte, které služby byly aktivní, a spusťte je ručně, pokud se vracíte ke staršímu HQbird.

7. Řešení problémů

Problém Co dělat
Windows: položka v Aplikace a funkce zůstává po odstranění Instance nebyla odstraněna (často ta, která provozuje RCM). Spusťte odinstalátor znovu; pro vlastníka RCM viz část 4
Windows: obecná chyba a příkaz ze starého odinstalátoru Agent se aktualizoval na 3.1.0 nebo novější a odmítá odstranit vlastníka RCM. Přidejte --force k zobrazenému příkazu nebo spusťte odinstalátor novějšího instalátoru
Windows: testovací sestavení 2027.0.1 a 2027.0.2 Používala jednu položku pro všechny řady. Odstraňte je jejich vlastním odinstalátorem
Linux: --uninstall odmítnuto, návratový kód 1 Několik agentů na hostiteli: přidejte --agent-dir (část 5.2)
Linux: --uninstall odmítnuto, návratový kód 5 Agent provozuje RCM hostitele: část 4
Linux: run as root (sudo sh ...) Spusťte instalátor s sudo nebo jako root
Linux: soubor .run je ztracen Stáhněte znovu instalátor stejné řady; funguje i novější verze stejné řady