HQbird-Server-Wartung
Wartung ohne Nachtschichten
Sweep, Datenbankvalidierung, Neuberechnung der Indexstatistiken, Ihre SQL-Skripte und Firebird-Updates laufen nachts nach Zeitplan. Gruppen-Sweep, SQL-Skripte und Firebird-Updates starten nur in ihrem eigenen Zeitfenster. Der Agent steht Backups und Benutzern nicht im Weg. Wenn etwas schiefgeht, stellt der Agent den vorherigen Zustand selbst wieder her.
- 4 Wartungsaufgaben
- 1 schwere Operation pro Datenbank
- 2 schwere Aufgaben pro Server
- 03:30–04:00 Zeitfenster für Firebird-Updates
- automatischer Rollback wenn die Prüfung fehlschlägt
Standardzeitplan
Servernacht
Die Wartung läuft nachts, jede Aufgabe zu ihrer eigenen Zeit. Unten stehen die Standardzeiten und Zeitfenster. Sie ändern sie im Konfigurationseditor des Agenten.
Sweep, gfix-Validierung, Index-Neuberechnung und SQL-Skripte sind standardmäßig ausgeschaltet: Sie aktivieren sie für Ihre Datenbanken. Die Zeiten gelten in der Zeitzone des Agenten.
Die Sonntagnacht läuft in dieser Reihenfolge: gfix-Validierung um 02:30, Sweep um 03:00, Index-Neuberechnung um 04:00. Zuerst die Prüfung, dann die Speicherbereinigung, dann die Statistiken auf Live-Daten.
sweep · gfix · indexes · SQL
Vier Wartungsaufgaben
Jede Aufgabe ist ein normaler Firebird-Befehl. Der Agent ergänzt, was ein DBA normalerweise von Hand erledigt: einen Zeitplan, ein Zeitfenster, eine Datenbanksperre, ein Protokoll und einen klaren Fehlergrund.
| Aufgabe | Was sie tut | Welche Datenbanken | Standard |
|---|---|---|---|
| Sweep | gfix -sweep: entfernt alte Datensatzversionen. | Explizite Datenbankliste | So 03:00 |
| Gruppen-Sweep | Derselbe Sweep für alle Datenbanken in Ordnern. Masken, Ausschlüsse, Suchtiefe. | Ordner, Maske *.fdb | 00:15–01:15 |
| gfix-Validierung | gfix -v -full: prüft jede Datenbankseite. | Nur explizite Liste | So 02:30 |
| Index-Neuberechnung | SET STATISTICS für Benutzerindizes. Findet auch inaktive Indizes. | Datenbankliste | So 04:00 |
| SQL-Skripte | Ihre DDL und DML aus dem Ordner für eingehende Skripte oder aus der Warteschlange. | Eine Datenbank pro Skript | 03:00–04:00 |
- Lang laufende Transaktionen vor dem SweepOptional trennt der Agent Verbindungen mit Transaktionen, die älter als 5 Stunden sind (der Schwellenwert ist konfigurierbar). gbak, gfix, gstat und fbsvcmgr werden nicht angefasst.
- Die Gruppe stoppt nichtEin Fehler bei einer Datenbank stoppt den Scan der anderen Datenbanken nicht.
- Ein klarer GrundFirebird 3 und später erlaubt keine Validierung einer Datenbank mit verbundenen Benutzern. Der Agent sagt genau das, statt nur einen Fehlercode anzuzeigen.
- SQL: Der Agent fügt COMMIT hinzuDDL: COMMIT nach jeder Anweisung, DML: nach jeweils 100 Anweisungen.
SET BAIL ON: Der erste Fehler stoppt das Skript. - Gefährliches SQL wird nicht ausgeführt
DROP DATABASE, Benutzer und Rollen,GRANTundREVOKE,ALTER DATABASE: Ein solches Skript geht als Ganzes in Quarantäne. - AusführungsprotokollWelcher Befehl, wann und mit welchem Ergebnis. Für Sweep und gfix-Validierung führt der Agent einen Befehlsverlauf: bis zu 50 pro Aufgabe, die letzten zwei sind im Editor sichtbar. Das Passwort gelangt nie ins Protokoll.
Zeitfenster · Sperren · Slots
Wenn der Server beschäftigt ist, wartet die Aufgabe oder überspringt die Datenbank
Vor einem Start prüft der Agent mehrere Bedingungen. Ist eine Bedingung nicht erfüllt, wartet die Aufgabe oder überspringt die Datenbank. Sie unterbricht keine andere Arbeit.
Aktivieren Sie die Bedingungen links und sehen Sie, was der Agent mit der Datenbank sales.fdb während eines Gruppen-Sweeps ihres Ordners macht.
| Regel | Was zählt | Was der Agent tut |
|---|---|---|
| Wartungsfenster | Gruppen-Sweep 00:15–01:15, SQL-Skripte 03:00–04:00, Performance-Test Sa 22:00 — So 06:00. | Außerhalb des Zeitfensters startet die Aufgabe nicht. Wenn weniger als eine Minute im Zeitfenster verbleibt, startet sie ebenfalls nicht. |
| Eine schwere Operation pro Datenbank | Backup, Sweep, Validierung, Index-Neuberechnung, Restore und SQL-Skript nehmen eine Datenbanksperre. | Ein Backup wartet bis zu 60 Minuten, bis die Datenbank frei wird. Sweep, Validierung und Index-Neuberechnung überspringen eine beschäftigte Datenbank bis zum nächsten geplanten Lauf. „Jetzt ausführen“ wartet und versucht es erneut. |
| Nicht mehr als 2 schwere Aufgaben pro Server | Backups, Restores, Sweep, Validierungen, Index-Neuberechnung, SQL-Skripte, vollständiges gstat, der Test. Auch schwere Arbeit des Agenten selbst belegt einen Slot: die Verarbeitung von Traces und Protokollen. | Eine dritte Aufgabe wartet auf einen freien Slot. Sie ändern die Anzahl in den Einstellungen; der neue Wert wird nach einem Neustart des Agenten wirksam. |
.delta-Datei | Neben der Datenbank liegt eine .delta-Datei: nbackup hält die Datenbank. | Der Sweep überspringt eine solche Datenbank. |
| Ein Fehler in einer Datenbank einer Gruppe | Der Sweep einer Datenbank in der Gruppe endete mit einem Fehler. | Der Gruppen-Sweep fährt mit der nächsten Datenbank fort. Ist die Fortsetzung ausgeschaltet, stoppt nur diese Aufgabe. Die Datenbanken mit einem Fehler werden im Ergebnis der Aufgabe genannt. |
Wenn ein gbak-Backup und ein nbackup derselben Datenbank auf dieselbe Minute fallen, verschiebt sich das gbak-Backup um 15 Minuten nach hinten. Ein manueller Start mit „Jetzt ausführen“ verschiebt sich nicht.
Eine Schaltfläche
Jetzt ausführen: jetzt starten
Brauchen Sie ein Backup vor einem Software-Update oder einen Sweep genau jetzt? Die Schaltfläche „Jetzt ausführen“ in der Aufgabenzeile startet die Aufgabe einmalig. Der Zeitplan ändert sich nicht.
„Jetzt ausführen“ ist für Backups, Restores, Sweep, Index-Neuberechnung und gfix-Validierung verfügbar. Sie können auch eine deaktivierte Aufgabe einmal ausführen: Danach bleibt sie deaktiviert. Der Agent prüft dieselben Bedingungen wie bei einem geplanten Lauf und zeigt an, worauf er wartet.
- Sie sehen, worauf gewartet wirdDie Datenbank ist mit einer anderen Operation beschäftigt, die Aufgabe wartet auf ihr Zeitfenster, der Speicherplatz ist knapp.
- AbbrechenSolange ein Lauf in der Warteschlange steht oder wartet, können Sie ihn abbrechen. Eine bereits gestartete Aufgabe wird nicht abgebrochen.
- Eine Anfrage lebt 60 MinutenWenn der Agent sie in dieser Zeit nicht annimmt, gilt der Lauf als abgelaufen, nicht als verloren.
- Sie sehen, welche Datenbank läuftDas Ausführungsfenster beginnt mit dem Datenbankfeld. Bei einer Gruppenaufgabe sind das Kontrollkästchen für die Datenbanken und die Zeile „N von M ausgewählt“.
- Performance-Bericht auf Anfrage„Jetzt ausführen“ erstellt einen Bericht für einen beliebigen Zeitraum bis zu 24 Stunden, mit Filtern nach Datenbank, Dauer und Programm. Dies ist derselbe Lauf wie die Schaltfläche „Bericht erstellen…“ auf der Berichtsseite.
- Lokal und vom Zentrum ausDie lokale Konsole geht direkt zum Agenten. Vom Zentrum aus geht die Anfrage über goafts. Der Agent nimmt sie bei der nächsten Synchronisierung an, in etwa einer Minute.
- Datenbankersetzung ist separatRestore mit Ersetzen und der Zyklus Backup-Restore-Ersetzen: Sie müssen den Datenbankdateinamen eingeben und benötigen eine separate Berechtigung. Der entfernte Start solcher Aufgaben ist auf dem Server standardmäßig ausgeschaltet.
- Direkt nach dem Speichern„Jetzt ausführen“ wartet, bis der Agent die neue Konfiguration annimmt, und startet die Aufgabe erst dann.
Engine-Update
Ein neuer Firebird-Build ist ein normaler Nachtvorgang
Der Agent lädt selbst einen neuen Firebird-Build herunter, wartet auf das Wartungsfenster, installiert ihn und prüft ihn. Schlägt die Prüfung fehl, stellt der Agent die vorherige Version wieder her und installiert diesen Build nicht erneut.
- FensterStandardmäßig 03:30–04:00. Außerhalb des Fensters wartet der heruntergeladene Build, bis das Fenster geöffnet wird. Wird das Update innerhalb des Fensters verschoben, versucht es der Agent nach 10 Minuten erneut. Einen neuen Build findet der Agent in etwa einer Stunde im Center.
- Jobs, die nicht abgebrochen werden dürfenWenn gbak, nbackup, ein Restore oder ein SQL-Skript läuft, wartet das Update bis zur nächsten Prüfung. Sweep, gfix-Validierung und gstat blockieren es nicht: Sie können wiederholt werden.
- Eine Engine nach der anderenAuf einem Server mit mehreren Firebird-Instanzen wird jeweils nur eine aktualisiert.
- Speicherplatz und gesperrte DateienFreier Speicherplatz und Dateien, die von einem anderen Programm gehalten werden, werden geprüft, bevor Firebird stoppt. Kann eine Datei nicht ersetzt werden, stoppt Firebird nicht.
- Ihre Dateien bleiben erhaltenDer Agent ersetzt nur die Distributionsdateien. firebird.conf, databases.conf, replication.conf, die Sicherheitsdatenbank, UDFs und Plugins von Drittanbietern bleiben erhalten. In firebird.conf werden nur fehlende erforderliche Parameter ergänzt.
- RollbackDie ersetzten Dateien werden im Update-Backup aufbewahrt. Ein Rollback stellt sie wieder her. Die letzten 2 Backups werden aufbewahrt.
- VersionssperreEin Build, der zurückgerollt wurde – automatisch oder von Hand –, wird gesperrt. Ein Befehl hebt die Sperre auf.
- Unvollständiges UpdateWenn der Prozess in der Mitte abgebrochen wurde, startet kein neues Update, bis der Administrator das vorherige zurückrollt oder abschließt.
Der Agent aktualisiert kein Firebird, das aus OS-Paketen (apt, dnf) installiert wurde: Die Dateien gehören dem Paketmanager. Wie ein solcher Server auf HQbird umgestellt wird, ist unten beschrieben.
Test · databases.conf · Migration
Administratorwerkzeuge
Serverleistungstest
Einmal pro Woche führt der Agent den IBSurgeon-Test aus: INSERT, UPDATE und DELETE auf einer Million Zeilen in einer temporären Datenbank. Der Testverlauf zeigt, wie der Server vor und nach einer Änderung von Hardware, Festplatte oder Einstellungen gearbeitet hat.
Der Test belastet die Festplatte, daher läuft er nur in seinem eigenen Fenster. Firebird selbst löscht die temporäre Datenbank. Ist der Agent während des Tests abgestürzt, wird die Datei beim nächsten Start gelöscht.
| Fenster | Sa 22:00 — So 06:00 |
|---|---|
| Start | So 01:00 |
| Zeilen | 1 000 000 |
| Freier Speicherplatz | etwa 7,2 GiB, sonst startet der Test nicht |
| Verlauf | letzte 30 Läufe |
| Gleichzeitig | ein Test; ein zweiter Lauf wird übersprungen |
Firebird-Benutzer: Security.fdb/Users
Eine separate Einstellungsseite zeigt die Sicherheitsdatenbanken des Servers: die gemeinsame, private und die in eine Datenbank eingebetteten. Beschriftungen zeigen ein Problem an: kein Login zum Lesen, die Liste wurde nicht aktualisiert, der Eintrag ist veraltet.
Die Schaltfläche Benutzer erstellen legt einen Firebird-Benutzer über den Agent an. Im Fenster: Name, Passwort zweimal, Plugin aus der Einstellung UserManager, die Flags „aktiv“ und „Administrator“. Administratorrechte werden in einem zweiten Schritt bestätigt. Vor der Ausführung sehen Sie den Befehlstext, mit verborgenem Passwort.
Das Erstellen funktioniert mit dem lokalen Agent und nicht für Firebird 2.5.
databases.conf-Editor
Die Datei wird als Liste von Datenbankpfaden angezeigt. Jeder Pfad hat seine Aliase und einen Parameterblock. Die Parameterliste enthält nur die, die diese Firebird-Version für eine einzelne Datenbank akzeptiert. Der Wert aus firebird.conf wird daneben angezeigt.
Ein wiederholter Alias und ein zweiter Block für denselben Pfad sind Fehler: Eine solche Datei können Sie nicht speichern. Ein Tippfehler in einem Parameternamen erhält einen Hinweis. Beim Speichern prüft der Agent die Datei erneut und bewahrt eine Kopie der vorherigen Datei daneben auf. Wurde die Datei während Ihrer Bearbeitung geändert, verweigert der Agent, und Ihr Text bleibt im Editor. Änderungen im Formular berühren keine Kommentare in der Datei. Jedes Speichern wird ins Audit-Log geschrieben.
Aus dem Center wird die Datei über goafts ausgeliefert. Der Agent wendet sie in etwa einer Minute an und meldet das Ergebnis: akzeptiert oder abgelehnt.
Umstellung auf HQbird und Einstellungsänderungen
FBDataGuard
Alte HQbird-Einstellungen werden von selbst übernommen
Beim ersten Start findet der Agent die FBDataGuard-Konfiguration und übernimmt die Jobs für Backup, Sweep und Indexstatistik. Der Import läuft einmal. Standardmäßig kommen die Jobs deaktiviert an. Wenn der Installer FBDataGuard deaktiviert, aktiviert er die Jobs, die FBDataGuard ausgeführt hat und die ohne Warnungen importiert wurden. So bleibt der Server nicht ohne Backups. Die anderen Jobs bleiben deaktiviert: Prüfen Sie sie und aktivieren Sie sie selbst. Alte Backups übernimmt der Agent aus den FBDataGuard-Journalen in seine eigenen Aufzeichnungen: Aufbewahrung und Restore sehen sie.
apt · dnf
Firebird aus OS-Paketen
Der Installer findet Firebird aus Paketen und stoppt, ohne etwas zu ändern. Er gibt Befehle aus, die das Paket entfernen und die Sicherheitsdatenbank, databases.conf und die Datenbanken behalten. Dann installiert der Installer HQbird und übernimmt die Benutzer und Aliase des alten Servers. Getestet für Firebird 2.5, 3.0, 4.0 und 5.0.
ohne Neustart
Neue Einstellungen, mit Prüfung
Der Agent prüft die neue Konfiguration, erstellt eine Kopie der alten und wendet die neue ohne Neustart an. Lädt die neue nicht, stellt der Agent die vorherige wieder her. Die meisten Einstellungen werden ohne Neustart angewendet. Ein Neustart ist erforderlich für den Datenordner, das Agent-Log, die Local API, die Verbindung zum Center, Prometheus, den Cluster, Lastgrenzen und die Zeitzone des Agents. Der Agent meldet, welche Änderungen auf einen Neustart warten.
← Zurück zur HQbird 2027-Übersicht · Backups im Detail → · Serverzustand →