Diese Seite wurde maschinell übersetzt. Lesen Sie das englische Original. English

Installation ohne Überraschungen

Ein Installer pro Firebird-Linie. Er findet Firebird, altes HQbird und Agents auf dem Server, zeigt einen Plan und ändert nichts, bis Sie „Ja“ sagen. Danach aktualisiert sich der Agent selbst, die Konsole und Firebird von allein, mit Prüfungen und Rollback.

  • 4 Installer: Firebird 2.5 · 3.0 · 4.0 · 5.0
  • 0 Änderungen, bevor Sie den Plan bestätigen
  • kein Internet nötig alles in einer Datei
  • Windows und Linux Assistent, Silent-Modus, .run
  • Rollback wenn eine Installation oder ein Update fehlschlägt

setup.exe · .run

Was im Kit enthalten ist

Der Installer ist eine Datei: hqbird2027-fb50-setup-<version>.exe für Windows oder hqbird2027-fb50-linux-<version>.run für Linux. Er enthält alles, was der Server braucht. Es wird nichts heruntergeladen.

Jeder Installer installiert eine Firebird-Linie. Wählen Sie die Linie, auf der Ihre Datenbanken laufen. Die Installation wird vom Agent im Kit durchgeführt: Er prüft den Server, erstellt einen Plan und führt ihn aus.

KomponenteWas sie tutWindowsLinux
Firebird, HQbird-BuildEin neuer Server oder ein In-Place-Update. Bei einem bereits installierten Server wird eine Zeile zu firebird.conf hinzugefügt: MonitoringPlugin = fblwmon. Bei einem neuen Server legt der Installer außerdem den Port fest. databases.conf, die Security-DB und das SYSDBA-Passwort ändern sich nicht.Dienst FirebirdServer…/opt/firebird
fbagent-AgentBackups, Monitoring, Wartung, Updates.HQbirdFBAgent-fb50hqbirdfbagent-fb50, Benutzer firebird
HQbird MonitorWebkonsole für diesen Server. Port = 20000 + Firebird-Port: bei 3050 ist es 23050. Der Port wird bei der Installation gewählt und ändert sich später nicht, auch wenn Sie den Firebird-Port ändern.HQbirdMonitor-fb50hqbirdmonitor-fb50
Cluster-KomponentenDie Cluster-Programme werden auf dem Server abgelegt, aber nicht aktiviert: RCM und das Pairing-Fenster sind standardmäßig aus. RCM macht den Server zum Zentrum eines neuen Clusters und öffnet die Ports 7443 und 7444. Das Pairing-Fenster öffnet 24 Stunden lang die Ports 7450–7459: darüber kann das RCM eines anderen Servers diesen Server einladen. Beides können Sie auch nach der Installation aktivieren.Assistentenseite „Replication and cluster setup“; /RCM, /DISCOVERY--rcm on, --cluster-pairing on
fbmcp-MCP-ServerZugriff für KI-Clients auf Firebird. Standardmäßig nur von diesem Server aus.Kontrollkästchen im Assistenten oder /NOFBMCP--no-fbmcp
Firebird-DebugdateienSymbole zur Analyse von Firebird-Abstürzen.—ja, --no-debug schaltet sie ab
  • WindowsUnterstützt: Windows 10 und 11, Windows Server 2016 und später, 64-Bit. Administratorrechte. Der Installer ist von IBSurgeon Software signiert: Windows zeigt den Herausgeber in der Rechteabfrage an.
  • Assistent oder Silent-ModusJede Assistentenseite ist auch als Schalter verfügbar: /VERYSILENT /YES /LOG=…. Gut für Skripte und für hundert Server.
  • Assistent in 8 SprachenEnglisch, Portugiesisch (Brasilien), Deutsch, Russisch, Spanisch, Polnisch, Türkisch, Chinesisch (vereinfacht). Standard ist die Windows-Sprache. Schalter: /LANG=en|pt_BR|de|ru|es|pl|tr|zh_CN.
  • ServernameDer Assistent fragt nach dem Namen des neuen Agents; HQCenter zeigt den Server unter diesem Namen an. Standard ist der Computername. Silent-Modus: /AGENTID=, unter Linux --agent-id. Ein bereits installierter Agent behält seinen Namen.
  • Linuxx86_64, Kernel 3.2 oder später, systemd, root. Ubuntu, Debian, AlmaLinux, Rocky, RHEL, Oracle Linux, openSUSE, RED OS und andere mit apt, dnf, yum oder zypper.
  • Server ohne InternetDer Installer bezieht einige OS-Bibliotheken (libtommath, ICU) aus dem Repository. Gibt es kein Repository, gibt er die genauen Befehle aus und ändert nichts.

Das Kit wird zweimal geprüft. Vor dem Entpacken: die sha256 des gesamten Kits. Bevor Firebird und der Agent installiert werden: die Signatur jeder Datei. Ein beschädigter Download stoppt die Installation, bevor Firebird, der Agent oder die Konsole verändert werden.

fbagent --install-plan

Erst der Plan, dann die Änderungen

Zuerst liest der Installer nur: Dienste, die Registry, Firebird- und HQbird-Ordner. Dann zeigt er, was er gefunden hat und was er tun wird. Änderungen beginnen erst, nachdem Sie „Ja“ sagen.

Wählen Sie aus, was auf dem Server vorhanden ist, und sehen Sie sich den Plan an. Die Texte sind gekürzt und übersetzt; die Reihenfolge und die Entscheidungen sind dieselben wie im Installer für Firebird 5.0.

Auf dem Server

        


          


          

  1. 1ServerprüfungRechte, Bitness; unter Linux auch systemd und der Kernel
  2. 2Kit-Prüfungsha256 vor dem Entpacken; Dateisignaturen vor der Installation
  3. 3Planwas gefunden wurde und was getan wird
  4. 4FragenServername für HQCenter; Firebird stoppen? andere Version?
  5. 5InstallationFirebird, Agent, Konsole, Dienste
  6. 6✓ ErgebnisDienste, Konsolenadresse, Login

Wenn etwas schiefgeht

Eine Ablehnung in der Planphase (Port belegt, Ordner nicht leer) ändert nichts: Der Installer nennt den Grund. Im Assistenten können Sie eine Seite nicht verlassen, solange ein Wert falsch ist.

Ein Fehler während der Installation, bevor der Agent-Dienst startet: Die Dienste kehren in ihren vorherigen Zustand zurück. Altes HQbird, falls es gestoppt wurde, startet wieder.

CodeBedeutung (Linux .run)
0Erledigt
1Abgelehnt: Server, Schalter oder Plan. Nichts geändert
2Installation fehlgeschlagen, Änderungen zurückgerollt
3Rollback unvollständig: Das Ergebnis sagt, was zu prüfen ist
4Antwort erforderlich: kein Terminal und kein --yes
5Kit hat die Prüfung nicht bestanden: erneut herunterladen
6Keine OS-Bibliotheken und kein Repository
7Firebird aus Distributionspaketen
CodeBedeutung (Windows setup.exe)
0Installiert
1Vor der Installation abgelehnt: falscher Schalter oder falsche Datei, eine neuere Version ist installiert, keine Administratorrechte
4Der Installer hatte eine Frage, aber es gibt keinen /YES-Schalter
7Serverprüfung oder Installation fehlgeschlagen. Der Grund steht im Log und in der Ergebnisdatei
10Installiert, aber die Verbindung zu HQCenter ist fehlgeschlagen
Plan im Assistenten. „Found on this computer“ und „Setup will do the following“. Unten: Es ändert sich nichts, bis Sie auf Installieren klicken.
Ergebnis. Was installiert ist, die Konsolenadresse von diesem Computer und von einem anderen, wo das Login-Passwort ist. Aus einem frühen Build: Dort verwenden die Dienst- und Ordnernamen des Agents den Port (-p3050); neue Installationen erhalten -fb50.

FBDataGuard → fbagent

Umzug von HQbird 2024

Das Installationsprogramm findet das alte HQbird und das Firebird, das es bedient. Dieses Firebird wird an Ort und Stelle aktualisiert, FBDataGuard-Aufgaben wandern zum Agenten, alte Dienste werden gestoppt. Datenbanken, Konfigurationen und Passwörter bleiben erhalten.

Umzug von HQbird 2024: FBDataGuard-Aufgaben wandern zum Agenten von HQbird 2027, Firebird wird an Ort und Stelle aktualisiert, alte HQbird-Dienste werden deaktiviert
  • Was sich nicht ändertdatabases.conf oder aliases.conf, die Sicherheitsdatenbank, das SYSDBA-Passwort, Datenbanken, Backups und alte HQbird-Dateien. In firebird.conf wird nur die Zeile MonitoringPlugin = fblwmon hinzugefügt, falls sie fehlt.
  • Kopie des alten FirebirdDer Programmordner des alten Firebird bleibt daneben als <folder>.old_<time> erhalten.
  • Aufgabengbak- und nbackup-Backups, Sweep, Indexstatistiken. Der Import läuft einmal und durchläuft die Prüfung der neuen Konfiguration; die alte Konfiguration bleibt erhalten.
  • Alte BackupsDer Agent übernimmt Backups aus den FBDataGuard-Journalen in seine eigenen Aufzeichnungen. Aufbewahrungsregeln und Wiederherstellung sehen sie genauso wie neue. Die Namen der nbackup-Level bleiben gleich.
  • AufgabennamenDer Aufgabenname endet mit dem Datenbanknamen aus FBDataGuard, zum Beispiel „Verified backup - MANUAL“. Gruppenaufgaben bilden den Baum der Quellordner nach.
  • Alte Dienste: drei OptionenAutomatisch (empfohlen): deaktivieren, wenn jedes von FBDataGuard bediente Firebird einen Agenten hat. Alle deaktivieren: /DISABLEHQBIRD. Unverändert lassen: /NOHQBIRD.
  • Sie können zurückDer Zustand jedes Dienstes vor seiner Deaktivierung wird in fbagent-hqbird-takeover.json gespeichert. Mit dieser Datei kann das alte HQbird wieder eingeschaltet werden.
  • LizenzDie alte HQbird-Lizenz wird nicht übernommen. Eine Testphase läuft, bis Sie eine neue Lizenz erhalten oder sich mit HQCenter verbinden.
  • Unklarer PfadWenn der Import eine Substitution in einem FBDataGuard-Pfad nicht auflösen kann, behält er sie unverändert bei und lässt die Aufgabe deaktiviert. Korrigieren Sie den Pfad und aktivieren Sie die Aufgabe.

Wenn Aufgaben importiert werden, aber alte Dienste noch laufen (zum Beispiel hat der Server zwei Firebird-Server unter FBDataGuard), kommen die Aufgaben deaktiviert an. So läuft eine Aufgabe nicht zweimal.

Ports · Ordner · Dienste

Mehrere Firebird-Server auf einer Maschine

Ein Agent pro Firebird. Eine neue Instanz wird neben den anderen installiert, auf ihrem eigenen Port, mit ihrem eigenen Agenten und ihrer eigenen Konsole. Installierte Instanzen ändern sich nicht.

Fügen Sie Firebird-Server hinzu und sehen Sie, welche Namen und Ports das Installationsprogramm wählt.

Hinzufügen
  • Ports nach LinieDas erste Firebird auf dem Server erhält 3050. Das nächste: 3052 für 2.5, 3053 für 3.0, 3054 für 4.0, 3055 für 5.0. Das Installationsprogramm belegt keinen Port, der bereits verwendet wird.
  • Zweite Instanz derselben LinieNummer -2 in Ordner- und Dienstnamen. Unter Windows ist dies die Assistentenoption „Weitere Instanz installieren“; der Port ist der erste freie im Bereich der Linie.
  • Updates nur innerhalb einer Linie5.0.x → 5.0.y. Der Wechsel von 3.0 auf 5.0 bedeutet eine zweite Instanz neben der ersten; die Datenbanken werden per Backup und Restore umgezogen.
  • XNET unter WindowsEin Firebird, das nicht auf Port 3050 läuft, erhält seinen eigenen Namen IpcName = FIREBIRD_<port>. Lokale XNET-Verbindungen zum zweiten Server funktionieren.
  • Eine Konsole pro AgentHQbird Monitor auf 20000 + Firebird-Port: 23050, 23055. Eine Anmeldedatei für alle Instanzen auf dem Server.
  • Ports sind festDie Ports der Konsole und der lokalen Agent-API werden bei der Installation festgeschrieben. Wenn Sie den Firebird-Port später ändern, bleiben sie gleich. Der Agent akzeptiert keine gleichen Ports.
  • Cluster: ein Slot für jeden AgentenJeder Agent auf dem Server erhält seinen eigenen Slot von 0 bis 9: Pairing-Port 7450 + Slot, Knoten-Ports 7051 + Slot und 7061 + Slot. So können zwei Agenten eines Servers einem Cluster beitreten. Der Schalter --pairing-port legt den Slot explizit fest.
Zwei Instanzen einer Linie. Der Plan erkennt beide Firebird-Server und beide Agenten und ändert nur die ausgewählte Instanz.

Images · Compose · Ports

HQbird in Docker

Für jede Firebird-Linie gibt es ein fertiges Image. Firebird, der Agent und HQbird Monitor laufen im Container. Der Agent installiert den Cluster-Knoten im Container selbst, wenn der Server einem Cluster beitritt. Er installiert RCM nur, wenn dieser Server als Cluster-RCM zugewiesen ist.

ImageFirebirdFirebird-PortHQbird 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
  • Erster StartKopieren Sie compose.yaml aus dem Kit, legen Sie das SYSDBA-Passwort in eine Secret-Datei, entfernen Sie das # aus den secrets:-Zeilen und führen Sie docker compose up -d aus. Der Server ist bereit, wenn docker compose ps healthy anzeigt.
  • Firebird-PortDie Variable HQBIRD_FB_PORT, standardmäßig 3050. HQbird Monitor lauscht auf 20000 + diesem Port.
  • Image-SignaturDie Images sind mit dem Tool cosign signiert. Der öffentliche Schlüssel für die Prüfung ist noch nicht veröffentlicht.
  • Mehrere Instanzen auf einem HostFirebird auf 3050 + N, HQbird Monitor auf 20000 + Firebird-Port, Cluster-Knoten auf 7051 + N. Nur eine Instanz auf dem Host kann RCM haben.
  • Dieselbe Portnummer außen und innenVeröffentlichen Sie 3051:3051, nicht 3051:3050. Der Agent und der Cluster melden den Port, den sie im Container sehen.
  • ClusterDie Mitgliedsadresse ist die Adresse des Docker-Hosts. Veröffentlichen Sie den Knoten-Port und, für RCM, die Ports 7443 und 7444.

Docker veröffentlicht Ports an ufw vorbei. Eine ufw-Regel „nur Port 22“ schließt die Container-Ports nicht. Veröffentlichen Sie den Port auf einer Host-Adresse oder schließen Sie ihn mit einer externen Firewall.

Cloud und Docker: Einstellungen, Volumes, Ports, Updates

Agent · Konsole · Cluster · Firebird

Updates nach der Installation

Nachdem er sich mit HQCenter verbunden hat, aktualisiert der Agent sich selbst, HQbird Monitor, Cluster-Komponenten, fbmcp und Firebird selbstständig. Ein Server ohne HQCenter aktualisiert sich ebenfalls selbst: Der Agent bezieht neue Versionen vom IBSurgeon-Update-Server.

Der Agent sieht eine neue Version von sich selbst in HQCenter innerhalb einer Minute. Neue Versionen von HQbird Monitor, fbmcp und Firebird: innerhalb einer Stunde. Jedes Update folgt einem Muster: prüfen, einen Rollback-Punkt speichern, ersetzen, sicherstellen, dass es funktioniert. Wenn es nicht funktioniert, wird das alte wiederhergestellt.

Updates ohne HQCenter

  • Was sich selbst aktualisiertDer Agent, HQbird Monitor und der MCP-Server. Die Prüfung läuft alle 6 Stunden.
  • Firebird wartet auf einen BefehlDas Firebird-Paket wird heruntergeladen und wartet. Der Administrator wendet es an: mit der Schaltfläche auf der Seite „Updates“ oder mit dem Befehl fbagent --firebird-update --apply.
  • Sie wählen den ModusDer Installationsschalter --auto-update all|agent|off, unter Windows /AUTOUPDATE=all|agent|off. agent ist der Standard. all installiert auch Firebird, im Update-Fenster. off prüft nichts.
  • Seite „Updates“ in HQbird MonitorZeigt, woher der Agent Versionen bezieht, den Modus und die letzte Antwort des Servers, den Zustand der Updates von Firebird, Konsole und MCP-Server. Der Administrator ändert den Modus und wendet das Firebird-Paket an.
  • QuellenprüfungDer Update-Server wird gegen einen festgeschriebenen Schlüssel geprüft. Die Herstellersignatur ist immer erforderlich.
  • Cluster läuft über das ZentrumEin Cluster-Knoten und RCM aktualisieren sich nicht auf diese Weise: HQCenter oder RCM aktualisieren sie.

Selbst-Update des Agenten

Selbst-Update des Agenten: Prüfungen, Rollback-Punkt, Ersetzen, bereit innerhalb von 180 s, 45 s Laufzeit; bei Fehler: Rollback, 30 min Pause, Version nach dem 2. Fehler blockiert
  • Nur vorwärtsDer Agent installiert keine Version, die älter ist als seine eigene, auch keine verpflichtende. Die Prüfung läuft, bevor das erste Byte heruntergeladen wird. So kann ein gefälschter Server keinen alten verwundbaren Build zurückbringen. Die Ausnahme ist eine alte Version, die in der eigenen Konfiguration des Agenten erlaubt ist (allow_downgrade_to).
  • SignaturReleases sind mit einem Ed25519-Schlüssel signiert; der öffentliche Schlüssel ist im Agenten eingebaut. Eine falsche Signatur wird immer abgelehnt. Der Modus „nur signiert" wird in der eigenen Konfiguration des Agenten aktiviert, nicht vom Server aus.
  • Manueller RollbackNeben dem Agenten liegt ein Skript rollback_to_version_NNN: Es stellt den vorherigen Agenten und die Konfiguration wieder her und blockiert die fehlgeschlagene Version. Die zwei letzten Rollback-Punkte werden behalten; ältere werden automatisch gelöscht.
  • Linux: root führt nur seine eigene Kopie ausDer Agent läuft als firebird. Das Ersetzen erfolgt durch eine verifizierte Kopie in einem Ordner, in den nur root schreiben kann.

Firebird-Update

Firebird wird nur innerhalb seiner Linie und nur auf einen neueren Build aktualisiert. Der Agent kann das Paket jederzeit herunterladen und vorbereiten, aber er stoppt Firebird nur im Update-Fenster.

  1. 1VorbereitungDownload, Signatur, Build nicht älter als die Engine
  2. 2Fenstertägliches Fenster; auch ein verpflichtendes Release wartet auf das Fenster
  3. 3Jobsgbak, nbackup oder ein SQL-Skript läuft: der Versuch wird verschoben
  4. 4Ersetzenalte Engine-Dateien werden beiseitegelegt, Konfigurationen bleiben
  5. 5PrüfungFirebird startet und antwortet auf seinem Port
  6. 6✓ oder Rollbackalte Dateien kommen zurück, der Build wird blockiert
Was aktualisiert wirdSchutzBei Fehler
fbagent-AgentSignatur, nur neuer, bereit innerhalb von 180 s und 45 s LaufzeitRollback, 30-Minuten-Pause; ein zweiter Fehler blockiert die Version
HQbird Monitor, Cluster, fbmcpSignatur, nur neuer als installiertDie vorherige Version bleibt; die 2 letzten Kopien werden behalten
FirebirdFenster, auf Backups warten, Prüfung nach dem StartAlte Engine kommt zurück, der Build landet auf der Sperrliste

Eine blockierte Version wird nicht erneut installiert, aber die nächste Version installiert wie gewohnt. So durchläuft der Server nicht endlos „Update → Rollback → Update".

Ordner · Logs · Deinstallation

Wo die Dateien liegen und wie man deinstalliert

Windows

C:\HQbird\
  Firebird50\            Firebird 5.0, Konfigurationen, Security-DB
  fbagent-fb50\          Agent und HQbird Monitor
    agent_config.json    Agent-Konfiguration
    logs\  bak\  update\ Logs, Kopien, Update-Cache
C:\HQbirdData\           Arbeitsdaten von Agent und Konsole
  config\access.properties  Konsolen-Login
C:\ProgramData\fbagent\  Installationsergebnis und Log

Linux

/opt/firebird/           Firebird 5.0 (zweite Linie: /opt/fb50)
/opt/hqbird/
  conf/access.properties Konsolen-Login, 0600
  fbagent-fb50/          Agent und HQ Monitor
    agent_config.json    Agent-Konfiguration
    logs/  bak/  update/ Logs, Kopien, Update-Cache
/var/lib/hqmonitor/      Konsolendaten
/var/log/fbagent/install.log  Installations-Log, keine Passwörter
  • Die Deinstallation rührt Ihre Datenbanken nicht anIhre Datenbanken und Backups (*.fdb, *.gdb, *.fbk, *.nbk) bleiben immer erhalten. Das Entfernen von Daten löscht nur die Security-DB und die Beispiele aus dem Firebird-Paket.
  • Windows„Apps": entfernt den Agenten, die Konsole, das RCM dieses Agenten, Firewall-Regeln und das Firebird, das dieser Installer als neues installiert hat. Wenn andere Agenten das RCM dieses Agenten verwenden, fragt der Assistent „Diese Instanz trotzdem entfernen?"; eine stille Deinstallation benötigt /FORCE. Ein aktualisiertes Firebird bleibt. Konfigurationen und die Security-DB werden nur entfernt, wenn Sie „Daten entfernen" wählen.
  • Linux--uninstall entfernt die Dienste von Agent und Konsole, das RCM dieses Agenten, sudoers-Regeln und die Ports, die der Installer in firewalld oder ufw geöffnet hat. Der Agent verlässt zuerst den Cluster. Wenn andere Agenten sein RCM verwenden, benötigen Sie den Schalter --force. Firebird bleibt. --remove-data entfernt zusätzlich die Konfiguration, Logs und Konsolendaten.
  • Altes HQbirdDie Deinstallation von HQbird 2027 schaltet die alten Dienste nicht wieder ein: Der Administrator entscheidet dies anhand der Statusdatei.
Linux, eine Instanz deinstallieren (Firebird und Datenbanken bleiben):
sudo sh hqbird2027-fb50-linux-<version>.run --uninstall --agent-dir /opt/hqbird/fbagent-fb50-2

← Zurück zur HQbird 2027-Übersicht · Server-Zustand →