Ta strona została przetłumaczona maszynowo. Przeczytaj oryginał angielski. English

Ten przewodnik jest przeznaczony dla administratora, który usuwa HQbird 2027 z serwera. Obejmuje instalator Windows hqbird2027-fbNN-setup-<version>.exe oraz instalator Linux hqbird2027-fbNN-linux-<version>.run.

Przykłady pokazują Firebird 5.0 (fb50). Dla Firebird 2.5, 3.0 i 4.0 użyj fb25, fb30, fb40 w nazwach plików, folderów i usług. Instalacja jest opisana w Windows installation i Linux setup.

HQbird 2024 jest usuwany zgodnie z poprzednimi instrukcjami.

1. Zanim zaczniesz

  1. Wykonaj kopię zapasową każdej bazy danych (gbak lub nbackup) i skopiuj ją na inny dysk lub serwer. Usunięcie nie usuwa plików baz danych, ale kopia zapasowa chroni przed pomyłką.
  2. Zatrzymaj aplikacje, które korzystają z baz danych. W systemie Windows usunięcie zatrzymuje Firebird zainstalowany przez instalator.
  3. Serwery klastra: jeśli ten serwer uruchamia konsolę klastra RCM, najpierw usuń klaster w RCM i odłącz jego agentów (sekcja 4).
  4. HQCenter: usunięcie nie usuwa rekordu serwera w Twoim HQCenter. Usuń tam agenta po zakończeniu usuwania, jeśli nie planujesz ponownej instalacji HQbird.
  5. Licencja: usunięcie wraz z danymi usuwa stan licencji agenta. Zachowaj plik licencji, jeśli planujesz ponowną instalację HQbird.

2. Co jest usuwane, a co pozostaje

Element Windows Linux
Agent HQbird (usługa lub unit, programy) usuwane usuwane
HQbird Monitor (usługa lub unit, reguła zapory) usuwane usuwane
Firebird zainstalowany od nowa przez HQbird 2027 usuwany (usługa, pliki programów, reguła zapory) pozostaje
Firebird, który istniał wcześniej i został tylko zaktualizowany pozostaje pozostaje
Pliki baz danych (*.fdb, *.gdb, *.fbk, *.nbk) zawsze pozostają zawsze pozostają
Konfiguracja agenta, logi, stan licencji, dane HQbird Monitor pozostają; usuwane z opcją danych pozostają; usuwane z --remove-data
Baza bezpieczeństwa i pliki *.conf Firebird pozostają; usuwane z opcją danych pozostają
Usługi starszego HQbird (2024 i wcześniejsze), które aktualizacja wyłączyła pozostają wyłączone pozostają wyłączone

Opcja danych w systemie Windows usuwa tylko to, co utworzył instalator HQbird 2027. Dane agenta, który istniał przed pierwszą instalacją HQbird 2027, pozostają.

3. Windows

Jeden wpis w Aplikacje i funkcje = jedna linia Firebird. Deinstalator linii usuwa wszystkie wystąpienia tej linii. Uruchom go jako administrator.

3.1. Usunięcie całej linii

  1. Otwórz Ustawienia → Aplikacje → Aplikacje i funkcje (lub Programy i funkcje).
  2. Wybierz HQbird 2027 (Firebird 5.0) i kliknij Odinstaluj.
  3. Potwierdź usunięcie.
  4. Odpowiedz na pytanie o dane: Nie zachowuje konfigurację i bazę bezpieczeństwa, Tak usuwa je również.
  5. Poczekaj na komunikat, że HQbird został usunięty.

Powtórz te kroki dla każdej linii Firebird na serwerze (jeden wpis na linię).

3.2. Usunięcie jednego wystąpienia

Użyj tego, gdy linia ma kilka wystąpień i usuwasz tylko jedno.

  1. Otwórz Start → HQbird 2027 (Firebird 5.0) maintenance.
  2. Wybierz Remove an instance i wybierz wystąpienie.
  3. Potwierdź, a następnie odpowiedz na pytanie o dane.

Po usunięciu ostatniego wystąpienia HQbird 2027 tej linii zostaje usunięty.

3.3. Ciche usunięcie

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

Folder deinstalatora to <HQbird folder>\setup\fb50. Linie zainstalowane przez instalatory przed 2027.2.8 mają go w C:\Program Files\IBSurgeon\HQbird 2027\fb50. Dokładny folder to wartość InstallLocation wpisu w Aplikacjach:

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

3.4. Sprawdzenie wyniku

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

Oczekiwane: brak usług HQbird tej linii i False dla klucza rejestru. Deinstalator usuwa klucz rejestru tylko po pełnym usunięciu. Jeśli klucz nadal istnieje, uruchom deinstalator ponownie.

3.5. Co pozostaje na dysku

Folder Zawartość Usunąć ręcznie?
C:\HQbird\Firebird50\ Pliki baz danych, a bez opcji danych baza bezpieczeństwa i *.conf Po przeniesieniu baz danych
C:\HQbird\fbagent-fb50\ Konfiguracja i logi agenta, gdy zachowano dane Tak, jeśli nie są potrzebne
C:\HQbirdData\ Dane robocze agenta, dane HQbird Monitor i plik logowania, gdy zachowano dane Tak, jeśli nie są potrzebne
C:\HQbird\hqbirdrcm\ Dane RCM (usuwane tylko z opcją danych) Tak, po usunięciu klastra
C:\ProgramData\fbagent\ install.log, wynik ostatniego uruchomienia instalatora Tak
C:\ProgramData\HQbird\fbagent\ Plik hasła SYSDBA z instalacji cichej Tak
<Firebird folder>.old_<time> Kopia starego folderu programów Firebird z aktualizacji Tak, gdy aktualizacja jest potwierdzona

Usługa fbmcp jest współdzielona przez wszystkie linie serwera. Pozostaje, dopóki korzysta z niej inna linia, i jest usuwana wraz z ostatnią linią.

4. Serwery w klastrze

Agent, który uruchamia RCM, przechowuje CA klastra. Gdy inne agenty używają tego RCM, usunięcie jest odrzucane i nic nie zostaje zmienione.

Zalecana kolejność:

  1. Usuń klaster w konsoli RCM i odłącz jego agentów.
  2. Usuń HQbird z serwerów członkowskich.
  3. Usuń HQbird z serwera, który uruchamia RCM.

Aby mimo to usunąć właściciela RCM:

  • Windows, okno dialogowe: deinstalator pyta „Remove this instance anyway? The cluster loses its RCM CA.". Odpowiedz Tak.
  • Windows, tryb cichy: dodaj /FORCE. Bez tego wystąpienie, które uruchamia RCM, pozostaje, a log podaje przyczynę.
  • Linux: instalator zatrzymuje się z kodem wyjścia 5. Uruchom go ponownie z --force.

Po wymuszonym usunięciu klaster nie ma CA: żadnych nowych certyfikatów i żadnych nowych członków. Aby uczynić innego agenta właścicielem nowego RCM, uruchom tam fbagent --cluster-init <id> --rcm-takeover i ponownie połącz członków.

5. Linux

Uruchom ten sam plik .run, który zainstalował HQbird (lub nowszy z tej samej linii) jako root. Przykłady używają wersji 2027.2.33.

5.1. Usunięcie agenta i 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

Polecenie zatrzymuje i usuwa unity hqbirdfbagent-fb50 i hqbirdmonitor-fb50, programy fbagent i hqmonitor oraz reguły sudoers agenta. Zamyka port HQbird Monitor, który instalacja otworzyła w firewalld lub ufw.

5.2. Kilka wystąpień na jednym hoście

Bez --agent-dir instalator usuwa jedynego agenta w /opt/hqbird. Przy kilku agentach zatrzymuje się z kodem wyjścia 1 i wyświetla listę ich folderów. Wskaż folder:

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

Uruchom polecenie raz dla każdego agenta. Współdzielony plik logowania HQbird Monitor pozostaje do usunięcia ostatniego agenta.

5.3. Usunięcie Firebird (opcjonalnie, ręcznie)

Instalator nigdy nie usuwa Firebird w systemie Linux. Zrób to ręcznie tylko po wykonaniu kopii zapasowych i przeniesieniu baz danych z folderu Firebird.

Nazwy unitów Firebird:

Folder Firebird Linia Unit
/opt/firebird 2.5, 4.0, 5.0 firebird
/opt/firebird 3.0 firebird-superserver
inny folder, na przykład /opt/fb50-2 4.0, 5.0 firebird.opt_fb50-2
inny folder, na przykład /opt/fb30 3.0 firebird.opt_fb30-superserver

Przykład dla Firebird w /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

Ostrzeżenie: rm -rf usuwa wszystko w folderze, także bazy danych i bazę bezpieczeństwa, które się w nim znajdują. Najpierw sprawdź folder.

5.4. Sprawdzenie wyniku

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

Oczekiwane: brak unitów hqbirdfbagent-fb50 i hqbirdmonitor-fb50. Unit Firebird nadal istnieje, chyba że usunięto Firebird ręcznie.

5.5. Co pozostaje na dysku

Ścieżka Zawartość Usunąć ręcznie?
/opt/hqbird/fbagent-fb50/ Konfiguracja i logi agenta (bez --remove-data) Tak, jeśli nie są potrzebne
/var/lib/hqmonitor/ Dane HQbird Monitor (bez --remove-data) Tak, jeśli nie są potrzebne
/opt/hqbirdrcm/ RCM, dopóki korzystają z niego inne agenty hosta Po usunięciu klastra
/opt/fbagent-update-backup/ Pliki programów Firebird zastąpione przez aktualizacje Tak, gdy aktualizacje są potwierdzone
/opt/hqbird/fbagent-hqbird-takeover.json Stan starszych unitów HQbird przed aktualizacją Zachowaj, jeśli planujesz powrót do starszego HQbird
/opt/firebird (lub Twój folder Firebird) Firebird i jego bazy danych Sekcja 5.3

5.6. Kody wyjścia --uninstall

Kod Znaczenie Co zrobić
0 Usunięto —
1 Odmowa: kilka agentów na hoście lub błędna opcja Dodaj --agent-dir z folderem z listy
5 Odmowa: ten agent uruchamia RCM hosta i korzystają z niego inne agenty Sekcja 4

6. Starszy HQbird po usunięciu

Gdy HQbird 2027 zastąpił starszy HQbird (2024 i wcześniejsze), aktualizacja wyłączyła usługi starszego HQbird. Usunięcie HQbird 2027 nie włącza ich ponownie. Ich stan przed aktualizacją jest zapisany w:

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

Użyj tego pliku, aby sprawdzić, które usługi były aktywne, i uruchom je ręcznie, jeśli wracasz do starszego HQbird.

7. Rozwiązywanie problemów

Problem Co zrobić
Windows: wpis w Aplikacje i funkcje pozostaje po usunięciu Wystąpienie nie zostało usunięte (często to, które uruchamia RCM). Uruchom deinstalator ponownie; dla właściciela RCM patrz sekcja 4
Windows: błąd ogólny i polecenie ze starego deinstalatora Agent zaktualizował się do 3.1.0 lub nowszego i odmawia usunięcia właściciela RCM. Dodaj --force do pokazanego polecenia lub uruchom deinstalator nowszego instalatora
Windows: kompilacje testowe 2027.0.1 i 2027.0.2 Używały jednego wpisu dla wszystkich linii. Usuń je ich własnym deinstalatorem
Linux: --uninstall odrzucone, kod wyjścia 1 Kilku agentów na hoście: dodaj --agent-dir (sekcja 5.2)
Linux: --uninstall odrzucone, kod wyjścia 5 Agent uruchamia RCM hosta: sekcja 4
Linux: run as root (sudo sh ...) Uruchom instalator z sudo lub jako root
Linux: plik .run został utracony Pobierz ponownie instalator tej samej linii; nowsza wersja tej samej linii również działa