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

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.

KomponentaCo děláWindowsLinux
Firebird, sestavení HQbirdNový 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 fbagentZálohy, monitorování, údržba, aktualizace.HQbirdFBAgent-fb50hqbirdfbagent-fb50, uživatel firebird
HQbird MonitorWebová 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-fb50hqbirdmonitor-fb50
Komponenty clusteruProgramy 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 MCPPří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 FirebirdSymboly 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.

Na serveru

        


          


          

  1. 1Kontrola serverupráva, bitovost; na Linuxu také systemd a jádro
  2. 2Kontrola sadysha256 před rozbalením; podpisy souborů před instalací
  3. 3Plánco bylo nalezeno a co bude provedeno
  4. 4Otázkynázev serveru pro HQCenter; zastavit Firebird? jiná verze?
  5. 5InstalaceFirebird, agent, konzole, služby
  6. 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ódVýznam (Linux .run)
0Hotovo
1Odmítnuto: server, přepínač nebo plán. Nic se nezměnilo
2Instalace selhala, změny vráceny
3Vrácení změn neúplné: výsledek uvádí, co zkontrolovat
4Je potřeba odpověď: žádný terminál a žádné --yes
5Sada neprošla kontrolou: stáhněte ji znovu
6Žádné knihovny OS a žádný repozitář
7Firebird z distribučních balíčků
KódVýznam (Windows setup.exe)
0Nainstalováno
1Odmítnuto před instalací: chybný přepínač nebo soubor, je nainstalována novější verze, chybí práva správce
4Instalátor měl otázku, ale chybí přepínač /YES
7Kontrola serveru nebo instalace selhala. Důvod je v logu a ve výsledkovém souboru
10Nainstalováno, ale připojení k HQCenter selhalo
Plán v průvodci. „Found on this computer“ a „Setup will do the following“. Dole: nic se nezmění, dokud nekliknete na Install.
Výsledek. Co je nainstalováno, adresa konzole z tohoto počítače a z jiného, kde je přihlašovací heslo. Převzato z raného sestavení: tam názvy služby agenta a složek používají port (-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í.

Přechod z HQbird 2024: úlohy FBDataGuard se přesunou do agenta HQbird 2027, Firebird se aktualizuje na místě, staré služby HQbird se zakážou
  • Co se neměnídatabases.conf nebo aliases.conf, bezpečnostní databáze, heslo SYSDBA, databáze, zálohy a soubory starého HQbird. V firebird.conf se pouze přidá řádek MonitoringPlugin = 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í.

Přidat
  • 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 -2 v 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-port nastavuje slot explicitně.
Dvě instance jedné řady. Plán vidí oba servery Firebird i oba agenty a mění pouze vybranou instanci.

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.

ImageFirebirdPort FirebirdHQbird Monitor
ghcr.io/ibsurgeon/hqbird2027-fb505.0305023050
ghcr.io/ibsurgeon/hqbird2027-fb404.0305023050
ghcr.io/ibsurgeon/hqbird2027-fb303.0305023050
ghcr.io/ibsurgeon/hqbird2027-fb252.5305023050
  • První spuštěníZkopírujte compose.yaml ze sady, vložte heslo SYSDBA do tajného souboru, odstraňte # z řádků secrets: a spusťte docker compose up -d. Server je připraven, když docker compose ps zobrazí 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, ne 3051: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, aktualizace

Agent · 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í je agent. all nainstaluje také Firebird, v aktualizačním okně. off nic 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

Samoaktualizace agenta: kontroly, bod obnovení, nahrazení, připraven do 180 s, 45 s běhu; při selhání: vrácení zpět, 30minutová pauza, verze zablokována po 2. selhání
  • 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ě.

  1. 1Přípravastažení, podpis, sestava není starší než engine
  2. 2Oknodenní okno; povinné vydání také čeká na okno
  3. 3Úlohyprobíhá gbak, nbackup nebo SQL skript: pokus se odkládá
  4. 4Nahrazenístaré soubory enginu se odloží, konfigurace zůstávají
  5. 5KontrolaFirebird se spustí a odpovídá na svém portu
  6. 6✓ nebo vrácení zpětstaré soubory se vrátí, sestava se zablokuje
Co se aktualizujeOchranaPokud selže
agent fbagentPodpis, pouze novější, připraven do 180 s a 45 s běhuVrácení zpět, 30minutová pauza; druhé selhání verzi zablokuje
HQbird Monitor, cluster, fbmcpPodpis, pouze novější než nainstalovanáPředchozí verze zůstává; uchovávají se 2 nejnovější kopie
FirebirdOkno, č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--uninstall odstraní 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-data odstraní také konfiguraci, logy a data konzole.
  • Starý HQbirdOdinstalace HQbird 2027 znovu nezapne staré služby: o tom rozhoduje správce pomocí souboru stavu.
Linux, odinstalace jedné instance (Firebird a databáze zůstávají):
sudo sh hqbird2027-fb50-linux-<version>.run --uninstall --agent-dir /opt/hqbird/fbagent-fb50-2

← Zpět na přehled HQbird 2027 · Stav serveru →