Usunięcie HQbird 2027
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
- Wykonaj kopię zapasową każdej bazy danych (
gbaklubnbackup) i skopiuj ją na inny dysk lub serwer. Usunięcie nie usuwa plików baz danych, ale kopia zapasowa chroni przed pomyłką. - Zatrzymaj aplikacje, które korzystają z baz danych. W systemie Windows usunięcie zatrzymuje Firebird zainstalowany przez instalator.
- Serwery klastra: jeśli ten serwer uruchamia konsolę klastra RCM, najpierw usuń klaster w RCM i odłącz jego agentów (sekcja 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.
- 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
- Otwórz Ustawienia → Aplikacje → Aplikacje i funkcje (lub Programy i funkcje).
- Wybierz HQbird 2027 (Firebird 5.0) i kliknij Odinstaluj.
- Potwierdź usunięcie.
- Odpowiedz na pytanie o dane: Nie zachowuje konfigurację i bazę bezpieczeństwa, Tak usuwa je również.
- 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.
- Otwórz Start → HQbird 2027 (Firebird 5.0) maintenance.
- Wybierz Remove an instance i wybierz wystąpienie.
- 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
# 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 /FORCEFolder 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:
Get-ItemProperty 'HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\*' | Where-Object DisplayName -like 'HQbird 2027*' | Select-Object DisplayName, InstallLocation, UninstallString3.4. Sprawdzenie wyniku
Get-Service | Where-Object Name -match 'HQbird|Firebird|hqbirdrcm|hqclusternode'
Test-Path 'HKLM:\SOFTWARE\IBSurgeon\HQbird2027\fb50'
Get-NetFirewallRule -DisplayName 'HQbird Monitor*', 'Firebird *' -ErrorAction SilentlyContinueOczekiwane: 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ść:
- Usuń klaster w konsoli RCM i odłącz jego agentów.
- Usuń HQbird z serwerów członkowskich.
- 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
# 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-dataPolecenie 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:
sudo sh hqbird2027-fb50-linux-2027.2.33.run --uninstall --agent-dir /opt/hqbird/fbagent-fb50-2Uruchom 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:
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 $BOstrzeż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
systemctl list-unit-files 'hqbird*' 'hqclusternode*' 'firebird*' --no-legend
ls /opt/hqbird /var/lib/hqmonitor 2>/dev/nullOczekiwane: 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 |