Tato stránka byla strojově přeložena. Přečtěte si anglický originál. English

Tento průvodce je určen správci, který instaluje HQbird 2027 na linuxový server pomocí offline instalátoru hqbird2027-fbNN-linux-<version>.run. Pokrývá novou instalaci, aktualizaci staršího HQbird a dřívějšího HQbird 2027, příkazy údržby, připojení k vašemu HQCenter, neobsluhovanou (skriptovanou) instalaci a umístění souborů po instalaci.

Příklady ukazují instalátor pro Firebird 5.0 na Ubuntu 24.04. Instalátory pro Firebird 2.5, 3.0 a 4.0 fungují stejně; liší se pouze verze, výchozí port a názvy složek. Instalace ve Windows je popsána v Windows installation.

Obsah

  1. 1. Co instalátor nainstaluje
  2. 2. Instalace v kostce
  3. 3. Nová instalace
  4. 4. Po instalaci
  5. 5. Aktualizace staršího HQbird (2024 a dříve)
  6. 6. Aktualizace HQbird 2027 na novou verzi
  7. 7. Údržbové příkazy
  8. 8. Připojení k vašemu HQCenter
  9. 9. Neobsluhovaná instalace a skripty
  10. 10. Řešení problémů

1. Co instalátor nainstaluje

Jeden soubor .run = jedna řada Firebird. Vyberte instalátor verze Firebird, kterou vaše databáze používají:

Instalátor Firebird, který nainstaluje nebo aktualizuje První Firebird na hostiteli Velikost
hqbird2027-fb50-linux-<version>.run Firebird 5.0 (HQbird build) /opt/firebird, port 3050 asi 250 MB
hqbird2027-fb40-linux-<version>.run Firebird 4.0 (HQbird build) /opt/firebird, port 3050 asi 220 MB
hqbird2027-fb30-linux-<version>.run Firebird 3.0 (HQbird build) /opt/firebird, port 3050 asi 130 MB
hqbird2027-fb25-linux-<version>.run Firebird 2.5 (HQbird build) /opt/firebird, port 3050 asi 80 MB

Každý instalátor obsahuje a instaluje bez internetu:

  • Firebird (HQbird build dané řady): nový server nebo aktualizaci na místě Firebirdu dané řady, který již na hostiteli je. Vaše firebird.conf, databases.conf (aliases.conf pro 2.5), bezpečnostní databáze a heslo SYSDBA jsou zachovány.
  • Ladicí soubory Firebird (symboly pro analýzu pádů), nainstalované do složky Firebird. --no-debug je přeskočí.
  • HQbird agent (fbagent): systemd unit hqbirdfbagent-fb50, běžící pod uživatelem firebird, který provádí zálohy, monitoring, úlohy údržby a aktualizace. Název končí řadou Firebird (-fb25 … -fb50); druhá instance řady má -fb50-2.
  • HQ Monitor: webová konzole této instance HQbird, unit hqbirdmonitor-fb50, adresa http://<server>:<20000 + Firebird port>/ (pro Firebird na portu 3050: http://localhost:23050/).
  • Komponenty clusteru: konzole clusteru RCM (hqbirdrcm) a uzel clusteru (hqclusternode) se zkopírují do mezipaměti agenta. Kity s agentem (fbagent) 3.1.0 a novějším ve výchozím nastavení nevytvářejí žádný cluster: žádné RCM, žádné párovací okno, žádný port clusteru ve firewallu. Dvě otázky (nebo --rcm on, --cluster-pairing on) je zapnou („Next: cluster“ v části 3). S RCM se instaluje do /opt/hqbirdrcm a běží jako unit hqbirdrcm; souhrn vypíše jeho adresu na řádku RCM:. Uzel dostane svou unit (například hqclusternode-master-p3050), když hostitele propojíte v RCM. Kity od 2027.2.19 se starším agentem instalují RCM na každém serveru (--rcm off jej ponechá v mezipaměti) a otevřou párovací okno. Kity před 2027.2.19 pouze zkopírují obě komponenty do mezipaměti agenta: neexistuje unit hqbirdrcm ani řádek RCM:.

Instance nainstalované před 2027.2.9 mají port Firebird v názvech agenta: složka /opt/hqbird/fbagent-p3050, unity hqbirdfbagent-p3050 a hqbirdmonitor-p3050. Aktualizace tyto názvy nemění. Pouze nové instance dostanou názvy -fb<NN>, takže jeden hostitel může mít obě formy.

Požadavky: x86_64, jádro 3.2 nebo novější, systemd; Linux s apt, dnf/yum nebo zypper (Ubuntu, Debian, AlmaLinux, Rocky, RHEL, Oracle Linux, openSUSE, RED OS a další); root. Asi 300 MB volného místa v /var/tmp během instalace (složka, kde mohou programy běžet; viz --tmpdir). Několik systémových knihoven (libtommath, ICU) se bere z distribučního repozitáře; server bez internetu dostane přesné příkazy k jejich přípravě (část 9).

Nepodporováno: Firebird nainstalovaný z distribučních balíčků (firebird3.0-server, firebird rpm). Instalátor se zastaví, než cokoli změní (návratový kód 7); nejprve odstraňte balíčky (zachovejte zálohu gbak svých databází) nebo použijte online instalátor s --import-firebird.

Několik řad Firebird na jednom serveru: každá řada má svůj instalátor. První Firebird na hostiteli jde do /opt/firebird; druhá řada jde do /opt/fb<NN> (/opt/fb50, /opt/fb40, /opt/fb30) na portu své řady: 3053 pro 3.0, 3054 pro 4.0, 3055 pro 5.0. Když je tento port obsazen, instalátor se zastaví a požádá o --port N. Několik instancí jedné řady (druhý Firebird 5.0 na jiném portu) se instaluje pomocí --fb-root <new folder> --port <port> (část 7). Firebird 2.5 má pouze jednu instanci, v /opt/firebird; pro druhý server vedle něj použijte jinou řadu (například Firebird 5.0 v /opt/fb50).

Podrobný runbook pro dvě instance na portech 3050 a 3051 pro každou řadu s příkazy ke zkopírování je v hqbird2027-linux-two-instances-runbook.ru.md (rusky) a hqbird2027-linux-two-instances-runbook.pt.md (portugalsky).

Zkušební verze: bez licence běží agent v 7denní zkušební verzi. Zkušební e-mail (--email) ji prodlouží na 30 dní. Licenční soubor (--license) nebo připojení k vašemu HQCenter (část 8) zkušební verzi nahradí.

Aktualizace: od kitu 2027.2.31 (agent 3.3.0) server, který není připojen k žádnému HQCenter, kontroluje aktualizační server dodavatele. Ve výchozím nastavení se agent, HQ Monitor a fbmcp aktualizují samy a nový balíček Firebird se stáhne a čeká na vás. --auto-update all|agent|off nebo řádek Updates textového rozhraní to změní („Updates without HQCenter“ v části 4). Server připojený k HQCenter přijímá aktualizace z tohoto HQCenter.

2. Instalace v kostce

Diagram

Kontrolu serveru a samotnou instalaci provádí HQbird agent, který instalátor nese (fbagent --install-plan, fbagent --setup-install). Nic se nestahuje kromě chybějících systémových balíčků. Nic se nemění, dokud není plán potvrzen: systémové balíčky se instalují až po potvrzení. V terminálu otevírají kity po 2027.2.30 textové rozhraní (krok 3 části 3); --no-tui spustí prostý instalátor, který klade své otázky jako řádky textu. Bez terminálu a bez --yes se instalátor zastaví u potvrzení s návratovým kódem 4. Pokud instalace selže předtím, než se spustí unit agenta, agent vrátí unity do stavu, v jakém byly předtím (návratový kód 2; kód 3, když vrácení nebylo úplné, souhrn uvádí, co zkontrolovat).

3. Nová instalace

Krok 1: Stáhněte instalátor a zkontrolujte jej

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

Ostatní řady mají stejné názvy s fb40, fb30, fb25. Očekáváno: hqbird2027-fb50-linux-2027.2.9.run: OK. Server bez internetu: stáhněte oba soubory na PC se stejnými odkazy a zkopírujte je na server (scp, USB disk, sdílená složka).

Instalátor také zkontroluje svůj vlastní payload, než cokoli rozbalí: přerušené nebo poškozené stažení se zastaví s návratovým kódem 5 („stáhněte jej znovu“).

Krok 2: Zkontrolujte hostitele bez změn (volitelné)

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

--check spustí kontrolu hostitele, ohlásí chybějící systémové knihovny (a příkazy k jejich získání na serveru bez internetu), ukáže, co agent našel a co by udělal, a skončí. Nic se neinstaluje.

Krok 3: Spusťte instalátor

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

Kity po 2027.2.30 otevřou textové rozhraní, když je spustíte v terminálu: celoobrazovkové stránky s plánem a nastavením. Kity do 2027.2.30 a případy v „Prostý instalátor“ níže kladou své otázky jako řádky textu. Oba provedou stejnou instalaci se stejnými volbami.

Textové rozhraní

Instalátor zkontroluje hostitele, rozbalí se, přečte plán a zobrazí první stránku. Na hostiteli se nic nezmění, dokud nespustíte instalaci na stránce 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

Horní řádky jsou plán pro aktuální nastavení: jeho kód a to, co instalátor udělá s Firebird a agentem. Plán, který není možný, je červený, s důvodem, a kurzor stojí na nastavení, které jej opraví. Po každé změně instalátor plán znovu načte.

Klávesa Co dělá
Up, Down Pohyb kurzoru (také k, j)
Enter Otevře nastavení pod kurzorem, vybere položku, přijme zadanou hodnotu
Space Zapne nebo vypne komponentu (stránka Components)
Esc Zpět na předchozí stránku; na první stránce: opustí instalátor (nejprve se zeptá)
Ctrl+C Okamžitě zastaví instalátor (návratový kód 2). Před stránkou Install se nic nezměnilo

Na stránce, kde zadáváte hodnotu (složka, port, adresa), ji Enter přijme a prázdná hodnota znamená „automaticky“. Esc takovou stránku neopustí.

Nastavení Co volíte Totéž jako volba
Language angličtina, ruština, brazilská portugalština, němčina; stránky se změní okamžitě --lang
Firebird folder Složka nového Firebirdu nebo Firebirdu k aktualizaci. Firebird 2.5 má jednu složku, takže jeho instalátor tento řádek nemá --fb-root
Firebird port TCP port Firebirdu --port
Agent id Automaticky, název hostitele, název hostitele a instance, nebo vaše vlastní hodnota. Pouze pro nového agenta: nainstalovaný agent si ponechá své id a řádek se nezobrazí --agent-id
SYSDBA password Pro nový Firebird: vygenerované, nebo vaše vlastní --sysdba-pass-file
HQ Monitor Port a přihlášení webové konzole --hqmonitor-port, --hqmonitor-login, --hqmonitor-password-file
License Ne teď, 30denní zkušební verze e-mailem (adresa, oznámení o ochraně soukromí, zóna), nebo licenční soubor --email --accept-privacy --trial-zone, --license
HQCenter Soubor attach.json vašeho HQCenter --attach
Cluster Správce clusteru RCM (id clusteru, heslo správce), režim discovery, párovací port --rcm, --cluster-id, --rcm-password-file, --cluster-pairing, --pairing-port
Components Ladicí soubory Firebird; fbmcp a adresy jeho vzdáleného režimu --no-debug, --no-fbmcp, --fbmcp-allow-from

| Aktualizace | Pouze HQbird (agent, HQ Monitor a fbmcp se aktualizují samy, nový Firebird na vás čeká), HQbird a Firebird (Firebird se také aktualizuje sám, v noci od 03:30 do 04:00, s restartem Firebird), nebo Vypnuto. Sady od 2027.2.31; pouze pro nového agenta bez souboru attach.json: aktualizace připojeného agenta řídí HQCenter | --auto-update |

Možnosti na příkazovém řádku jsou hodnoty, se kterými stránky začínají: sudo sh hqbird2027-fb50-linux-<ver>.run --rcm on --port 3055 otevře první stránku s RCM zapnutým a portem 3055.

Čtyři řádky pod nastaveními:

  • Install zobrazí plán v plném rozsahu a poté se zeptá Start the install now? s kurzorem na No. Otázky plánu (starší HQbird, běžící Firebird k zastavení) jsou na stejné stránce: Yes odpoví na všechny. Po Yes se stránky zavřou a instalace vypíše svůj log a souhrn na běžnou obrazovku, jako v prostém instalátoru níže.
  • Plan details ukazuje, co znamená kód plánu, co instalátor na hostiteli našel, varování a balíčky OS, které nainstaluje.
  • About plans vypisuje všechny kódy (M1 … M17). Enter na kódu jej vysvětlí. * označuje kód aktuálního plánu.
  • Quit opustí instalátor (návratový kód 1). Nic nebylo změněno.

Prostý instalátor

Prostý instalátor se spustí, když platí jedna z těchto podmínek:

  • možnost --no-tui nebo proměnná HQBIRD_NO_TUI=1;
  • --yes, --check, --uninstall, --extract, --plan-help, --help;
  • stdin nebo stdout není terminál: skript, ssh host 'command' bez terminálu nebo roura jako ... 2>&1 | tee install.log;
  • TERM je dumb nebo není nastaven;
  • okno je menší než 80 sloupců na 24 řádků (uvnitř tmux s jeho stavovým řádkem má terminál 80x24 jen 23 řádků: zvětšete okno, nebo použijte --no-tui);
  • bash na hostiteli je starší než 4.4 (RHEL 7, CentOS 7);
  • sada je 2027.2.30 nebo starší.

U okna a u bashe první řádek výstupu říká, proč se stránky neotevřely.

Typický běh prostého instalátoru na serveru 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

Tento příklad je ze sady 2027.2.9. Od sady 2027.2.19 má souhrn také řádky RCM: a Pairing: konzole clusteru (“Next: cluster” níže). S agentem 3.1.0 a novějším a bez zvoleného clusteru jsou 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 řádky znamenají:

  • host: distribuce a jádro; instalátor odmítne hostitele, který není x86_64, nemá systemd nebo běží na jádře starším než 3.2.
  • OS libraries: co Firebird této řady potřebuje od OS (sekce 9). Plán vypisuje chybějící balíčky (OS packages to install); po potvrzení je instalátor vezme z úložiště distribuce. Bez úložiště se zastaví s návratovým kódem 6 a vypíše příkazy.
  • plan: co agent našel (řádky found Firebird ..., HQbird: ...) a co udělá: Firebird new (nový server), update (Firebird této řady se aktualizuje na místě), nebo odmítnutí s důvodem (návratový kód 1, nic nezměněno).
  • Install as planned? Yes/No: poslední otázka před jakoukoli změnou. Odpovězte y. Když má plán vlastní otázky (starší HQbird, jiná verze), přijdou místo ní (sekce 5). Bez terminálu předejte --yes; jinak se instalátor zastaví s návratovým kódem 4.
  • Cluster questions (agent 3.1.0 a novější): Install the cluster manager (RCM) on this host and make a new cluster? [y/N] a Turn on discovery mode for 24 hours (an RCM on the network may invite this agent into its cluster; port 7450)? [y/N]. Výchozí je No. První se ptá jen tehdy, když hostitel nemá RCM a agent není v žádném clusteru; druhá ne, když je agent v clusteru nebo provozuje RCM. --yes a běh bez terminálu odpovídají No (žádný návratový kód 4).
  • HQ Monitor: adresa a přihlášení. Nová instalace dostane přihlášení admin; jeho vygenerované heslo je v /opt/hqbird/conf/access.properties (mód 0600, čitelné pro root a agenta). Všechny instance HQbird 2027 na hostiteli sdílejí tento soubor. Změňte heslo v HQ Monitor.

Heslo SYSDBA nového Firebird je vygenerováno a uloženo v /root/fbagent-install-sysdba.txt (mód 0600): řádek s komentářem, poté řádek SYSDBA_PASS=<password>. Další Firebird nainstalovaný později na stejném hostiteli dostane stejné heslo z tohoto souboru. Chcete-li nastavit vlastní, předejte --sysdba-pass-file <file> (první řádek souboru) nebo --sysdba-pass <password>.

Jazyk instalátoru

Sady po 2027.2.30 mluví čtyřmi jazyky: anglicky, rusky (ru), brazilská portugalština (pt-BR) a německy (de). Instalátor volí jazyk v tomto pořadí:

  1. možnost --lang en|ru|pt-BR|de;
  2. proměnná HQBIRD_LANG;
  3. locale konzole (LC_ALL, poté LC_MESSAGES, poté LANG), když je to locale UTF-8;
  4. angličtina.

Druhý řádek výstupu říká, který jazyk to je a jak jej změnit. Tento řádek je vždy anglicky:

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

Poznámky:

  • PuTTY neposílá LANG na server. Počítá se vlastní locale serveru, takže jazyk je často angličtina. Použijte --lang.
  • S --yes a bez terminálu je automatický jazyk angličtina: skripty čtou tento výstup. --lang zde stále funguje.
  • Instalátor potřebuje pro ostatní jazyky locale UTF-8 na hostiteli (C.UTF-8 nebo en_US.UTF-8). Nastaví si jedno pro sebe. Bez něj mluví anglicky.
  • V textovém rozhraní řádek Language na první stránce změní jazyk okamžitě. Terminál musí zobrazovat UTF-8 (PuTTY: Window, Translation, Remote character set UTF-8, což je jeho výchozí nastavení).
  • Angličtina zůstává: řádky průběhu samotné instalace, souhrn Done:, /var/log/fbagent/install.log a varování skenování hostitele.

Kód plánu

Plán má kód: M1, M2, … Pojmenovává případ, který instalátor našel na hostiteli. Instalátor vypíše, co kód znamená:

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 vypíše všechny kódy a skončí. Nic nemění. V textovém rozhraní první stránka zobrazuje kód a jeho název, “Plan details” zobrazuje text a “About plans” vypisuje všechny kódy.

Kód Co instalátor našel Firebird Agent Starší HQbird
M1 nic nový nový —
M2 Firebird této řady, žádný starší HQbird aktualizace nový —
M3 Firebird jiné řady, žádný starší HQbird nový, port 305N nový —
M4 starší HQbird, který obsluhuje Firebird této řady aktualizace nový vypnut, jeho úlohy importovány jako povolené
M5 starší HQbird jiné řady; Firebird této řady je přítomen aktualizace, po otázce nový pokračuje v práci
M6 starší HQbird jiné řady; žádný Firebird této řady nový, po otázce nový pokračuje v práci
M7 starší HQbird bez lokálního Firebird známé verze aktualizace nebo nový nový pokračuje v práci, varování
M8 agent HQbird 2027 pro jiný Firebird aktualizace nebo nový nový, vedle prvního nezměněn
M9 jako M8 a starší HQbird obsluhuje tuto řadu aktualizace nový, vedle prvního vypnut, jeho úlohy importovány jako povolené
M10 agent již obsluhuje tento Firebird (opakovaný běh) aktualizace na místě vypnut, když běží
M11 --fb-root je Firebird této řady aktualizace nový nebo na místě jako výše
M13 --fb-root je prázdná nebo nová složka nový v této složce nový jako výše

Kódy odmítnutí (návratový kód 1, nic nezměněno): M12 složka obsahuje Firebird, který instalátor nemůže aktualizovat (jiná řada, verze, kterou nelze přečíst, zakázaná služba); M14 složka není prázdná a neobsahuje Firebird; M16 několik serverů Firebird této řady, zadejte --fb-root; M17 Firebird 2.5 funguje pouze v /opt/firebird. M15 je sada pouze s agentem: Firebird se neinstaluje a neaktualizuje.

ID agenta

ID agenta pojmenovává agenta v HQCenter, v licenci a v clusteru. Nastavuje se pouze při první instalaci:

  • Výchozí: název hostitele + datum + instance, například srv1261114-fb50.
  • --agent-id ID zadá vaše vlastní ID (1-128 písmen, číslic, ., _ nebo -; první znak písmeno nebo číslice).
  • Instalátor odmítne ID, které má jiný agent hostitele.
  • V textovém rozhraní stránka Agent id nabízí automatické ID, název hostitele, název hostitele s instancí a vaši vlastní hodnotu a vypisuje ID, která hostitel již má.
  • Nainstalovaný agent si své ID ponechá. Opakovaný běh jej zobrazí v plánu (id srv1 (kept)), textové rozhraní pak nemá řádek Agent id a --agent-id zde dá pouze varování. Nový agent ve složce, kterou dřívější instalace zanechala se svou konfigurací, si také ponechá ID z této konfigurace.

Krok 4: Zkontrolujte výsledek

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

Použijte úplnou cestu k ukázkové databázi: funguje pro každou řadu a také po aktualizaci, zatímco zachovaný databases.conf starší instalace nemusí mít alias employee (nová instalace 2027.2.3 jej má).

Otevřete http://<server>:23050/ v prohlížeči a přihlaste se jako admin s heslem z /opt/hqbird/conf/access.properties. Port Firebird a port HQ Monitor jsou otevřeny v firewalld (zóna public), když běží, jinak v ufw, když je aktivní; s jiným firewallem je otevřete sami. Porty clusteru se otevírají pouze pro možnost clusteru: 7443, 7444 a port uzlu s --rcm on; port uzlu a párovací port s --cluster-pairing on. Bez aktivního firewallu instalátor vypíše jeden řádek s porty, které neotevřel. Port, který byl otevřený před instalací, zůstane tak, jak je.

Další: cluster

Chcete-li replikovat své databáze z hlavního serveru na replikační server, propojte oba servery v konzoli clusteru RCM. S agentem 3.1.0 a novějším nainstalujte RCM pouze na hlavní server (--rcm on, nebo odpovězte y) a zapněte režim discovery na replice (--cluster-pairing on). Režim discovery otevře párovací okno na 24 hodin: párovací port slotu agenta (7450 pro první instanci, 7451 pro druhou, až po 7459) je otevřen ve firewallu a RCM může agenta pozvat. Jeden hostitel má jeden RCM (porty 7443 a 7444); agent, který jej vytvořil, jej provozuje a neotevírá žádné párovací okno.

Později, bez instalátoru: HQ Monitor → Clusters → Cluster on this server, nebo fbagent --cluster-init <id> a fbagent --cluster-pairing on. Kity od 2027.2.19 se starším agentem spustí RCM na každém serveru a vypíší jeho adresu na řádku RCM: v souhrnu; instalace před 2027.2.19 získá RCM, když ji aktualizujete novějším kitem (sekce 6). Průvodce clusterem (pro kit 2027.2.33) provede krok za krokem od dvou nových serverů k funkční replice, se snímky obrazovky: Průvodce clusterem pro Linux (také v ruštině a portugalštině). Stejné kroky pouze jako příkazy: hqbird2027-linux-cluster-runbook.md (hqbird2027-linux-cluster-runbook.ru.md, hqbird2027-linux-cluster-runbook.pt.md).

4. Po instalaci

Unity

Unit Co Běží jako
firebird (2.5, 4.0, 5.0 v /opt/firebird); firebird-superserver (3.0 v /opt/firebird); pro jinou složku název složky s / → _: firebird.opt_fb50, firebird.opt_fb40-2 (4.0, 5.0 v /opt/fb50, /opt/fb40-2), firebird.opt_fb30-superserver (3.0 v /opt/fb30) Server Firebird firebird
hqbirdfbagent-fb50 (druhá instance hqbirdfbagent-fb50-2; před 2027.2.9 hqbirdfbagent-p<port Firebirdu>) Agent HQbird firebird
hqbirdmonitor-fb50 (hqbirdmonitor-fb50-2; před 2027.2.9 hqbirdmonitor-p<port Firebirdu>) HQ Monitor firebird

Všechny tři jsou povolené a spouštějí se při bootu. journalctl -u hqbirdfbagent-fb50 zobrazí log unity agenta. Firebird 3.0 má také unity firebird-classic.socket a [email protected] (firebird.opt_fb30-classic.* v jiné složce) a Firebird 2.5 má firebird.socket: zůstávají inactive, to je normální. Proces Firebirdu 2.5 je fb_smp_server (SuperClassic).

Kde jsou soubory

Příklad je první instance Firebirdu 5.0 v /opt/firebird na portu 3050. Druhá instance řady má -2 v názvech agenta (fbagent-fb50-2, hqbirdfbagent-fb50-2, hqbirdmonitor-fb50-2). Instance nainstalované před 2027.2.9 mají port v těchto názvech (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)

Instalátor nenechává nic v /var/tmp: jeho pracovní složka /var/tmp/hqbird2027.XXXXXX je na konci odstraněna, také po chybě.

Logy

Log Kde
Instalátor terminál; /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; auditní log /opt/hqbird/fbagent-fb50/hqmonitor_audit.log
Firebird /opt/firebird/firebird.log

Aktualizace bez HQCenter

Od kitu 2027.2.31 (agent 3.3.0) agent, který není připojen k žádnému HQCenter, bere nové verze z update serveru dodavatele. Režim aktualizace je klíč update.mode v agent_config.json:

Režim Co se aktualizuje samo
agent (výchozí) Agent, HQ Monitor a fbmcp. Nový balíček Firebirdu se stáhne a čeká na administrátora
all Totéž a také Firebird, ve svém okně aplikace (v noci od 03:30 do 04:00; aktualizace restartuje Firebird)
off Nic: agent neprovádí žádné kontroly aktualizací. Pro aktualizaci spusťte instalátor nové verze (sekce 6)
  • Při instalaci: řádek Updates textového rozhraní, nebo --auto-update all|agent|off. Bez nich instalátor režim nezmění.
  • Později: stránka Updates v HQ Monitor, nebo instalátor znovu s --auto-update <mode>.
  • Stav: sudo /opt/hqbird/fbagent-fb50/fbagent --update-status (přidejte --json pro skript). Vypíše zdroj vydání, zónu a poslední odpověď update serveru.

Agent otevírá odchozí HTTPS spojení pouze na tyto adresy. Není potřeba žádný příchozí port.

Účel Adresa
Aktualizace, zóna EU liceu.ibsurgeon.com:9443
Aktualizace, zóna BR licbr.ibsurgeon.com:9443
Aktualizace, zóna RU licru.ibsurgeon.com:20943
Trial licence trialeu.ibsurgeon.com:9443, trialbr.ibsurgeon.com:19443, trialru.ibsurgeon.com:23943

Server, který je připojen k HQCenter, nepoužívá adresy aktualizací: bere své aktualizace z tohoto HQCenter (sekce 8).

Oznámení

Od kitu 2027.2.33 (agent 3.4.0) agent posílá zprávy o problémech serveru do vašeho vlastního Telegram bota, na webhook nebo e-mailem (SMTP). Instalátor nenastavuje žádný kanál a nic se neposílá, dokud nějaký nepřidáte: HQ Monitor → Servers → Notifications. Pro otestování kanálu z příkazového řádku: sudo -u firebird /opt/hqbird/fbagent-fb50/fbagent --notify-test <channel>; --notify-history vypíše poslední doručení.

5. Aktualizace staršího HQbird (2024 a dříve)

Instalátor najde nainstalovaný HQbird (FBDataGuard) v /opt/hqbird a jeho unity a servery Firebird, které spravuje. Poté postupuje podle stejných pravidel jako instalační skripty HQbird:

Diagram

Co uvidíte na terminálu:

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
  • Plán pojmenovává Firebird, který se aktualizuje; --fb-root a --port jej nemohou přesunout (jeho unit je převzat).
  • Otázka Confirm to stop running Firebird? se položí, když musí být engine zastaven; řádek před ní zobrazuje otevřená spojení. Another version se zeptá, když starší HQbird spravuje Firebird jiné verze (aktualizovat ten, nebo nový vedle něj). --yes odpoví na všechny otázky Ano; bez terminálu a bez --yes instalátor skončí s návratovým kódem 4 a nic nezmění.
  • --disable-hqbird v každém případě vypne unity staršího HQbird; --no-hqbird nechá starší HQbird na pokoji (běží dál vedle HQbird 2027).
  • Na heslo SYSDBA se neptá: agent je vezme ze staršího HQbird.
  • HQ Monitor používá přihlášení staršího HQbird: jeho soubor /opt/hqbird/conf/access.properties je zachován, takže se přihlaste loginem a heslem, které jste používali dříve. Instalátor předá soubor uživateli firebird s právy 0600 (starší HQbird jej nechal čitelný pro každého uživatele). Hostovské přihlášení staršího HQbird (access.guest-login) HQ Monitor nepoužívá.

Co je zachováno: firebird.conf, databases.conf / aliases.conf, bezpečnostní databáze, heslo SYSDBA, databáze, zálohy a soubory staršího HQbird. Aktualizace nahradí programové soubory Firebirdu na místě; soubory, které nahradila, jsou zachovány v /opt/fbagent-update-backup/<folder name>-<id>/<time>_<old version>_to_<new version>/ (dvě nejnovější aktualizace zůstávají). Úlohy HQbird (zálohy, sweepy, monitoring) jsou importovány do nového agenta. Licence HQbird staršího HQbird se nepřenáší: nový agent běží v trial režimu, dokud není nainstalována licence nebo dokud server není připojen k vašemu HQCenter.

Od kitu 2027.2.33 (agent 3.4.0) import konfigurace staršího HQbird dělá ještě dvě věci:

  • Zaregistruje databáze staršího HQbird do souboru aliasů Firebirdu (databases.conf, nebo aliases.conf pro 2.5) jako řádky name = path. Starý soubor se nejprve zkopíruje. Databáze je vynechána, když její cesta je již v souboru, nebo když její soubor neexistuje. Soubor s direktivou include se nemění.
  • Odstraní staré logy monitoringu staršího HQbird: obsah složek mon/outcoming a mon/outtrace jeho výstupní složky (složky zůstávají). Nic se neodstraňuje, dokud běží nějaká služba staršího HQbird. Odstranění nelze vrátit zpět: pokud tyto logy potřebujete, zkopírujte je před instalací.

Obě jsou ve výchozím nastavení zapnuté. Klíče hqbird_import.register_databases a hqbird_import.clean_mon_logs v agent_config.json (oba jsou v editoru konfigurace HQ Monitor) je vypnou pro pozdější import; instalátor pro ně nemá žádnou volbu.

Stav unit staršího HQbird před převzetím je uložen v /opt/hqbird/fbagent-hqbird-takeover.json. --uninstall je znovu nezapne.

Nedohlednutelná forma:

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

6. Aktualizace HQbird 2027 na novou verzi

Novější instalátor stejné řady spuštěný na hostiteli s HQbird 2027 aktualizuje nainstalovanou instanci na místě: Firebird, soubory se symboly, agenta a HQ Monitor. Konfigurace, databáze, stav trial nebo licence, port HQ Monitor a přihlášení jsou zachovány.

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

V textovém rozhraní první stránka zobrazuje Plan M10: Update of an installed HQbird 2027, agenta s jeho id (kept) a žádný řádek Agent id; Install spustí aktualizaci. Prostý instalátor vypíše:

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

Aktualizace nemění názvy složky agenta ani unitů: instance v tomto příkladu byla nainstalována před 2027.2.9 a zachovává si fbagent-p3050.

Když je sestavení Firebird v instalátoru stejné jako to již nainstalované (například Firebird 2.5.9.27194 v každém HQbird 2027 pro 2.5), aktualizují se pouze agent a HQ Monitor: Firebird se nezastavuje a nezobrazuje se otázka Confirm to stop.

Zachovaný databases.conf instance nainstalované starším HQbird 2027 nemusí mít alias employee; připojte se k ukázkové databázi její úplnou cestou (sekce 3, krok 4). Na Firebird 3.0 zanechá aktualizace z 2027.2.0 /opt/firebird/examples/empbuild/employee.fdb s právy 0444 a Firebird jej nemůže otevřít (no permission for read-write access); pokud potřebujete ukázkovou databázi: sudo chmod 660 /opt/firebird/examples/empbuild/employee.fdb. Vaše vlastní databáze nejsou dotčeny.

  • Při více instancích řady určete tu, kterou chcete aktualizovat: --fb-root /opt/fb50-2 --port 3056.
  • Opětovné spuštění stejného instalátoru nad nainstalovanou verzí je oprava: programové soubory a unity se zapíší znovu, data zůstanou.
  • Po připojení k HQCenter (sekce 8) se agent, HQ Monitor, Firebird a komponenty clusteru aktualizují z katalogu HQCenter; nový instalátor pak není potřeba.
  • Server nepřipojený k žádnému HQCenter s agentem 3.3.0 nebo novějším (kity z 2027.2.31) aktualizuje agenta, HQ Monitor a fbmcp sám, pokud režim aktualizací není off („Aktualizace bez HQCenter" v sekci 4). Instalace provedená před 2027.2.31 toto získá po jedné aktualizaci novějším instalátorem. Aktualizace instalátorem zachovává režim aktualizací; --auto-update <mode> jej mění.

7. Údržbové příkazy

Každá údržbová akce je spuštění instalátoru s volbami, nebo příkaz agenta ve složce agenta. V terminálu spuštění bez --yes otevře textové rozhraní s těmito volbami již nastavenými (kity po 2027.2.30): zkontrolujte plán na první stránce a poté zvolte Install.

Akce Příkaz
Další instance této řady sudo sh hqbird2027-fb50-linux-<ver>.run --fb-root /opt/fb50-2 --port 3056
Oprava / aktualizace sudo sh hqbird2027-fb50-linux-<ver>.run (při více instancích: --fb-root <folder> --port <port>)
Připojení k HQCenter sudo sh hqbird2027-fb50-linux-<ver>.run --attach attach.json během instalace, nebo později cd /opt/hqbird/fbagent-fb50 && sudo ./fbagent --attach --file /path/attach.json
Odeslání zkušebního e-mailu cd /opt/hqbird/fbagent-fb50 && sudo -u firebird ./fbagent --trial-email [email protected] --accept-privacy
Potvrzení zkušebního kódu z e-mailu cd /opt/hqbird/fbagent-fb50 && sudo -u firebird ./fbagent --trial-confirm <code> (nebo v HQ Monitor)
Instalace licenčního souboru --license <file> během instalace, nebo cd /opt/hqbird/fbagent-fb50 && sudo -u firebird ./fbagent --license-install /path/license.json
Stav instalace sudo /opt/hqbird/fbagent-fb50/fbagent --install-state --json
Stav aktualizací (bez HQCenter) sudo /opt/hqbird/fbagent-fb50/fbagent --update-status
Změna režimu aktualizací (bez HQCenter) HQ Monitor, stránka Updates; nebo sudo sh hqbird2027-fb50-linux-<ver>.run --auto-update all|agent|off
Odstranění sudo sh hqbird2027-fb50-linux-<ver>.run --uninstall [--remove-data] [--force] [--agent-dir /opt/hqbird/fbagent-fb50]

Další instance

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

Nový Firebird jde do /opt/fb50-2 (nová nebo prázdná složka), unit firebird.opt_fb50-2, s vlastním agentem (/opt/hqbird/fbagent-fb50-2, unit hqbirdfbagent-fb50-2) a vlastním HQ Monitor (http://localhost:23056/, unit hqbirdmonitor-fb50-2). Agent dostane nejnižší volné číslo řady: fb50-2 pro druhou instanci, také vedle agenta nainstalovaného před 2027.2.9 (fbagent-p3050). Přihlašovací soubor HQ Monitor /opt/hqbird/conf/access.properties je sdílen instancemi hostitele: nová instance bez --hqmonitor-login zachová stávající přihlášení a --hqmonitor-login/--hqmonitor-password-file na jakékoli instanci změní přihlášení všech z nich (starý soubor je zachován jako access.properties.bak-<time>). Firebird 2.5 nepodporuje druhou instanci: instalátor se zastaví s refused (M17): Firebird 2.5 works only in /opt/firebird, not in <folder> (návratový kód 1, nic se nezměnilo). Nainstalujte Firebird jiné řady vedle něj, například sudo sh hqbird2027-fb50-linux-<ver>.run --fb-root /opt/fb50 --port 3051.

Odstranění

Odstranění na Windows a Linuxu, servery v clusteru a co zůstane na disku je podrobně popsáno v průvodci odstraněním. Stručně:

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 instalátor odstraní jediného agenta v /opt/hqbird. Při více agentech na hostiteli se zastaví (návratový kód 1), vypíše jejich složky a požádá o --agent-dir:

Command
sudo sh hqbird2027-fb50-linux-2027.2.9.run --uninstall --agent-dir /opt/hqbird/fbagent-fb50-2

--uninstall zastaví a odstraní unity agenta a jeho HQ Monitor (hqbirdfbagent-fb50, hqbirdmonitor-fb50), pravidla sudoers agenta a jeho programy (fbagent, hqmonitor) a zavře port HQ Monitor, který instalace otevřela v firewalld nebo ufw. Složka agenta zůstane s konfigurací a logy; --remove-data odstraní složku a také data HQ Monitor v /var/lib/hqmonitor/. Firebird zůstane nainstalován (unit, programová složka, databáze); starší unity HQbird, které byly vypnuty, zůstanou vypnuté. Při více agentech na hostiteli zůstane sdílený přihlašovací soubor HQ Monitor až do odstranění posledního agenta.

Pokud agent provozuje RCM hostitele a jiní agenti toto RCM používají, --uninstall odmítne s návratovým kódem 5 a nic nezmění: 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 odstraní agenta přesto; cluster pak ztratí své CA (žádné nové certifikáty, žádní noví členové). Unit RCM zůstane, dokud jej používají jiní agenti hostitele. Chcete-li, aby se jiný agent stal vlastníkem nového RCM, když starý vlastník zmizel: fbagent --cluster-init <id> --rcm-takeover (nové CA: propojte členy znovu).

Nápověda na konci instalace (Uninstall: sudo sh ... --uninstall) nemá --agent-dir: při více instancích jej přidejte, jak je uvedeno výše.

Chcete-li odstranit také Firebird instance (instalátor to nedělá; nejprve vytvořte zálohy gbak jejích databází), například Firebird v /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. Připojení k vašemu HQCenter

HQCenter je centrální server vaší společnosti, který spravuje agenty HQbird: licence, konfiguraci, aktualizace, přehled záloh. Bez HQCenter pracuje agent samostatně s verzemi instalátoru a zkušebním nebo licenčním souborem.

Diagram
  1. V administračním panelu HQCenter otevřete Tokens (https://<hqcenter>:8443/admin/tokens). Ve formuláři Install script zvolte licenci (nebo žádnou), režim, počet serverů a platnost (1 až 365 dní); pole platforma a Firebird se nepoužívají. Klikněte na Download connection file a uložte attach.json. Soubor obsahuje tajný token: chraňte jej (chmod 600), po použití jej smažte a zrušte token v seznamu na stejné stránce. Formulář se zobrazuje pouze když je nastaveno admin_panel.install_script_url.
  2. Zkopírujte attach.json na server.
  3. Připojte jedním ze dvou způsobů:
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

S běžným tokenem příkaz čeká, dokud administrátor HQCenter neschválí požadavek (až 30 minut). S licenčním tokenem je agent připojen okamžitě a získá licenci. Po připojení zkušební období končí, když HQCenter dá agentovi licenci; agent, HQ Monitor, Firebird a komponenty clusteru se pak aktualizují z katalogu HQCenter. Neúspěšné připojení během instalace instalaci nevrátí zpět: souhrn to uvede a výše uvedený příkaz jej zopakuje.

Požadavky: HQCenter (goafts) 1.15.0 nebo novější (starší verze nemají tlačítko pro soubor připojení); server dosáhne bootstrap portu HQCenter jednou pro připojení a poté portu agentů (ve výchozím nastavení 443). HQCenter může být bez internetu. Druhé připojení stejného serveru ke stejnému HQCenter vyžaduje schválení administrátora i s licenčním tokenem.

9. Neobsluhovaná instalace a skripty

Každá volba funguje i v terminálu. Neobsluhované spuštění vyžaduje --yes (odpovídá na otázky plánu; bez terminálu a bez --yes se instalátor zastaví s návratovým kódem 4). --yes nikdy neotevře textové rozhraní. Skript, který spustí instalátor v terminálu a sám odpovídá na jeho otázky (například pomocí expect), musí přidat --no-tui nebo nastavit HQBIRD_NO_TUI=1: kity po 2027.2.30 tam otevírají stránky. Návratový kód sděluje výsledek; podrobnosti jsou v terminálu a v /var/log/fbagent/install.log.

Volby

Volba Význam Výchozí
--fb-root DIR Složka nového Firebird (nová nebo prázdná); nebo složka Firebird k aktualizaci /opt/firebird, poté /opt/fb<NN>
--port N Port Firebird 3050 pro první Firebird; pro jinou řadu port řady (3053 pro 3.0, 3054 pro 4.0, 3055 pro 5.0)
--sysdba-pass-file F, --sysdba-pass P Heslo SYSDBA nového Firebird (první řádek F; P se zapíše do souboru s právy 0600) vygenerováno, uloženo v /root/fbagent-install-sysdba.txt; další Firebird na hostiteli převezme heslo z tohoto souboru
--agent-id ID agent.id nového agenta; pouze při první instalaci, nainstalovaný agent si zachová své id („The agent id" v sekci 3) název hostitele + datum + instance
--hqmonitor-port N Port HQ Monitor 20000 + port Firebird
--hqmonitor-login L --hqmonitor-password-file F Přihlášení k HQ Monitor, sdílené všemi instancemi hostitele: zadáno na jedné instanci, změní přihlášení všech admin + vygenerované heslo; aktualizace nebo další instance zachová stávající přihlášení
--email ADDR --accept-privacy [--trial-zone RU|EU|BR] Zkušební e-mail (30 dní); adresa se odešle na zkušební server dodavatele žádný
--auto-update all|agent|off Aktualizace serveru nepřipojeného k žádnému HQCenter (kity od 2027.2.31): agent = agent, HQ Monitor a fbmcp se aktualizují samy, balíček Firebird čeká na vás; all = také Firebird, v jeho okně; off = žádné kontroly aktualizací („Aktualizace bez HQCenter" v sekci 4) režim se nemění; nový agent má agent

| --license F | Soubor licence k instalaci | žádný | | --attach F | Připojení k vašemu HQCenter (attach.json) | žádné | | --no-hqbird, --disable-hqbird | Ponechat starší HQbird beze změny / vypnout všechny jeho jednotky | automaticky | | --no-debug | Neinstalovat ladicí soubory Firebird | instalováno | | --no-fbmcp | Neinstalovat fbmcp (server MCP pro AI klienty) a neměnit fbmcp tohoto hostitele | instalováno | | --fbmcp-allow-from A,B | Zapnout vzdálený režim fbmcp pro tyto administrátorské adresy (IP nebo CIDR) | pouze lokálně | | --fbmcp-port N, --fbmcp-dns NAME,..., --fbmcp-ip ADDR | Vzdálený port fbmcp; další názvy pro jeho certifikát; adresa pro certifikát a listener | port 8650 | | --rcm on\|off | Nainstalovat konzoli clusteru RCM na tomto hostiteli a vytvořit nový cluster (agent 3.1.0 a novější) | dotázáno; Ne | | --rcm-password-file F | Heslo správce RCM s --rcm on (první řádek F) | vygenerováno, zobrazeno na konci | | --cluster-id ID | ID clusteru s --rcm on | název hostitele | | --cluster-pairing on\|off | Režim zjišťování: párovací okno na 24 hodin, RCM může pozvat tohoto agenta | dotázáno; Ne | | --rcm-allow A,B,... | V režimu zjišťování může tohoto hostitele pozvat pouze tyto RCM (IP, CIDR nebo název hostitele) | jakékoli RCM | | --pairing-port N | Párovací port 7450–7459 nového agenta; vybere slot (porty uzlů 7051+k, 7061+k). Pozdější nastavení slot zachová | první volný slot | | --cluster-node on\|off | Umístit službu uzlu clusteru do mezipaměti agenta | on | | --yes | Odpovědět Ano na otázky plánu (Ne na otázky clusteru) | dotázáno | | --check | Pouze kontroly, knihovny a plán; nic se nemění | — | | --plan-help | Vypsat, co znamenají kódy plánu (M1, M2, …), a ukončit | — | | --no-tui | Prostý instalátor bez textového rozhraní; také proměnná HQBIRD_NO_TUI=1 („Prostý instalátor" v části 3) | textové rozhraní v terminálu | | --lang en\|ru\|pt-BR\|de | Jazyk instalátoru; také proměnná HQBIRD_LANG („Jazyk instalátoru" v části 3) | locale konzole UTF-8, jinak angličtina | | --tmpdir DIR | Rozbalit sem (složka, kde se mohou spouštět programy) | /var/tmp | | --extract DIR | Pouze rozbalit obsah do DIR/payload a ukončit | — | | --uninstall [--remove-data] [--force] [--agent-dir DIR] | Odebrat agenta a HQ Monitor (Firebird zůstává); --force odebere i agenta, který na hostiteli provozuje RCM, zatímco jej používají jiní agenti | — |

Možnosti lze psát jako --port 3055 nebo --port=3055. Relativní cesty se počítají od aktuální složky.

Příklady

Nová instalace s výchozími hodnotami:

Command
sudo sh hqbird2027-fb50-linux-2027.2.9.run --yes
echo "exit code $?"

Nová instalace do zvolené složky a portu, s heslem SYSDBA ze souboru a přihlášením 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

Nová instalace s e-mailem pro zkušební verzi, souborem licence a souborem 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

Aktualizace staršího HQbird, všechny jednotky staršího HQbird vypnuty:

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

Aktualizace HQbird 2027 na novou verzi (jedna instance; při více instancích přidejte --fb-root a --port):

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

Druhá instance Firebird 5.0 na portu 3056:

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

Odebrání:

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

Skript, který se zastaví při neúspěšné instalaci:

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"

Server bez internetu: knihovny OS

Firebird dané řady potřebuje tyto knihovny z OS (kromě glibc):

Řada Balíčky (Debian/Ubuntu) Balíčky (rodina 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 obvykle nic (libstdc++6 je v základním systému) obvykle nic

Instalační sady po 2027.2.30 řad 3.0, 4.0 a 5.0 také potřebují program colrm, který používá instalační skript Firebird: balíček bsdextrautils (bsdmainutils na starších Debian a Ubuntu). Minimální Debian jej nemá; rodina RHEL jej má v util-linux, který je vždy přítomen.

Když balíček chybí a úložiště není dostupné, instalátor se zastaví s návratovým kódem 6 a nic se nezmění:

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

V rodině RHEL je libtommath v EPEL: při dostupném úložišti instalátor sám přidá epel-release. Bez něj jsou příkazy dnf install -y epel-release, dnf download --resolve <packages> a dnf install -y ./*.rpm. --check vypíše stejný seznam předem, takže balíčky lze připravit před instalačním oknem.

Návratové kódy

Kód Význam Změny na hostiteli
0 Hotovo (upozornění na e-mail pro zkušební verzi, attach nebo licenci jsou v souhrnu) ano
1 Odmítnuto: hostitel, možnost, soubor nebo plán (důvod je vypsán). Také: Quit v textovém rozhraní žádné
2 Instalace selhala a byla vrácena zpět. Také: instalátor byl zastaven signálem (Ctrl+C) vráceno zpět; žádné, pokud byl zastaven před instalací
3 Instalace selhala a vrácení zpět nebylo úplné (souhrn uvádí, co zkontrolovat) částečně
4 Otázka plánu nebyla potvrzena (žádný terminál, žádné --yes). žádné
5 Obsah neprošel kontrolou (sha256, podpisy): stáhněte soubor znovu. S --uninstall: odmítnuto, agent provozuje RCM hostitele a používají jej jiní agenti (část 7) žádné
6 Chybí knihovny OS a úložiště balíčků není dostupné žádné
7 Je nainstalován Firebird z balíčků distribuce žádné

10. Řešení problémů

Problém Co dělat
run as root (sudo sh ...) Spusťte instalátor se sudo nebo jako root
Stránky textového rozhraní se neotevřou První řádek uvádí proč: needs a window of 80x24 or larger (zvětšete okno; tmux se stavovým řádkem zabere jeden řádek) nebo needs bash 4.4 or newer. Prostý instalátor, který se poté spustí, provede stejnou instalaci
Nesprávné znaky nebo rozbité řádky na stránkách Nastavte terminál na UTF-8 nebo spusťte s --lang en; --no-tui spustí prostý instalátor
/var/tmp is mounted noexec Spusťte znovu s --tmpdir /root (jakákoli složka, kde se mohou spouštět programy)
is damaged or cut (návratový kód 5) Zkopírujte soubor .run znovu a porovnejte jeho sha256sum se zveřejněnou hodnotou
Návratový kód 6, chybí knihovny Připravte balíčky podle výpisu (část 9) a poté instalátor spusťte znovu
Návratový kód 7, Firebird z balíčků distribuce Odstraňte balíčky (apt-get remove firebird3.0-server, ponechte zálohu gbak) nebo použijte online instalátor s --import-firebird
refused (M17): Firebird 2.5 works only in /opt/firebird Druhý Firebird 2.5 není možný; nainstalujte vedle něj jinou řadu (část 7)
--uninstall odmítnuto (návratový kód 1) při více agentech Přidejte --agent-dir se složkou ze seznamu, například --agent-dir /opt/hqbird/fbagent-fb50-2
--uninstall odmítnuto (návratový kód 5): this agent runs the RCM of the host Nejprve odeberte cluster v konzoli RCM, nebo spusťte znovu s --force (část 7)
no permission for read-write access k employee.fdb po aktualizaci (3.0) sudo chmod 660 /opt/firebird/examples/empbuild/employee.fdb (část 6)
refused (M14): the folder is not empty Zvolte prázdnou nebo novou složku pomocí --fb-root, nebo určete Firebird k aktualizaci
Návratový kód 2 nebo 3 Přečtěte si /var/log/fbagent/install.log; jednotky jsou zpět ve stavu před spuštěním (kód 2) nebo vyžadují kontrolu (kód 3)
HQ Monitor se neotevře systemctl status hqbirdmonitor-fb50 (hqbirdmonitor-p<port> před 2027.2.9); zkontrolujte, že na portu nic jiného nenaslouchá; otevřete port ve firewallu; --hqmonitor-port pro jiný port
Ztracené heslo k HQ Monitor Spusťte instalátor znovu (oprava) s --hqmonitor-login admin --hqmonitor-password-file <file>; starý /opt/hqbird/conf/access.properties je zachován jako access.properties.bak-<time>. Nové přihlášení platí pro všechny instance hostitele
E-mail pro zkušební verzi nebyl odeslán (žádná síť) Odešlete jej později: cd /opt/hqbird/fbagent-fb50 && sudo -u firebird ./fbagent --trial-email <address> --accept-privacy
SELinux (AlmaLinux, RHEL) Podporováno v režimu enforcing: instalátor obnoví kontexty souborů, které zapíše; není třeba nic dělat