HQCenter: Server-Flotte
Viele Server in einer Konsole
HQCenter ist ein Linux-Server beim Kunden. Alle Agents des Kunden verbinden sich mit ihm. Die Agents senden ihre Daten dorthin und holen Einstellungen, Befehle, Lizenzen und neue Versionen von dort. Der Administrator sieht die gesamte Flotte im HQ Monitor und verwaltet sie über einen Browser.
- 0 eingehende Ports für die Kommunikation mit dem Center
- mTLS-Zertifikat für jeden Agent
- 3 Min. bis die Daten das Center erreichen
- ~1 Min. bis die Einstellungen den Agent erreichen
- mit Rollback Agent- und Center-Updates
Agent · nginx · goafts · fblogspacker · HQ Monitor
Verbindung ohne eingehende Ports
Der Agent baut jede Verbindung auf. HQCenter verbindet sich nie mit einem Datenbankserver. Sie öffnen also keine Ports auf Firebird-Servern für die Kommunikation mit dem Center, und ein Server in einer Filiale hinter NAT funktioniert genauso wie ein Server im nächsten Rack.
Auf HQCenter laufen drei Programme hinter nginx. goafts empfängt Archive, stellt Zertifikate aus und speichert Einstellungen, Befehle, Lizenzen und neue Versionen. fblogspacker sortiert Archive in Agent-Ordner. HQ Monitor zeigt diese Ordner in einem Browser.
| HQCenter-Port | Wer sich verbindet | Prüfung |
|---|---|---|
:443 | Agents: Archive, Einstellungen, Befehle, Lizenz, neue Versionen | TLS 1.3 und das Agent-Zertifikat; ein widerrufenes Zertifikat wird abgelehnt |
:9443 | Neuer Agent bei der ersten Verbindung sowie Installationsprogramme | Kein Agent-Zertifikat: Zertifikatsanfrage mit dem Schlüssel aus attach.json, Fingerabdruck des Center-Schlüssels, Downloads der Installationsprogramme |
:8443 | Administrator und Konsole: Verwaltung | Administrator-Zertifikat und Liste der erlaubten Adressen |
:8085 | Browser: HQ Monitor-Konsole | Liste der erlaubten Adressen |
- Verbinden mit einem BefehlDas Center stellt eine Datei
attach.jsonbereit: Adresse, Schlüssel-Fingerabdruck und Ablaufdatum. Auf dem Server:fbagent --attach --file attach.json. Die Installationsprogramme von HQbird 2027 erledigen das für Sie. Eine Anfrage mit einem regulären Schlüssel wird vom Administrator im Center-Panel genehmigt. Ein Lizenzschlüssel genehmigt die Anfrage selbst, solange die Lizenz freie Plätze hat. - Der Agent-Name ist der ZertifikatsnameDer Datenordner, die Einstellungen und die Zeile in der Konsole des Agents verwenden diesen Namen. Das Windows-Installationsprogramm fragt nach dem Servernamen; Standard ist der Computername. Ein Zertifikat ist ein Jahr gültig; ein widerrufenes funktioniert sofort nicht mehr.
- Nichts geht verlorenEin Archiv ist bis zu 120 MiB groß. Bei einem Netzwerkfehler 3 Wiederholungsversuche. Ein gesendetes Archiv wird gelöscht; ein nicht gesendetes wird nie gelöscht. Jeder Agent sendet mit einem eigenen Versatz von bis zu 150 s, damit die Agents eines Centers nicht in derselben Sekunde eintreffen.
- Lizenzen aus dem CenterDer Agent holt eine neue Lizenz in etwa einer Minute: Die Antwort auf das Einstellungs-Polling informiert ihn über die Lizenz. Der Agent fragt die Lizenz außerdem beim Start und alle 6 Stunden an. Er prüft die Lizenz selbst, ohne Netzwerk. Die Seite Lizenzen zeigt den Zustand jedes Servers.
- Die Konsole berührt keine DatenbankenHQ Monitor baut seine Seiten aus Agent-Dateien auf. Er verbindet sich nicht mit Firebird und erzeugt keine Last auf Datenbanken.
- Ein Linux-ServerUbuntu oder AlmaLinux. Ein Skript installiert das Center; ein zweiter Lauf aktualisiert das Vorhandene und behält Passwörter und Schlüssel.
IBSurgeon erhält Zusammenfassungen: Serverzustand, Serverliste, Liste der Backups und Wiederherstellungen (ohne die Dateien), Ereignisse und Wochenberichte, Cluster-Beschreibungen, Lizenzen. Logs, Traces, Backup-Dateien, Passwörter und das Audit-Log bleiben beim Kunden.
Einstellungseditor · Jetzt ausführen · Lieferstatus
Einstellungen aus dem Center
Das Center hält eine Kopie der Einstellungen jedes Agents. Der Administrator ändert Jobs und Einstellungen im selben Editor wie direkt am Agent und klickt auf Save and Send to agent. Der Agent holt die Änderung in etwa einer Minute.
Der Agent überschreibt die funktionierenden Einstellungen nicht mit neuen. Er prüft zuerst den Kandidaten. Ein fehlerhafter Kandidat wird beiseitegelegt, die funktionierenden Einstellungen bleiben, und die Konsole zeigt den Grund für die Ablehnung.
Status auf der Seite Server
Für jeden Server sehen Sie, wie weit die letzte Änderung gekommen ist: ein Statussymbol, die Sendezeit (push) und die Antwortzeit des Agents (ack). Der Hinweis am Symbol zeigt, warum der Agent abgelehnt hat, und die genaue Zeit.
In einer Minute sehen Sie, welche Server den neuen Backup-Job übernommen haben, welche nicht und warum.
Die Serverstufe in der Liste ist das Urteil des Agents über den Server als Ganzes. Unter den Symbolen steht eine Zeile mit dem wichtigsten Befund. Ein separates „Agent“-Symbol erscheint nur, wenn der Zustand des Agents selbst schlechter ist als der Zustand des Servers.
Ein Server, der länger als 30 Minuten schweigt, erhält ein graues Symbol „keine Daten seit …“ und wandert ans Ende der Liste. Die Zusammenfassungszeile über der Liste zählt die Server nach Stufe.
Der Agent schützt den Server
Der Agent überwacht seinen eigenen Speicher und seine CPU. Wenn eine Agent-Aufgabe zu viel verbraucht, pausiert der Agent sie und stoppt den Lauf, der den Speicher hält. Backups und Daten-Uploads berührt er nicht. Wächst der Speicher des Agents weiter, startet sich der Agent selbst neu. Eine Aufgabe, die der Agent abgeschaltet hat, wird im Zustandsbericht und im Editor angezeigt; ein Klick schaltet sie wieder ein.
Jetzt ausführen aus dem Center
Sie können ein Backup, eine Wiederherstellung, ein Sweep, eine gfix-Prüfung oder eine Neuberechnung von Indizes jetzt starten, ohne auf den Zeitplan zu warten. Die Anfrage nimmt denselben Weg: in goafts, dann holt der Agent sie beim Polling ab und legt sie mit den üblichen Prüfungen in seine Warteschlange.
- EntwürfeEine Änderung in der Konsole speichern und später senden. Sie sehen den Zustand: nicht gesendet, gesendet, angewendet, überholt.
- Passwörter sind vor dem Center verborgenDie Konsole verschlüsselt ein neues Passwort mit dem öffentlichen Schlüssel des Agents. Nur der Agent auf seinem eigenen Server kann es entschlüsseln.
- EinstellungskopienVor jedem Ersetzen speichert der Agent eine Kopie: die letzten 10, für mindestens 14 Tage. Abgelehnte Kandidaten werden 90 Tage aufbewahrt.
- Nur am ServerPrüfung der Release-Signatur, die Lizenz, Remote-Befehle, Programmpfade und die Konsolen-Anmeldung können nicht aus dem Center geändert werden.
- Datenbank-Ersetzen erfordert zwei SeitenEine Remote-Wiederherstellung, die die funktionierende Datenbank ersetzt, läuft nur, wenn der Server selbst es erlaubt und der Benutzer ein separates Recht hat. Vor dem Start müssen Sie den Dateinamen der Datenbank eingeben.
- databases.conf vom CenterSie können die Datei an einen Agenten senden. goafts leitet sie nur weiter; der Agent prüft und schreibt die Datei und bewahrt die alte daneben auf.
Signatur · Rollback-Punkt · Prüfung
Updates mit Rollback
Agenten beziehen neue Versionen von HQCenter, nicht aus dem Internet. Der Agent aktualisiert sich selbst, HQ Monitor, die Cluster-Programme und Firebird. Jedes Update folgt einem Schema: Signatur prüfen, Rollback-Punkt speichern, installieren, prüfen, dass es funktioniert. Wenn es nicht funktioniert, zurück zur alten Version.
- 1SignaturRelease von IBSurgeon signiert
- 2Rollback-PunktKopie der aktuellen Version
- 3Installierendie Dateien ersetzen
- 4Prüfendie neue Version meldet „Ich arbeite“ und läuft 45 s
- 5Fertigdie neue Version funktioniert
- ↺Rollbackdie Kopie vom Rollback-Punkt wiederherstellen
- ✓Alte Version funktioniertnach 2 Rollbacks wird die Version blockiert
| Was aktualisiert wird | Wann | Schutz |
|---|---|---|
| Agent | sofort, wenn die Antwort auf die Einstellungsabfrage eine neue Version meldet, und einmal pro Stunde; ohne eine solche Antwort alle 180 s | Signatur, 2 Rollback-Punkte. Die neue Version muss „Ich arbeite“ melden und 45 s laufen. Nach 2 Rollbacks wird die Version blockiert. |
| HQ Monitor | einmal pro Stunde, solange die Einstellungsabfrage funktioniert; sonst alle 180 s | Konsolen-Zustandsprüfung für 30 s, Kopie der alten Version. |
| Cluster-Programme | Prüfung alle 180 s | Zuerst Replikat, dann Master. |
| Firebird | nur im Zeitfenster, standardmäßig 03:30–04:00 | Wartet, bis Backups abgeschlossen sind. Prüfung nach der Installation, Rollback bei Fehler. Ein zurückgerollter Build wird nicht erneut installiert. |
| HQCenter | alle 15 Min., wenn IBSurgeon Updates für dieses Center aktiviert hat; in einem von IBSurgeon festgelegten Zeitfenster, zum Beispiel 02:00–05:00 | Standardmäßig aus. Der Center-Eigentümer kann das Update verbieten: STACK_UPDATE=off. Die Stack-Signatur wird geprüft, dann werden die Dienste bis zu 5 Minuten lang geprüft. Wenn sie fehlschlagen, wird der vorherige Stack aus dem Cache installiert. |
- Erst testen, dann alleIBSurgeon veröffentlicht ein Release zuerst in der Testzone und nach den Prüfungen in den Produktionszonen. HQCenter kopiert die Releases seiner Zone einmal pro Stunde.
- Signatur zweimal geprüftDas Center prüft die Signatur vor dem Download und erneut an den geschriebenen Bytes. Der Agent prüft sie vor der Installation noch einmal.
- Kein DowngradeSie können keine Version installieren, die niedriger als die aktuelle ist, es sei denn, der Server selbst erlaubt es.
- Unter Linux ändert root die DateienDer Agent-Dienst läuft nicht als root und kann vertrauenswürdige Installationsdateien nicht ersetzen.
Statusüberwachung · E-Mail · Webhook
Problem-E-Mails und ein Wochenbericht
HQCenter liest den Zustands-Snapshot jedes Agenten. Ein neues Problem oder ein Problem, das sich verschlimmert hat, ist ein Ereignis. Das Center selbst versendet die E-Mail oder den Webhook. Einmal pro Woche erstellt das Center einen Bericht für die gesamte Flotte.
Das Center ändert von sich aus nichts. Wenn ein Problem wochenlang bestehen bleibt und das für den Server normal ist, schlägt das Center einen neuen Schwellenwert vor. Nur ein Mensch wendet ihn an.
- 1Status lesenalle 2 Minuten, wenn sich die Agent-Datei geändert hat
- 2Ereignisneu, verschlimmert, behoben, wieder aufgetreten
- 3E-Mailoder Webhook; keine Wiederholung innerhalb von 24 h
- 4Wochenberichtstandardmäßig Montag um 07:00
- 5✓ Vorschlagneuer Schwellenwert; der Administrator wendet ihn an
Die gesamte Flotte über 14 Tage
Für jeden Server: Anteil der Zeit ohne Probleme, Episoden pro Woche und welche Befunde „festhängen“.
Kein Rauschen, sondern normal
Mindestens die Hälfte der Zeit aktiv und mindestens eine Woche in Folge. Zum Beispiel liegt die Server-CPU immer nahe am Schwellenwert.
Schwellenwert aus echten Daten
Etwas über dem, was der Server gezeigt hat: ein Viertel über dem Maximum. Bei einem unteren Schwellenwert, etwa freiem Speicher, ein Fünftel unter dem Minimum. Sie können ihn vor der Genehmigung ändern; er gilt 30 Tage.
- Ein Host, eine E-MailWenn ein Host mehrere Agenten ausführt, zählt ein Problem mit Host-CPU, Arbeitsspeicher oder Festplatte einmal.
- Behoben oder ausgeblendetDas Ereignis nennt den Grund, warum das Problem verschwunden ist: behoben, vom Administrator bestätigt oder zu Info geworden.
- Genehmigung ist eine neue EinstellungsversionDer Schwellenwert gelangt über die normale Zustellung zum Agenten, im Namen des Administrators. Jede Genehmigung und Ablehnung steht im Audit-Log.
- Link in der E-MailDie E-Mail nennt den Host, gibt einen Hinweis und einen Link zum Server in HQ Monitor.
Der Center-Administrator aktiviert E-Mail und Webhook. Bis sie eingerichtet sind, werden keine E-Mails versendet. Ereignisse und Berichte sind im Center-Panel und in seiner API sichtbar.
Benutzer · Rechte · Audit · Sprachen
Benutzer und Rechte
Jeder Benutzer sieht nur seine eigenen Server. Rechte für Änderungen werden separat einzeln vergeben.
Der Administrator sieht alle Server und verwaltet Benutzer. Ein normaler Benutzer sieht die Server aus seiner Liste. Ein neues Recht oder eine neue Liste wird beim nächsten Seitenaufruf wirksam; ein neues Passwort meldet den Benutzer aus allen Browsern ab.
| Recht | Was es erlaubt |
|---|---|
| Einstellungen senden | Geänderte Einstellungen über das Center an den Agenten senden. |
| Jobs ausführen | Ein Backup, Restore, Sweep oder eine Index-Neuberechnung starten und abbrechen (Jetzt ausführen). |
| Jobs, die eine Datenbank ersetzen | Einen Restore starten, der die Arbeitsdatenbank ersetzt. Nur zusammen mit dem Ausführungsrecht und nur, wenn der Agent es ebenfalls erlaubt. |
- Audit-LogJedes Speichern, Senden, jede Passwortänderung und jeder Job-Start wird mit dem Benutzer-Login geschrieben. In goafts schützt eine Hash-Kette das Log.
- Agent-Anfrage-LogDer Agent selbst schreibt eine Zeile für jede Anfrage, die den Server ändert, und für jede Zugriffsverweigerung: Local API, Befehle vom Center, Jetzt ausführen, Einstellungsänderungen, Updates. Passwörter und Anfrageinhalte gelangen nicht ins Log. Die Datei geht zusammen mit den Logs an das Center.
- HQ Monitor-LoginSitzung dauert 7 Tage. Nicht mehr als 8 Login-Versuche von einer Adresse in 15 Minuten.
- Center-Admin-PanelEin separates Login, nur mit einem Administrator-Zertifikat. Sitzung dauert 8 Stunden. Nach 5 fehlgeschlagenen Versuchen in 15 Minuten wird das Login für 15 Minuten gesperrt.
- Bis zu 2000 BenutzerJeder hat sein eigenes Passwort und seine Serverliste; Suche nach Server beim Zuweisen von Servern.
- 5 OberflächensprachenEnglisch, Russisch, Deutsch, Portugiesisch (Brasilien), Spanisch. Auch Statistikberichte verwenden die gewählte Sprache.
← Zurück zur HQbird 2027-Übersicht · Server-Zustand in einer Minute →