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

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. 1. Co instaluje instalator
  2. 2. Instalacja w skrócie
  3. 3. Nowa instalacja
  4. 4. Po instalacji
  5. 5. Aktualizacja starszego HQbird (2024 i wcześniejsze)
  6. 6. Aktualizacja HQbird 2027 do nowej wersji
  7. 7. Polecenia konserwacyjne
  8. 8. Przypisanie do HQCenter
  9. 9. Instalacja nienadzorowana i skrypty
  10. 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.conf dla 2.5), baza danych zabezpieczeń i hasło SYSDBA są zachowywane.
  • Pliki debugowania Firebird (symbole do analizy awarii), instalowane w folderze Firebird. --no-debug je pomija.
  • Agent HQbird (fbagent): jednostka systemd hqbirdfbagent-fb50, działająca jako użytkownik firebird, 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, adres http://<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/hqbirdrcm i działa jako jednostka hqbirdrcm; podsumowanie wypisuje jego adres w linii RCM:. Węzeł otrzymuje swoją jednostkę (na przykład hqclusternode-master-p3050), gdy połączysz host w RCM. Zestawy od 2027.2.19 ze starszym agentem instalują RCM na każdym serwerze (--rcm off pozostawia 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 jednostki hqbirdrcm ani linii RCM:.

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

Diagram

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

Command
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.sha256

Pozostał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)

Command
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

Command
sudo sh hqbird2027-fb50-linux-2027.2.9.run

Zestawy 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.

text
 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: quit

Gó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-tui lub zmienna HQBIRD_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;
  • TERM ma wartość dumb lub nie jest ustawiona;
  • okno jest mniejsze niż 80 kolumn na 24 wiersze (wewnątrz tmux z 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:

text
[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 --uninstall

Ten 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:

text
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] oraz Turn 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. --yes i 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 dla root i 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:

  1. opcja --lang en|ru|pt-BR|de;
  2. zmienna HQBIRD_LANG;
  3. locale konsoli (LC_ALL, następnie LC_MESSAGES, następnie LANG), gdy jest to locale UTF-8;
  4. angielski.

Drugi wiersz wyjścia mówi, jaki to język i jak go zmienić. Ten wiersz jest zawsze po angielsku:

text
[install] Language: Русский (auto). Use --lang en to change.

Uwagi:

  • PuTTY nie wysyła LANG do serwera. Liczy się locale samego serwera, więc językiem często jest angielski. Użyj --lang.
  • Z --yes i bez terminala automatycznym językiem jest angielski: skrypty czytają to wyjście. --lang nadal tam działa.
  • Instalator potrzebuje locale UTF-8 na hoście dla pozostałych języków (C.UTF-8 lub en_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.log oraz 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:

text
[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 ID podaje 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-id daje 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

Command
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.fdb

Uż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).

text
/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 --json dla 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:

Diagram

Co widzisz na terminalu:

text
[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-root i --port nie 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 version jest pytaniem, gdy starszy HQbird zarządza Firebirdem innej wersji (zaktualizuj tamten lub nowy obok niego). --yes odpowiada Yes na wszystkie pytania; bez terminala i bez --yes instalator zatrzymuje się z kodem wyjścia 4 i niczego nie zmienia.
  • --disable-hqbird w każdym przypadku wyłącza unity starszego HQbird; --no-hqbird pozostawia 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.properties jest zachowywany, więc zaloguj się loginem i hasłem, których używałeś wcześniej. Instalator przekazuje plik użytkownikowi firebird z 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.conf lub aliases.conf dla 2.5) jako wiersze name = 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ą include nie jest zmieniany.
  • Usuwa stare dzienniki monitorowania starszego HQbird: zawartość folderów mon/outcoming i mon/outtrace jego 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:

Command
sudo sh hqbird2027-fb50-linux-2027.2.9.run --yes --disable-hqbird

6. 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.

Command
sudo sh hqbird2027-fb50-linux-2027.2.9.run

W 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:

text
[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

Command
sudo sh hqbird2027-fb50-linux-2027.2.9.run --fb-root /opt/fb50-2 --port 3056

Nowy 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:

Command
# 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-data

Bez --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:

Command
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:

Command
B=/opt/fb50-2
U=firebird.$(echo ${B#/} | tr / _)          # /opt/fb50-2 -> firebird.opt_fb50-2
systemctl list-unit-files "$U*"             # the units that will be removed
sudo systemctl disable --now $(systemctl list-unit-files "$U*" --no-legend | awk '$1 !~ /@/ {print $1}')
sudo rm -f /usr/lib/systemd/system/$U* /etc/systemd/system/$U*
sudo systemctl daemon-reload
sudo rm -rf $B

8. 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.

Diagram
  1. 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 zapisz attach.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 ustawiono admin_panel.install_script_url.
  2. Skopiuj attach.json na serwer.
  3. Przypisz na jeden z dwóch sposobów:
Command
# 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.json

Ze 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:

Command
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:

Command
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.txt

Nowa instalacja z e-mailem próbnym, plikiem licencji i plikiem attach:

Command
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.json

Aktualizacja starszego HQbird, wszystkie jednostki starszego HQbird wyłączone:

Command
sudo sh hqbird2027-fb50-linux-2027.2.9.run --yes --disable-hqbird

Aktualizacja HQbird 2027 do nowej wersji (jedna instancja; przy kilku dodaj --fb-root i --port):

Command
sudo sh hqbird2027-fb50-linux-2027.2.9.run --yes

Druga instancja Firebird 5.0 na porcie 3056:

Command
sudo sh hqbird2027-fb50-linux-2027.2.9.run --yes --fb-root /opt/fb50-2 --port 3056

Usuwanie:

Command
sudo sh hqbird2027-fb50-linux-2027.2.9.run --uninstall
sudo sh hqbird2027-fb50-linux-2027.2.9.run --uninstall --remove-data

Skrypt, który zatrzymuje się przy nieudanej instalacji:

Command
#!/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:

text
[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 ./*.deb

W 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ć