HQbird 2027 für Linux: Installationsanleitung
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. Was der Installer installiert
- 2. Die Installation auf einen Blick
- 3. Neuinstallation
- 4. Nach der Installation
- 5. Update eines älteren HQbird (2024 und früher)
- 6. Update von HQbird 2027 auf eine neue Version
- 7. Wartungsbefehle
- 8. Mit Ihrem HQCenter verbinden
- 9. Unbeaufsichtigte Installation und Skripte
- 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.conffü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-Unithqbirdfbagent-fb50, ausgeführt als Benutzerfirebird, 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, Adressehttp://<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/hqbirdrcminstalliert und läuft als Unithqbirdrcm; die Zusammenfassung gibt seine Adresse in der ZeileRCM:aus. Der Knoten erhält seine Unit (zum Beispielhqclusternode-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 offbelä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 Unithqbirdrcmund keine ZeileRCM:.
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
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
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.sha256Die 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)
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
sudo sh hqbird2027-fb50-linux-2027.2.9.runKits 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.
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: quitDie 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-tuioder die VariableHQBIRD_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; TERMistdumboder nicht gesetzt;- das Fenster ist kleiner als 80 Spalten mal 24 Zeilen (innerhalb von
tmuxmit 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:
[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 --uninstallDieses 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:
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]undTurn 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.--yesund 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ürrootund 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:
- die Option
--lang en|ru|pt-BR|de; - die Variable
HQBIRD_LANG; - das Locale der Konsole (
LC_ALL, dannLC_MESSAGES, dannLANG), wenn es ein UTF-8-Locale ist; - Englisch.
Die zweite Zeile der Ausgabe sagt, welche Sprache es ist und wie man sie ändert. Diese Zeile ist immer Englisch:
[install] Language: Русский (auto). Use --lang en to change.Hinweise:
- PuTTY sendet
LANGnicht an den Server. Das Locale des Servers zählt, daher ist die Sprache oft Englisch. Verwenden Sie--lang. - Mit
--yesund ohne Terminal ist die automatische Sprache Englisch: Skripte lesen diese Ausgabe.--langfunktioniert dort trotzdem. - Der Installer benötigt ein UTF-8-Locale auf dem Host für die anderen Sprachen
(
C.UTF-8oderen_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.logund 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:
[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 IDgibt 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-idgibt 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
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.fdbVerwenden 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).
/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--jsonfü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:
Was Sie im Terminal sehen:
[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-rootund--portkö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 versionwird gefragt, wenn das ältere HQbird ein Firebird einer anderen Version verwaltet (aktualisieren Sie dieses, oder ein neues daneben).--yesbeantwortet alle Fragen mit Ja; ohne Terminal und ohne--yesbricht der Installer mit Exit-Code 4 ab und ändert nichts. --disable-hqbirdschaltet die Units des älteren HQbird in jedem Fall aus;--no-hqbirdlä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.propertiesbleibt erhalten, melden Sie sich also mit dem Login und Passwort an, die Sie zuvor verwendet haben. Der Installer übergibt die Datei anfirebirdmit 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, oderaliases.conffür 2.5) alsname = 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 einerinclude-Direktive wird nicht geändert. - Er entfernt die alten Monitoring-Logs des älteren HQbird: den Inhalt
der Ordner
mon/outcomingundmon/outtraceseines 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:
sudo sh hqbird2027-fb50-linux-2027.2.9.run --yes --disable-hqbird6. 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.
sudo sh hqbird2027-fb50-linux-2027.2.9.runIn 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:
[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
sudo sh hqbird2027-fb50-linux-2027.2.9.run --fb-root /opt/fb50-2 --port 3056Das 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:
# 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-dataOhne --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:
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:
B=/opt/fb50-2
U=firebird.$(echo ${B#/} | tr / _) # /opt/fb50-2 -> firebird.opt_fb50-2
systemctl list-unit-files "$U*" # the units that will be removed
sudo systemctl disable --now $(systemctl list-unit-files "$U*" --no-legend | awk '$1 !~ /@/ {print $1}')
sudo rm -f /usr/lib/systemd/system/$U* /etc/systemd/system/$U*
sudo systemctl daemon-reload
sudo rm -rf $B8. 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.
- Ö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 Sieattach.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, wennadmin_panel.install_script_urlgesetzt ist. - Kopieren Sie
attach.jsonauf den Server. - Verbinden Sie auf eine der beiden Arten:
# 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.jsonMit 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:
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:
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.txtNeue Installation mit der Trial-E-Mail, einer Lizenzdatei und der Attach-Datei:
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.jsonUpdate eines älteren HQbird, alle älteren HQbird-Units aus:
sudo sh hqbird2027-fb50-linux-2027.2.9.run --yes --disable-hqbirdUpdate von HQbird 2027 auf eine neue Version (eine Instanz; bei mehreren
--fb-root und --port hinzufügen):
sudo sh hqbird2027-fb50-linux-2027.2.9.run --yesEine zweite Firebird 5.0-Instanz auf Port 3056:
sudo sh hqbird2027-fb50-linux-2027.2.9.run --yes --fb-root /opt/fb50-2 --port 3056Entfernung:
sudo sh hqbird2027-fb50-linux-2027.2.9.run --uninstall
sudo sh hqbird2027-fb50-linux-2027.2.9.run --uninstall --remove-dataEin Skript, das bei einer fehlgeschlagenen Installation abbricht:
#!/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:
[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 ./*.debAuf 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 |