Instalacja i aktualizacje
Instalacja bez niespodzianek
Jeden instalator na każdą linię Firebird. Znajduje Firebird, starego HQbird i agentów na serwerze, pokazuje plan i niczego nie zmienia, dopóki nie powiesz „Tak”. Potem agent aktualizuje się sam, a także konsolę i Firebird, z kontrolami i wycofywaniem zmian.
- 4 instalatory: Firebird 2.5 · 3.0 · 4.0 · 5.0
- 0 zmian przed potwierdzeniem planu
- bez potrzeby internetu wszystko w jednym pliku
- Windows i Linux kreator, tryb cichy, .run
- wycofywanie zmian jeśli instalacja lub aktualizacja się nie powiedzie
setup.exe · .run
Co zawiera zestaw
Instalator to jeden plik: hqbird2027-fb50-setup-<version>.exe dla Windows lub hqbird2027-fb50-linux-<version>.run dla Linux. Zawiera wszystko, czego potrzebuje serwer. Nic nie jest pobierane.
Każdy instalator instaluje jedną linię Firebird. Wybierz linię, na której działają Twoje bazy danych. Instalację wykonuje agent znajdujący się w zestawie: sprawdza serwer, buduje plan i go realizuje.
| Komponent | Co robi | Windows | Linux |
|---|---|---|---|
| Firebird, kompilacja HQbird | Nowy serwer lub aktualizacja w miejscu. Dla serwera, który jest już zainstalowany, do firebird.conf dodawana jest jedna linia: MonitoringPlugin = fblwmon. Dla nowego serwera instalator ustawia także port. databases.conf, baza bezpieczeństwa i hasło SYSDBA nie zmieniają się. | usługa FirebirdServer… | /opt/firebird |
| agent fbagent | Kopie zapasowe, monitorowanie, konserwacja, aktualizacje. | HQbirdFBAgent-fb50 | hqbirdfbagent-fb50, użytkownik firebird |
| HQbird Monitor | Konsola webowa dla tego serwera. Port = 20000 + port Firebird: dla 3050 to 23050. Port jest wybierany podczas instalacji i nie zmienia się później, nawet jeśli zmienisz port Firebird. | HQbirdMonitor-fb50 | hqbirdmonitor-fb50 |
| Komponenty klastra | Programy klastra są umieszczane na serwerze, ale nie są włączane: RCM i okno parowania są domyślnie wyłączone. RCM czyni serwer centrum nowego klastra i otwiera porty 7443 i 7444. Okno parowania otwiera porty 7450–7459 na 24 godziny: za jego pośrednictwem RCM innego serwera może zaprosić ten serwer. Oba można włączyć także po instalacji. | strona kreatora „Replication and cluster setup”; /RCM, /DISCOVERY | --rcm on, --cluster-pairing on |
| serwer MCP fbmcp | Dostęp dla klientów AI do Firebird. Domyślnie tylko z tego serwera. | pole wyboru w kreatorze lub /NOFBMCP | --no-fbmcp |
| Pliki debugowania Firebird | Symbole do analizy awarii Firebird. | — | tak, --no-debug je wyłącza |
- WindowsObsługiwane: Windows 10 i 11, Windows Server 2016 i nowsze, 64-bit. Uprawnienia administratora. Instalator jest podpisany przez IBSurgeon Software: Windows pokazuje wydawcę w monicie o uprawnienia.
- Kreator lub tryb cichyKażda strona kreatora jest dostępna także jako przełącznik:
/VERYSILENT /YES /LOG=…. Dobre do skryptów i do stu serwerów. - Kreator w 8 językachangielski, portugalski (Brazylia), niemiecki, rosyjski, hiszpański, polski, turecki, chiński uproszczony. Domyślnie język Windows. Przełącznik:
/LANG=en|pt_BR|de|ru|es|pl|tr|zh_CN. - Nazwa serweraKreator pyta o nazwę nowego agenta; HQCenter pokazuje serwer pod tą nazwą. Domyślnie nazwa komputera. Tryb cichy:
/AGENTID=, w Linux--agent-id. Zainstalowany agent zachowuje swoją nazwę.
- Linuxx86_64, jądro 3.2 lub nowsze, systemd, root. Ubuntu, Debian, AlmaLinux, Rocky, RHEL, Oracle Linux, openSUSE, RED OS i inne z apt, dnf, yum lub zypper.
- Serwer bez internetuInstalator pobiera kilka bibliotek systemowych (libtommath, ICU) z repozytorium. Jeśli nie ma repozytorium, wypisuje dokładne polecenia i niczego nie zmienia.
Zestaw jest sprawdzany dwukrotnie. Przed rozpakowaniem: sha256 całego zestawu. Przed instalacją Firebird i agenta: podpis każdego pliku. Uszkodzone pobranie zatrzymuje instalację przed jakąkolwiek zmianą Firebird, agenta lub konsoli.
fbagent --install-plan
Najpierw plan, potem zmiany
Najpierw instalator tylko odczytuje: usługi, rejestr, foldery Firebird i HQbird. Potem pokazuje, co znalazł i co zrobi. Zmiany zaczynają się po Twoim „Tak”.
Wybierz, co znajduje się na serwerze, i spójrz na plan. Teksty są skrócone i przetłumaczone; kolejność i decyzje są takie same jak w instalatorze Firebird 5.0.
- 1Sprawdzenie serwerauprawnienia, bitowość; w Linux także systemd i jądro
- 2Sprawdzenie zestawusha256 przed rozpakowaniem; podpisy plików przed instalacją
- 3Planco znaleziono i co zostanie zrobione
- 4Pytanianazwa serwera dla HQCenter; zatrzymać Firebird? inna wersja?
- 5InstalacjaFirebird, agent, konsola, usługi
- 6✓ Wynikusługi, adres konsoli, login
Jeśli coś pójdzie nie tak
Odmowa na etapie planu (port zajęty, folder niepusty) niczego nie zmienia: instalator podaje przyczynę. W kreatorze nie można opuścić strony, gdy wartość jest nieprawidłowa.
Niepowodzenie podczas instalacji, przed uruchomieniem usługi agenta: usługi wracają do poprzedniego stanu. Stary HQbird, jeśli został zatrzymany, uruchamia się ponownie.
| Kod | Znaczenie (Linux .run) |
|---|---|
| 0 | Gotowe |
| 1 | Odmowa: serwer, przełącznik lub plan. Nic nie zmieniono |
| 2 | Instalacja nie powiodła się, zmiany wycofane |
| 3 | Wycofywanie niekompletne: wynik mówi, co sprawdzić |
| 4 | Wymagana odpowiedź: brak terminala i brak --yes |
| 5 | Zestaw nie przeszedł sprawdzenia: pobierz go ponownie |
| 6 | Brak bibliotek systemowych i brak repozytorium |
| 7 | Firebird z pakietów dystrybucji |
| Kod | Znaczenie (Windows setup.exe) |
|---|---|
| 0 | Zainstalowano |
| 1 | Odmowa przed instalacją: nieprawidłowy przełącznik lub plik, zainstalowana jest nowsza wersja, brak uprawnień administratora |
| 4 | Instalator miał pytanie, ale brak przełącznika /YES |
| 7 | Sprawdzenie serwera lub instalacja nie powiodła się. Przyczyna jest w logu i w pliku wyniku |
| 10 | Zainstalowano, ale połączenie z HQCenter nie powiodło się |
-p3050); nowe instalacje otrzymują -fb50.FBDataGuard → fbagent
Przejście z HQbird 2024
Instalator odnajduje starego HQbirda oraz Firebirda, któremu służy. Ten Firebird jest aktualizowany w miejscu, zadania FBDataGuard przechodzą do agenta, stare usługi są zatrzymywane. Bazy danych, konfiguracje i hasła pozostają.
- Co się nie zmienia
databases.conflubaliases.conf, baza bezpieczeństwa, hasło SYSDBA, bazy danych, kopie zapasowe i stare pliki HQbird. Wfirebird.confdodawany jest tylko wierszMonitoringPlugin = fblwmon, jeśli go brakuje. - Kopia starego FirebirdaFolder programu starego Firebirda jest zachowywany obok jako
<folder>.old_<time>. - ZadaniaKopie zapasowe gbak i nbackup, sweep, statystyki indeksów. Import uruchamia się raz i przechodzi przez sprawdzenie nowej konfiguracji; stara konfiguracja jest zachowywana.
- Stare kopie zapasoweAgent przenosi kopie zapasowe z dzienników FBDataGuard do własnych rejestrów. Reguły retencji i przywracanie widzą je tak samo jak nowe. Nazwy poziomów nbackup pozostają takie same.
- Nazwy zadańNazwa zadania kończy się nazwą bazy danych z FBDataGuard, na przykład "Verified backup - MANUAL". Zadania grupowe odtwarzają drzewo folderów źródłowych.
- Stare usługi: trzy opcjeAutomatycznie (zalecane): wyłącz je, gdy każdy Firebird obsługiwany przez FBDataGuard ma agenta. Wyłącz wszystkie:
/DISABLEHQBIRD. Pozostaw bez zmian:/NOHQBIRD. - Można wrócićStan każdej usługi przed jej wyłączeniem jest zapisywany w
fbagent-hqbird-takeover.json. Za pomocą tego pliku można ponownie włączyć starego HQbirda. - LicencjaStara licencja HQbird nie jest przenoszona. Okres próbny trwa do momentu uzyskania nowej licencji lub połączenia z HQCenter.
- Nieczytelna ścieżkaJeśli import nie może rozwinąć podstawienia w ścieżce FBDataGuard, pozostawia ją bez zmian i pozostawia zadanie wyłączone. Popraw ścieżkę i włącz zadanie.
Jeśli zadania są importowane, ale stare usługi nadal działają (na przykład serwer ma dwa serwery Firebird pod FBDataGuard), zadania trafiają jako wyłączone. Dzięki temu jedno zadanie nie uruchamia się dwa razy.
Porty · foldery · usługi
Kilka serwerów Firebird na jednej maszynie
Jeden agent na jednego Firebirda. Nowa instancja jest instalowana obok pozostałych, na własnym porcie, z własnym agentem i własną konsolą. Zainstalowane instancje się nie zmieniają.
Dodaj serwery Firebird i zobacz, jakie nazwy i porty wybierze instalator.
- Porty według liniiPierwszy Firebird na serwerze otrzymuje 3050. Następny: 3052 dla 2.5, 3053 dla 3.0, 3054 dla 4.0, 3055 dla 5.0. Instalator nie zajmuje portu, który jest w użyciu.
- Druga instancja tej samej liniiNumer
-2w nazwach folderów i usług. W systemie Windows jest to opcja kreatora "Install another instance"; port to pierwszy wolny w zakresie danej linii.
- Aktualizacje tylko w obrębie linii5.0.x → 5.0.y. Przejście z 3.0 na 5.0 oznacza drugą instancję obok pierwszej; bazy danych przenosi się przez kopię zapasową i przywracanie.
- XNET w systemie WindowsFirebird, który nie działa na porcie 3050, otrzymuje własną nazwę
IpcName = FIREBIRD_<port>. Lokalne połączenia XNET z drugim serwerem działają. - Jedna konsola na agentaHQbird Monitor na 20000 + port Firebird: 23050, 23055. Jeden plik logowania dla wszystkich instancji na serwerze.
- Porty są stałePorty konsoli i lokalnego API agenta są zapisywane podczas instalacji. Jeśli później zmienisz port Firebird, pozostaną takie same. Agent nie akceptuje jednakowych portów.
- Klaster: slot dla każdego agentaKażdy agent na serwerze otrzymuje własny slot od 0 do 9: port parowania 7450 + slot, porty węzła 7051 + slot i 7061 + slot. Dzięki temu dwa agenty jednego serwera mogą dołączyć do klastra. Przełącznik
--pairing-portustawia slot jawnie.
Obrazy · compose · porty
HQbird w Dockerze
Dla każdej linii Firebird jest gotowy obraz. Firebird, agent i HQbird Monitor działają w kontenerze. Agent instaluje węzeł klastra wewnątrz samego kontenera, gdy serwer dołącza do klastra. RCM instaluje tylko wtedy, gdy ten serwer jest wyznaczony jako RCM klastra.
| Obraz | Firebird | Port Firebird | HQbird Monitor |
|---|---|---|---|
ghcr.io/ibsurgeon/hqbird2027-fb50 | 5.0 | 3050 | 23050 |
ghcr.io/ibsurgeon/hqbird2027-fb40 | 4.0 | 3050 | 23050 |
ghcr.io/ibsurgeon/hqbird2027-fb30 | 3.0 | 3050 | 23050 |
ghcr.io/ibsurgeon/hqbird2027-fb25 | 2.5 | 3050 | 23050 |
- Pierwsze uruchomienieSkopiuj
compose.yamlz zestawu, umieść hasło SYSDBA w pliku sekretu, usuń#z wierszysecrets:i uruchomdocker compose up -d. Serwer jest gotowy, gdydocker compose pspokazujehealthy. - Port FirebirdZmienna
HQBIRD_FB_PORT, domyślnie 3050. HQbird Monitor nasłuchuje na 20000 + ten port. - Podpis obrazuObrazy są podpisywane narzędziem cosign. Klucz publiczny do weryfikacji nie jest jeszcze opublikowany.
- Kilka instancji na jednym hościeFirebird na 3050 + N, HQbird Monitor na 20000 + port Firebird, węzeł klastra na 7051 + N. Tylko jedna instancja na hoście może mieć RCM.
- Ten sam numer portu na zewnątrz i wewnątrzPublikuj
3051:3051, a nie3051:3050. Agent i klaster zgłaszają port, który widzą wewnątrz kontenera. - KlasterAdres członka to adres hosta Docker. Opublikuj port węzła, a dla RCM porty 7443 i 7444.
Docker publikuje porty z pominięciem ufw. Reguła ufw "tylko port 22" nie zamyka portów kontenera. Opublikuj port na jednym adresie hosta lub zamknij go zewnętrznym firewallem.
Chmura i Docker: ustawienia, wolumeny, porty, aktualizacjeAgent · konsola · klaster · Firebird
Aktualizacje po instalacji
Po połączeniu z HQCenter agent samodzielnie aktualizuje siebie, HQbird Monitor, komponenty klastra, fbmcp i Firebird. Serwer bez HQCenter również aktualizuje się samodzielnie: agent pobiera nowe wersje z serwera aktualizacji IBSurgeon.
Agent widzi nową wersję siebie w HQCenter w ciągu minuty. Nowe wersje HQbird Monitor, fbmcp i Firebird: w ciągu godziny. Każda aktualizacja przebiega według jednego schematu: sprawdź, zapisz punkt wycofania, zastąp, upewnij się, że działa. Jeśli nie działa, przywróć starą wersję.
Aktualizacje bez HQCenter
- Co aktualizuje się samoAgent, HQbird Monitor i serwer MCP. Sprawdzenie odbywa się raz na 6 godzin.
- Firebird czeka na poleceniePakiet Firebird jest pobierany i czeka. Administrator stosuje go: przyciskiem na stronie Updates lub poleceniem
fbagent --firebird-update --apply. - Tryb wybierasz samPrzełącznik instalacji
--auto-update all|agent|off, w systemie Windows/AUTOUPDATE=all|agent|off. Domyślnie jest toagent.allinstaluje także Firebirda, w oknie aktualizacji.offniczego nie sprawdza.
- Strona Updates w HQbird MonitorPokazuje, skąd agent pobiera wersje, tryb i ostatnią odpowiedź serwera, stan aktualizacji Firebirda, konsoli i serwera MCP. Administrator zmienia tryb i stosuje pakiet Firebird.
- Weryfikacja źródłaSerwer aktualizacji jest weryfikowany względem przypiętego klucza. Podpis dostawcy jest zawsze wymagany.
- Klaster przechodzi przez centrumWęzeł klastra i RCM nie aktualizują się w ten sposób: aktualizuje je HQCenter lub RCM.
Samoaktualizacja agenta
- Tylko do przoduAgent nie instaluje wersji starszej niż własna, nawet obowiązkowej. Sprawdzenie odbywa się przed pobraniem pierwszego bajtu. Dzięki temu fałszywy serwer nie może przywrócić starej podatnej kompilacji. Wyjątkiem jest jedna stara wersja dozwolona w konfiguracji samego agenta (
allow_downgrade_to). - PodpisWydania są podpisywane kluczem Ed25519; klucz publiczny jest wbudowany w agenta. Błędny podpis jest zawsze odrzucany. Tryb „tylko podpisane” jest włączany w konfiguracji samego agenta, a nie z serwera.
- Ręczne wycofanieObok agenta znajduje się skrypt
rollback_to_version_NNN: przywraca poprzedniego agenta i konfigurację oraz blokuje nieudaną wersję. Zachowywane są dwa najnowsze punkty wycofania; starsze są usuwane automatycznie. - Linux: root uruchamia tylko własną kopięAgent działa jako
firebird. Zamiana jest wykonywana przez zweryfikowaną kopię w folderze, do którego zapis może mieć tylko root.
Aktualizacja Firebird
Firebird jest aktualizowany tylko w obrębie swojej linii i tylko do nowszej kompilacji. Agent może pobrać i przygotować pakiet w dowolnym momencie, ale zatrzymuje Firebird tylko w oknie aktualizacji.
- 1Przygotowaniepobranie, podpis, kompilacja nie starsza niż silnik
- 2Oknocodzienne okno; wydanie obowiązkowe również czeka na okno
- 3Zadaniadziała gbak, nbackup lub skrypt SQL: próba zostaje odroczona
- 4Zamianastare pliki silnika są odkładane, konfiguracje pozostają
- 5SprawdzenieFirebird startuje i odpowiada na swoim porcie
- 6✓ lub wycofaniestare pliki wracają, kompilacja zostaje zablokowana
| Co jest aktualizowane | Ochrona | Jeśli się nie powiedzie |
|---|---|---|
| agent fbagent | Podpis, tylko nowsza wersja, gotowość w ciągu 180 s i 45 s działania | Wycofanie, 30-minutowa pauza; drugie niepowodzenie blokuje wersję |
| HQbird Monitor, klaster, fbmcp | Podpis, tylko nowsza niż zainstalowana | Poprzednia wersja pozostaje; zachowywane są 2 najnowsze kopie |
| Firebird | Okno, oczekiwanie na kopie zapasowe, sprawdzenie po starcie | Stary silnik wraca, kompilacja trafia na listę zablokowanych |
Zablokowana wersja nie jest instalowana ponownie, ale następna wersja instaluje się normalnie. Dzięki temu serwer nie zapętla się w cyklu „aktualizacja → wycofanie → aktualizacja”.
Foldery · logi · odinstalowanie
Gdzie są pliki i jak odinstalować
Windows
C:\HQbird\ Firebird50\ Firebird 5.0, konfiguracje, baza zabezpieczeń fbagent-fb50\ agent i HQbird Monitor agent_config.json konfiguracja agenta logs\ bak\ update\ logi, kopie, pamięć podręczna aktualizacji C:\HQbirdData\ dane robocze agenta i konsoli config\access.properties logowanie do konsoli C:\ProgramData\fbagent\ wynik instalacji i log
Linux
/opt/firebird/ Firebird 5.0 (druga linia: /opt/fb50) /opt/hqbird/ conf/access.properties logowanie do konsoli, 0600 fbagent-fb50/ agent i HQ Monitor agent_config.json konfiguracja agenta logs/ bak/ update/ logi, kopie, pamięć podręczna aktualizacji /var/lib/hqmonitor/ dane konsoli /var/log/fbagent/install.log log instalacji, bez haseł
- Odinstalowanie nie dotyka Twoich baz danychTwoje bazy danych i kopie zapasowe (
*.fdb,*.gdb,*.fbk,*.nbk) zawsze pozostają. Usuwanie danych usuwa tylko bazę zabezpieczeń i przykłady z pakietu Firebird. - Windows„Aplikacje”: usuwa agenta, konsolę, RCM tego agenta, reguły zapory i Firebird, którego ten instalator zainstalował jako nowy. Jeśli inne agenty korzystają z RCM tego agenta, kreator pyta „Usunąć tę instancję mimo to?”; cicha dezinstalacja wymaga
/FORCE. Zaktualizowany Firebird pozostaje. Konfiguracje i baza zabezpieczeń są usuwane tylko po wybraniu „usuń dane”.
- Linux
--uninstallusuwa usługi agenta i konsoli, RCM tego agenta, reguły sudoers oraz porty otwarte przez instalator w firewalld lub ufw. Agent najpierw opuszcza klaster. Jeśli inne agenty korzystają z jego RCM, potrzebny jest przełącznik--force. Firebird pozostaje.--remove-datausuwa także konfigurację, logi i dane konsoli. - Stary HQbirdOdinstalowanie HQbird 2027 nie włącza ponownie starych usług: administrator decyduje o tym za pomocą pliku stanu.
sudo sh hqbird2027-fb50-linux-<version>.run --uninstall --agent-dir /opt/hqbird/fbagent-fb50-2