HQbird 2027 pro Linux: průvodce instalací
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. Co instalátor nainstaluje
- 2. Instalace v kostce
- 3. Nová instalace
- 4. Po instalaci
- 5. Aktualizace staršího HQbird (2024 a dříve)
- 6. Aktualizace HQbird 2027 na novou verzi
- 7. Údržbové příkazy
- 8. Připojení k vašemu HQCenter
- 9. Neobsluhovaná instalace a skripty
- 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.confpro 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-debugje přeskočí. - HQbird agent (
fbagent): systemd unithqbirdfbagent-fb50, běžící pod uživatelemfirebird, 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, adresahttp://<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/hqbirdrcma běží jako unithqbirdrcm; souhrn vypíše jeho adresu na řádkuRCM:. Uzel dostane svou unit (napříkladhqclusternode-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 offjej 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 unithqbirdrcmani řádekRCM:.
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
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
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.sha256Ostatní ř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é)
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
sudo sh hqbird2027-fb50-linux-2027.2.9.runKity 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.
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: quitHorní řá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-tuinebo 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; TERMjedumbnebo není nastaven;- okno je menší než 80 sloupců na 24 řádků (uvnitř
tmuxs 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:
[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 --uninstallTento 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:
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]aTurn 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.--yesa 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é proroota 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í:
- možnost
--lang en|ru|pt-BR|de; - proměnná
HQBIRD_LANG; - locale konzole (
LC_ALL, potéLC_MESSAGES, potéLANG), když je to locale UTF-8; - angličtina.
Druhý řádek výstupu říká, který jazyk to je a jak jej změnit. Tento řádek je vždy anglicky:
[install] Language: Русский (auto). Use --lang en to change.Poznámky:
- PuTTY neposílá
LANGna server. Počítá se vlastní locale serveru, takže jazyk je často angličtina. Použijte--lang. - S
--yesa bez terminálu je automatický jazyk angličtina: skripty čtou tento výstup.--langzde stále funguje. - Instalátor potřebuje pro ostatní jazyky locale UTF-8 na hostiteli
(
C.UTF-8neboen_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.loga 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á:
[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 IDzadá 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-idzde 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
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.fdbPouž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).
/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--jsonpro 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:
Co uvidíte na terminálu:
[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-roota--portjej 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 versionse zeptá, když starší HQbird spravuje Firebird jiné verze (aktualizovat ten, nebo nový vedle něj).--yesodpoví na všechny otázky Ano; bez terminálu a bez--yesinstalátor skončí s návratovým kódem 4 a nic nezmění. --disable-hqbirdv každém případě vypne unity staršího HQbird;--no-hqbirdnechá 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.propertiesje zachován, takže se přihlaste loginem a heslem, které jste používali dříve. Instalátor předá soubor uživatelifirebirds 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, neboaliases.confpro 2.5) jako řádkyname = 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 direktivouincludese nemění. - Odstraní staré logy monitoringu staršího HQbird: obsah
složek
mon/outcomingamon/outtracejeho 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:
sudo sh hqbird2027-fb50-linux-2027.2.9.run --yes --disable-hqbird6. 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.
sudo sh hqbird2027-fb50-linux-2027.2.9.runV 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:
[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
sudo sh hqbird2027-fb50-linux-2027.2.9.run --fb-root /opt/fb50-2 --port 3056Nový 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ě:
# the agent and HQ Monitor of this instance; Firebird, the databases, configs and logs stay
sudo sh hqbird2027-fb50-linux-2027.2.9.run --uninstall
# the same, and the agent's configuration, logs, license state and HQ Monitor data too
sudo sh hqbird2027-fb50-linux-2027.2.9.run --uninstall --remove-dataBez --agent-dir 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:
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:
B=/opt/fb50-2
U=firebird.$(echo ${B#/} | tr / _) # /opt/fb50-2 -> firebird.opt_fb50-2
systemctl list-unit-files "$U*" # the units that will be removed
sudo systemctl disable --now $(systemctl list-unit-files "$U*" --no-legend | awk '$1 !~ /@/ {print $1}')
sudo rm -f /usr/lib/systemd/system/$U* /etc/systemd/system/$U*
sudo systemctl daemon-reload
sudo rm -rf $B8. 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.
- 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žteattach.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 nastavenoadmin_panel.install_script_url. - Zkopírujte
attach.jsonna server. - Připojte jedním ze dvou způsobů:
# 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.jsonS 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:
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:
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.txtNová instalace s e-mailem pro zkušební verzi, souborem licence a souborem attach:
sudo sh hqbird2027-fb50-linux-2027.2.9.run --yes \
--email [email protected] --accept-privacy --trial-zone EU \
--license /root/hqbird-license.json \
--attach /root/attach.jsonAktualizace staršího HQbird, všechny jednotky staršího HQbird vypnuty:
sudo sh hqbird2027-fb50-linux-2027.2.9.run --yes --disable-hqbirdAktualizace HQbird 2027 na novou verzi (jedna instance; při více instancích přidejte
--fb-root a --port):
sudo sh hqbird2027-fb50-linux-2027.2.9.run --yesDruhá instance Firebird 5.0 na portu 3056:
sudo sh hqbird2027-fb50-linux-2027.2.9.run --yes --fb-root /opt/fb50-2 --port 3056Odebrání:
sudo sh hqbird2027-fb50-linux-2027.2.9.run --uninstall
sudo sh hqbird2027-fb50-linux-2027.2.9.run --uninstall --remove-dataSkript, který se zastaví při neúspěšné instalaci:
#!/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í:
[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 ./*.debV 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 |