HQbird 2027 dla systemu Linux: przewodnik instalacji
Ten przewodnik jest przeznaczony dla administratora, który instaluje HQbird 2027 na serwerze Linux za pomocą instalatora offline hqbird2027-fbNN-linux-<version>.run. Obejmuje nową instalację, aktualizację starszego HQbird oraz wcześniejszej wersji HQbird 2027, polecenia konserwacyjne, połączenie z Twoim HQCenter, instalację bezobsługową (skryptową) oraz lokalizację plików po instalacji.
Przykłady pokazują instalator dla Firebird 5.0 na Ubuntu 24.04. Instalatory dla Firebird 2.5, 3.0 i 4.0 działają w ten sam sposób; różnią się tylko wersja, domyślny port i nazwy folderów. Konfiguracja Windows jest opisana w Windows installation.
Spis treści
- 1. Co instaluje instalator
- 2. Instalacja w skrócie
- 3. Nowa instalacja
- 4. Po instalacji
- 5. Aktualizacja starszego HQbird (2024 i wcześniejsze)
- 6. Aktualizacja HQbird 2027 do nowej wersji
- 7. Polecenia konserwacyjne
- 8. Przypisanie do HQCenter
- 9. Instalacja nienadzorowana i skrypty
- 10. Rozwiązywanie problemów
1. Co instaluje instalator
Jeden plik .run = jedna linia Firebird. Wybierz instalator wersji Firebird, której używają Twoje bazy danych:
| Instalator | Firebird, który instaluje lub aktualizuje | Pierwszy Firebird na hoście | Rozmiar |
|---|---|---|---|
hqbird2027-fb50-linux-<version>.run |
Firebird 5.0 (kompilacja HQbird) | /opt/firebird, port 3050 |
około 250 MB |
hqbird2027-fb40-linux-<version>.run |
Firebird 4.0 (kompilacja HQbird) | /opt/firebird, port 3050 |
około 220 MB |
hqbird2027-fb30-linux-<version>.run |
Firebird 3.0 (kompilacja HQbird) | /opt/firebird, port 3050 |
około 130 MB |
hqbird2027-fb25-linux-<version>.run |
Firebird 2.5 (kompilacja HQbird) | /opt/firebird, port 3050 |
około 80 MB |
Każdy instalator zawiera i instaluje bez dostępu do Internetu:
- Firebird (kompilacja HQbird tej linii): nowy serwer lub aktualizację w miejscu Firebird tej linii, który już znajduje się na hoście. Twoje pliki
firebird.conf,databases.conf(aliases.confdla 2.5), baza danych zabezpieczeń i hasło SYSDBA są zachowywane. - Pliki debugowania Firebird (symbole do analizy awarii), instalowane w folderze Firebird.
--no-debugje pomija. - Agent HQbird (
fbagent): jednostka systemdhqbirdfbagent-fb50, działająca jako użytkownikfirebird, która wykonuje kopie zapasowe, monitorowanie, zadania konserwacyjne i aktualizacje. Nazwa kończy się linią Firebird (-fb25…-fb50); druga instancja tej linii ma-fb50-2. - HQ Monitor: konsola webowa tej instancji HQbird, jednostka
hqbirdmonitor-fb50, adreshttp://<server>:<20000 + Firebird port>/(dla Firebird na porcie 3050:http://localhost:23050/). - Komponenty klastra: konsola klastra RCM (
hqbirdrcm) i węzeł klastra (hqclusternode) są kopiowane do pamięci podręcznej agenta. Zestawy z agentem (fbagent) 3.1.0 i nowszym domyślnie nie tworzą klastra: brak RCM, brak okna parowania, brak portu klastra w zaporze. Dwa pytania (lub--rcm on,--cluster-pairing on) je włączają („Next: cluster" w sekcji 3). Z RCM jest instalowany w/opt/hqbirdrcmi działa jako jednostkahqbirdrcm; podsumowanie wypisuje jego adres w liniiRCM:. Węzeł otrzymuje swoją jednostkę (na przykładhqclusternode-master-p3050), gdy połączysz host w RCM. Zestawy od 2027.2.19 ze starszym agentem instalują RCM na każdym serwerze (--rcm offpozostawia go w pamięci podręcznej) i otwierają okno parowania. Zestawy przed 2027.2.19 tylko kopiują oba komponenty do pamięci podręcznej agenta: nie ma jednostkihqbirdrcmani liniiRCM:.
Instancje zainstalowane przed 2027.2.9 mają port Firebird w nazwach agenta: folder /opt/hqbird/fbagent-p3050, jednostki hqbirdfbagent-p3050 i hqbirdmonitor-p3050. Aktualizacja nie zmienia tych nazw. Tylko nowe instancje otrzymują nazwy -fb<NN>, więc jeden host może mieć obie formy.
Wymagania: x86_64, jądro 3.2 lub nowsze, systemd; Linux z apt, dnf/yum lub zypper (Ubuntu, Debian, AlmaLinux, Rocky, RHEL, Oracle Linux, openSUSE, RED OS i inne); root. Około 300 MB wolnego miejsca w /var/tmp podczas instalacji (folder, w którym programy mogą działać; patrz --tmpdir). Kilka bibliotek systemowych (libtommath, ICU) jest pobieranych z repozytorium dystrybucji; serwer bez dostępu do Internetu otrzymuje dokładne polecenia ich przygotowania (sekcja 9).
Nieobsługiwane: Firebird zainstalowany z pakietów dystrybucji (firebird3.0-server, rpm firebird). Instalator zatrzymuje się, zanim cokolwiek zmieni (kod wyjścia 7); najpierw usuń pakiety (zachowaj kopię zapasową gbak swoich baz danych) lub użyj instalatora online z --import-firebird.
Kilka linii Firebird na jednym serwerze: każda linia ma własny instalator. Pierwszy Firebird na hoście trafia do /opt/firebird; druga linia trafia do /opt/fb<NN> (/opt/fb50, /opt/fb40, /opt/fb30) na porcie swojej linii: 3053 dla 3.0, 3054 dla 4.0, 3055 dla 5.0. Gdy ten port jest zajęty, instalator zatrzymuje się i prosi o --port N. Kilka instancji jednej linii (drugi Firebird 5.0 na innym porcie) instaluje się za pomocą --fb-root <new folder> --port <port> (sekcja 7). Firebird 2.5 ma tylko jedną instancję, w /opt/firebird; dla drugiego serwera obok niego użyj innej linii (na przykład Firebird 5.0 w /opt/fb50).
Szczegółowy przewodnik krok po kroku dla dwóch instancji na portach 3050 i 3051, dla każdej linii, z poleceniami do skopiowania, znajduje się w hqbird2027-linux-two-instances-runbook.ru.md (rosyjski) i hqbird2027-linux-two-instances-runbook.pt.md (portugalski).
Wersja próbna: bez licencji agent działa w trybie 7-dniowej wersji próbnej. E-mail wersji próbnej (--email) wydłuża ją do 30 dni. Plik licencji (--license) lub połączenie z Twoim HQCenter (sekcja 8) zastępuje wersję próbną.
Aktualizacje: od zestawu 2027.2.31 (agent 3.3.0) serwer, który nie jest podłączony do żadnego HQCenter, sprawdza serwer aktualizacji dostawcy. Domyślnie agent, HQ Monitor i fbmcp aktualizują się same, a nowy pakiet Firebird jest pobierany i czeka na Ciebie. --auto-update all|agent|off lub linia Updates w interfejsie tekstowym to zmienia („Updates without HQCenter" w sekcji 4). Serwer podłączony do HQCenter pobiera aktualizacje z tego HQCenter.
2. Instalacja w skrócie
Sprawdzenie serwera i sama instalacja są wykonywane przez agenta HQbird, którego instalator zawiera (fbagent --install-plan, fbagent --setup-install). Nic nie jest pobierane poza brakującymi pakietami systemowymi. Nic nie jest zmieniane przed potwierdzeniem planu: pakiety systemowe są instalowane po potwierdzeniu. W terminalu zestawy po 2027.2.30 otwierają interfejs tekstowy (krok 3 sekcji 3); --no-tui uruchamia zwykły instalator, który zadaje pytania jako linie tekstu. Bez terminala i bez --yes instalator zatrzymuje się na potwierdzeniu z kodem wyjścia 4. Jeśli instalacja nie powiedzie się przed uruchomieniem jednostki agenta, agent przywraca jednostki do stanu sprzed instalacji (kod wyjścia 2; kod 3, gdy przywracanie nie było kompletne, podsumowanie mówi, co sprawdzić).
3. Nowa instalacja
Krok 1: Pobierz instalator i sprawdź go
KIT=hqbird2027-fb50-linux-2027.2.9.run
curl -fL -O https://ib-aid.com/download/hqbird/v2027/$KIT -O https://ib-aid.com/download/hqbird/v2027/$KIT.sha256
sha256sum -c $KIT.sha256Pozostałe linie mają te same nazwy z fb40, fb30, fb25. Oczekiwany wynik: hqbird2027-fb50-linux-2027.2.9.run: OK. Serwer bez dostępu do Internetu: pobierz oba pliki na komputerze z tymi samymi linkami i skopiuj je na serwer (scp, dysk USB, udział sieciowy).
Instalator sprawdza również własny ładunek, zanim cokolwiek rozpakuje: przerwane lub uszkodzone pobranie zatrzymuje się z kodem wyjścia 5 („download it again").
Krok 2: Sprawdź host bez zmieniania go (opcjonalnie)
sudo sh hqbird2027-fb50-linux-2027.2.9.run --check--check uruchamia sprawdzenie hosta, zgłasza brakujące biblioteki systemowe (oraz polecenia, aby je uzyskać na serwerze bez dostępu do Internetu), pokazuje, co znalazł agent i co by zrobił, i kończy działanie. Nic nie jest instalowane.
Krok 3: Uruchom instalator
sudo sh hqbird2027-fb50-linux-2027.2.9.runZestawy po 2027.2.30 otwierają interfejs tekstowy, gdy uruchomisz je w terminalu: pełnoekranowe strony z planem i ustawieniami. Zestawy do 2027.2.30 oraz przypadki opisane w „The plain installer" poniżej zadają pytania jako linie tekstu. Oba wykonują tę samą instalację z tymi samymi opcjami.
Interfejs tekstowy
Instalator sprawdza host, rozpakowuje się, odczytuje plan i pokazuje pierwszą stronę. Nic na hoście nie jest zmieniane, dopóki nie rozpoczniesz instalacji na stronie Install.
HQbird 2027 setup <version> | Firebird 5.0 (5.0.5.1917)
Plan M1: New Firebird and HQbird agent
Firebird: new /opt/firebird (unit firebird, port 3050)
Agent: new, in /opt/hqbird/fbagent-fb50
OS packages to install: libtommath1 (see Plan details)
Language English (auto)
Firebird folder automatic (/opt/firebird)
Firebird port automatic (3050)
Agent id automatic (srv1261114-fb50)
SYSDBA password generated (for a new Firebird)
HQ Monitor port automatic, login admin
License not now (add it later in HQ Monitor)
HQCenter not attached
Cluster RCM off, discovery mode off
Components debug files: yes, fbmcp: yes
Updates HQbird only (recommended)
> Install
Plan details
About plans
Quit
Up/Down: move Enter: change or start Esc: quitGórne linie to plan dla bieżących ustawień: jego kod i to, co instalator zrobi z Firebird i agentem. Plan, który nie jest możliwy, jest czerwony, z podaniem przyczyny, a kursor stoi na ustawieniu, które to naprawia. Po każdej zmianie instalator ponownie odczytuje plan.
| Klawisz | Co robi |
|---|---|
| Up, Down | Przesuwa kursor (także k, j) |
| Enter | Otwiera ustawienie pod kursorem, wybiera element, akceptuje wpisaną wartość |
| Space | Włącza lub wyłącza komponent (strona Components) |
| Esc | Powrót do poprzedniej strony; na pierwszej stronie: wyjście z instalatora (najpierw pyta) |
| Ctrl+C | Natychmiast zatrzymuje instalator (kod wyjścia 2). Nic nie zostało zmienione przed stroną Install |
Na stronie, na której wpisujesz wartość (folder, port, adres), Enter ją akceptuje, a pusta wartość oznacza „automatic". Esc nie opuszcza takiej strony.
| Ustawienie | Co wybierasz | To samo co opcja |
|---|---|---|
| Language | English, Russian, Brazilian Portuguese, German; strony zmieniają się natychmiast | --lang |
| Firebird folder | Folder nowego Firebird lub Firebird do aktualizacji. Firebird 2.5 ma jeden folder, więc jego instalator nie ma tej linii | --fb-root |
| Firebird port | Port TCP Firebird | --port |
| Agent id | Automatic, nazwa hosta, nazwa hosta i instancja lub własna wartość. Tylko dla nowego agenta: zainstalowany agent zachowuje swój identyfikator, a linia nie jest wyświetlana | --agent-id |
| SYSDBA password | Dla nowego Firebird: wygenerowane lub własne | --sysdba-pass-file |
| HQ Monitor | Port i logowanie do konsoli webowej | --hqmonitor-port, --hqmonitor-login, --hqmonitor-password-file |
| License | Not now, 30-dniowa wersja próbna przez e-mail (adres, informacja o prywatności, strefa) lub plik licencji | --email --accept-privacy --trial-zone, --license |
| HQCenter | Plik attach.json Twojego HQCenter |
--attach |
| Cluster | Menedżer klastra RCM (identyfikator klastra, hasło administratora), tryb wykrywania, port parowania | --rcm, --cluster-id, --rcm-password-file, --cluster-pairing, --pairing-port |
| Components | Pliki debugowania Firebird; fbmcp i adresy jego trybu zdalnego | --no-debug, --no-fbmcp, --fbmcp-allow-from |
| Aktualizacje | Tylko HQbird (agent, HQ Monitor i fbmcp aktualizują się same, nowy Firebird czeka na Ciebie), HQbird i Firebird (Firebird również aktualizuje się sam, w nocy od 03:30 do 04:00, z restartem Firebird) lub Wyłączone. Zestawy od 2027.2.31; tylko dla nowego agenta bez pliku attach.json: HQCenter kontroluje aktualizacje dołączonego agenta | --auto-update |
Opcje w wierszu poleceń to wartości, z którymi startują strony:
sudo sh hqbird2027-fb50-linux-<ver>.run --rcm on --port 3055 otwiera
pierwszą stronę z włączonym RCM i portem 3055.
Cztery wiersze pod ustawieniami:
- Install pokazuje plan w całości, a następnie pyta
Start the install now?z kursorem na Nie. Pytania planu (starszy HQbird, działający Firebird do zatrzymania) są na tej samej stronie: Tak odpowiada na nie wszystkie. Po Tak strony się zamykają, a instalacja wypisuje swój log i podsumowanie na normalnym ekranie, jak w instalatorze zwykłym poniżej. - Plan details pokazuje, co oznacza kod planu, co instalator znalazł na hoście, ostrzeżenia i pakiety systemowe, które zainstaluje.
- About plans wyświetla listę wszystkich kodów (M1 … M17). Enter na kodzie wyjaśnia
go.
*oznacza kod bieżącego planu. - Quit opuszcza instalator (kod wyjścia 1). Nic nie zostało zmienione.
Instalator zwykły
Instalator zwykły uruchamia się, gdy spełniony jest jeden z tych warunków:
- opcja
--no-tuilub zmiennaHQBIRD_NO_TUI=1; --yes,--check,--uninstall,--extract,--plan-help,--help;- stdin lub stdout nie jest terminalem: skrypt,
ssh host 'command'bez terminala lub potok taki jak... 2>&1 | tee install.log; TERMma wartośćdumblub nie jest ustawiona;- okno jest mniejsze niż 80 kolumn na 24 wiersze (wewnątrz
tmuxz jego linią statusu terminal 80x24 ma 23 wiersze: powiększ okno lub użyj--no-tui); - bash na hoście jest starszy niż 4.4 (RHEL 7, CentOS 7);
- zestaw ma wersję 2027.2.30 lub starszą.
W przypadku okna i basha pierwszy wiersz wyjścia mówi, dlaczego strony się nie otworzyły.
Typowe uruchomienie instalatora zwykłego na serwerze bez Firebird:
[install] HQbird 2027 setup 2027.2.9, Firebird 5.0 (5.0.5.1916)
[install] host: Ubuntu 24.04.5 LTS, kernel 6.8.0-142-generic
[install] checking the payload (sha256) ...
[install] unpacking into /var/tmp/hqbird2027.k3Qf1x ...
[install] OS libraries missing: libtommath.so.1 (packages: libtommath1)
[install] plan M1: Firebird new /opt/firebird (unit firebird, port 3050)
[install] agent new in /opt/hqbird/fbagent-fb50 (unit hqbirdfbagent-fb50), HQ Monitor hqbirdmonitor-fb50
[install] OS packages to install: libtommath1
[install] Install as planned? Yes/No y
[install] installing from the package repository: libtommath1
[install] OS libraries: installed
[install] installing (fbagent --setup-install; log /var/log/fbagent/install.log) ...
...
Done: agent hqbirdfbagent-fb50 in /opt/hqbird/fbagent-fb50, Firebird 5.0.5.1916 in /opt/firebird (port 3050).
HQ Monitor: http://localhost:23050/ (login admin; password in /opt/hqbird/conf/access.properties)
[install] done. Uninstall: sudo sh hqbird2027-fb50-linux-2027.2.9.run --uninstallTen przykład pochodzi z zestawu 2027.2.9. Od zestawu 2027.2.19 podsumowanie zawiera także
wiersze RCM: i Pairing: konsoli klastra (“Next: cluster”
poniżej). W przypadku agenta 3.1.0 i nowszego oraz braku wybranego klastra są to:
RCM: off; turn it on in HQbird Monitor or with fbagent --cluster-init <id>
Pairing: off; turn it on in HQbird Monitor or with fbagent --cluster-pairing on (port 7450)Co oznaczają te wiersze:
- host: dystrybucja i jądro; instalator odrzuca host, który nie jest x86_64, nie ma systemd lub działa na jądrze starszym niż 3.2.
- OS libraries: czego Firebird tej linii potrzebuje od systemu
(sekcja 9). Plan wymienia brakujące pakiety (
OS packages to install); po potwierdzeniu instalator pobiera je z repozytorium dystrybucji. Bez repozytorium zatrzymuje się z kodem wyjścia 6 i wypisuje polecenia. - plan: co znalazł agent (wiersze
found Firebird ...,HQbird: ...) i co zrobi:Firebird new(nowy serwer),update(Firebird tej linii jest aktualizowany w miejscu) lub odmowa z podaniem powodu (kod wyjścia 1, nic nie zmieniono). - Install as planned? Yes/No: ostatnie pytanie, zanim cokolwiek zostanie
zmienione. Odpowiedz
y. Gdy plan ma własne pytania (starszy HQbird, inna wersja), pojawiają się one zamiast tego (sekcja 5). Bez terminala podaj--yes; w przeciwnym razie instalator zatrzymuje się z kodem wyjścia 4. - Pytania o klaster (agent 3.1.0 i nowszy):
Install the cluster manager (RCM) on this host and make a new cluster? [y/N]orazTurn on discovery mode for 24 hours (an RCM on the network may invite this agent into its cluster; port 7450)? [y/N]. Domyślnie jest Nie. Pierwsze jest zadawane tylko wtedy, gdy host nie ma RCM, a agent nie należy do żadnego klastra; drugie nie jest zadawane, gdy agent należy do klastra lub uruchamia RCM.--yesi uruchomienie bez terminala odpowiadają Nie (bez kodu wyjścia 4). - HQ Monitor: adres i login. Nowa instalacja otrzymuje
login
admin; jego wygenerowane hasło znajduje się w/opt/hqbird/conf/access.properties(uprawnienia 0600, czytelny tylko dlarooti agenta). Wszystkie instancje HQbird 2027 na hoście współdzielą ten plik. Zmień hasło w HQ Monitor.
Hasło SYSDBA nowego Firebird jest generowane i zapisywane w
/root/fbagent-install-sysdba.txt (uprawnienia 0600): wiersz komentarza, a następnie wiersz
SYSDBA_PASS=<password>. Kolejny Firebird zainstalowany później na tym samym hoście
otrzymuje to samo hasło z tego pliku. Aby ustawić własne, podaj
--sysdba-pass-file <file> (pierwszy wiersz pliku) lub --sysdba-pass <password>.
Język instalatora
Zestawy po 2027.2.30 obsługują cztery języki: angielski, rosyjski (ru),
brazylijski portugalski (pt-BR) i niemiecki (de). Instalator wybiera
język w tej kolejności:
- opcja
--lang en|ru|pt-BR|de; - zmienna
HQBIRD_LANG; - locale konsoli (
LC_ALL, następnieLC_MESSAGES, następnieLANG), gdy jest to locale UTF-8; - angielski.
Drugi wiersz wyjścia mówi, jaki to język i jak go zmienić. Ten wiersz jest zawsze po angielsku:
[install] Language: Русский (auto). Use --lang en to change.Uwagi:
- PuTTY nie wysyła
LANGdo serwera. Liczy się locale samego serwera, więc językiem często jest angielski. Użyj--lang. - Z
--yesi bez terminala automatycznym językiem jest angielski: skrypty czytają to wyjście.--langnadal tam działa. - Instalator potrzebuje locale UTF-8 na hoście dla pozostałych języków
(
C.UTF-8luben_US.UTF-8). Ustawia je dla siebie. Bez niego mówi po angielsku. - W interfejsie tekstowym wiersz Language na pierwszej stronie zmienia język od razu. Terminal musi wyświetlać UTF-8 (PuTTY: Window, Translation, Remote character set UTF-8, co jest jego domyślnym ustawieniem).
- Angielski pozostaje w: wierszach postępu samej instalacji, podsumowaniu
Done:,/var/log/fbagent/install.logoraz ostrzeżeniach skanowania hosta.
Kod planu
Plan ma kod: M1, M2, … Nazywa przypadek, który instalator znalazł
na hoście. Instalator wypisuje, co oznacza kod:
[install] plan M1: New Firebird and HQbird agent
[install] This host has no Firebird and no older HQbird. Setup installs a new Firebird and a new HQbird agent.
[install] plan M1: Firebird new /opt/firebird (unit firebird, port 3050)--plan-help wypisuje wszystkie kody i kończy działanie. Nic nie zmienia. W
interfejsie tekstowym pierwsza strona pokazuje kod i jego tytuł, “Plan details”
pokazuje tekst, a “About plans” wyświetla listę wszystkich kodów.
| Kod | Co znalazł instalator | Firebird | Agent | Starszy HQbird |
|---|---|---|---|---|
| M1 | nic | nowy | nowy | — |
| M2 | Firebird tej linii, brak starszego HQbird | aktualizacja | nowy | — |
| M3 | Firebird innej linii, brak starszego HQbird | nowy, port 305N | nowy | — |
| M4 | starszy HQbird obsługujący Firebird tej linii | aktualizacja | nowy | wyłączony, jego zadania zaimportowane jako włączone |
| M5 | starszy HQbird innej linii; Firebird tej linii jest obecny | aktualizacja, po pytaniu | nowy | działa dalej |
| M6 | starszy HQbird innej linii; brak Firebird tej linii | nowy, po pytaniu | nowy | działa dalej |
| M7 | starszy HQbird bez lokalnego Firebird znanej wersji | aktualizacja lub nowy | nowy | działa dalej, ostrzeżenie |
| M8 | agent HQbird 2027 dla innego Firebird | aktualizacja lub nowy | nowy, obok pierwszego | niezmieniony |
| M9 | jak M8, a starszy HQbird obsługuje tę linię | aktualizacja | nowy, obok pierwszego | wyłączony, jego zadania zaimportowane jako włączone |
| M10 | agent już obsługuje tego Firebird (ponowne uruchomienie) | aktualizacja | w miejscu | wyłączony, gdy działa |
| M11 | --fb-root to Firebird tej linii |
aktualizacja | nowy lub w miejscu | jak wyżej |
| M13 | --fb-root to pusty lub nowy folder |
nowy w tym folderze | nowy | jak wyżej |
Kody odmowy (kod wyjścia 1, nic nie zmieniono): M12 folder zawiera
Firebird, którego instalator nie może zaktualizować (inna linia, wersja, której nie może
odczytać, wyłączona usługa); M14 folder nie jest pusty i nie zawiera
Firebird; M16 kilka serwerów Firebird tej linii, podaj --fb-root;
M17 Firebird 2.5 działa tylko w /opt/firebird. M15 to
zestaw tylko z agentem: Firebird nie jest instalowany ani aktualizowany.
Identyfikator agenta
Identyfikator agenta nazywa agenta w HQCenter, w licencji i w klastrze. Jest ustawiany tylko przy pierwszej instalacji:
- Domyślnie: nazwa hosta + data + instancja, na przykład
srv1261114-fb50. --agent-id IDpodaje własny identyfikator (1-128 liter, cyfr,.,_lub-; pierwszy znak to litera lub cyfra).- Instalator odrzuca identyfikator, który ma inny agent hosta.
- W interfejsie tekstowym strona Agent id oferuje identyfikator automatyczny, nazwę hosta, nazwę hosta z instancją oraz własną wartość, i wyświetla listę identyfikatorów, które host już ma.
- Zainstalowany agent zachowuje swój identyfikator. Ponowne uruchomienie pokazuje go w planie
(
id srv1 (kept)), interfejs tekstowy nie ma wtedy wiersza Agent id, a--agent-iddaje tam tylko ostrzeżenie. Nowy agent w folderze, który wcześniejsza instalacja pozostawiła z jego konfiguracją, również zachowuje identyfikator tej konfiguracji.
Krok 4: Sprawdź wynik
systemctl status firebird hqbirdfbagent-fb50 hqbirdmonitor-fb50 --no-pager
ss -ltnp | grep -E ':3050|:23050'
ISC_PASSWORD="$(sed -n 's/^SYSDBA_PASS=//p' /root/fbagent-install-sysdba.txt)" \
/opt/firebird/bin/isql -user SYSDBA localhost/3050:/opt/firebird/examples/empbuild/employee.fdbUżyj pełnej ścieżki bazy przykładowej: działa dla każdej linii i także
po aktualizacji, podczas gdy zachowany databases.conf starszej instalacji może
nie mieć aliasu employee (nowa instalacja 2027.2.3 go ma).
Otwórz http://<server>:23050/ w przeglądarce i zaloguj się jako admin z
hasłem z /opt/hqbird/conf/access.properties. Port Firebird i
port HQ Monitor są otwierane w firewalld (strefa public), gdy działa,
w przeciwnym razie w ufw, gdy jest aktywny; przy innym firewallu otwórz je samodzielnie.
Porty klastra są otwierane tylko dla opcji klastra: 7443, 7444 i port
węzła z --rcm on; port węzła i port parowania z
--cluster-pairing on. Bez aktywnego firewalla instalator wypisuje jeden
wiersz z portami, których nie otworzył. Port, który był otwarty przed
instalacją, pozostaje bez zmian.
Dalej: klaster
Aby replikować bazy danych z serwera głównego do serwera repliki, połącz
dwa serwery w konsoli klastra RCM. W przypadku agenta 3.1.0 i nowszego
zainstaluj RCM tylko na serwerze głównym (--rcm on lub odpowiedz y) i włącz
tryb odkrywania na replice (--cluster-pairing on). Tryb odkrywania otwiera
okno parowania na 24 godziny: port parowania slotu agenta (7450
dla pierwszej instancji, 7451 dla drugiej, aż do 7459) jest otwarty w
firewallu, a RCM może zaprosić agenta. Jeden host ma jeden RCM (porty 7443
i 7444); agent, który go utworzył, uruchamia go i nie otwiera okna parowania.
Później, bez instalatora: HQ Monitor → Clusters → Cluster on this
server, lub fbagent --cluster-init <id> i fbagent --cluster-pairing on. Zestawy od 2027.2.19 ze starszym agentem uruchamiają RCM na każdym serwerze i
wypisują jego adres w wierszu RCM: podsumowania; instalacja sprzed
2027.2.19 otrzymuje RCM, gdy zaktualizujesz ją nowszym zestawem (sekcja 6).
Przewodnik po klastrze (dla zestawu 2027.2.33) prowadzi krok
po kroku od dwóch nowych serwerów do działającej repliki, ze zrzutami ekranu:
Linux cluster guide
(także po rosyjsku i
portugalsku). Te same kroki
tylko jako polecenia:
hqbird2027-linux-cluster-runbook.md
(hqbird2027-linux-cluster-runbook.ru.md,
hqbird2027-linux-cluster-runbook.pt.md).
4. Po instalacji
Unity
| Unit | Co | Uruchamiane jako |
|---|---|---|
firebird (2.5, 4.0, 5.0 w /opt/firebird); firebird-superserver (3.0 w /opt/firebird); dla innego folderu nazwa folderu z / → _: firebird.opt_fb50, firebird.opt_fb40-2 (4.0, 5.0 w /opt/fb50, /opt/fb40-2), firebird.opt_fb30-superserver (3.0 w /opt/fb30) |
Serwer Firebird | firebird |
hqbirdfbagent-fb50 (druga instancja hqbirdfbagent-fb50-2; przed 2027.2.9 hqbirdfbagent-p<port Firebird>) |
Agent HQbird | firebird |
hqbirdmonitor-fb50 (hqbirdmonitor-fb50-2; przed 2027.2.9 hqbirdmonitor-p<port Firebird>) |
HQ Monitor | firebird |
Wszystkie trzy są włączone i uruchamiają się przy starcie. journalctl -u hqbirdfbagent-fb50
pokazuje dziennik unitu agenta. Firebird 3.0 ma także unity
firebird-classic.socket i [email protected]
(firebird.opt_fb30-classic.* w innym folderze), a Firebird 2.5 ma
firebird.socket: pozostają inactive, to jest normalne. Proces Firebird 2.5
to fb_smp_server (SuperClassic).
Gdzie są pliki
Przykład dotyczy pierwszej instancji Firebird 5.0 w /opt/firebird na porcie
3050. Druga instancja linii ma -2 w nazwach agenta
(fbagent-fb50-2, hqbirdfbagent-fb50-2, hqbirdmonitor-fb50-2).
Instancje zainstalowane przed 2027.2.9 mają port w tych nazwach
(fbagent-p3050, hqbirdfbagent-p3050, hqbirdmonitor-p3050).
/opt/firebird/ Firebird 5.0 server: bin/, lib/, plugins/, firebird.conf,
databases.conf, security5.fdb, *.debug files (symbols)
/opt/fb50/ a Firebird 5.0 next to another line (/opt/fb40, /opt/fb30)
/opt/hqbird/ root of the HQbird agents
conf/access.properties HQ Monitor sign-in, shared by all instances of the host (0600)
fbagent-fb50/ HQbird agent of this Firebird
fbagent the agent (unit hqbirdfbagent-fb50)
hqmonitor HQ Monitor (unit hqbirdmonitor-fb50)
agent_config.json agent configuration (encrypted secrets: config_secret.key)
config.properties HQ Monitor configuration
hqbird2027-firebird.json the Firebird this installer installed
hqbird2027-hqmonitor-firewall.json the HQ Monitor port this installer opened in firewalld or ufw
conf/ trace and job settings
logs/ agent log (firebird-agent_<date>.jsonl), license_state.json;
journal.log and server_status.json after the first checks
bak/ backups of the configuration
outcoming/ status reports for HQCenter
update/ update cache: hqmonitor/, hqclusternode/, hqbirdrcm/
certs/ certificates after the attach to HQCenter
fbagent-hqbird-takeover.json state of the older HQbird units before the takeover (section 5)
/opt/hqbirdrcm/ the cluster console RCM (unit hqbirdrcm, owner firebird):
with agent 3.1.0 only after --rcm on (or HQ Monitor);
kits 2027.2.19+ with an older agent: unless --rcm off
/opt/hqclusternode/ the cluster node (owner firebird), empty until the host is
linked in RCM or HQCenter adds it to a cluster
/var/lib/hqmonitor/<server id>/ HQ Monitor data
/var/log/fbagent/install.log log of the installer's steps (passwords are hidden)
/root/fbagent-install-sysdba.txt SYSDBA password of a new Firebird (root only, 0600)
/etc/sysctl.d/90-hqbird-firebird.conf kernel settings for Firebird (vm.max_map_count), only when
the system value is lower (Ubuntu 24.04 needs none)
/etc/sudoers.d/ the agent's sudoers rules for its root helpers (updates, HQ Monitor)Instalator nie pozostawia niczego w /var/tmp: jego folder roboczy
/var/tmp/hqbird2027.XXXXXX jest usuwany na końcu, także po błędzie.
Dzienniki
| Dziennik | Gdzie |
|---|---|
| Instalator | terminal; /var/log/fbagent/install.log |
| Agent | /opt/hqbird/fbagent-fb50/logs/firebird-agent_<date>.jsonl, journal.log; journalctl -u hqbirdfbagent-fb50 |
| HQ Monitor | journalctl -u hqbirdmonitor-fb50; dziennik audytu /opt/hqbird/fbagent-fb50/hqmonitor_audit.log |
| Firebird | /opt/firebird/firebird.log |
Aktualizacje bez HQCenter
Od zestawu 2027.2.31 (agent 3.3.0) agent, który nie jest podłączony do żadnego HQCenter,
pobiera nowe wersje z serwera aktualizacji dostawcy. Tryb aktualizacji to
klucz update.mode w agent_config.json:
| Tryb | Co aktualizuje się samo |
|---|---|
agent (domyślnie) |
Agent, HQ Monitor i fbmcp. Nowy pakiet Firebird jest pobierany i czeka na administratora |
all |
To samo, a także Firebird, w jego oknie stosowania (w nocy od 03:30 do 04:00; aktualizacja restartuje Firebird) |
off |
Nic: agent nie sprawdza aktualizacji. Aby zaktualizować, uruchom instalator nowej wersji (sekcja 6) |
- Przy instalacji: wiersz Updates w interfejsie tekstowym lub
--auto-update all|agent|off. Bez nich instalator nie zmienia trybu. - Później: strona Updates w HQ Monitor lub ponownie instalator z
--auto-update <mode>. - Stan:
sudo /opt/hqbird/fbagent-fb50/fbagent --update-status(dodaj--jsondla skryptu). Wypisuje źródło wydania, strefę i ostatnią odpowiedź serwera aktualizacji.
Agent otwiera wychodzące połączenia HTTPS tylko do tych adresów. Nie jest potrzebny żaden port przychodzący.
| Cel | Adres |
|---|---|
| Aktualizacje, strefa EU | liceu.ibsurgeon.com:9443 |
| Aktualizacje, strefa BR | licbr.ibsurgeon.com:9443 |
| Aktualizacje, strefa RU | licru.ibsurgeon.com:20943 |
| Licencja próbna | trialeu.ibsurgeon.com:9443, trialbr.ibsurgeon.com:19443, trialru.ibsurgeon.com:23943 |
Serwer podłączony do HQCenter nie używa adresów aktualizacji: pobiera aktualizacje z tego HQCenter (sekcja 8).
Powiadomienia
Od zestawu 2027.2.33 (agent 3.4.0) agent wysyła komunikaty o problemach
serwera do własnego bota Telegram, webhooka lub e-maila (SMTP). Instalator
nie ustawia żadnego kanału i nic nie jest wysyłane, dopóki go nie dodasz: HQ
Monitor → Servers → Notifications. Aby przetestować kanał z
wiersza poleceń: sudo -u firebird /opt/hqbird/fbagent-fb50/fbagent --notify-test <channel>; --notify-history wypisuje ostatnie dostarczenia.
5. Aktualizacja starszego HQbird (2024 i wcześniejsze)
Instalator znajduje zainstalowany HQbird (FBDataGuard) w /opt/hqbird i
jego unity oraz zarządzane przez niego serwery Firebird. Następnie stosuje te same
zasady co skrypty instalacyjne HQbird:
Co widzisz na terminalu:
[install] found Firebird 5.0.5.1878: /opt/firebird, port 3050, unit firebird, no agent
[install] plan M4: Firebird update /opt/firebird (unit firebird, port 3050)
[install] agent new in /opt/hqbird/fbagent-fb50 (unit hqbirdfbagent-fb50), HQ Monitor hqbirdmonitor-fb50
[install] HQbird services to turn off: hqbird
[install] Firebird 5.0.5.1878: unit firebird, port 3050, 0 TCP connections
[install] Confirm to stop running Firebird 5.0.5.1878? Yes/No y- Plan wskazuje Firebird, który jest aktualizowany;
--fb-rooti--portnie mogą go przenieść (jego unit jest zajęty). - Pytanie Confirm to stop running Firebird? jest zadawane, gdy
silnik musi zostać zatrzymany; wiersz przed nim pokazuje otwarte połączenia.
Another versionjest pytaniem, gdy starszy HQbird zarządza Firebirdem innej wersji (zaktualizuj tamten lub nowy obok niego).--yesodpowiada Yes na wszystkie pytania; bez terminala i bez--yesinstalator zatrzymuje się z kodem wyjścia 4 i niczego nie zmienia. --disable-hqbirdw każdym przypadku wyłącza unity starszego HQbird;--no-hqbirdpozostawia starszy HQbird w spokoju (dalej działa obok HQbird 2027).- Hasło SYSDBA nie jest pytane: agent pobiera je ze starszego HQbird.
- HQ Monitor używa logowania starszego HQbird: jego plik
/opt/hqbird/conf/access.propertiesjest zachowywany, więc zaloguj się loginem i hasłem, których używałeś wcześniej. Instalator przekazuje plik użytkownikowifirebirdz uprawnieniami 0600 (starszy HQbird pozostawiał go czytelnym dla każdego użytkownika). Logowanie gościa starszego HQbird (access.guest-login) nie jest używane przez HQ Monitor.
Co jest zachowywane: firebird.conf, databases.conf / aliases.conf,
baza bezpieczeństwa, hasło SYSDBA, bazy danych, kopie zapasowe i
pliki starszego HQbird. Aktualizacja zastępuje pliki programu Firebird
w miejscu; pliki, które zastąpiła, są zachowywane w
/opt/fbagent-update-backup/<folder name>-<id>/<time>_<old version>_to_<new version>/
(dwie najnowsze aktualizacje pozostają). Zadania HQbird (kopie zapasowe, sweepy, monitorowanie)
są importowane do nowego agenta. Licencja HQbird starszego HQbird nie jest
przenoszona: nowy agent działa na licencji próbnej, dopóki nie zostanie zainstalowana licencja
lub serwer nie zostanie podłączony do Twojego HQCenter.
Od zestawu 2027.2.33 (agent 3.4.0) import konfiguracji starszego HQbird robi jeszcze dwie rzeczy:
- Rejestruje bazy danych starszego HQbird w pliku aliasów Firebird
(
databases.conflubaliases.confdla 2.5) jako wierszename = path. Stary plik jest najpierw kopiowany. Baza danych jest pomijana, gdy jej ścieżka już jest w pliku lub gdy jej plik nie istnieje. Plik z dyrektywąincludenie jest zmieniany. - Usuwa stare dzienniki monitorowania starszego HQbird: zawartość
folderów
mon/outcomingimon/outtracejego folderu wyjściowego (foldery pozostają). Nic nie jest usuwane, dopóki działa usługa starszego HQbird. Usunięcia nie można cofnąć: jeśli potrzebujesz tych dzienników, skopiuj je przed instalacją.
Oba są domyślnie włączone. Klucze hqbird_import.register_databases i
hqbird_import.clean_mon_logs w agent_config.json (oba są w
edytorze konfiguracji HQ Monitor) wyłączają je dla późniejszego importu; instalator
nie ma dla nich opcji.
Stan unitów starszego HQbird przed przejęciem jest zapisany w
/opt/hqbird/fbagent-hqbird-takeover.json. --uninstall nie włącza
ich ponownie.
Forma nieobsługiwana:
sudo sh hqbird2027-fb50-linux-2027.2.9.run --yes --disable-hqbird6. Aktualizacja HQbird 2027 do nowej wersji
Nowszy instalator tej samej linii, uruchomiony na hoście z HQbird 2027, aktualizuje zainstalowaną instancję w miejscu: Firebird, pliki debug, agenta i HQ Monitor. Konfiguracja, bazy danych, stan licencji próbnej lub licencji, port HQ Monitor i dane logowania są zachowywane.
sudo sh hqbird2027-fb50-linux-2027.2.9.runW interfejsie tekstowym pierwsza strona pokazuje Plan M10: Update of an installed HQbird 2027, agenta z jego id (kept) i brak wiersza Agent id; Install
uruchamia aktualizację. Zwykły instalator wypisuje:
[install] HQbird 2027 setup 2027.2.9, Firebird 5.0 (5.0.5.1916)
[install] found Firebird 5.0.5.1880: /opt/firebird, port 3050, unit firebird, agent hqbirdfbagent-p3050
[install] plan M10: Firebird update /opt/firebird (unit firebird, port 3050)
[install] agent in_place in /opt/hqbird/fbagent-p3050 (unit hqbirdfbagent-p3050), HQ Monitor hqbirdmonitor-p3050
[install] Firebird 5.0.5.1880: unit firebird, port 3050, 2 TCP connections
[install] Confirm to stop running Firebird 5.0.5.1880? Yes/No y
...
Firebird updated: 5.0.5.1880 -> 5.0.5.1916
HQ Monitor updated 1.31.0 -> 1.33.0 (...)
Done: agent hqbirdfbagent-p3050 in /opt/hqbird/fbagent-p3050, Firebird 5.0.5.1916 in /opt/firebird (port 3050).Aktualizacja nie zmienia nazw folderu agenta ani unitów: instancja
w tym przykładzie została zainstalowana przed 2027.2.9 i zachowuje
fbagent-p3050.
Gdy kompilacja Firebird w instalatorze jest tą już zainstalowaną (na
przykład Firebird 2.5.9.27194 w każdym HQbird 2027 dla 2.5), aktualizowane są
tylko agent i HQ Monitor: Firebird nie jest zatrzymywany i nie pojawia się
pytanie Potwierdzić zatrzymanie.
Zachowany databases.conf instancji zainstalowanej przez starszy HQbird 2027
może nie mieć aliasu employee; połącz się z bazą przykładową przez jej pełną
ścieżkę (sekcja 3, krok 4). W Firebird 3.0 aktualizacja z 2027.2.0 pozostawia
/opt/firebird/examples/empbuild/employee.fdb z uprawnieniami 0444, a Firebird
nie może jej otworzyć (no permission for read-write access); jeśli
potrzebujesz bazy przykładowej: sudo chmod 660 /opt/firebird/examples/empbuild/employee.fdb.
Twoje własne bazy nie są naruszane.
- Przy kilku instancjach tej linii wskaż tę do aktualizacji:
--fb-root /opt/fb50-2 --port 3056. - Ponowne uruchomienie tego samego instalatora na zainstalowanej wersji to naprawa: pliki programu i unity są zapisywane ponownie, dane pozostają.
- Po połączeniu z HQCenter (sekcja 8) agent, HQ Monitor, Firebird i komponenty klastra są aktualizowane z katalogu HQCenter; nowy instalator nie jest wtedy potrzebny.
- Serwer nieprzypisany do żadnego HQCenter z agentem 3.3.0 lub nowszym (kity z
2027.2.31) samodzielnie aktualizuje agenta, HQ Monitor i fbmcp, chyba że
tryb aktualizacji to
off(“Aktualizacje bez HQCenter” w sekcji 4). Instalacja wykonana przed 2027.2.31 otrzymuje to po jednej aktualizacji nowszym instalatorem. Aktualizacja instalatorem zachowuje tryb aktualizacji;--auto-update <mode>go zmienia.
7. Polecenia konserwacyjne
Każda czynność konserwacyjna to uruchomienie instalatora z opcjami albo
polecenie agenta w folderze agenta. W terminalu uruchomienie bez --yes otwiera
interfejs tekstowy z tymi opcjami już ustawionymi (kity po 2027.2.30):
sprawdź plan na pierwszej stronie, a następnie wybierz Install.
| Czynność | Polecenie |
|---|---|
| Kolejna instancja tej linii | sudo sh hqbird2027-fb50-linux-<ver>.run --fb-root /opt/fb50-2 --port 3056 |
| Naprawa / aktualizacja | sudo sh hqbird2027-fb50-linux-<ver>.run (przy kilku instancjach: --fb-root <folder> --port <port>) |
| Przypisanie do HQCenter | sudo sh hqbird2027-fb50-linux-<ver>.run --attach attach.json podczas instalacji lub później cd /opt/hqbird/fbagent-fb50 && sudo ./fbagent --attach --file /path/attach.json |
| Wysłanie e-maila próbnego | cd /opt/hqbird/fbagent-fb50 && sudo -u firebird ./fbagent --trial-email [email protected] --accept-privacy |
| Potwierdzenie kodu próbnego z maila | cd /opt/hqbird/fbagent-fb50 && sudo -u firebird ./fbagent --trial-confirm <code> (lub w HQ Monitor) |
| Instalacja pliku licencji | --license <file> podczas instalacji lub cd /opt/hqbird/fbagent-fb50 && sudo -u firebird ./fbagent --license-install /path/license.json |
| Stan instalacji | sudo /opt/hqbird/fbagent-fb50/fbagent --install-state --json |
| Stan aktualizacji (bez HQCenter) | sudo /opt/hqbird/fbagent-fb50/fbagent --update-status |
| Zmiana trybu aktualizacji (bez HQCenter) | HQ Monitor, strona Updates; lub sudo sh hqbird2027-fb50-linux-<ver>.run --auto-update all|agent|off |
| Usunięcie | sudo sh hqbird2027-fb50-linux-<ver>.run --uninstall [--remove-data] [--force] [--agent-dir /opt/hqbird/fbagent-fb50] |
Kolejna instancja
sudo sh hqbird2027-fb50-linux-2027.2.9.run --fb-root /opt/fb50-2 --port 3056Nowy Firebird trafia do /opt/fb50-2 (nowy lub pusty folder), unit
firebird.opt_fb50-2, z własnym agentem (/opt/hqbird/fbagent-fb50-2, unit
hqbirdfbagent-fb50-2) i własnym HQ Monitor (http://localhost:23056/,
unit hqbirdmonitor-fb50-2). Agent otrzymuje najniższy wolny numer
linii: fb50-2 dla drugiej instancji, także obok agenta zainstalowanego
przed 2027.2.9 (fbagent-p3050). Plik logowania HQ Monitor
/opt/hqbird/conf/access.properties jest współdzielony przez instancje hosta:
nowa instancja bez --hqmonitor-login zachowuje istniejące logowanie, a
--hqmonitor-login/--hqmonitor-password-file na dowolnej instancji zmieniają
logowanie wszystkich z nich (stary plik jest zachowywany jako
access.properties.bak-<time>). Firebird 2.5 nie obsługuje drugiej
instancji: instalator zatrzymuje się z refused (M17): Firebird 2.5 works only in /opt/firebird, not in <folder> (kod wyjścia 1, nic nie zostało zmienione). Zainstaluj
Firebird innej linii obok, na przykład
sudo sh hqbird2027-fb50-linux-<ver>.run --fb-root /opt/fb50 --port 3051.
Usunięcie
Usunięcie w Windows i Linux, serwery w klastrze i to, co pozostaje na dysku, opisano w pełni w przewodniku usuwania. W skrócie:
# the agent and HQ Monitor of this instance; Firebird, the databases, configs and logs stay
sudo sh hqbird2027-fb50-linux-2027.2.9.run --uninstall
# the same, and the agent's configuration, logs, license state and HQ Monitor data too
sudo sh hqbird2027-fb50-linux-2027.2.9.run --uninstall --remove-dataBez --agent-dir instalator usuwa jedynego agenta w
/opt/hqbird. Przy kilku agentach na hoście zatrzymuje się (kod wyjścia 1),
wymienia ich foldery i prosi o --agent-dir:
sudo sh hqbird2027-fb50-linux-2027.2.9.run --uninstall --agent-dir /opt/hqbird/fbagent-fb50-2--uninstall zatrzymuje i usuwa unity agenta i jego HQ Monitor
(hqbirdfbagent-fb50, hqbirdmonitor-fb50), reguły sudoers agenta i jego programów
(fbagent, hqmonitor) oraz zamyka port HQ Monitor, który
instalacja otworzyła w firewalld lub ufw. Folder agenta pozostaje z konfiguracją i
logami; --remove-data usuwa także folder i dane HQ Monitor w
/var/lib/hqmonitor/. Firebird pozostaje zainstalowany (unit, folder
programu, bazy danych); starsze unity HQbird, które zostały wyłączone, pozostają wyłączone.
Przy kilku agentach na hoście współdzielony plik logowania HQ Monitor pozostaje
do usunięcia ostatniego agenta.
Jeśli agent uruchamia RCM hosta i inne agenty używają tego RCM,
--uninstall odmawia z kodem wyjścia 5 i niczego nie zmienia:
this agent runs the RCM of the host, and other agents use it: remove the cluster in the RCM console, or run again with --force. --force usuwa
agenta mimo to; klaster traci wtedy swoje CA (brak nowych certyfikatów, brak nowych
członków). Unit RCM pozostaje, dopóki inne agenty hosta go używają. Aby uczynić
innego agenta właścicielem nowego RCM, gdy stary właściciel zniknął:
fbagent --cluster-init <id> --rcm-takeover (nowe CA: połącz członków
ponownie).
Wskazówka na końcu instalacji (Uninstall: sudo sh ... --uninstall)
nie ma --agent-dir: przy kilku instancjach dodaj go, jak pokazano powyżej.
Aby usunąć także Firebird instancji (instalator tego nie robi;
najpierw wykonaj kopie zapasowe gbak jej baz danych), na przykład 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 $B8. Przypisanie do HQCenter
HQCenter to centralny serwer Twojej firmy, który zarządza agentami HQbird: licencjami, konfiguracją, aktualizacjami, przeglądem kopii zapasowych. Bez HQCenter agent działa samodzielnie z wersjami instalatora i plikiem próbnym lub licencyjnym.
- W panelu administracyjnym HQCenter otwórz Tokens
(
https://<hqcenter>:8443/admin/tokens). W formularzu Install script wybierz licencję (lub żadną), tryb, liczbę serwerów i ważność (od 1 do 365 dni); pola platformy i Firebird nie są używane. Kliknij Download connection file i zapiszattach.json. Plik zawiera tajny token: przechowuj go bezpiecznie (chmod 600), usuń go po użyciu i unieważnij token na liście na tej samej stronie. Formularz jest pokazywany tylko gdy ustawionoadmin_panel.install_script_url. - Skopiuj
attach.jsonna serwer. - Przypisz na jeden z dwóch sposobów:
# during the installation
sudo sh hqbird2027-fb50-linux-2027.2.9.run --yes --attach /root/attach.json
# later, for an installed agent
cd /opt/hqbird/fbagent-fb50 && sudo ./fbagent --attach --file /root/attach.jsonZe zwykłym tokenem polecenie czeka, aż administrator HQCenter zatwierdzi żądanie (do 30 minut). Z tokenem licencyjnym agent jest przypisywany od razu i otrzymuje licencję. Po przypisaniu okres próbny kończy się, gdy HQCenter przydzieli agentowi licencję; agent, HQ Monitor, Firebird i komponenty klastra są wtedy aktualizowane z katalogu HQCenter. Nieudane przypisanie podczas instalacji nie cofa instalacji: podsumowanie to mówi, a powyższe polecenie je powtarza.
Wymagania: HQCenter (goafts) 1.15.0 lub nowszy (starsze wersje nie mają przycisku pliku połączenia); serwer jednorazowo dociera do portu bootstrap HQCenter na potrzeby przypisania, a następnie do portu agentów (443 domyślnie). HQCenter może działać bez Internetu. Drugie przypisanie tego samego serwera do tego samego HQCenter wymaga zatwierdzenia przez administratora nawet z tokenem licencyjnym.
9. Instalacja nienadzorowana i skrypty
Każda opcja działa także w terminalu. Uruchomienie nienadzorowane wymaga --yes
(odpowiada na pytania planu; bez terminala i bez --yes
instalator zatrzymuje się z kodem wyjścia 4). --yes nigdy nie otwiera interfejsu
tekstowego. Skrypt, który uruchamia instalator w terminalu i sam odpowiada na jego
pytania (na przykład za pomocą expect), musi dodać --no-tui lub ustawić
HQBIRD_NO_TUI=1: kity po 2027.2.30 otwierają tam strony. Kod wyjścia informuje o wyniku;
szczegóły są w terminalu i w /var/log/fbagent/install.log.
Opcje
| Opcja | Znaczenie | Domyślnie |
|---|---|---|
--fb-root DIR |
Folder nowego Firebird (nowy lub pusty); lub folder Firebird do aktualizacji | /opt/firebird, następnie /opt/fb<NN> |
--port N |
Port Firebird | 3050 dla pierwszego Firebird; dla innej linii port linii (3053 dla 3.0, 3054 dla 4.0, 3055 dla 5.0) |
--sysdba-pass-file F, --sysdba-pass P |
Hasło SYSDBA nowego Firebird (pierwsza linia F; P jest zapisywane do pliku 0600) |
wygenerowane, zapisane w /root/fbagent-install-sysdba.txt; kolejny Firebird na hoście pobiera hasło z tego pliku |
--agent-id ID |
agent.id nowego agenta; tylko przy pierwszej instalacji, zainstalowany agent zachowuje swoje id (“The agent id” w sekcji 3) |
nazwa hosta + data + instancja |
--hqmonitor-port N |
Port HQ Monitor | 20000 + port Firebird |
--hqmonitor-login L --hqmonitor-password-file F |
Logowanie HQ Monitor, współdzielone przez wszystkie instancje hosta: podane na jednej instancji zmienia logowanie wszystkich | admin + wygenerowane hasło; aktualizacja lub kolejna instancja zachowuje istniejące logowanie |
--email ADDR --accept-privacy [--trial-zone RU|EU|BR] |
E-mail próbny (30 dni); adres jest wysyłany do serwera próbnego dostawcy | brak |
--auto-update all|agent|off |
Aktualizacje serwera nieprzypisanego do żadnego HQCenter (kity od 2027.2.31): agent = agent, HQ Monitor i fbmcp aktualizują się same, pakiet Firebird czeka na Ciebie; all = także Firebird, w jego oknie; off = brak sprawdzania aktualizacji (“Aktualizacje bez HQCenter” w sekcji 4) |
tryb nie jest zmieniany; nowy agent ma agent |
| --license F | Plik licencji do zainstalowania | brak |
| --attach F | Dołącz do swojego HQCenter (attach.json) | brak |
| --no-hqbird, --disable-hqbird | Pozostaw starszy HQbird bez zmian / wyłącz wszystkie jego jednostki | automatycznie |
| --no-debug | Nie instaluj plików debugowania Firebird | instalowane |
| --no-fbmcp | Nie instaluj fbmcp (serwera MCP dla klientów AI) i nie zmieniaj fbmcp na tym hoście | instalowane |
| --fbmcp-allow-from A,B | Włącz tryb zdalny fbmcp dla tych adresów administracyjnych (IP lub CIDR) | tylko lokalnie |
| --fbmcp-port N, --fbmcp-dns NAME,..., --fbmcp-ip ADDR | Zdalny port fbmcp; dodatkowe nazwy dla jego certyfikatu; adres dla certyfikatu i listenera | port 8650 |
| --rcm on\|off | Zainstaluj konsolę klastra RCM na tym hoście i utwórz nowy klaster (agent 3.1.0 i nowszy) | pytanie; Nie |
| --rcm-password-file F | Hasło administratora RCM z --rcm on (pierwsza linia F) | wygenerowane, pokazane na końcu |
| --cluster-id ID | Identyfikator klastra z --rcm on | nazwa hosta |
| --cluster-pairing on\|off | Tryb wykrywania: okno parowania na 24 godziny, RCM może zaprosić tego agenta | pytanie; Nie |
| --rcm-allow A,B,... | Tylko te RCM mogą zaprosić ten host w trybie wykrywania (IP, CIDR lub nazwa hosta) | dowolny RCM |
| --pairing-port N | Port parowania 7450–7459 nowego agenta; wybiera slot (porty węzłów 7051+k, 7061+k). Późniejsza konfiguracja zachowuje slot | pierwszy wolny slot |
| --cluster-node on\|off | Umieść usługę węzła klastra w pamięci podręcznej agenta | on |
| --yes | Odpowiedz Tak na pytania planu (Nie na pytania o klaster) | pytanie |
| --check | Tylko sprawdzenia, biblioteki i plan; nic nie jest zmieniane | — |
| --plan-help | Wyświetl znaczenie kodów planu (M1, M2, …) i zakończ | — |
| --no-tui | Instalator zwykły, bez interfejsu tekstowego; także zmienna HQBIRD_NO_TUI=1 (“The plain installer” w sekcji 3) | interfejs tekstowy w terminalu |
| --lang en\|ru\|pt-BR\|de | Język instalatora; także zmienna HQBIRD_LANG (“Language of the installer” w sekcji 3) | locale UTF-8 konsoli, w przeciwnym razie angielski |
| --tmpdir DIR | Rozpakuj tutaj (folder, w którym programy mogą być uruchamiane) | /var/tmp |
| --extract DIR | Tylko rozpakuj payload do DIR/payload i zakończ | — |
| --uninstall [--remove-data] [--force] [--agent-dir DIR] | Usuń agenta i HQ Monitor (Firebird pozostaje); --force usuwa także agenta, który uruchamia RCM hosta, podczas gdy inne agenty go używają | — |
Opcje można zapisywać jako --port 3055 lub --port=3055. Ścieżki względne
liczone są od bieżącego folderu.
Przykłady
Nowa instalacja z domyślnymi ustawieniami:
sudo sh hqbird2027-fb50-linux-2027.2.9.run --yes
echo "exit code $?"Nowa instalacja do wybranego folderu i portu, z hasłem SYSDBA z pliku i logowaniem do HQ Monitor:
umask 077
printf '%s\n' 'S3cret-Sysdba' > /root/sysdba.txt
printf '%s\n' 'S3cret-Monitor' > /root/hqm.txt
sudo sh hqbird2027-fb50-linux-2027.2.9.run --yes \
--fb-root /opt/firebird --port 3050 \
--sysdba-pass-file /root/sysdba.txt \
--hqmonitor-port 24000 --hqmonitor-login ops --hqmonitor-password-file /root/hqm.txt
rm -f /root/sysdba.txt /root/hqm.txtNowa instalacja z e-mailem próbnym, plikiem licencji i plikiem attach:
sudo sh hqbird2027-fb50-linux-2027.2.9.run --yes \
--email [email protected] --accept-privacy --trial-zone EU \
--license /root/hqbird-license.json \
--attach /root/attach.jsonAktualizacja starszego HQbird, wszystkie jednostki starszego HQbird wyłączone:
sudo sh hqbird2027-fb50-linux-2027.2.9.run --yes --disable-hqbirdAktualizacja HQbird 2027 do nowej wersji (jedna instancja; przy kilku dodaj
--fb-root i --port):
sudo sh hqbird2027-fb50-linux-2027.2.9.run --yesDruga instancja Firebird 5.0 na porcie 3056:
sudo sh hqbird2027-fb50-linux-2027.2.9.run --yes --fb-root /opt/fb50-2 --port 3056Usuwanie:
sudo sh hqbird2027-fb50-linux-2027.2.9.run --uninstall
sudo sh hqbird2027-fb50-linux-2027.2.9.run --uninstall --remove-dataSkrypt, który zatrzymuje się przy nieudanej instalacji:
#!/bin/sh
set -e
sh hqbird2027-fb50-linux-2027.2.9.run --yes || {
rc=$?
echo "HQbird setup failed with code $rc, see /var/log/fbagent/install.log" >&2
exit $rc
}
echo "HQbird 2027 installed"Serwer bez internetu: biblioteki systemu operacyjnego
Firebird danej linii wymaga tych bibliotek z systemu operacyjnego (oprócz glibc):
| Linia | Pakiety (Debian/Ubuntu) | Pakiety (rodzina RHEL) |
|---|---|---|
| 5.0 | libtommath1, libicu<NN>, libgssapi-krb5-2 |
libtommath (EPEL), libicu, krb5-libs |
| 4.0 | libtommath1, libicu<NN> |
libtommath (EPEL), libicu |
| 3.0 | libtommath1, libicu<NN> |
libtommath (EPEL), libicu |
| 2.5 | zwykle nic (libstdc++6 jest w systemie podstawowym) |
zwykle nic |
Zestawy po 2027.2.30 z linii 3.0, 4.0 i 5.0 wymagają także programu
colrm, którego używa skrypt instalacyjny Firebird: pakiet bsdextrautils
(bsdmainutils na starszych Debian i Ubuntu). Minimalny Debian go nie ma;
rodzina RHEL ma go w util-linux, który jest zawsze obecny.
Gdy brakuje pakietu, a repozytorium jest nieosiągalne, instalator zatrzymuje się z kodem wyjścia 6 i nic nie jest zmieniane:
[install] ERROR: no access to the package repository, or a package is not there; nothing was changed.
[install] Missing: libtommath1
[install] Install them, then run this file again:
[install] apt-get install -y libtommath1
[install] On a server without internet: on a PC with the same Ubuntu 24.04.5 LTS
[install] apt-get download libtommath1
[install] copy the .deb files here and run: apt-get install -y ./*.debW rodzinie RHEL libtommath jest w EPEL: przy osiągalnym repozytorium
instalator sam dodaje epel-release. Bez niego polecenia to dnf install -y epel-release, dnf download --resolve <packages> i dnf install -y ./*.rpm. --check wyświetla
tę samą listę z wyprzedzeniem, więc pakiety można przygotować przed
oknem instalacji.
Kody wyjścia
| Kod | Znaczenie | Zmiany na hoście |
|---|---|---|
| 0 | Gotowe (ostrzeżenia o e-mailu próbnym, attach lub licencji są w podsumowaniu) | tak |
| 1 | Odrzucono: host, opcja, plik lub plan (powód jest wyświetlony). Także: Quit w interfejsie tekstowym | brak |
| 2 | Instalacja nie powiodła się i została wycofana. Także: instalator został zatrzymany przez sygnał (Ctrl+C) | wycofane; brak, gdy zatrzymano przed instalacją |
| 3 | Instalacja nie powiodła się i wycofanie nie było kompletne (podsumowanie mówi, co sprawdzić) | częściowo |
| 4 | Pytanie planu nie zostało potwierdzone (brak terminala, brak --yes). |
brak |
| 5 | Payload nie przeszedł sprawdzenia (sha256, podpisy): pobierz plik ponownie. Z --uninstall: odrzucono, agent uruchamia RCM hosta i inne agenty go używają (sekcja 7) |
brak |
| 6 | Brakuje bibliotek systemu operacyjnego, a repozytorium pakietów jest nieosiągalne | brak |
| 7 | Zainstalowany jest Firebird z pakietów dystrybucji | brak |
10. Rozwiązywanie problemów
| Problem | Co zrobić |
|---|---|
run as root (sudo sh ...) |
Uruchom instalator z sudo lub jako root |
| Strony interfejsu tekstowego nie otwierają się | Pierwsza linia mówi dlaczego: needs a window of 80x24 or larger (powiększ okno; tmux z linią statusu zajmuje jeden wiersz) lub needs bash 4.4 or newer. Uruchamiany wtedy instalator zwykły wykonuje tę samą instalację |
| Błędne znaki lub przerwane linie na stronach | Ustaw terminal na UTF-8 lub uruchom z --lang en; --no-tui uruchamia instalator zwykły |
/var/tmp is mounted noexec |
Uruchom ponownie z --tmpdir /root (dowolny folder, w którym programy mogą być uruchamiane) |
is damaged or cut (kod wyjścia 5) |
Skopiuj plik .run ponownie i porównaj jego sha256sum z opublikowaną wartością |
| Kod wyjścia 6, brakuje bibliotek | Przygotuj pakiety zgodnie z wydrukiem (sekcja 9), a następnie uruchom instalator ponownie |
| Kod wyjścia 7, Firebird z pakietów dystrybucji | Usuń pakiety (apt-get remove firebird3.0-server, zachowaj kopię zapasową gbak) lub użyj instalatora online z --import-firebird |
refused (M17): Firebird 2.5 works only in /opt/firebird |
Druga instancja Firebird 2.5 nie jest możliwa; zainstaluj obok inną linię (sekcja 7) |
--uninstall odrzucono (kod wyjścia 1) przy kilku agentach |
Dodaj --agent-dir z folderem z listy, na przykład --agent-dir /opt/hqbird/fbagent-fb50-2 |
--uninstall odrzucono (kod wyjścia 5): this agent runs the RCM of the host |
Najpierw usuń klaster w konsoli RCM lub uruchom ponownie z --force (sekcja 7) |
no permission for read-write access do employee.fdb po aktualizacji (3.0) |
sudo chmod 660 /opt/firebird/examples/empbuild/employee.fdb (sekcja 6) |
refused (M14): the folder is not empty |
Wybierz pusty lub nowy folder z --fb-root lub wskaż Firebird do aktualizacji |
| Kod wyjścia 2 lub 3 | Przeczytaj /var/log/fbagent/install.log; jednostki są przywrócone do stanu sprzed uruchomienia (kod 2) lub wymagają sprawdzenia (kod 3) |
| HQ Monitor nie otwiera się | systemctl status hqbirdmonitor-fb50 (hqbirdmonitor-p<port> przed 2027.2.9); sprawdź, czy nic innego nie nasłuchuje na porcie; otwórz port w zaporze; --hqmonitor-port dla innego portu |
| Utracono hasło HQ Monitor | Uruchom instalator ponownie (naprawa) z --hqmonitor-login admin --hqmonitor-password-file <file>; stary /opt/hqbird/conf/access.properties jest zachowywany jako access.properties.bak-<time>. Nowe logowanie obowiązuje dla wszystkich instancji hosta |
| E-mail próbny nie został wysłany (brak sieci) | Wyślij go później: cd /opt/hqbird/fbagent-fb50 && sudo -u firebird ./fbagent --trial-email <address> --accept-privacy |
| SELinux (AlmaLinux, RHEL) | Obsługiwany w trybie enforcing: instalator przywraca konteksty plików, które zapisuje; nic nie trzeba robić |