Instalace a aktualizace
Instalace bez překvapení
Jeden instalátor pro každou řadu Firebird. Najde Firebird, starý HQbird a agenty na serveru, zobrazí plán a nic nezmění, dokud neřeknete „Ano“. Poté se agent aktualizuje sám, konzole a Firebird samostatně, s kontrolami a vrácením změn.
- 4 instalátory: Firebird 2.5 · 3.0 · 4.0 · 5.0
- 0 změn před potvrzením plánu
- není potřeba internet vše v jednom souboru
- Windows a Linux průvodce, tichý režim, .run
- vrácení změn pokud instalace nebo aktualizace selže
setup.exe · .run
Co je v sadě
Instalátor je jeden soubor: hqbird2027-fb50-setup-<version>.exe pro Windows nebo hqbird2027-fb50-linux-<version>.run pro Linux. Obsahuje vše, co server potřebuje. Nic se nestahuje.
Každý instalátor instaluje jednu řadu Firebird. Vyberte řadu, na které běží vaše databáze. Instalaci provádí agent uvnitř sady: zkontroluje server, sestaví plán a spustí ho.
| Komponenta | Co dělá | Windows | Linux |
|---|---|---|---|
| Firebird, sestavení HQbird | Nový server nebo aktualizace na místě. U již nainstalovaného serveru se do firebird.conf přidá jeden řádek: MonitoringPlugin = fblwmon. U nového serveru instalátor také nastaví port. databases.conf, bezpečnostní DB a heslo SYSDBA se nemění. | služba FirebirdServer… | /opt/firebird |
| agent fbagent | Zálohy, monitorování, údržba, aktualizace. | HQbirdFBAgent-fb50 | hqbirdfbagent-fb50, uživatel firebird |
| HQbird Monitor | Webová konzole pro tento server. Port = 20000 + port Firebird: pro 3050 je to 23050. Port se volí při instalaci a později se nemění, ani když změníte port Firebird. | HQbirdMonitor-fb50 | hqbirdmonitor-fb50 |
| Komponenty clusteru | Programy clusteru se na server nainstalují, ale nezapnou: RCM a párovací okno jsou ve výchozím nastavení vypnuté. RCM udělá ze serveru centrum nového clusteru a otevře porty 7443 a 7444. Párovací okno otevře porty 7450–7459 na 24 hodin: přes něj může RCM jiného serveru pozvat tento server. Obojí můžete zapnout i po instalaci. | stránka průvodce „Replication and cluster setup“; /RCM, /DISCOVERY | --rcm on, --cluster-pairing on |
| server fbmcp MCP | Přístup pro AI klienty k Firebird. Ve výchozím nastavení pouze z tohoto serveru. | zaškrtávací políčko v průvodci nebo /NOFBMCP | --no-fbmcp |
| Ladicí soubory Firebird | Symboly pro analýzu pádů Firebird. | — | ano, --no-debug je vypne |
- WindowsPodporováno: Windows 10 a 11, Windows Server 2016 a novější, 64bit. Práva správce. Instalátor je podepsán IBSurgeon Software: Windows zobrazí vydavatele v žádosti o práva.
- Průvodce nebo tichý režimKaždá stránka průvodce je dostupná i jako přepínač:
/VERYSILENT /YES /LOG=…. Vhodné pro skripty a pro sto serverů. - Průvodce v 8 jazycíchAngličtina, portugalština (Brazílie), němčina, ruština, španělština, polština, turečtina, zjednodušená čínština. Výchozí je jazyk Windows. Přepínač:
/LANG=en|pt_BR|de|ru|es|pl|tr|zh_CN. - Název serveruPrůvodce se zeptá na název nového agenta; HQCenter zobrazí server pod tímto názvem. Výchozí je název počítače. Tichý režim:
/AGENTID=, na Linuxu--agent-id. Již nainstalovaný agent si ponechá svůj název.
- Linuxx86_64, jádro 3.2 nebo novější, systemd, root. Ubuntu, Debian, AlmaLinux, Rocky, RHEL, Oracle Linux, openSUSE, RED OS a další s apt, dnf, yum nebo zypper.
- Server bez internetuInstalátor získá několik knihoven OS (libtommath, ICU) z repozitáře. Pokud repozitář není, vypíše přesné příkazy a nic nezmění.
Sada se kontroluje dvakrát. Před rozbalením: sha256 celé sady. Před instalací Firebird a agenta: podpis každého souboru. Poškozené stažení zastaví instalaci dříve, než dojde ke změně Firebird, agenta nebo konzole.
fbagent --install-plan
Nejprve plán, potom změny
Nejprve instalátor pouze čte: služby, registr, složky Firebird a HQbird. Poté zobrazí, co našel a co bude dělat. Změny začnou, až když řeknete „Ano“.
Vyberte, co je na serveru, a podívejte se na plán. Texty jsou zkrácené a přeložené; pořadí a rozhodnutí jsou stejná jako v instalátoru Firebird 5.0.
- 1Kontrola serverupráva, bitovost; na Linuxu také systemd a jádro
- 2Kontrola sadysha256 před rozbalením; podpisy souborů před instalací
- 3Plánco bylo nalezeno a co bude provedeno
- 4Otázkynázev serveru pro HQCenter; zastavit Firebird? jiná verze?
- 5InstalaceFirebird, agent, konzole, služby
- 6✓ Výsledekslužby, adresa konzole, přihlášení
Pokud se něco pokazí
Odmítnutí ve fázi plánu (port je obsazen, složka není prázdná) nic nezmění: instalátor uvede důvod. V průvodci nelze opustit stránku, dokud je hodnota chybná.
Selhání během instalace, před spuštěním služby agenta: služby se vrátí do předchozího stavu. Starý HQbird, pokud byl zastaven, se znovu spustí.
| Kód | Význam (Linux .run) |
|---|---|
| 0 | Hotovo |
| 1 | Odmítnuto: server, přepínač nebo plán. Nic se nezměnilo |
| 2 | Instalace selhala, změny vráceny |
| 3 | Vrácení změn neúplné: výsledek uvádí, co zkontrolovat |
| 4 | Je potřeba odpověď: žádný terminál a žádné --yes |
| 5 | Sada neprošla kontrolou: stáhněte ji znovu |
| 6 | Žádné knihovny OS a žádný repozitář |
| 7 | Firebird z distribučních balíčků |
| Kód | Význam (Windows setup.exe) |
|---|---|
| 0 | Nainstalováno |
| 1 | Odmítnuto před instalací: chybný přepínač nebo soubor, je nainstalována novější verze, chybí práva správce |
| 4 | Instalátor měl otázku, ale chybí přepínač /YES |
| 7 | Kontrola serveru nebo instalace selhala. Důvod je v logu a ve výsledkovém souboru |
| 10 | Nainstalováno, ale připojení k HQCenter selhalo |
-p3050); nové instalace dostanou -fb50.FBDataGuard → fbagent
Přechod z HQbird 2024
Instalátor najde starý HQbird a Firebird, kterému slouží. Tento Firebird se aktualizuje na místě, úlohy FBDataGuard se přesunou do agenta, staré služby se zastaví. Databáze, konfigurace a hesla zůstávají.
- Co se nemění
databases.confneboaliases.conf, bezpečnostní databáze, heslo SYSDBA, databáze, zálohy a soubory starého HQbird. Vfirebird.confse pouze přidá řádekMonitoringPlugin = fblwmon, pokud chybí. - Kopie starého FirebirdSložka programu starého Firebird zůstává vedle jako
<folder>.old_<time>. - ÚlohyZálohy gbak a nbackup, sweep, statistiky indexů. Import proběhne jednou a projde kontrolou nové konfigurace; stará konfigurace zůstává.
- Staré zálohyAgent převezme zálohy z deníků FBDataGuard do svých záznamů. Pravidla uchovávání a obnova je vidí stejně jako nové. Názvy úrovní nbackup zůstávají stejné.
- Názvy úlohNázev úlohy končí názvem databáze z FBDataGuard, například "Verified backup - MANUAL". Skupinové úlohy opakují strom zdrojových složek.
- Staré služby: tři možnostiAutomaticky (doporučeno): zakázat je, když každý Firebird obsluhovaný FBDataGuard má agenta. Zakázat vše:
/DISABLEHQBIRD. Ponechat beze změny:/NOHQBIRD. - Můžete se vrátitStav každé služby před jejím zakázáním se ukládá do
fbagent-hqbird-takeover.json. S tímto souborem lze starý HQbird znovu zapnout. - LicenceStará licence HQbird se nepřenáší. Zkušební období běží, dokud nezískáte novou licenci nebo se nepřipojíte k HQCenter.
- Nejasná cestaPokud import nemůže rozvinout substituci v cestě FBDataGuard, ponechá ji beze změny a úlohu nechá zakázanou. Opravte cestu a úlohu povolte.
Pokud jsou úlohy importovány, ale staré služby stále běží (například server má dva servery Firebird pod FBDataGuard), úlohy přijdou zakázané. Tímto způsobem se jedna úloha nespustí dvakrát.
Porty · složky · služby
Několik serverů Firebird na jednom stroji
Jeden agent na jeden Firebird. Nová instance se nainstaluje vedle ostatních, na vlastním portu, s vlastním agentem a vlastní konzolí. Nainstalované instance se nemění.
Přidejte servery Firebird a podívejte se, které názvy a porty instalátor zvolí.
- Porty podle řadyPrvní Firebird na serveru dostane 3050. Další: 3052 pro 2.5, 3053 pro 3.0, 3054 pro 4.0, 3055 pro 5.0. Instalátor nezaujme port, který je používán.
- Druhá instance stejné řadyČíslo
-2v názvech složek a služeb. Ve Windows jde o volbu průvodce "Install another instance"; port je první volný v rozsahu řady.
- Aktualizace pouze v rámci řady5.0.x → 5.0.y. Přechod z 3.0 na 5.0 znamená druhou instanci vedle první; databáze se přesouvají zálohou a obnovou.
- XNET ve WindowsFirebird, který není na portu 3050, dostane vlastní název
IpcName = FIREBIRD_<port>. Místní připojení XNET k druhému serveru fungují. - Jedna konzole na agentaHQbird Monitor na 20000 + port Firebird: 23050, 23055. Jeden přihlašovací soubor pro všechny instance na serveru.
- Porty jsou pevnéPorty konzole a místního API agenta se zapisují při instalaci. Pokud později změníte port Firebird, zůstanou stejné. Agent nepřijímá stejné porty.
- Cluster: slot pro každého agentaKaždý agent na serveru dostane vlastní slot od 0 do 9: párovací port 7450 + slot, porty uzlů 7051 + slot a 7061 + slot. Tak se dva agenti jednoho serveru mohou připojit ke clusteru. Přepínač
--pairing-portnastavuje slot explicitně.
Image · compose · porty
HQbird v Dockeru
Pro každou řadu Firebird je připraven image. Firebird, agent a HQbird Monitor běží v kontejneru. Agent nainstaluje uzel clusteru uvnitř kontejneru sám, když se server připojí ke clusteru. RCM nainstaluje pouze tehdy, když je tento server určen jako RCM clusteru.
| Image | Firebird | Port Firebird | HQbird Monitor |
|---|---|---|---|
ghcr.io/ibsurgeon/hqbird2027-fb50 | 5.0 | 3050 | 23050 |
ghcr.io/ibsurgeon/hqbird2027-fb40 | 4.0 | 3050 | 23050 |
ghcr.io/ibsurgeon/hqbird2027-fb30 | 3.0 | 3050 | 23050 |
ghcr.io/ibsurgeon/hqbird2027-fb25 | 2.5 | 3050 | 23050 |
- První spuštěníZkopírujte
compose.yamlze sady, vložte heslo SYSDBA do tajného souboru, odstraňte#z řádkůsecrets:a spusťtedocker compose up -d. Server je připraven, kdyždocker compose pszobrazíhealthy. - Port FirebirdProměnná
HQBIRD_FB_PORT, výchozí 3050. HQbird Monitor naslouchá na 20000 + tento port. - Podpis imageImage jsou podepsány nástrojem cosign. Veřejný klíč pro kontrolu zatím není zveřejněn.
- Několik instancí na jednom hostiteliFirebird na 3050 + N, HQbird Monitor na 20000 + port Firebird, uzel clusteru na 7051 + N. RCM může mít na hostiteli pouze jedna instance.
- Stejné číslo portu venku i uvnitřPublikujte
3051:3051, ne3051:3050. Agent a cluster hlásí port, který vidí uvnitř kontejneru. - ClusterAdresa člena je adresa hostitele Dockeru. Publikujte port uzlu a pro RCM porty 7443 a 7444.
Docker publikuje porty mimo ufw. Pravidlo ufw "pouze port 22" nezavře porty kontejneru. Publikujte port na jedné adrese hostitele nebo jej zavřete externím firewallem.
Cloud a Docker: nastavení, svazky, porty, aktualizaceAgent · konzole · cluster · Firebird
Aktualizace po instalaci
Po připojení k HQCenter agent sám aktualizuje sebe, HQbird Monitor, komponenty clusteru, fbmcp a Firebird. Server bez HQCenter se také aktualizuje sám: agent odebírá nové verze z aktualizačního serveru IBSurgeon.
Agent uvidí novou verzi sebe sama v HQCenter do minuty. Nové verze HQbird Monitor, fbmcp a Firebird: do hodiny. Každá aktualizace probíhá podle jednoho vzoru: kontrola, uložení bodu obnovení, nahrazení, ověření funkčnosti. Pokud nefunguje, obnoví se stará verze.
Aktualizace bez HQCenter
- Co se aktualizuje samoAgent, HQbird Monitor a server MCP. Kontrola probíhá jednou za 6 hodin.
- Firebird čeká na příkazBalíček Firebird se stáhne a čeká. Správce jej použije: tlačítkem na stránce Updates nebo příkazem
fbagent --firebird-update --apply. - Režim volíte vyInstalační přepínač
--auto-update all|agent|off, ve Windows/AUTOUPDATE=all|agent|off. Výchozí jeagent.allnainstaluje také Firebird, v aktualizačním okně.offnic nekontroluje.
- Stránka Updates v HQbird MonitorZobrazuje, odkud agent odebírá verze, režim a poslední odpověď serveru, stav aktualizací Firebird, konzole a serveru MCP. Správce mění režim a aplikuje balíček Firebird.
- Kontrola zdrojeAktualizační server se kontroluje proti připnutému klíči. Podpis dodavatele je vždy vyžadován.
- Cluster jde přes centrumUzel clusteru a RCM se takto neaktualizují: aktualizuje je HQCenter nebo RCM.
Samoaktualizace agenta
- Pouze vpředAgent nenainstaluje verzi starší než svou vlastní, a to ani povinnou. Kontrola proběhne dříve, než se stáhne první bajt. Falešný server tak nemůže vrátit starou zranitelnou sestavu. Výjimkou je jedna stará verze povolená ve vlastní konfiguraci agenta (
allow_downgrade_to). - PodpisVydání jsou podepsána klíčem Ed25519; veřejný klíč je zabudován v agentovi. Nesprávný podpis je vždy odmítnut. Režim „pouze podepsané“ se zapíná ve vlastní konfiguraci agenta, nikoli ze serveru.
- Ruční vrácení zpětVedle agenta je skript
rollback_to_version_NNN: obnoví předchozího agenta a konfiguraci a zablokuje nefunkční verzi. Uchovávají se dva nejnovější body obnovení; starší se automaticky mažou. - Linux: root spouští pouze svou vlastní kopiiAgent běží jako
firebird. Nahrazení provádí ověřená kopie ve složce, do které může zapisovat pouze root.
Aktualizace Firebird
Firebird se aktualizuje pouze v rámci své řady a pouze na novější sestavu. Agent může balíček kdykoli stáhnout a připravit, ale Firebird zastaví pouze v aktualizačním okně.
- 1Přípravastažení, podpis, sestava není starší než engine
- 2Oknodenní okno; povinné vydání také čeká na okno
- 3Úlohyprobíhá gbak, nbackup nebo SQL skript: pokus se odkládá
- 4Nahrazenístaré soubory enginu se odloží, konfigurace zůstávají
- 5KontrolaFirebird se spustí a odpovídá na svém portu
- 6✓ nebo vrácení zpětstaré soubory se vrátí, sestava se zablokuje
| Co se aktualizuje | Ochrana | Pokud selže |
|---|---|---|
| agent fbagent | Podpis, pouze novější, připraven do 180 s a 45 s běhu | Vrácení zpět, 30minutová pauza; druhé selhání verzi zablokuje |
| HQbird Monitor, cluster, fbmcp | Podpis, pouze novější než nainstalovaná | Předchozí verze zůstává; uchovávají se 2 nejnovější kopie |
| Firebird | Okno, čekání na zálohy, kontrola po spuštění | Starý engine se vrátí, sestava se zařadí na seznam blokovaných |
Zablokovaná verze se znovu nenainstaluje, ale další verze se nainstaluje jako obvykle. Server tak neprochází smyčkou „aktualizace → vrácení zpět → aktualizace“.
Složky · logy · odinstalace
Kde jsou soubory a jak odinstalovat
Windows
C:\HQbird\ Firebird50\ Firebird 5.0, konfigurace, bezpečnostní DB fbagent-fb50\ agent a HQbird Monitor agent_config.json konfigurace agenta logs\ bak\ update\ logy, kopie, mezipaměť aktualizací C:\HQbirdData\ pracovní data agenta a konzole config\access.properties přihlášení do konzole C:\ProgramData\fbagent\ výsledek instalace a log
Linux
/opt/firebird/ Firebird 5.0 (druhá řada: /opt/fb50) /opt/hqbird/ conf/access.properties přihlášení do konzole, 0600 fbagent-fb50/ agent a HQ Monitor agent_config.json konfigurace agenta logs/ bak/ update/ logy, kopie, mezipaměť aktualizací /var/lib/hqmonitor/ data konzole /var/log/fbagent/install.log instalační log, bez hesel
- Odinstalace se nedotkne vašich databázíVaše databáze a zálohy (
*.fdb,*.gdb,*.fbk,*.nbk) vždy zůstanou. Odstranění dat smaže pouze bezpečnostní DB a ukázky z balíčku Firebird. - Windows„Aplikace“: odstraní agenta, konzoli, RCM tohoto agenta, pravidla firewallu a Firebird, který tento instalátor nainstaloval jako nový. Pokud RCM tohoto agenta používají jiní agenti, průvodce se zeptá „Remove this instance anyway?“; tichá odinstalace vyžaduje
/FORCE. Aktualizovaný Firebird zůstává. Konfigurace a bezpečnostní DB se odstraní pouze při volbě „remove data“.
- Linux
--uninstallodstraní služby agenta a konzole, RCM tohoto agenta, pravidla sudoers a porty, které instalátor otevřel ve firewalld nebo ufw. Agent nejprve opustí cluster. Pokud jeho RCM používají jiní agenti, potřebujete přepínač--force. Firebird zůstává.--remove-dataodstraní také konfiguraci, logy a data konzole. - Starý HQbirdOdinstalace HQbird 2027 znovu nezapne staré služby: o tom rozhoduje správce pomocí souboru stavu.
sudo sh hqbird2027-fb50-linux-<version>.run --uninstall --agent-dir /opt/hqbird/fbagent-fb50-2