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

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.

KomponentCo robiWindowsLinux
Firebird, kompilacja HQbirdNowy 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 fbagentKopie zapasowe, monitorowanie, konserwacja, aktualizacje.HQbirdFBAgent-fb50hqbirdfbagent-fb50, użytkownik firebird
HQbird MonitorKonsola 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-fb50hqbirdmonitor-fb50
Komponenty klastraProgramy 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 fbmcpDostęp dla klientów AI do Firebird. Domyślnie tylko z tego serwera.pole wyboru w kreatorze lub /NOFBMCP--no-fbmcp
Pliki debugowania FirebirdSymbole 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.

Na serwerze

        


          


          

  1. 1Sprawdzenie serwerauprawnienia, bitowość; w Linux także systemd i jądro
  2. 2Sprawdzenie zestawusha256 przed rozpakowaniem; podpisy plików przed instalacją
  3. 3Planco znaleziono i co zostanie zrobione
  4. 4Pytanianazwa serwera dla HQCenter; zatrzymać Firebird? inna wersja?
  5. 5InstalacjaFirebird, agent, konsola, usługi
  6. 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.

KodZnaczenie (Linux .run)
0Gotowe
1Odmowa: serwer, przełącznik lub plan. Nic nie zmieniono
2Instalacja nie powiodła się, zmiany wycofane
3Wycofywanie niekompletne: wynik mówi, co sprawdzić
4Wymagana odpowiedź: brak terminala i brak --yes
5Zestaw nie przeszedł sprawdzenia: pobierz go ponownie
6Brak bibliotek systemowych i brak repozytorium
7Firebird z pakietów dystrybucji
KodZnaczenie (Windows setup.exe)
0Zainstalowano
1Odmowa przed instalacją: nieprawidłowy przełącznik lub plik, zainstalowana jest nowsza wersja, brak uprawnień administratora
4Instalator miał pytanie, ale brak przełącznika /YES
7Sprawdzenie serwera lub instalacja nie powiodła się. Przyczyna jest w logu i w pliku wyniku
10Zainstalowano, ale połączenie z HQCenter nie powiodło się
Plan w kreatorze. „Found on this computer” i „Setup will do the following”. Na dole: nic się nie zmienia, dopóki nie klikniesz Install.
Wynik. Co jest zainstalowane, adres konsoli z tego komputera i z innego, gdzie jest hasło logowania. Pobrane z wczesnej kompilacji: tam nazwy usługi agenta i folderów używają portu (-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ą.

Przejście z HQbird 2024: zadania FBDataGuard przechodzą do agenta HQbird 2027, Firebird jest aktualizowany w miejscu, stare usługi HQbird są wyłączane
  • Co się nie zmieniadatabases.conf lub aliases.conf, baza bezpieczeństwa, hasło SYSDBA, bazy danych, kopie zapasowe i stare pliki HQbird. W firebird.conf dodawany jest tylko wiersz MonitoringPlugin = 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.

Dodaj
  • 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 -2 w 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-port ustawia slot jawnie.
Dwie instancje jednej linii. Plan widzi oba serwery Firebird i obu agentów i zmienia tylko wybraną instancję.

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.

ObrazFirebirdPort FirebirdHQbird Monitor
ghcr.io/ibsurgeon/hqbird2027-fb505.0305023050
ghcr.io/ibsurgeon/hqbird2027-fb404.0305023050
ghcr.io/ibsurgeon/hqbird2027-fb303.0305023050
ghcr.io/ibsurgeon/hqbird2027-fb252.5305023050
  • Pierwsze uruchomienieSkopiuj compose.yaml z zestawu, umieść hasło SYSDBA w pliku sekretu, usuń # z wierszy secrets: i uruchom docker compose up -d. Serwer jest gotowy, gdy docker compose ps pokazuje healthy.
  • 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 nie 3051: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, aktualizacje

Agent · 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 to agent. all instaluje także Firebirda, w oknie aktualizacji. off niczego 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

Samoaktualizacja agenta: sprawdzenia, punkt wycofania, zamiana, gotowość w ciągu 180 s, 45 s działania; w razie niepowodzenia: wycofanie, 30-minutowa pauza, wersja zablokowana po drugim niepowodzeniu
  • 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.

  1. 1Przygotowaniepobranie, podpis, kompilacja nie starsza niż silnik
  2. 2Oknocodzienne okno; wydanie obowiązkowe również czeka na okno
  3. 3Zadaniadziała gbak, nbackup lub skrypt SQL: próba zostaje odroczona
  4. 4Zamianastare pliki silnika są odkładane, konfiguracje pozostają
  5. 5SprawdzenieFirebird startuje i odpowiada na swoim porcie
  6. 6✓ lub wycofaniestare pliki wracają, kompilacja zostaje zablokowana
Co jest aktualizowaneOchronaJeśli się nie powiedzie
agent fbagentPodpis, tylko nowsza wersja, gotowość w ciągu 180 s i 45 s działaniaWycofanie, 30-minutowa pauza; drugie niepowodzenie blokuje wersję
HQbird Monitor, klaster, fbmcpPodpis, tylko nowsza niż zainstalowanaPoprzednia wersja pozostaje; zachowywane są 2 najnowsze kopie
FirebirdOkno, oczekiwanie na kopie zapasowe, sprawdzenie po starcieStary 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--uninstall usuwa 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-data usuwa 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.
Linux, odinstalowanie jednej instancji (Firebird i bazy danych pozostają):
sudo sh hqbird2027-fb50-linux-<version>.run --uninstall --agent-dir /opt/hqbird/fbagent-fb50-2

← Powrót do przeglądu HQbird 2027 · Kondycja serwera →