Onderhoud van de HQbird-server
Onderhoud zonder nachtdiensten
Sweep, databasevalidatie, herberekening van indexstatistieken, uw SQL-scripts en Firebird-updates worden 's nachts volgens schema uitgevoerd. Groepssweep, SQL-scripts en Firebird-updates starten alleen in hun eigen venster. De agent staat back-ups en gebruikers niet in de weg. Als er iets misgaat, herstelt de agent zelf de vorige toestand.
- 4 onderhoudstaken
- 1 zware bewerking per database
- 2 zware taken per server
- 03:30–04:00 Firebird-updatevenster
- automatische rollback als de controle mislukt
Standaardschema
Servernacht
Onderhoud wordt 's nachts uitgevoerd, elke taak op zijn eigen tijd. Hieronder staan de standaardtijden en vensters. U wijzigt ze in de configuratie-editor van de agent.
Sweep, gfix-validatie, indexherberekening en SQL-scripts staan standaard uit: u schakelt ze in voor uw databases. Tijden gebruiken de tijdzone van de agent.
De zondagnacht verloopt in deze volgorde: gfix-validatie om 02:30, sweep om 03:00, indexherberekening om 04:00. Eerst de controle, dan garbage collection, dan statistieken op live data.
sweep · gfix · indexes · SQL
Vier onderhoudstaken
Elke taak is een normale Firebird-opdracht. De agent voegt toe wat een DBA meestal handmatig doet: een schema, een venster, een databaselock, een log en een duidelijke foutreden.
| Taak | Wat het doet | Welke databases | Standaard |
|---|---|---|---|
| Sweep | gfix -sweep: verwijdert oude recordversies. | Expliciete databaselijst | zo 03:00 |
| Groepssweep | Dezelfde sweep voor alle databases in mappen. Maskers, uitsluitingen, scandiepte. | Mappen, masker *.fdb | 00:15–01:15 |
| gfix-validatie | gfix -v -full: controleert elke databasepagina. | Alleen expliciete lijst | zo 02:30 |
| Indexherberekening | SET STATISTICS voor gebruikersindexen. Vindt ook inactieve indexen. | Databaselijst | zo 04:00 |
| SQL-scripts | Uw DDL en DML uit de map met inkomende scripts of uit de wachtrij. | Eén database per script | 03:00–04:00 |
- Langdurige transacties vóór sweepAls optie verbreekt de agent verbindingen met transacties ouder dan 5 uur (de drempel is configureerbaar). gbak, gfix, gstat en fbsvcmgr worden niet aangeraakt.
- De groep stopt nietEen fout op één database stopt de scan van de andere databases niet.
- Een duidelijke redenFirebird 3 en later staan validatie van een database met verbonden gebruikers niet toe. De agent zegt precies dat in plaats van alleen een foutcode te tonen.
- SQL: de agent voegt COMMIT toeDDL: COMMIT na elke opdracht, DML: na elke 100 opdrachten.
SET BAIL ON: de eerste fout stopt het script. - Gevaarlijke SQL wordt niet uitgevoerd
DROP DATABASE, gebruikers en rollen,GRANTenREVOKE,ALTER DATABASE: zo'n script gaat als geheel naar quarantaine. - UitvoeringslogWelke opdracht, wanneer en met welk resultaat. Voor sweep en gfix-validatie houdt de agent een opdrachtgeschiedenis bij: tot 50 per taak, de laatste twee zijn zichtbaar in de editor. Het wachtwoord komt nooit in het log.
Vensters · locks · slots
Als de server bezet is, wacht de taak of slaat de database over
Vóór een start controleert de agent verschillende voorwaarden. Als een voorwaarde niet is vervuld, wacht de taak of slaat de database over. Ander werk wordt niet onderbroken.
Schakel de voorwaarden aan de linkerkant in en zie wat de agent doet met de database sales.fdb tijdens een groepssweep van de map.
| Regel | Wat telt | Wat de agent doet |
|---|---|---|
| Onderhoudsvenster | Groepssweep 00:15–01:15, SQL-scripts 03:00–04:00, performancetest za 22:00 — zo 06:00. | Buiten het venster start de taak niet. Als er minder dan een minuut in het venster over is, start hij ook niet. |
| Eén zware bewerking per database | Back-up, sweep, validatie, indexherberekening, restore en SQL-script nemen een databaselock. | Een back-up wacht tot 60 minuten tot de database vrij is. Sweep, validatie en indexherberekening slaan een bezette database over tot de volgende geplande uitvoering. Nu uitvoeren wacht en probeert het opnieuw. |
| Niet meer dan 2 zware taken per server | Back-ups, restores, sweep, validaties, indexherberekening, SQL-scripts, volledige gstat, de test. Zwaar werk van de agent zelf neemt ook een slot: verwerking van traces en logs. | Een derde taak wacht op een vrij slot. U wijzigt het aantal in de instellingen; de nieuwe waarde wordt van kracht na een herstart van de agent. |
.delta-bestand | Er staat een .delta-bestand naast de database: nbackup houdt de database vast. | Sweep slaat zo'n database over. |
| Een fout in één database van een groep | De sweep van één database in de groep eindigde met een fout. | De groepssweep gaat verder met de volgende database. Als doorgaan uit staat, stopt alleen deze taak. De databases met een fout worden in de taakuitkomst genoemd. |
Als een gbak-back-up en een nbackup van dezelfde database op dezelfde minuut vallen, schuift de gbak-back-up 15 minuten op. Een handmatige start met Nu uitvoeren schuift niet op.
Eén knop
Nu uitvoeren: start het nu
Een back-up nodig vóór een software-update, of een sweep meteen? De knop “Nu uitvoeren” op de taakrij start de taak één keer. Het schema verandert niet.
Nu uitvoeren is beschikbaar voor back-ups, restores, sweep, indexherberekening en gfix-validatie. U kunt ook een uitgeschakelde taak één keer uitvoeren: daarna blijft hij uitgeschakeld. De agent controleert dezelfde voorwaarden als bij een geplande uitvoering en toont waarop hij wacht.
- U ziet waarop hij wachtDe database is bezet met een andere bewerking, de taak wacht op zijn venster, schijfruimte is laag.
- AnnulerenZolang een uitvoering in de wachtrij staat of wacht, kunt u deze annuleren. Een taak die al is gestart, wordt niet geannuleerd.
- Een verzoek leeft 60 minutenAls de agent het in deze tijd niet heeft opgepakt, geldt de uitvoering als verlopen, niet als verloren.
- U ziet welke database wordt uitgevoerdHet uitvoeringsvenster begint met het databaseveld. Voor een groepstaak zijn dit selectievakjes voor de databases en de regel “N van M geselecteerd”.
- Prestatierapport op verzoekNu uitvoeren bouwt een rapport voor elk bereik tot 24 uur, met filters op database, duur en programma. Dit is dezelfde uitvoering als de knop “Rapport bouwen…” op de rapportpagina.
- Lokaal en vanuit het centrumDe lokale console gaat rechtstreeks naar de agent. Vanuit het centrum gaat het verzoek via goafts. De agent pakt het op bij de volgende synchronisatie, in ongeveer een minuut.
- Databasevervanging is apartRestore met vervanging en de cyclus back-up-restore-vervanging: u moet de databasenaam typen en hebt een aparte machtiging nodig. Extern starten van zulke taken staat standaard uit op de server.
- Direct na OpslaanNu uitvoeren wacht tot de agent de nieuwe configuratie accepteert en start de taak pas daarna.
Engine-update
Een nieuwe Firebird-build is een normale nachtelijke operatie
De agent downloadt zelf een nieuwe Firebird-build, wacht op het onderhoudsvenster, installeert deze en controleert hem. Als de controle mislukt, zet de agent de vorige versie terug en installeert deze build niet opnieuw.
- VensterStandaard 03:30–04:00. Buiten het venster wacht de gedownloade build tot het venster opent. Als de update binnen het venster wordt uitgesteld, probeert de agent het over 10 minuten opnieuw. De agent vindt een nieuwe build in het centrum binnen ongeveer een uur.
- Jobs die niet mogen worden afgebrokenAls gbak, nbackup, een restore of een SQL-script draait, wacht de update tot de volgende controle. Sweep, gfix-validatie en gstat blokkeren hem niet: die kunnen worden herhaald.
- Eén engine tegelijkOp een server met meerdere Firebird-instanties wordt er slechts één tegelijk bijgewerkt.
- Ruimte en vergrendelde bestandenVrije ruimte en bestanden die door een ander programma worden vastgehouden, worden gecontroleerd voordat Firebird stopt. Als een bestand niet kan worden vervangen, stopt Firebird niet.
- Uw bestanden blijven staanDe agent vervangt alleen de distributiebestanden. firebird.conf, databases.conf, replication.conf, de security-database, UDF's en plug-ins van derden blijven staan. Alleen ontbrekende vereiste parameters worden aan firebird.conf toegevoegd.
- TerugdraaienDe vervangen bestanden worden bewaard in de update-back-up. Een rollback zet ze terug. De laatste 2 back-ups worden bewaard.
- VersieblokkeringEen build die automatisch of handmatig is teruggedraaid, wordt geblokkeerd. Eén opdracht verwijdert de blokkering.
- Onvoltooide updateAls het proces halverwege is gestopt, start er geen nieuwe update tot de beheerder de vorige heeft teruggedraaid of voltooid.
De agent werkt Firebird dat uit OS-pakketten is geïnstalleerd (apt, dnf) niet bij: de pakketbeheerder is eigenaar van de bestanden. Hoe u zo'n server naar HQbird verhuist, wordt hieronder beschreven.
Test · databases.conf · migratie
Beheerderstools
Prestatietest van de server
Eens per week voert de agent de IBSurgeon-test uit: INSERT, UPDATE en DELETE op een miljoen rijen in een tijdelijke database. De testgeschiedenis laat zien hoe de server werkte vóór en na een wijziging van hardware, schijf of instellingen.
De test belast de schijf, dus hij draait alleen in zijn eigen venster. Firebird zelf verwijdert de tijdelijke database. Als de agent tijdens de test is gecrasht, wordt het bestand bij de volgende start verwijderd.
| Venster | za 22:00 — zo 06:00 |
|---|---|
| Start | zo 01:00 |
| Rijen | 1 000 000 |
| Vrije schijfruimte | ongeveer 7,2 GiB, anders start de test niet |
| Geschiedenis | laatste 30 uitvoeringen |
| Tegelijkertijd | één test; een tweede uitvoering wordt overgeslagen |
Firebird-gebruikers: Security.fdb/Users
Een aparte instellingenpagina toont de security-databases van de server: de gedeelde, privé-databases en die welke in een database zijn ingebed. Labels tonen een probleem: geen login voor lezen, de lijst is niet vernieuwd, de vermelding is verouderd.
Met de knop Gebruiker aanmaken maakt u een Firebird-gebruiker aan via de agent. In het venster: naam, wachtwoord twee keer, plug-in uit de instelling UserManager, de vlaggen “actief” en “beheerder”. Beheerdersrechten worden in een tweede stap bevestigd. Voordat het wordt uitgevoerd, ziet u de opdrachttekst, met het wachtwoord verborgen.
Aanmaken werkt met de lokale agent en werkt niet voor Firebird 2.5.
databases.conf-editor
Het bestand wordt getoond als een lijst met databasepaden. Elk pad heeft zijn aliassen en een parameterblok. De parameterlijst bevat alleen die parameters die deze Firebird-versie voor één database accepteert. De waarde uit firebird.conf wordt ernaast getoond.
Een herhaalde alias en een tweede blok voor hetzelfde pad zijn fouten: u kunt zo'n bestand niet opslaan. Een typefout in een parameternaam krijgt een hint. Bij opslaan controleert de agent het bestand opnieuw en bewaart een kopie van het vorige bestand ernaast. Als het bestand is gewijzigd terwijl u het bewerkte, weigert de agent, en uw tekst blijft in de editor staan. Bewerkingen in het formulier raken opmerkingen in het bestand niet aan. Elke opslag wordt naar het auditlog geschreven.
Vanuit het centrum wordt het bestand geleverd via goafts. De agent past het binnen ongeveer een minuut toe en meldt het resultaat: geaccepteerd of geweigerd.
Verhuizen naar HQbird en instellingen wijzigen
FBDataGuard
Oude HQbird-instellingen worden automatisch overgenomen
Bij de eerste start vindt de agent de FBDataGuard-configuratie en neemt de jobs voor back-up, sweep en indexstatistieken over. De import wordt één keer uitgevoerd. Standaard komen de jobs uitgeschakeld binnen. Als de installer FBDataGuard uitschakelt, schakelt hij de jobs in die FBDataGuard uitvoerde en die zonder waarschuwingen zijn geïmporteerd. Zo blijft de server niet zonder back-ups achter. De andere jobs blijven uitgeschakeld: controleer ze en schakel ze zelf in. De agent neemt oude back-ups uit de FBDataGuard-journals op in zijn eigen administratie: retentie en restore zien ze.
apt · dnf
Firebird uit OS-pakketten
De installer vindt Firebird uit pakketten en stopt zonder iets te wijzigen. Hij toont opdrachten die het pakket verwijderen en de security-database, databases.conf en de databases behouden. Daarna installeert de installer HQbird en neemt de gebruikers en aliassen van de oude server over. Getest voor Firebird 2.5, 3.0, 4.0 en 5.0.
zonder herstart
Nieuwe instellingen, met een controle
De agent controleert de nieuwe configuratie, maakt een kopie van de oude en past de nieuwe toe zonder herstart. Als de nieuwe niet laadt, zet de agent de vorige terug. De meeste instellingen worden toegepast zonder herstart. Een herstart is nodig voor de datamap, het agentlog, Local API, de verbinding met het centrum, Prometheus, het cluster, belastingslimieten en de tijdzone van de agent. De agent meldt welke wijzigingen op een herstart wachten.
← Terug naar het HQbird 2027-overzicht · Back-ups in detail → · Serverstatus →