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

Dieser Leitfaden richtet sich an den Administrator, der HQbird 2027 auf einem Linux-Server mit dem Offline-Installer hqbird2027-fbNN-linux-<version>.run installiert. Er behandelt eine Neuinstallation, die Aktualisierung eines älteren HQbird und eines früheren HQbird 2027, die Wartungsbefehle, die Verbindung zu Ihrem HQCenter, die unbeaufsichtigte (skriptgesteuerte) Installation und wo sich die Dateien nach der Installation befinden.

Die Beispiele zeigen den Installer für Firebird 5.0 auf Ubuntu 24.04. Die Installer für Firebird 2.5, 3.0 und 4.0 funktionieren auf die gleiche Weise; nur die Version, der Standardport und die Ordnernamen unterscheiden sich. Die Windows-Installation wird in Windows installation beschrieben.

Inhalt

  1. 1. Was der Installer installiert
  2. 2. Die Installation auf einen Blick
  3. 3. Neuinstallation
  4. 4. Nach der Installation
  5. 5. Update eines älteren HQbird (2024 und früher)
  6. 6. Update von HQbird 2027 auf eine neue Version
  7. 7. Wartungsbefehle
  8. 8. Mit Ihrem HQCenter verbinden
  9. 9. Unbeaufsichtigte Installation und Skripte
  10. 10. Fehlerbehebung

1. Was der Installer installiert

Eine .run-Datei = eine Firebird-Linie. Wählen Sie den Installer der Firebird-Version, die Ihre Datenbanken verwenden:

Installer Firebird, das installiert oder aktualisiert wird Erstes Firebird auf dem Host Größe
hqbird2027-fb50-linux-<version>.run Firebird 5.0 (HQbird-Build) /opt/firebird, Port 3050 etwa 250 MB
hqbird2027-fb40-linux-<version>.run Firebird 4.0 (HQbird-Build) /opt/firebird, Port 3050 etwa 220 MB
hqbird2027-fb30-linux-<version>.run Firebird 3.0 (HQbird-Build) /opt/firebird, Port 3050 etwa 130 MB
hqbird2027-fb25-linux-<version>.run Firebird 2.5 (HQbird-Build) /opt/firebird, Port 3050 etwa 80 MB

Jeder Installer enthält und installiert ohne Internet:

  • Firebird (der HQbird-Build dieser Linie): einen neuen Server oder eine In-Place-Aktualisierung des Firebird dieser Linie, das bereits auf dem Host vorhanden ist. Ihre firebird.conf, databases.conf (aliases.conf für 2.5), die Sicherheitsdatenbank und das SYSDBA-Passwort bleiben erhalten.
  • Firebird-Debugdateien (Symbole für die Absturzanalyse), installiert im Firebird-Ordner. --no-debug überspringt sie.
  • HQbird-Agent (fbagent): die systemd-Unit hqbirdfbagent-fb50, ausgeführt als Benutzer firebird, die die Backups, die Überwachung, die Wartungsaufträge und die Updates durchführt. Der Name endet mit der Firebird-Linie (-fb25 … -fb50); eine zweite Instanz der Linie hat -fb50-2.
  • HQ Monitor: die Webkonsole dieser HQbird-Instanz, Unit hqbirdmonitor-fb50, Adresse http://<server>:<20000 + Firebird port>/ (für Firebird auf Port 3050: http://localhost:23050/).
  • Cluster-Komponenten: die Cluster-Konsole RCM (hqbirdrcm) und der Cluster-Knoten (hqclusternode) werden in den Cache des Agenten kopiert. Kits mit Agent (fbagent) 3.1.0 und später erstellen standardmäßig keinen Cluster: kein RCM, kein Pairing-Fenster, kein Cluster-Port in der Firewall. Zwei Fragen (oder --rcm on, --cluster-pairing on) aktivieren sie („Next: cluster" in Abschnitt 3). Mit RCM wird es in /opt/hqbirdrcm installiert und läuft als Unit hqbirdrcm; die Zusammenfassung gibt seine Adresse in der Zeile RCM: aus. Der Knoten erhält seine Unit (zum Beispiel hqclusternode-master-p3050), wenn Sie den Host in RCM verknüpfen. Kits ab 2027.2.19 mit einem älteren Agenten installieren RCM auf jedem Server (--rcm off belässt es im Cache) und öffnen das Pairing-Fenster. Kits vor 2027.2.19 kopieren beide Komponenten nur in den Cache des Agenten: Es gibt keine Unit hqbirdrcm und keine Zeile RCM:.

Vor 2027.2.9 installierte Instanzen haben den Firebird-Port in den Agentennamen: Ordner /opt/hqbird/fbagent-p3050, Units hqbirdfbagent-p3050 und hqbirdmonitor-p3050. Eine Aktualisierung ändert diese Namen nicht. Nur neue Instanzen erhalten die Namen -fb<NN>, sodass ein Host beide Formen haben kann.

Voraussetzungen: x86_64, Kernel 3.2 oder neuer, systemd; ein Linux mit apt, dnf/yum oder zypper (Ubuntu, Debian, AlmaLinux, Rocky, RHEL, Oracle Linux, openSUSE, RED OS und andere); root. Etwa 300 MB frei in /var/tmp während der Installation (ein Ordner, in dem Programme ausgeführt werden dürfen; siehe --tmpdir). Einige Betriebssystembibliotheken (libtommath, ICU) werden aus dem Repository der Distribution bezogen; ein Server ohne Internet erhält die genauen Befehle zu deren Vorbereitung (Abschnitt 9).

Nicht unterstützt: ein Firebird, das aus den Paketen der Distribution installiert wurde (firebird3.0-server, firebird rpm). Der Installer stoppt, bevor er etwas ändert (Exit-Code 7); entfernen Sie zuerst die Pakete (behalten Sie ein gbak-Backup Ihrer Datenbanken) oder verwenden Sie den Online-Installer mit --import-firebird.

Mehrere Firebird-Linien auf einem Server: Jede Linie hat ihren eigenen Installer. Das erste Firebird auf dem Host geht nach /opt/firebird; eine zweite Linie geht nach /opt/fb<NN> (/opt/fb50, /opt/fb40, /opt/fb30) auf dem Port ihrer Linie: 3053 für 3.0, 3054 für 4.0, 3055 für 5.0. Wenn dieser Port belegt ist, stoppt der Installer und fragt nach --port N. Mehrere Instanzen einer Linie (ein zweites Firebird 5.0 auf einem anderen Port) werden mit --fb-root <new folder> --port <port> installiert (Abschnitt 7). Firebird 2.5 hat nur eine Instanz, in /opt/firebird; für einen zweiten Server daneben verwenden Sie eine andere Linie (zum Beispiel Firebird 5.0 in /opt/fb50).

Ein schrittweises Runbook für zwei Instanzen auf den Ports 3050 und 3051, für jede Linie, mit Copy-Paste-Befehlen, finden Sie in hqbird2027-linux-two-instances-runbook.ru.md (Russisch) und hqbird2027-linux-two-instances-runbook.pt.md (Portugiesisch).

Testversion: Ohne Lizenz führt der Agent eine 7-tägige Testversion aus. Die Test-E-Mail (--email) verlängert sie auf 30 Tage. Eine Lizenzdatei (--license) oder die Verbindung zu Ihrem HQCenter (Abschnitt 8) ersetzt die Testversion.

Updates: Ab Kit 2027.2.31 (Agent 3.3.0) prüft ein Server, der an kein HQCenter angebunden ist, den Update-Server des Herstellers. Standardmäßig aktualisieren sich der Agent, HQ Monitor und fbmcp selbst, und ein neues Firebird-Paket wird heruntergeladen und wartet auf Sie. --auto-update all|agent|off oder die Zeile Updates der Textoberfläche ändert dies („Updates without HQCenter" in Abschnitt 4). Ein an ein HQCenter angebundener Server bezieht seine Updates von diesem HQCenter.

2. Die Installation auf einen Blick

Diagram

Die Serverprüfung und die Installation selbst werden vom HQbird-Agenten durchgeführt, den der Installer mitführt (fbagent --install-plan, fbagent --setup-install). Es wird nichts heruntergeladen außer den fehlenden Betriebssystempaketen. Es wird nichts geändert, bevor der Plan bestätigt ist: Die Betriebssystempakete werden nach der Bestätigung installiert. In einem Terminal öffnen Kits nach 2027.2.30 die Textoberfläche (Schritt 3 von Abschnitt 3); --no-tui führt den einfachen Installer aus, der seine Fragen als Textzeilen stellt. Ohne Terminal und ohne --yes stoppt der Installer bei der Bestätigung mit Exit-Code 4. Wenn die Installation fehlschlägt, bevor die Agent-Unit startet, setzt der Agent die Units auf den Zustand zurück, den sie zuvor hatten (Exit-Code 2; Code 3, wenn das Zurücksetzen nicht vollständig war, die Zusammenfassung sagt, was zu prüfen ist).

3. Neuinstallation

Schritt 1: Den Installer herunterladen und prüfen

Command
KIT=hqbird2027-fb50-linux-2027.2.9.run
curl -fL -O https://ib-aid.com/download/hqbird/v2027/$KIT -O https://ib-aid.com/download/hqbird/v2027/$KIT.sha256
sha256sum -c $KIT.sha256

Die anderen Linien haben dieselben Namen mit fb40, fb30, fb25. Erwartet: hqbird2027-fb50-linux-2027.2.9.run: OK. Ein Server ohne Internet: Laden Sie die beiden Dateien auf einem PC mit denselben Links herunter und kopieren Sie sie auf den Server (scp, ein USB-Laufwerk, eine Freigabe).

Der Installer prüft außerdem seine eigene Nutzlast, bevor er etwas entpackt: Ein abgeschnittener oder beschädigter Download stoppt mit Exit-Code 5 („download it again").

Schritt 2: Den Host prüfen, ohne ihn zu ändern (optional)

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

--check führt die Host-Prüfung aus, meldet die fehlenden Betriebssystembibliotheken (und die Befehle, um sie auf einem Server ohne Internet zu erhalten), zeigt, was der Agent gefunden hat und was er tun würde, und beendet sich. Es wird nichts installiert.

Schritt 3: Den Installer ausführen

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

Kits nach 2027.2.30 öffnen die Textoberfläche, wenn Sie sie in einem Terminal starten: Vollbildseiten mit dem Plan und den Einstellungen. Kits bis 2027.2.30 und die Fälle unter „Der einfache Installer" unten stellen ihre Fragen als Textzeilen. Beide führen dieselbe Installation mit denselben Optionen durch.

Die Textoberfläche

Der Installer prüft den Host, entpackt sich selbst, liest den Plan und zeigt die erste Seite. Auf dem Host wird nichts geändert, bis Sie die Installation auf der Seite Install starten.

text
 HQbird 2027 setup <version> | Firebird 5.0 (5.0.5.1917)

 Plan M1: New Firebird and HQbird agent
   Firebird: new /opt/firebird (unit firebird, port 3050)
   Agent: new, in /opt/hqbird/fbagent-fb50
   OS packages to install: libtommath1 (see Plan details)

   Language         English (auto)
   Firebird folder  automatic (/opt/firebird)
   Firebird port    automatic (3050)
   Agent id         automatic (srv1261114-fb50)
   SYSDBA password  generated (for a new Firebird)
   HQ Monitor       port automatic, login admin
   License          not now (add it later in HQ Monitor)
   HQCenter         not attached
   Cluster          RCM off, discovery mode off
   Components       debug files: yes, fbmcp: yes
   Updates          HQbird only (recommended)

 > Install
   Plan details
   About plans
   Quit

 Up/Down: move   Enter: change or start   Esc: quit

Die oberen Zeilen sind der Plan für die aktuellen Einstellungen: sein Code und was der Installer mit Firebird und dem Agenten tun wird. Ein Plan, der nicht möglich ist, ist rot, mit dem Grund, und der Cursor steht auf der Einstellung, die ihn behebt. Nach jeder Änderung liest der Installer den Plan erneut.

Taste Was sie bewirkt
Up, Down Den Cursor bewegen (auch k, j)
Enter Die Einstellung unter dem Cursor öffnen, ein Element auswählen, einen eingegebenen Wert übernehmen
Space Eine Komponente ein- oder ausschalten (die Seite Components)
Esc Zurück zur vorherigen Seite; auf der ersten Seite: den Installer verlassen (er fragt zuerst)
Ctrl+C Den Installer sofort stoppen (Exit-Code 2). Vor der Seite Install wurde nichts geändert

Auf einer Seite, auf der Sie einen Wert eingeben (einen Ordner, einen Port, eine Adresse), übernimmt Enter ihn, und ein leerer Wert bedeutet „automatisch". Esc verlässt eine solche Seite nicht.

Einstellung Was Sie wählen Entspricht der Option
Language Englisch, Russisch, brasilianisches Portugiesisch, Deutsch; die Seiten ändern sich sofort --lang
Firebird folder Der Ordner eines neuen Firebird oder des zu aktualisierenden Firebird. Firebird 2.5 hat einen Ordner, daher hat sein Installer keine solche Zeile --fb-root
Firebird port Der TCP-Port von Firebird --port
Agent id Automatisch, der Hostname, der Hostname und die Instanz oder Ihr eigener Wert. Nur für einen neuen Agenten: Ein installierter Agent behält seine ID, und die Zeile wird nicht angezeigt --agent-id
SYSDBA password Für ein neues Firebird: generiert oder Ihr eigenes --sysdba-pass-file
HQ Monitor Der Port und die Anmeldung der Webkonsole --hqmonitor-port, --hqmonitor-login, --hqmonitor-password-file
License Nicht jetzt, eine 30-tägige Testversion per E-Mail (Adresse, Datenschutzhinweis, Zone) oder eine Lizenzdatei --email --accept-privacy --trial-zone, --license
HQCenter Die Datei attach.json Ihres HQCenter --attach
Cluster Der Cluster-Manager RCM (Cluster-ID, Admin-Passwort), der Discovery-Modus, der Pairing-Port --rcm, --cluster-id, --rcm-password-file, --cluster-pairing, --pairing-port
Components Firebird-Debugdateien; fbmcp und die Adressen seines Remote-Modus --no-debug, --no-fbmcp, --fbmcp-allow-from

| Updates | Nur HQbird (der Agent, HQ Monitor und fbmcp aktualisieren sich selbst, ein neues Firebird wartet auf Sie), HQbird und Firebird (Firebird aktualisiert sich ebenfalls selbst, nachts von 03:30 bis 04:00, mit einem Neustart von Firebird), oder Aus. Kits ab 2027.2.31; nur für einen neuen Agenten ohne attach.json-Datei: ein HQCenter steuert die Updates eines angehängten Agenten | --auto-update |

Optionen auf der Kommandozeile sind die Werte, mit denen die Seiten starten: sudo sh hqbird2027-fb50-linux-<ver>.run --rcm on --port 3055 öffnet die erste Seite mit RCM an und Port 3055.

Die vier Zeilen unter den Einstellungen:

  • Install zeigt den Plan vollständig, dann fragt es Start the install now? mit dem Cursor auf Nein. Die Fragen des Plans (ein älteres HQbird, ein laufendes Firebird, das gestoppt werden soll) stehen auf derselben Seite: Ja beantwortet sie alle. Nach Ja schließen sich die Seiten, und die Installation gibt ihr Protokoll und die Zusammenfassung auf dem normalen Bildschirm aus, wie im einfachen Installer unten.
  • Plan details zeigt, was der Code des Plans bedeutet, was der Installer auf dem Host gefunden hat, die Warnungen und die OS-Pakete, die er installieren wird.
  • About plans listet alle Codes auf (M1 … M17). Enter auf einem Code erklärt ihn. Ein * markiert den Code des aktuellen Plans.
  • Quit verlässt den Installer (Exit-Code 1). Es wurde nichts geändert.

Der einfache Installer

Der einfache Installer läuft, wenn eine der folgenden Bedingungen zutrifft:

  • die Option --no-tui oder die Variable HQBIRD_NO_TUI=1;
  • --yes, --check, --uninstall, --extract, --plan-help, --help;
  • stdin oder stdout ist kein Terminal: ein Skript, ssh host 'command' ohne ein Terminal, oder eine Pipe wie ... 2>&1 | tee install.log;
  • TERM ist dumb oder nicht gesetzt;
  • das Fenster ist kleiner als 80 Spalten mal 24 Zeilen (innerhalb von tmux mit seiner Statuszeile hat ein 80x24-Terminal 23 Zeilen: machen Sie das Fenster größer oder verwenden Sie --no-tui);
  • bash auf dem Host ist älter als 4.4 (RHEL 7, CentOS 7);
  • das Kit ist 2027.2.30 oder älter.

Für das Fenster und für bash sagt die erste Zeile der Ausgabe, warum die Seiten nicht geöffnet wurden.

Ein typischer Lauf des einfachen Installers auf einem Server ohne Firebird:

text
[install] HQbird 2027 setup 2027.2.9, Firebird 5.0 (5.0.5.1916)
[install] host: Ubuntu 24.04.5 LTS, kernel 6.8.0-142-generic
[install] checking the payload (sha256) ...
[install] unpacking into /var/tmp/hqbird2027.k3Qf1x ...
[install] OS libraries missing: libtommath.so.1 (packages: libtommath1)
[install] plan M1: Firebird new /opt/firebird (unit firebird, port 3050)
[install]              agent new in /opt/hqbird/fbagent-fb50 (unit hqbirdfbagent-fb50), HQ Monitor hqbirdmonitor-fb50
[install]              OS packages to install: libtommath1
[install] Install as planned? Yes/No y
[install] installing from the package repository: libtommath1
[install] OS libraries: installed
[install] installing (fbagent --setup-install; log /var/log/fbagent/install.log) ...
...
Done: agent hqbirdfbagent-fb50 in /opt/hqbird/fbagent-fb50, Firebird 5.0.5.1916 in /opt/firebird (port 3050).
HQ Monitor: http://localhost:23050/ (login admin; password in /opt/hqbird/conf/access.properties)
[install] done. Uninstall: sudo sh hqbird2027-fb50-linux-2027.2.9.run --uninstall

Dieses Beispiel stammt aus Kit 2027.2.9. Ab Kit 2027.2.19 enthält die Zusammenfassung auch die Zeilen RCM: und Pairing: der Cluster-Konsole („Next: cluster“ unten). Mit Agent 3.1.0 und später und ohne gewähltes Cluster lauten sie:

text
RCM:        off; turn it on in HQbird Monitor or with fbagent --cluster-init <id>
Pairing:    off; turn it on in HQbird Monitor or with fbagent --cluster-pairing on (port 7450)

Was die Zeilen bedeuten:

  • host: die Distribution und der Kernel; der Installer lehnt einen Host ab, der nicht x86_64 ist, kein systemd hat oder einen Kernel älter als 3.2 ausführt.
  • OS libraries: was das Firebird dieser Linie vom Betriebssystem benötigt (Abschnitt 9). Der Plan listet die fehlenden Pakete auf (OS packages to install); nach der Bestätigung nimmt der Installer sie aus dem Repository der Distribution. Ohne ein Repository stoppt er mit Exit-Code 6 und gibt die Befehle aus.
  • plan: was der Agent gefunden hat (found Firebird ..., HQbird: ... Zeilen) und was er tun wird: Firebird new (ein neuer Server), update (das Firebird dieser Linie wird an Ort und Stelle aktualisiert), oder eine Ablehnung mit dem Grund (Exit-Code 1, nichts geändert).
  • Install as planned? Yes/No: die letzte Frage, bevor etwas geändert wird. Antworten Sie y. Wenn der Plan eigene Fragen hat (ein älteres HQbird, eine andere Version), kommen diese stattdessen (Abschnitt 5). Ohne Terminal übergeben Sie --yes; andernfalls stoppt der Installer mit Exit-Code 4.
  • Cluster questions (Agent 3.1.0 und später): Install the cluster manager (RCM) on this host and make a new cluster? [y/N] und Turn on discovery mode for 24 hours (an RCM on the network may invite this agent into its cluster; port 7450)? [y/N]. Die Voreinstellung ist Nein. Die erste wird nur gefragt, wenn der Host keinen RCM hat und der Agent in keinem Cluster ist; die zweite nicht, wenn der Agent in einem Cluster ist oder den RCM ausführt. --yes und ein Lauf ohne Terminal antworten mit Nein (kein Exit-Code 4).
  • HQ Monitor: die Adresse und der Login. Eine neue Installation erhält den Login admin; sein generiertes Passwort steht in /opt/hqbird/conf/access.properties (Modus 0600, lesbar nur für root und den Agenten). Alle HQbird 2027-Instanzen des Hosts teilen diese Datei. Ändern Sie das Passwort in HQ Monitor.

Das SYSDBA-Passwort eines neuen Firebird wird generiert und in /root/fbagent-install-sysdba.txt gespeichert (Modus 0600): eine Kommentarzeile, dann die Zeile SYSDBA_PASS=<password>. Ein weiteres Firebird, das später auf demselben Host installiert wird, erhält dasselbe Passwort aus dieser Datei. Um Ihr eigenes festzulegen, übergeben Sie --sysdba-pass-file <file> (erste Zeile der Datei) oder --sysdba-pass <password>.

Sprache des Installers

Kits nach 2027.2.30 sprechen vier Sprachen: Englisch, Russisch (ru), brasilianisches Portugiesisch (pt-BR) und Deutsch (de). Der Installer wählt die Sprache in dieser Reihenfolge:

  1. die Option --lang en|ru|pt-BR|de;
  2. die Variable HQBIRD_LANG;
  3. das Locale der Konsole (LC_ALL, dann LC_MESSAGES, dann LANG), wenn es ein UTF-8-Locale ist;
  4. Englisch.

Die zweite Zeile der Ausgabe sagt, welche Sprache es ist und wie man sie ändert. Diese Zeile ist immer Englisch:

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

Hinweise:

  • PuTTY sendet LANG nicht an den Server. Das Locale des Servers zählt, daher ist die Sprache oft Englisch. Verwenden Sie --lang.
  • Mit --yes und ohne Terminal ist die automatische Sprache Englisch: Skripte lesen diese Ausgabe. --lang funktioniert dort trotzdem.
  • Der Installer benötigt ein UTF-8-Locale auf dem Host für die anderen Sprachen (C.UTF-8 oder en_US.UTF-8). Er setzt eines für sich selbst. Ohne eines spricht er Englisch.
  • In der Textoberfläche ändert die Language-Zeile der ersten Seite die Sprache sofort. Das Terminal muss UTF-8 anzeigen (PuTTY: Window, Translation, Remote character set UTF-8, was seine Voreinstellung ist).
  • Englisch bleibt erhalten: die Fortschrittszeilen der Installation selbst, die Done: Zusammenfassung, /var/log/fbagent/install.log und die Warnungen des Host- Scans.

Der Code des Plans

Der Plan hat einen Code: M1, M2, … Er benennt den Fall, den der Installer auf dem Host gefunden hat. Der Installer gibt aus, was der Code bedeutet:

text
[install] plan M1: New Firebird and HQbird agent
[install]              This host has no Firebird and no older HQbird. Setup installs a new Firebird and a new HQbird agent.
[install] plan M1: Firebird new /opt/firebird (unit firebird, port 3050)

--plan-help gibt alle Codes aus und beendet sich. Es ändert nichts. In der Textoberfläche zeigt die erste Seite den Code und seinen Titel, „Plan details“ zeigt den Text, und „About plans“ listet alle Codes auf.

Code Was der Installer gefunden hat Firebird Agent Älteres HQbird
M1 nichts neu neu —
M2 Firebird dieser Linie, kein älteres HQbird Update neu —
M3 Firebird einer anderen Linie, kein älteres HQbird neu, Port 305N neu —
M4 älteres HQbird, das das Firebird dieser Linie bedient Update neu abgeschaltet, seine Jobs als aktiviert importiert
M5 älteres HQbird einer anderen Linie; ein Firebird dieser Linie ist vorhanden Update, nach einer Frage neu arbeitet weiter
M6 älteres HQbird einer anderen Linie; kein Firebird dieser Linie neu, nach einer Frage neu arbeitet weiter
M7 älteres HQbird ohne ein lokales Firebird einer bekannten Version Update oder neu neu arbeitet weiter, eine Warnung
M8 ein HQbird 2027-Agent für ein anderes Firebird Update oder neu neu, neben dem ersten nicht geändert
M9 wie M8, und ein älteres HQbird bedient diese Linie Update neu, neben dem ersten abgeschaltet, seine Jobs als aktiviert importiert
M10 ein Agent bedient dieses Firebird bereits (ein wiederholter Lauf) Update an Ort und Stelle abgeschaltet, wenn er läuft
M11 --fb-root ist ein Firebird dieser Linie Update neu oder an Ort und Stelle wie oben
M13 --fb-root ist ein leerer oder neuer Ordner neu in diesem Ordner neu wie oben

Codes einer Ablehnung (Exit-Code 1, nichts geändert): M12 der Ordner enthält ein Firebird, das der Installer nicht aktualisieren kann (eine andere Linie, eine Version, die er nicht lesen kann, ein deaktivierter Dienst); M14 der Ordner ist nicht leer und enthält kein Firebird; M16 mehrere Firebird-Server dieser Linie, geben Sie --fb-root an; M17 Firebird 2.5 funktioniert nur in /opt/firebird. M15 ist das Agent-only-Kit: Firebird wird nicht installiert und nicht aktualisiert.

Die Agent-ID

Die Agent-ID benennt den Agenten in HQCenter, in der Lizenz und im Cluster. Sie wird nur bei der ersten Installation festgelegt:

  • Standard: Hostname + Datum + Instanz, zum Beispiel srv1261114-fb50.
  • --agent-id ID gibt Ihre eigene ID (1-128 Buchstaben, Ziffern, ., _ oder -; das erste Zeichen ein Buchstabe oder eine Ziffer).
  • Der Installer lehnt eine ID ab, die ein anderer Agent des Hosts hat.
  • In der Textoberfläche bietet die Agent id-Seite die automatische ID, den Host- namen, den Hostnamen mit der Instanz und Ihren eigenen Wert an und listet die IDs auf, die der Host bereits hat.
  • Ein installierter Agent behält seine ID. Ein wiederholter Lauf zeigt sie im Plan (id srv1 (kept)), die Textoberfläche hat dann keine Agent id-Zeile, und --agent-id gibt dort nur eine Warnung aus. Ein neuer Agent in einem Ordner, den eine frühere Installation mit ihrer Konfiguration hinterlassen hat, behält ebenfalls die ID dieser Konfiguration.

Schritt 4: Prüfen Sie das Ergebnis

Command
systemctl status firebird hqbirdfbagent-fb50 hqbirdmonitor-fb50 --no-pager
ss -ltnp | grep -E ':3050|:23050'
ISC_PASSWORD="$(sed -n 's/^SYSDBA_PASS=//p' /root/fbagent-install-sysdba.txt)" \
  /opt/firebird/bin/isql -user SYSDBA localhost/3050:/opt/firebird/examples/empbuild/employee.fdb

Verwenden Sie den vollständigen Pfad der Beispieldatenbank: er funktioniert für jede Linie und auch nach einem Update, während die beibehaltene databases.conf einer älteren Installation möglicherweise keinen employee-Alias hat (eine neue Installation von 2027.2.3 hat ihn).

Öffnen Sie http://<server>:23050/ in einem Browser und melden Sie sich als admin mit dem Passwort aus /opt/hqbird/conf/access.properties an. Der Firebird-Port und der HQ Monitor-Port werden in firewalld (Zone public) geöffnet, wenn es läuft, sonst in ufw, wenn es aktiv ist; bei einer anderen Firewall öffnen Sie sie selbst. Cluster-Ports werden nur für eine Cluster-Option geöffnet: 7443, 7444 und der Node- Port mit --rcm on; der Node-Port und der Pairing-Port mit --cluster-pairing on. Ohne eine aktive Firewall gibt der Installer eine Zeile mit den Ports aus, die er nicht geöffnet hat. Ein Port, der vor der Installation offen war, bleibt unverändert.

Weiter: Cluster

Um Ihre Datenbanken von einem Master-Server auf einen Replica-Server zu replizieren, verbinden Sie die beiden Server in der Cluster-Konsole RCM. Mit Agent 3.1.0 und später installieren Sie RCM nur auf dem Master (--rcm on, oder antworten Sie y) und aktivieren Sie den Discovery-Modus auf der Replica (--cluster-pairing on). Der Discovery-Modus öffnet das Pairing-Fenster für 24 Stunden: der Pairing-Port des Slots des Agenten (7450 für die erste Instanz, 7451 für die zweite, bis zu 7459) ist in der Firewall geöffnet, und der RCM kann den Agenten einladen. Ein Host hat einen RCM (Ports 7443 und 7444); der Agent, der ihn erstellt hat, führt ihn aus und öffnet kein Pairing- Fenster.

Später, ohne den Installer: HQ Monitor → Clusters → Cluster on this server, oder fbagent --cluster-init <id> und fbagent --cluster-pairing on. Kits ab 2027.2.19 mit einem älteren Agent starten RCM auf jedem Server und geben seine Adresse in der Zeile RCM: der Zusammenfassung aus; eine Installation vor 2027.2.19 erhält RCM, wenn Sie sie mit einem neueren Kit aktualisieren (Abschnitt 6). Die Cluster-Anleitung (für Kit 2027.2.33) führt Schritt für Schritt von zwei neuen Servern zu einer funktionierenden Replik, mit Screenshots: Linux cluster guide (auch auf Russisch und Portugiesisch). Dieselben Schritte nur als Befehle: hqbird2027-linux-cluster-runbook.md (hqbird2027-linux-cluster-runbook.ru.md, hqbird2027-linux-cluster-runbook.pt.md).

4. Nach der Installation

Units

Unit Was Läuft als
firebird (2.5, 4.0, 5.0 in /opt/firebird); firebird-superserver (3.0 in /opt/firebird); für einen anderen Ordner der Ordnername mit / → _: firebird.opt_fb50, firebird.opt_fb40-2 (4.0, 5.0 in /opt/fb50, /opt/fb40-2), firebird.opt_fb30-superserver (3.0 in /opt/fb30) Firebird-Server firebird
hqbirdfbagent-fb50 (zweite Instanz hqbirdfbagent-fb50-2; vor 2027.2.9 hqbirdfbagent-p<Firebird port>) HQbird-Agent firebird
hqbirdmonitor-fb50 (hqbirdmonitor-fb50-2; vor 2027.2.9 hqbirdmonitor-p<Firebird port>) HQ Monitor firebird

Alle drei sind aktiviert und starten beim Booten. journalctl -u hqbirdfbagent-fb50 zeigt das Unit-Log des Agents. Firebird 3.0 hat außerdem die Units firebird-classic.socket und [email protected] (firebird.opt_fb30-classic.* in einem anderen Ordner), und Firebird 2.5 hat firebird.socket: Sie bleiben inactive, das ist normal. Der Firebird-2.5- Prozess ist fb_smp_server (SuperClassic).

Wo die Dateien liegen

Das Beispiel ist die erste Firebird-5.0-Instanz in /opt/firebird auf Port 3050. Eine zweite Instanz der Linie hat -2 in den Agent-Namen (fbagent-fb50-2, hqbirdfbagent-fb50-2, hqbirdmonitor-fb50-2). Instanzen, die vor 2027.2.9 installiert wurden, haben den Port in diesen Namen (fbagent-p3050, hqbirdfbagent-p3050, hqbirdmonitor-p3050).

text
/opt/firebird/                         Firebird 5.0 server: bin/, lib/, plugins/, firebird.conf,
                                       databases.conf, security5.fdb, *.debug files (symbols)
/opt/fb50/                             a Firebird 5.0 next to another line (/opt/fb40, /opt/fb30)
/opt/hqbird/                           root of the HQbird agents
  conf/access.properties               HQ Monitor sign-in, shared by all instances of the host (0600)
  fbagent-fb50/                        HQbird agent of this Firebird
    fbagent                            the agent (unit hqbirdfbagent-fb50)
    hqmonitor                          HQ Monitor (unit hqbirdmonitor-fb50)
    agent_config.json                  agent configuration (encrypted secrets: config_secret.key)
    config.properties                  HQ Monitor configuration
    hqbird2027-firebird.json           the Firebird this installer installed
    hqbird2027-hqmonitor-firewall.json the HQ Monitor port this installer opened in firewalld or ufw
    conf/                              trace and job settings
    logs/                              agent log (firebird-agent_<date>.jsonl), license_state.json;
                                       journal.log and server_status.json after the first checks
    bak/                               backups of the configuration
    outcoming/                         status reports for HQCenter
    update/                            update cache: hqmonitor/, hqclusternode/, hqbirdrcm/
    certs/                             certificates after the attach to HQCenter
  fbagent-hqbird-takeover.json         state of the older HQbird units before the takeover (section 5)
/opt/hqbirdrcm/                        the cluster console RCM (unit hqbirdrcm, owner firebird):
                                       with agent 3.1.0 only after --rcm on (or HQ Monitor);
                                       kits 2027.2.19+ with an older agent: unless --rcm off
/opt/hqclusternode/                    the cluster node (owner firebird), empty until the host is
                                       linked in RCM or HQCenter adds it to a cluster
/var/lib/hqmonitor/<server id>/        HQ Monitor data
/var/log/fbagent/install.log           log of the installer's steps (passwords are hidden)
/root/fbagent-install-sysdba.txt       SYSDBA password of a new Firebird (root only, 0600)
/etc/sysctl.d/90-hqbird-firebird.conf  kernel settings for Firebird (vm.max_map_count), only when
                                       the system value is lower (Ubuntu 24.04 needs none)
/etc/sudoers.d/                        the agent's sudoers rules for its root helpers (updates, HQ Monitor)

Der Installer hinterlässt nichts in /var/tmp: Sein Arbeitsordner /var/tmp/hqbird2027.XXXXXX wird am Ende entfernt, auch nach einem Fehler.

Logs

Log Wo
Installer das Terminal; /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; Audit-Log /opt/hqbird/fbagent-fb50/hqmonitor_audit.log
Firebird /opt/firebird/firebird.log

Updates ohne HQCenter

Ab Kit 2027.2.31 (Agent 3.3.0) bezieht ein Agent, der an kein HQCenter angebunden ist, neue Versionen vom Update-Server des Herstellers. Der Update-Modus ist der Schlüssel update.mode von agent_config.json:

Modus Was sich selbst aktualisiert
agent (Standard) Der Agent, HQ Monitor und fbmcp. Ein neues Firebird-Paket wird heruntergeladen und wartet auf den Administrator
all Dasselbe, und auch Firebird, in seinem Anwendungsfenster (nachts von 03:30 bis 04:00; das Update startet Firebird neu)
off Nichts: Der Agent führt keine Update-Prüfungen durch. Zum Aktualisieren führen Sie den Installer einer neuen Version aus (Abschnitt 6)
  • Bei der Installation: die Zeile Updates der Textoberfläche, oder --auto-update all|agent|off. Ohne diese ändert der Installer den Modus nicht.
  • Später: die Seite Updates von HQ Monitor, oder erneut der Installer mit --auto-update <mode>.
  • Der Status: sudo /opt/hqbird/fbagent-fb50/fbagent --update-status (fügen Sie --json für ein Skript hinzu). Er zeigt die Release-Quelle, die Zone und die letzte Antwort des Update-Servers.

Der Agent öffnet ausgehende HTTPS-Verbindungen nur zu diesen Adressen. Es wird kein eingehender Port benötigt.

Zweck Adresse
Updates, Zone EU liceu.ibsurgeon.com:9443
Updates, Zone BR licbr.ibsurgeon.com:9443
Updates, Zone RU licru.ibsurgeon.com:20943
Testlizenz trialeu.ibsurgeon.com:9443, trialbr.ibsurgeon.com:19443, trialru.ibsurgeon.com:23943

Ein Server, der an ein HQCenter angebunden ist, verwendet die Update-Adressen nicht: Er bezieht seine Updates von diesem HQCenter (Abschnitt 8).

Benachrichtigungen

Ab Kit 2027.2.33 (Agent 3.4.0) sendet der Agent Meldungen über Server- probleme an einen eigenen Telegram-Bot, einen Webhook oder E-Mail (SMTP). Der Installer legt keinen Kanal fest, und es wird nichts gesendet, bis Sie einen hinzufügen: HQ Monitor → Servers → Notifications. Zum Testen eines Kanals über die Befehlszeile: sudo -u firebird /opt/hqbird/fbagent-fb50/fbagent --notify-test <channel>; --notify-history zeigt die letzten Zustellungen.

5. Update eines älteren HQbird (2024 und früher)

Der Installer findet ein installiertes HQbird (FBDataGuard) in /opt/hqbird und seine Units sowie die Firebird-Server, die es verwaltet. Er folgt dann denselben Regeln wie die HQbird-Installationsskripte:

Diagram

Was Sie im Terminal sehen:

text
[install]   found Firebird 5.0.5.1878: /opt/firebird, port 3050, unit firebird, no agent
[install] plan M4: Firebird update /opt/firebird (unit firebird, port 3050)
[install]              agent new in /opt/hqbird/fbagent-fb50 (unit hqbirdfbagent-fb50), HQ Monitor hqbirdmonitor-fb50
[install]              HQbird services to turn off: hqbird
[install] Firebird 5.0.5.1878: unit firebird, port 3050, 0 TCP connections
[install] Confirm to stop running Firebird 5.0.5.1878? Yes/No y
  • Der Plan nennt das Firebird, das aktualisiert wird; --fb-root und --port können es nicht verschieben (seine Unit ist belegt).
  • Die Frage Confirm to stop running Firebird? wird gestellt, wenn die Engine gestoppt werden muss; die Zeile davor zeigt die offenen Verbindungen. Another version wird gefragt, wenn das ältere HQbird ein Firebird einer anderen Version verwaltet (aktualisieren Sie dieses, oder ein neues daneben). --yes beantwortet alle Fragen mit Ja; ohne Terminal und ohne --yes bricht der Installer mit Exit-Code 4 ab und ändert nichts.
  • --disable-hqbird schaltet die Units des älteren HQbird in jedem Fall aus; --no-hqbird lässt das ältere HQbird in Ruhe (es läuft weiter neben HQbird 2027).
  • Das SYSDBA-Passwort wird nicht abgefragt: Der Agent übernimmt es vom älteren HQbird.
  • HQ Monitor verwendet die Anmeldung des älteren HQbird: Seine Datei /opt/hqbird/conf/access.properties bleibt erhalten, melden Sie sich also mit dem Login und Passwort an, die Sie zuvor verwendet haben. Der Installer übergibt die Datei an firebird mit Modus 0600 (das ältere HQbird ließ sie für jeden Benutzer lesbar). Der Gast-Login des älteren HQbird (access.guest-login) wird von HQ Monitor nicht verwendet.

Was erhalten bleibt: firebird.conf, databases.conf / aliases.conf, die Sicherheitsdatenbank, das SYSDBA-Passwort, die Datenbanken, die Backups und die Dateien des älteren HQbird. Das Update ersetzt die Firebird-Programmdateien an Ort und Stelle; die ersetzten Dateien werden in /opt/fbagent-update-backup/<folder name>-<id>/<time>_<old version>_to_<new version>/ aufbewahrt (die zwei neuesten Updates bleiben). Die HQbird-Jobs (Backups, Sweeps, Monitoring) werden in den neuen Agent importiert. Die HQbird-Lizenz des älteren HQbird wird nicht übertragen: Der neue Agent läuft im Testmodus, bis eine Lizenz installiert wird oder der Server an Ihr HQCenter angebunden wird.

Ab Kit 2027.2.33 (Agent 3.4.0) bewirkt der Import der Konfiguration des älteren HQbird zwei weitere Dinge:

  • Er registriert die Datenbanken des älteren HQbird in der Firebird-Aliases- Datei (databases.conf, oder aliases.conf für 2.5) als name = path-Zeilen. Die alte Datei wird zuerst kopiert. Eine Datenbank wird ausgelassen, wenn ihr Pfad bereits in der Datei steht oder wenn ihre Datei nicht existiert. Eine Datei mit einer include-Direktive wird nicht geändert.
  • Er entfernt die alten Monitoring-Logs des älteren HQbird: den Inhalt der Ordner mon/outcoming und mon/outtrace seines Ausgabeordners (die Ordner bleiben). Nichts wird entfernt, solange ein Dienst des älteren HQbird läuft. Die Entfernung kann nicht rückgängig gemacht werden: Wenn Sie diese Logs benötigen, kopieren Sie sie vor der Installation.

Beides ist standardmäßig aktiviert. Die Schlüssel hqbird_import.register_databases und hqbird_import.clean_mon_logs von agent_config.json (beide sind im Konfigurationseditor von HQ Monitor) schalten sie für einen späteren Import aus; der Installer hat keine Option dafür.

Der Zustand der Units des älteren HQbird vor der Übernahme wird in /opt/hqbird/fbagent-hqbird-takeover.json gespeichert. --uninstall schaltet sie nicht wieder ein.

Unbeaufsichtigte Form:

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

6. Update von HQbird 2027 auf eine neue Version

Ein neuerer Installer derselben Linie, ausgeführt auf einem Host mit HQbird 2027, aktualisiert die installierte Instanz an Ort und Stelle: Firebird, die Debug-Dateien, den Agent und HQ Monitor. Die Konfiguration, die Datenbanken, der Test- oder Lizenzstatus, der HQ Monitor-Port und die Anmeldung bleiben erhalten.

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

In der Textoberfläche zeigt die erste Seite Plan M10: Update of an installed HQbird 2027, den Agent mit seiner ID (kept) und keine Agent-ID-Zeile; Install startet das Update. Der einfache Installer gibt aus:

text
[install] HQbird 2027 setup 2027.2.9, Firebird 5.0 (5.0.5.1916)
[install]   found Firebird 5.0.5.1880: /opt/firebird, port 3050, unit firebird, agent hqbirdfbagent-p3050
[install] plan M10: Firebird update /opt/firebird (unit firebird, port 3050)
[install]              agent in_place in /opt/hqbird/fbagent-p3050 (unit hqbirdfbagent-p3050), HQ Monitor hqbirdmonitor-p3050
[install] Firebird 5.0.5.1880: unit firebird, port 3050, 2 TCP connections
[install] Confirm to stop running Firebird 5.0.5.1880? Yes/No y
...
Firebird updated: 5.0.5.1880 -> 5.0.5.1916
HQ Monitor updated 1.31.0 -> 1.33.0 (...)
Done: agent hqbirdfbagent-p3050 in /opt/hqbird/fbagent-p3050, Firebird 5.0.5.1916 in /opt/firebird (port 3050).

Eine Aktualisierung ändert nicht die Namen des Agent-Ordners und der Units: Die Instanz in diesem Beispiel wurde vor 2027.2.9 installiert und behält fbagent-p3050.

Wenn der Firebird-Build des Installers der bereits installierte ist (zum Beispiel Firebird 2.5.9.27194 in jedem HQbird 2027 für 2.5), werden nur der Agent und HQ Monitor aktualisiert: Firebird wird nicht gestoppt und es gibt keine Confirm to stop-Frage.

Die beibehaltene databases.conf einer Instanz, die von einem älteren HQbird 2027 installiert wurde, hat möglicherweise keinen employee-Alias; verbinden Sie sich mit der Beispieldatenbank über ihren vollständigen Pfad (Abschnitt 3, Schritt 4). Unter Firebird 3.0 hinterlässt eine Aktualisierung von 2027.2.0 /opt/firebird/examples/empbuild/employee.fdb mit Modus 0444, und Firebird kann sie nicht öffnen (no permission for read-write access); wenn Sie die Beispieldatenbank benötigen: sudo chmod 660 /opt/firebird/examples/empbuild/employee.fdb. Ihre eigenen Datenbanken werden nicht berührt.

  • Bei mehreren Instanzen der Linie benennen Sie die zu aktualisierende: --fb-root /opt/fb50-2 --port 3056.
  • Derselbe Installer, erneut über die installierte Version ausgeführt, ist eine Reparatur: Die Programmdateien und Units werden erneut geschrieben, die Daten bleiben.
  • Nach der Verbindung mit einem HQCenter (Abschnitt 8) werden der Agent, HQ Monitor, Firebird und die Cluster-Komponenten aus dem HQCenter- Katalog aktualisiert; ein neuer Installer ist dann nicht erforderlich.
  • Ein Server, der mit keinem HQCenter verbunden ist, mit Agent 3.3.0 oder neuer (Kits von 2027.2.31) aktualisiert den Agent, HQ Monitor und fbmcp selbst, es sei denn, der Aktualisierungsmodus ist off (“Updates without HQCenter” in Abschnitt 4). Eine Installation, die vor 2027.2.31 vorgenommen wurde, erhält dies nach einer Aktualisierung mit einem neueren Installer. Eine Aktualisierung mit dem Installer behält den Aktualisierungsmodus; --auto-update <mode> ändert ihn.

7. Wartungsbefehle

Jede Wartungsaktion ist ein Lauf des Installers mit Optionen oder ein Agent-Befehl im Agent-Ordner. In einem Terminal öffnet ein Lauf ohne --yes die Textoberfläche mit diesen bereits gesetzten Optionen (Kits nach 2027.2.30): Prüfen Sie den Plan auf der ersten Seite und wählen Sie dann Installieren.

Aktion Befehl
Eine weitere Instanz dieser Linie sudo sh hqbird2027-fb50-linux-<ver>.run --fb-root /opt/fb50-2 --port 3056
Reparieren / aktualisieren sudo sh hqbird2027-fb50-linux-<ver>.run (bei mehreren Instanzen: --fb-root <folder> --port <port>)
Mit HQCenter verbinden sudo sh hqbird2027-fb50-linux-<ver>.run --attach attach.json während der Installation oder später cd /opt/hqbird/fbagent-fb50 && sudo ./fbagent --attach --file /path/attach.json
Die Test-E-Mail senden cd /opt/hqbird/fbagent-fb50 && sudo -u firebird ./fbagent --trial-email [email protected] --accept-privacy
Den Testcode aus der E-Mail bestätigen cd /opt/hqbird/fbagent-fb50 && sudo -u firebird ./fbagent --trial-confirm <code> (oder in HQ Monitor)
Eine Lizenzdatei installieren --license <file> während der Installation oder cd /opt/hqbird/fbagent-fb50 && sudo -u firebird ./fbagent --license-install /path/license.json
Zustand der Installation sudo /opt/hqbird/fbagent-fb50/fbagent --install-state --json
Zustand der Aktualisierungen (kein HQCenter) sudo /opt/hqbird/fbagent-fb50/fbagent --update-status
Den Aktualisierungsmodus ändern (kein HQCenter) HQ Monitor, die Seite Updates; oder sudo sh hqbird2027-fb50-linux-<ver>.run --auto-update all|agent|off
Entfernen sudo sh hqbird2027-fb50-linux-<ver>.run --uninstall [--remove-data] [--force] [--agent-dir /opt/hqbird/fbagent-fb50]

Eine weitere Instanz

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

Das neue Firebird kommt nach /opt/fb50-2 (ein neuer oder leerer Ordner), Unit firebird.opt_fb50-2, mit seinem eigenen Agent (/opt/hqbird/fbagent-fb50-2, Unit hqbirdfbagent-fb50-2) und seinem eigenen HQ Monitor (http://localhost:23056/, Unit hqbirdmonitor-fb50-2). Der Agent erhält die niedrigste freie Nummer der Linie: fb50-2 für die zweite Instanz, auch neben einem vor 2027.2.9 installierten Agent (fbagent-p3050). Die HQ Monitor-Anmeldedatei /opt/hqbird/conf/access.properties wird von den Instanzen des Hosts gemeinsam genutzt: Eine neue Instanz ohne --hqmonitor-login behält die bestehende Anmeldung, und --hqmonitor-login/--hqmonitor-password-file auf einer beliebigen Instanz ändern die Anmeldung für alle (die alte Datei wird als access.properties.bak-<time> aufbewahrt). Firebird 2.5 unterstützt keine zweite Instanz: Der Installer stoppt mit refused (M17): Firebird 2.5 works only in /opt/firebird, not in <folder> (Exit-Code 1, nichts geändert). Installieren Sie ein Firebird einer anderen Linie daneben, zum Beispiel sudo sh hqbird2027-fb50-linux-<ver>.run --fb-root /opt/fb50 --port 3051.

Entfernen

Das Entfernen unter Windows und Linux, Server in einem Cluster und was auf der Festplatte verbleibt, ist vollständig im Entfernungsleitfaden beschrieben. Kurz gesagt:

Command
# the agent and HQ Monitor of this instance; Firebird, the databases, configs and logs stay
sudo sh hqbird2027-fb50-linux-2027.2.9.run --uninstall
# the same, and the agent's configuration, logs, license state and HQ Monitor data too
sudo sh hqbird2027-fb50-linux-2027.2.9.run --uninstall --remove-data

Ohne --agent-dir entfernt der Installer den einzigen Agent in /opt/hqbird. Bei mehreren Agents auf dem Host stoppt er (Exit-Code 1), listet deren Ordner auf und fragt nach --agent-dir:

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

--uninstall stoppt und entfernt die Units des Agents und seines HQ Monitors (hqbirdfbagent-fb50, hqbirdmonitor-fb50), die sudoers-Regeln des Agents und seiner Programme (fbagent, hqmonitor) und schließt den HQ Monitor-Port, den die Installation in firewalld oder ufw geöffnet hat. Der Agent-Ordner bleibt mit der Konfiguration und den Logs; --remove-data entfernt auch den Ordner und die HQ Monitor-Daten in /var/lib/hqmonitor/. Firebird bleibt installiert (Unit, Programm- ordner, Datenbanken); die älteren HQbird-Units, die abgeschaltet wurden, bleiben abgeschaltet. Bei mehreren Agents auf dem Host bleibt die gemeinsame HQ Monitor-Anmeldedatei bestehen, bis der letzte Agent entfernt ist.

Wenn der Agent das RCM des Hosts ausführt und andere Agents dieses RCM verwenden, verweigert --uninstall mit Exit-Code 5 und ändert nichts: 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 entfernt den Agent trotzdem; der Cluster verliert dann seine CA (keine neuen Zertifikate, keine neuen Mitglieder). Die RCM-Unit bleibt, solange andere Agents des Hosts sie verwenden. Um einen anderen Agent zum Eigentümer eines neuen RCM zu machen, wenn der alte Eigentümer weg ist: fbagent --cluster-init <id> --rcm-takeover (eine neue CA: die Mitglieder erneut verknüpfen).

Der Hinweis am Ende einer Installation (Uninstall: sudo sh ... --uninstall) hat kein --agent-dir: Bei mehreren Instanzen fügen Sie es wie oben gezeigt hinzu.

Um auch das Firebird einer Instanz zu entfernen (der Installer tut dies nicht; erstellen Sie zuerst gbak-Backups ihrer Datenbanken), zum Beispiel das Firebird in /opt/fb50-2:

Command
B=/opt/fb50-2
U=firebird.$(echo ${B#/} | tr / _)          # /opt/fb50-2 -> firebird.opt_fb50-2
systemctl list-unit-files "$U*"             # the units that will be removed
sudo systemctl disable --now $(systemctl list-unit-files "$U*" --no-legend | awk '$1 !~ /@/ {print $1}')
sudo rm -f /usr/lib/systemd/system/$U* /etc/systemd/system/$U*
sudo systemctl daemon-reload
sudo rm -rf $B

8. Mit Ihrem HQCenter verbinden

HQCenter ist der zentrale Server Ihres Unternehmens, der die HQbird- Agents verwaltet: Lizenzen, Konfiguration, Aktualisierungen, Backup-Übersicht. Ohne ein HQCenter arbeitet der Agent eigenständig mit den Versionen des Installers und der Test- oder Lizenzdatei.

Diagram
  1. Öffnen Sie im HQCenter-Admin-Panel Tokens (https://<hqcenter>:8443/admin/tokens). Wählen Sie im Formular Install script die Lizenz (oder keine), den Modus, die Anzahl der Server und die Gültigkeit (1 bis 365 Tage); die Felder Plattform und Firebird werden nicht verwendet. Klicken Sie auf Download connection file und speichern Sie attach.json. Die Datei enthält ein geheimes Token: Bewahren Sie sie sicher auf (chmod 600), löschen Sie sie nach der Verwendung und widerrufen Sie das Token in der Liste auf derselben Seite. Das Formular wird nur angezeigt, wenn admin_panel.install_script_url gesetzt ist.
  2. Kopieren Sie attach.json auf den Server.
  3. Verbinden Sie auf eine der beiden Arten:
Command
# during the installation
sudo sh hqbird2027-fb50-linux-2027.2.9.run --yes --attach /root/attach.json
# later, for an installed agent
cd /opt/hqbird/fbagent-fb50 && sudo ./fbagent --attach --file /root/attach.json

Mit einem gewöhnlichen Token wartet der Befehl, bis der HQCenter-Administrator die Anfrage genehmigt (bis zu 30 Minuten). Mit einem Lizenz-Token wird der Agent sofort verbunden und erhält die Lizenz. Nach dem Verbinden endet die Testphase, wenn HQCenter dem Agent eine Lizenz gibt; der Agent, HQ Monitor, Firebird und die Cluster-Komponenten werden dann aus dem HQCenter-Katalog aktualisiert. Ein fehlgeschlagenes Verbinden während der Installation macht die Installation nicht rückgängig: Die Zusammenfassung sagt es, und der obige Befehl wiederholt es.

Voraussetzungen: HQCenter (goafts) 1.15.0 oder neuer (ältere Versionen haben keine Schaltfläche für die Verbindungsdatei); der Server erreicht den HQCenter-Bootstrap-Port einmal für das Verbinden und danach den Port der Agents (standardmäßig 443). HQCenter kann ohne Internet betrieben werden. Ein zweites Verbinden desselben Servers mit demselben HQCenter erfordert die Genehmigung des Administrators, auch mit einem Lizenz-Token.

9. Unbeaufsichtigte Installation und Skripte

Jede Option funktioniert auch im Terminal. Ein unbeaufsichtigter Lauf benötigt --yes (beantwortet die Fragen des Plans; ohne Terminal und ohne --yes stoppt der Installer mit Exit-Code 4). --yes öffnet niemals die Text- oberfläche. Ein Skript, das den Installer in einem Terminal startet und seine Fragen selbst beantwortet (zum Beispiel mit expect), muss --no-tui hinzufügen oder HQBIRD_NO_TUI=1 setzen: Kits nach 2027.2.30 öffnen dort die Seiten. Der Exit-Code teilt das Ergebnis mit; die Details stehen im Terminal und in /var/log/fbagent/install.log.

Optionen

Option Bedeutung Standard
--fb-root DIR Ordner des neuen Firebird (neu oder leer); oder der Ordner des zu aktualisierenden Firebird /opt/firebird, dann /opt/fb<NN>
--port N Firebird-Port 3050 für das erste Firebird; für eine andere Linie der Port der Linie (3053 für 3.0, 3054 für 4.0, 3055 für 5.0)
--sysdba-pass-file F, --sysdba-pass P SYSDBA-Passwort eines neuen Firebird (erste Zeile von F; P wird in eine 0600-Datei geschrieben) generiert, gespeichert in /root/fbagent-install-sysdba.txt; ein weiteres Firebird auf dem Host übernimmt das Passwort aus dieser Datei
--agent-id ID agent.id des neuen Agents; nur bei der ersten Installation, ein installierter Agent behält seine ID (“The agent id” in Abschnitt 3) Hostname + Datum + Instanz
--hqmonitor-port N HQ Monitor-Port 20000 + Firebird-Port
--hqmonitor-login L --hqmonitor-password-file F HQ Monitor-Anmeldung, gemeinsam genutzt von allen Instanzen des Hosts: auf einer Instanz angegeben, ändert sie die Anmeldung für alle admin + generiertes Passwort; eine Aktualisierung oder eine weitere Instanz behält die bestehende Anmeldung
--email ADDR --accept-privacy [--trial-zone RU|EU|BR] Test-E-Mail (30 Tage); die Adresse wird an den Testserver des Anbieters gesendet keine
--auto-update all|agent|off Aktualisierungen eines Servers, der mit keinem HQCenter verbunden ist (Kits ab 2027.2.31): agent = der Agent, HQ Monitor und fbmcp aktualisieren sich selbst, ein Firebird-Paket wartet auf Sie; all = auch Firebird, in seinem Fenster; off = keine Aktualisierungsprüfungen (“Updates without HQCenter” in Abschnitt 4) der Modus wird nicht geändert; ein neuer Agent hat agent

| --license F | Zu installierende Lizenzdatei | keine | | --attach F | An Ihr HQCenter anhängen (attach.json) | keine | | --no-hqbird, --disable-hqbird | Das ältere HQbird unberührt lassen / alle seine Units ausschalten | automatisch | | --no-debug | Die Firebird-Debugdateien nicht installieren | installiert | | --no-fbmcp | fbmcp (den MCP-Server für KI-Clients) nicht installieren und das fbmcp dieses Hosts nicht ändern | installiert | | --fbmcp-allow-from A,B | Den Remote-Modus von fbmcp für diese Admin-Adressen (IP oder CIDR) einschalten | nur lokal | | --fbmcp-port N, --fbmcp-dns NAME,..., --fbmcp-ip ADDR | Der Remote-Port von fbmcp; zusätzliche Namen für sein Zertifikat; die Adresse für das Zertifikat und den Listener | Port 8650 | | --rcm on\|off | Die Cluster-Konsole RCM auf diesem Host installieren und einen neuen Cluster erstellen (Agent 3.1.0 und später) | gefragt; Nein | | --rcm-password-file F | RCM-Admin-Passwort mit --rcm on (erste Zeile von F) | generiert, am Ende angezeigt | | --cluster-id ID | Cluster-ID mit --rcm on | der Hostname | | --cluster-pairing on\|off | Discovery-Modus: das Pairing-Fenster für 24 Stunden, ein RCM darf diesen Agenten einladen | gefragt; Nein | | --rcm-allow A,B,... | Nur diese RCMs dürfen diesen Host im Discovery-Modus einladen (IP, CIDR oder Hostname) | jedes RCM | | --pairing-port N | Pairing-Port 7450–7459 eines neuen Agenten; er wählt den Slot (Node-Ports 7051+k, 7061+k). Ein späteres Setup behält den Slot | der erste freie Slot | | --cluster-node on\|off | Den Cluster-Node-Dienst in den Cache des Agenten legen | an | | --yes | Die Fragen des Plans mit Ja beantworten (Nein bei den Cluster-Fragen) | fragen | | --check | Nur die Prüfungen, die Bibliotheken und der Plan; nichts wird geändert | — | | --plan-help | Ausgeben, was die Codes des Plans bedeuten (M1, M2, …), und beenden | — | | --no-tui | Der einfache Installer, ohne Textoberfläche; auch die Variable HQBIRD_NO_TUI=1 („The plain installer" in Abschnitt 3) | die Textoberfläche in einem Terminal | | --lang en\|ru\|pt-BR\|de | Sprache des Installers; auch die Variable HQBIRD_LANG („Language of the installer" in Abschnitt 3) | das UTF-8-Locale der Konsole, sonst Englisch | | --tmpdir DIR | Hier entpacken (ein Ordner, in dem Programme laufen dürfen) | /var/tmp | | --extract DIR | Nur die Payload nach DIR/payload entpacken und beenden | — | | --uninstall [--remove-data] [--force] [--agent-dir DIR] | Den Agenten und HQ Monitor entfernen (Firebird bleibt); --force entfernt auch den Agenten, der das RCM des Hosts ausführt, während andere Agenten es nutzen | — |

Optionen können als --port 3055 oder --port=3055 geschrieben werden. Relative Pfade zählen vom aktuellen Ordner aus.

Beispiele

Neue Installation mit den Standardwerten:

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

Neue Installation in einen gewählten Ordner und Port, mit einem SYSDBA-Passwort aus einer Datei und einer HQ Monitor-Anmeldung:

Command
umask 077
printf '%s\n' 'S3cret-Sysdba' > /root/sysdba.txt
printf '%s\n' 'S3cret-Monitor' > /root/hqm.txt
sudo sh hqbird2027-fb50-linux-2027.2.9.run --yes \
  --fb-root /opt/firebird --port 3050 \
  --sysdba-pass-file /root/sysdba.txt \
  --hqmonitor-port 24000 --hqmonitor-login ops --hqmonitor-password-file /root/hqm.txt
rm -f /root/sysdba.txt /root/hqm.txt

Neue Installation mit der Trial-E-Mail, einer Lizenzdatei und der Attach-Datei:

Command
sudo sh hqbird2027-fb50-linux-2027.2.9.run --yes \
  --email [email protected] --accept-privacy --trial-zone EU \
  --license /root/hqbird-license.json \
  --attach /root/attach.json

Update eines älteren HQbird, alle älteren HQbird-Units aus:

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

Update von HQbird 2027 auf eine neue Version (eine Instanz; bei mehreren --fb-root und --port hinzufügen):

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

Eine zweite Firebird 5.0-Instanz auf Port 3056:

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

Entfernung:

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

Ein Skript, das bei einer fehlgeschlagenen Installation abbricht:

Command
#!/bin/sh
set -e
sh hqbird2027-fb50-linux-2027.2.9.run --yes || {
  rc=$?
  echo "HQbird setup failed with code $rc, see /var/log/fbagent/install.log" >&2
  exit $rc
}
echo "HQbird 2027 installed"

Server ohne Internet: OS-Bibliotheken

Das Firebird einer Linie benötigt diese Bibliotheken vom OS (neben glibc):

Linie Pakete (Debian/Ubuntu) Pakete (RHEL-Familie)
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 normalerweise nichts (libstdc++6 ist im Basissystem) normalerweise nichts

Kits nach 2027.2.30 der Linien 3.0, 4.0 und 5.0 benötigen außerdem das Programm colrm, das das Firebird-Installationsskript verwendet: Paket bsdextrautils (bsdmainutils auf älteren Debian und Ubuntu). Ein minimales Debian hat keines; die RHEL-Familie hat es in util-linux, das immer vorhanden ist.

Wenn ein Paket fehlt und das Repository nicht erreichbar ist, stoppt der Installer mit Exit-Code 6 und nichts wird geändert:

text
[install] ERROR: no access to the package repository, or a package is not there; nothing was changed.
[install] Missing: libtommath1
[install] Install them, then run this file again:
[install]   apt-get install -y libtommath1
[install] On a server without internet: on a PC with the same Ubuntu 24.04.5 LTS
[install]   apt-get download libtommath1
[install] copy the .deb files here and run:  apt-get install -y ./*.deb

Auf der RHEL-Familie ist libtommath in EPEL: Bei erreichbarem Repository fügt der Installer epel-release selbst hinzu. Ohne eines sind die Befehle dnf install -y epel-release, dnf download --resolve <packages> und dnf install -y ./*.rpm. --check gibt dieselbe Liste im Voraus aus, sodass die Pakete vor dem Installationsfenster vorbereitet werden können.

Exit-Codes

Code Bedeutung Änderungen auf dem Host
0 Erledigt (Warnungen zur Trial-E-Mail, zum Attach oder zur Lizenz stehen in der Zusammenfassung) ja
1 Abgelehnt: der Host, eine Option, eine Datei oder der Plan (der Grund wird ausgegeben). Auch: Beenden in der Textoberfläche keine
2 Die Installation ist fehlgeschlagen und wurde zurückgerollt. Auch: der Installer wurde durch ein Signal (Strg+C) gestoppt zurückgerollt; keine, wenn vor der Installation gestoppt
3 Die Installation ist fehlgeschlagen und das Rollback war nicht vollständig (die Zusammenfassung sagt, was zu prüfen ist) teilweise
4 Eine Frage des Plans wurde nicht bestätigt (kein Terminal, kein --yes). keine
5 Die Payload hat die Prüfung nicht bestanden (sha256, Signaturen): die Datei erneut herunterladen. Mit --uninstall: abgelehnt, der Agent führt das RCM des Hosts aus und andere Agenten nutzen es (Abschnitt 7) keine
6 OS-Bibliotheken fehlen und das Paket-Repository ist nicht erreichbar keine
7 Ein Firebird aus den Paketen der Distribution ist installiert keine

10. Fehlerbehebung

Problem Was zu tun ist
run as root (sudo sh ...) Den Installer mit sudo oder als root ausführen
Die Seiten der Textoberfläche öffnen sich nicht Die erste Zeile sagt warum: needs a window of 80x24 or larger (das Fenster vergrößern; tmux mit Statuszeile belegt eine Zeile) oder needs bash 4.4 or newer. Der dann laufende einfache Installer führt dieselbe Installation aus
Falsche Zeichen oder kaputte Zeilen auf den Seiten Das Terminal auf UTF-8 stellen oder mit --lang en ausführen; --no-tui führt den einfachen Installer aus
/var/tmp is mounted noexec Erneut mit --tmpdir /root ausführen (jeder Ordner, in dem Programme laufen dürfen)
is damaged or cut (Exit-Code 5) Die .run-Datei erneut kopieren und ihre sha256sum mit dem veröffentlichten Wert vergleichen
Exit-Code 6, Bibliotheken fehlen Die Pakete wie ausgegeben vorbereiten (Abschnitt 9), dann den Installer erneut ausführen
Exit-Code 7, Firebird aus den Distro-Paketen Die Pakete entfernen (apt-get remove firebird3.0-server, ein gbak-Backup behalten) oder den Online-Installer mit --import-firebird verwenden
refused (M17): Firebird 2.5 works only in /opt/firebird Ein zweites Firebird 2.5 ist nicht möglich; eine andere Linie daneben installieren (Abschnitt 7)
--uninstall abgelehnt (Exit-Code 1) bei mehreren Agenten --agent-dir mit einem Ordner aus der Liste hinzufügen, zum Beispiel --agent-dir /opt/hqbird/fbagent-fb50-2
--uninstall abgelehnt (Exit-Code 5): this agent runs the RCM of the host Zuerst den Cluster in der RCM-Konsole entfernen oder erneut mit --force ausführen (Abschnitt 7)
no permission for read-write access auf employee.fdb nach einem Update (3.0) sudo chmod 660 /opt/firebird/examples/empbuild/employee.fdb (Abschnitt 6)
refused (M14): the folder is not empty Einen leeren oder neuen Ordner mit --fb-root wählen oder das zu aktualisierende Firebird benennen
Exit-Code 2 oder 3 /var/log/fbagent/install.log lesen; die Units sind wieder im Zustand vor dem Lauf (Code 2) oder benötigen eine Prüfung (Code 3)
HQ Monitor öffnet sich nicht systemctl status hqbirdmonitor-fb50 (hqbirdmonitor-p<port> vor 2027.2.9); prüfen, dass nichts anderes auf dem Port lauscht; den Port in der Firewall öffnen; --hqmonitor-port für einen anderen Port
Das HQ Monitor-Passwort verloren Den Installer erneut ausführen (Reparatur) mit --hqmonitor-login admin --hqmonitor-password-file <file>; die alte /opt/hqbird/conf/access.properties wird als access.properties.bak-<time> behalten. Die neue Anmeldung gilt für alle Instanzen des Hosts
Die Trial-E-Mail wurde nicht gesendet (kein Netzwerk) Später senden: cd /opt/hqbird/fbagent-fb50 && sudo -u firebird ./fbagent --trial-email <address> --accept-privacy
SELinux (AlmaLinux, RHEL) Im Enforcing-Modus unterstützt: der Installer stellt die Kontexte der von ihm geschriebenen Dateien wieder her; nichts zu tun