Novità in HQbird 2027
Questo documento elenca le modifiche di HQbird 2027, dalla più recente. Ogni parte inizia con il numero del rilascio e la sua data. Un nuovo rilascio aggiunge la propria parte in cima; le parti sotto restano come erano.
- 2027.2.34 e successivi: una parte per ogni rilascio.
- 2027.2.33: l’intero HQbird 2027 a quel rilascio, confrontato con HQbird 2024.
- Le note di ogni kit, da 2027.2.8 a 2027.2.33, sono in hqbird2027-whats-new-2027.2.8-2027.2.33.md sul sito di download.
Programmi di installazione: Download di HQbird 2027.
Scaricamenti: https://ib-aid.com/download/hqbird/v2027/
(setup Windows .exe e .run Linux per Firebird 2.5, 3.0, 4.0 e 5.0;
SHA256SUMS contiene le somme di controllo).
Immagini Docker: ghcr.io/ibsurgeon/hqbird2027-fb25, -fb30, -fb40, -fb50.
2027.2.35 (2026-11-18)
Versioni
| Componente | Versione | Modificato |
|---|---|---|
| Agent HQbird (fbagent, enroll) | 3.6.0 | sì |
| HQbird Monitor | 1.59.0 | sì |
| Editor di configurazione (in HQbird Monitor) | 1.63.0 | sì |
| HQbird RCM | 2027.5.13 | sì |
| Nodo HQCluster | 2027.5.13 | sì |
| fbmcp (server MCP per Firebird) | 2027.2.24 | no |
| Firebird | 2.5.9.27194, 3.0.15.33893, 4.0.8.3332, 5.0.5.1917 | no |
Cluster: reinizializzazione dopo un backup e un ripristino di un database master
- Un backup e un ripristino (gbak) di un database master gli danno un nuovo
GUID, e le sue repliche non possono più applicare il suo journal di
replica. Il nodo lo vede in pochi secondi, sospende l’invio verso ogni
replica (motivo
master_db_replaced) e imposta il master suNEEDS_REINIT, come prima. - Novità: RCM decide che cosa fare dopo, secondo l’impostazione
auto_reinit.on_master_restoreinrcm.json(anche nella pagina Impostazioni):auto: RCM reinizializza da solo ogni replica del database, dopo un’attesa di 300 secondi (auto_reinit.master_restore_settle_sec);window: RCM le reinizializza nella sua finestra di reinizializzazione automatica;propose: RCM non avvia nulla e attende un operatore.
- Senza questa impostazione, non cambia nulla:
windowquando la reinizializzazione automatica è attiva,proposequando è disattivata. - La riga del database master nella pagina Database dice che cosa è successo e che cosa fa RCM. Il nuovo pulsante Reinizializza tutte le repliche ora avvia la reinizializzazione di tutte le repliche, una dopo l’altra. Posticipa la trattiene.
- Il nodo reagisce a ogni sostituzione del file del database: un ripristino
fatto a mano, oppure il ciclo di backup-ripristino dell’agent. Verificato
su Firebird 2.5, 3.0 e 5.0. L’avviso
master_db_replacedva ai canali di notifica di RCM.
Cluster: la replica di HQbird 2024 (FBDataGuard) passa a RCM
- Su un server aggiornato da HQbird 2024, l’agent legge le impostazioni di replica di FBDataGuard (ruoli, cartelle del journal di replica e dell’archivio, destinazioni delle repliche) e le dà a RCM.
- RCM collega da solo gli host delle repliche. Un host che RCM non può collegare è mostrato come candidato nella pagina Collega gli host.
- RCM poi prende in carico la replica dei database così com’è. Non reinizializza nessuna replica, non riavvia Firebird e non elimina file. Attende mentre FBDataGuard gira ancora.
- La pagina Impostazioni → Importa da FBDataGuard mostra lo stato
dell’import e lo ripete. La riga di comando ha
hqbirdrcm dg-import statusehqbirdrcm dg-import retry. - Il nodo legge i blocchi che FBDataGuard ha scritto in
replication.confe i segmenti del journal che ha rinominato in.uploaded. - L’import è stato provato su server Linux.
RCM: la pagina Database
- La riga di un database master con la pubblicazione attiva mostra quante
tabelle sono nella pubblicazione e quante l’operatore ne ha escluse, per
esempio
publication on · tables: 118 · taken out: 2.
Installatori: la prima password di RCM
- Dopo un’installazione con RCM, l’installatore Linux mostra sul terminale
la password generata di
rcmadmin, con il percorso del suo file. Il setup Windows la mostra nella pagina di risultato. - La password è mostrata solo su un terminale. Non viene scritta in un log, in una pipe o nel file di risultato dell’installazione.
HQbird Monitor: l’ora dell’intervallo di tempo
- I campi dell’ora dell’intervallo di tempo (dashboard, pagine dei database,
Log, Errori) sono due campi da compilare, ore e minuti, al posto degli
elenchi. Le frecce su e giù cambiano un valore di 1,
:passa dalle ore ai minuti, e un breve elenco offre passi di 15 minuti.
Editor di configurazione in HQbird Monitor
- Un timestamp è l’ora esatta. La sua età («23 min fa») è nell’infobolla.
- Il pannello di esito di un job di backup ha una riga Dimensione: il file di backup dell’esecuzione, e il database che il suo ripristino di prova ha costruito.
- Le pagine di configurazione dell’agent stanno su un telefono e su uno schermo largo 1280 px: la riga delle schede va a capo, Impostazioni mostra le sue voci su una sola riga che scorre, e le tabelle Job e Backup non scorrono più di lato a 1280 px.
Correzioni
- HQbird 3.0 su un server aggiornato da HQbird 2024 non si avviava dopo la
configurazione del cluster (“Incorrect version of replication config file”):
Firebird caricava la vecchia copia del plugin di replica dalla cartella
plugins. La copia ora è tenuta fuori da quella cartella. - Il nodo applica una modifica di
limits.rescan_interval_secsenza riavvio.
Aggiornamento
- Installa o aggiorna con il setup Windows 2027.2.35 o il
.runLinux. Un server con gli aggiornamenti automatici prende da solo l’agent 3.6.0 e HQbird Monitor 1.59.0. - In un cluster, aggiorna RCM prima dei nodi, oppure nello stesso momento. RCM 2027.5.13 funziona con nodi più vecchi; l’import da FBDataGuard ha bisogno di nodi 2027.5.13.
- Un ciclo pianificato di backup-ripristino su un database master di un
cluster: imposta
auto_reinit.on_master_restoresuauto. Altrimenti le repliche non ricevono modifiche dopo il ciclo finché un operatore non avvia la reinizializzazione. - Docker: scarica l’immagine 2027.2.35 e avvia un nuovo container sugli stessi volumi.
2027.2.34 (2026-11-17)
Versioni
| Componente | Versione | Modificato |
|---|---|---|
| Agent HQbird (fbagent, enroll) | 3.5.0 | sì |
| HQbird Monitor | 1.58.0 | sì |
| Editor di configurazione (in HQbird Monitor) | 1.62.0 | sì |
| fbmcp (server MCP per Firebird) | 2027.2.24 | no |
| HQbird RCM | 2027.5.12 | no |
| Nodo HQCluster | 2027.5.12 | no |
| Firebird | 2.5.9.27194, 3.0.15.33893, 4.0.8.3332, 5.0.5.1917 | no |
Il log di un job gbak è conservato per intero
- Prima, l’agent toglieva la parte centrale di un log gbak più grande di
16 MiB. Ora il log di ogni fase di un job di backup o di ripristino è un
solo archivio
.log.zipcon tutto ciò che gbak ha stampato. - Accanto all’archivio l’agent conserva un piccolo file di testo con le ultime 100 righe dell’output e degli errori.
- Nell’editor di configurazione, Scarica il log salva l’archivio. Il nuovo pulsante Ultime righe, nella riga di log di un job e nella cronologia dei ripristini, mostra la fine del log senza uno scaricamento.
- Un archivio più grande di 30 MB non viene inviato a HQCenter. La sua riga dice conservato solo sul server, e Scarica il log mostra il percorso dell’archivio sul server. Le ultime righe vengono comunque inviate.
- I log scritti dalle versioni precedenti (
.log.gz) sono conservati e si scaricano come prima.
HQbird Monitor su un telefono
- Su uno schermo largo 768 px o meno, l’intestazione è una sola riga: la freccia indietro, il nome del server e un pulsante di menu. Il pulsante apre il menu del server, Impostazioni, la lingua ed Esci come pannello. Prima, l’intestazione occupava tre righe e mostrava quattro delle sette voci di menu.
- L’intervallo di tempo è un solo pulsante. Apre la data, l’intervallo e le preimpostazioni come pannello. I filtri Includi ed Escludi di Log, Errori e Conflitti si ripiegano sotto un pulsante Filtri.
- Su uno schermo largo 600 px o meno, i server, i database della dashboard, gli errori e i record di log sono schede. Niente scorre di lato.
- I pulsanti e i campi sono alti almeno 44 px, e il testo di un campo è 16 px, così Safari su iPhone non ingrandisce la pagina quando tocchi un campo.
Pagine dei database in HQbird Monitor
- Una pagina di database mantiene il menu del server: Log, Configurazioni, Errori, Conflitti, Perf Report, Job e Backup sono a un clic. Prima, le voci del database prendevano il posto del menu del server.
- Le voci del database (Database, Metriche, Versioni dei client, Statistiche, Report delle prestazioni) stanno su una riga sotto l’intestazione. La riga inizia con l’etichetta DB e il nome del database, e resta al suo posto quando scorri.
- Fai clic sul nome del database per vedere i database del server: il nome, il percorso e la dimensione di ciascuno. Un altro database si apre sulla stessa pagina, lo stesso giorno e lo stesso intervallo di tempo. Da 8 database in poi, l’elenco ha un campo di ricerca.
- Perf Report mostra la riga di un database finché quel database è scelto nell’elenco Database.
- Il logo su una pagina di database non è più un link alla dashboard; lo è il nome del server.
- La guida utente (inglese e portoghese brasiliano) è aggiornata, con nuove immagini.
Installatore Linux
- ALT Linux. Su un ALT 11 pulito, i kit per Firebird 3.0, 4.0 e 5.0 si fermavano con il codice 6, perché l’installatore chiedeva nomi di pacchetti Debian. L’installatore ora conosce ALT Linux e installa i pacchetti giusti.
sudoper un solo gruppo. Su un sistema in cui solo un gruppo può eseguiresudo(ALT Linux: il gruppowheel), l’installazione veniva annullata. L’installatore ora aggiunge l’account dell’agent a quel gruppo e lo segnala. Si ferma, con il motivo, quando quel gruppo può eseguire ogni comando senza password o quando solo root può eseguiresudo.- Un’installazione fallita non lascia nulla. L’annullamento ora ferma un servizio Firebird che girava dalla cartella rimossa e teneva la porta, e rimuove la cartella dell’agent e il suo file sudoers. Il tentativo successivo riparte da zero.
- SELinux. Su AlmaLinux 8, HQbird Monitor non veniva installato: il suo file di unit aveva un label SELinux errato. L’installatore ora imposta il label.
Immagini Docker
- Un router del cluster (HAProxy) ora si avvia nel container. Prima, il servizio del router non si avviava nell’immagine.
- Un nuovo container sui volumi di uno vecchio, con un router su di essi, non si ferma più in un ciclo di riavvio.
Correzioni
- HQbird Monitor su un telefono: le voci Job e Backup comparivano per un server il cui agent non ha un editor di configurazione.
Aggiornamento
- Installa o aggiorna con il setup Windows 2027.2.34 o il
.runLinux. Un server con gli aggiornamenti automatici prende da solo l’agent 3.5.0 e HQbird Monitor 1.58.0. - Un HQCenter ha bisogno di HQbird Monitor 1.58.0 per scaricare i nuovi log
.log.zipdei suoi agent. Aggiorna HQCenter prima degli agent, oppure nello stesso momento. - Un proxy davanti a HQbird Monitor che filtra i tipi di contenuto delle
risposte deve consentire
application/zipsuapi/joblog. - Docker: scarica l’immagine 2027.2.34 e avvia un nuovo container sugli stessi volumi.
2027.2.33 (2026-11-16): HQbird 2027 a confronto con HQbird 2024
Stato del codice sorgente al 2026-11-16. Il kit rilasciato era 2027.2.33 (2026-11-16). Questa parte dà il quadro completo rispetto a HQbird 2024.
1. Riepilogo
- Lo strumento Java FBDataGuard è sostituito. Il suo lavoro è ora svolto da un servizio, fbagent, e da una console web, HQbird Monitor.
- Novità: HQbird Cluster. Un gestore di cluster (RCM) e un nodo su ogni server danno la configurazione delle repliche da una pagina web, lo switchover, il failover e il rejoin.
- Novità: HQCenter. Il tuo server centrale per molti server HQbird: una sola console, distribuzione della configurazione, aggiornamenti, licenze, controllo dei problemi.
- Novità: fbmcp. Un server MCP che permette a un assistente IA di lavorare come DBA Firebird. Le modifiche critiche richiedono l’approvazione di una persona esterna al client IA.
- Nuovi programmi di installazione. Un setup offline per ogni versione
maggiore di Firebird, per Windows (
.exe) e Linux (.run), con diverse versioni maggiori di Firebird e diverse istanze su un solo server. Immagini Docker per ogni versione maggiore. - Nuove licenze. File di licenza firmati, una prova senza registrazione per 7 giorni, zone di licenza EU / RU / BR.
- Aggiornamenti automatici dell’agent, di HQbird Monitor, di fbmcp, dei programmi del cluster e di Firebird, con verifica delle firme e rollback.
- Motore. Indice NGRAM, viste materializzate,
CREATE INDEX CONCURRENTLY,CREATE TABLE AS SELECT, opzioni di trace avanzate, un limite di connessioni per database, accesso Active Directory su Linux.
2. Componenti: 2024 e 2027
| HQbird 2024 | HQbird 2027 |
|---|---|
| FBDataGuard (Java, console web sulla porta 8082) | fbagent (servizio) + HQbird Monitor (console web) + editor di configurazione dentro il Monitor |
| Advanced Monitoring Viewer (AMV), strumenti desktop | Pagine di HQbird Monitor: dashboard, report delle prestazioni, errori, conflitti, statistiche |
| Replica impostata a mano o in FBDataGuard, failover manuale | HQbird Cluster: RCM + nodo, switchover, failover, router |
| Nessun server centrale | HQCenter (Linux) per una flotta di server |
| Nessuno strumento di IA | fbmcp, un server MCP con circa 120 strumenti |
| Un setup Windows con componenti, uno script Linux | Un setup offline per ogni versione maggiore di Firebird, .exe e .run, immagini Docker |
| Attivazione tramite e-mail e password | File di licenza firmato, prova, zone di licenza |
| Avvisi e-mail da FBDataGuard | E-mail dal monitoraggio dello stato di HQCenter; Telegram, webhook ed e-mail dall’agent |
3. Versioni
| Componente | Versione nel kit 2027.2.33 |
|---|---|
| Firebird (build HQbird) | 2.5.9.27194, 3.0.15.33893, 4.0.8.3332, 5.0.5.1917 |
| fbagent | 3.4.0 |
| HQbird Monitor | 1.57.0 |
| Editor di configurazione (nel Monitor) | 1.61.0 |
| HQbird RCM / nodo del cluster | 2027.5.12 |
| fbmcp | 2027.2.24 |
| HQCenter (goafts, site stack) | 1.22.0 |
| fblogspacker (dentro fbagent) | 1.5.12 |
4. Motore Firebird (build HQbird)
Le build HQbird di Firebird hanno funzionalità a livello di server (plugin e modifiche del core) che vanilla Firebird della stessa versione non possiede. La tabella mostra ogni funzionalità e le versioni maggiori di Firebird che la includono. La fonte è la pagina Miglioramenti di HQbird 2027 a livello di server.
| Funzionalità | Che cosa offre | Parametro | Versioni maggiori |
|---|---|---|---|
| Indice NGRAM | Ricerca di sottostringhe indicizzata (LIKE '%search%') per VARCHAR e BLOB di testo |
- | 5.0 |
| Viste materializzate | CREATE MATERIALIZED VIEW, per la BI e le query complesse. Usa l’inserimento in blocco |
- | 5.0 |
| Tabella come risultato di una query | CREATE TABLE AS SELECT. Usa l’inserimento in blocco |
- | 5.0 |
| Creazione di indici sotto carico | CREATE INDEX ... CONCURRENTLY: la tabella resta disponibile |
- | 5.0 |
| Tabelle MON$ più veloci | Disattiva la raccolta dei dati che non servono | FillMonCompiledStatements, FillMonStatements, FillMonCallStack |
5.0 |
| Migrazione facile a 5.0 | I letterali vecchio stile sono riconosciuti; COUNT(*) è descritto come INT per le vecchie applicazioni |
LegacyTimeLiterals, LegacyIntForCount |
5.0 |
| Autenticazione GSSAPI/SSPI | Plugin gssauth per Active Directory; server e client Windows e Linux |
- | 5.0 |
| Nessun log degli errori INET | Gli errori di rete non vengono scritti in firebird.log |
DisableLogNetIOErrors |
5.0 |
| Monitoraggio leggero | Tracciamento dello stato del server senza carico | MonitoringPlugin |
2.5, 3.0, 4.0, 5.0 |
| Limite di connessioni a un database | Protezione contro i picchi di connessioni | WarnCountAttachments, MaxCountAttachments |
3.0, 4.0, 5.0 |
| Opzioni di trace avanzate | Tracciamento dei conflitti (deadlock) e delle modifiche (per esempio, un audit delle modifiche) | - | 3.0, 4.0, 5.0 |
| Sostituzione della query al volo | Il server sostituisce il testo della query. Il nuovo testo è visibile nel trace e in MON$ | SqlSubstDirectory |
2.5, 3.0, 4.0, 5.0 |
| Cache dei BLOB nello spazio temporaneo | I BLOB sono più veloci del 15-200% | BlobTempSpace |
2.5, 3.0, 4.0, 5.0 |
| Log delle query con ordinamenti grandi | Il testo della query viene scritto in firebird.log |
TempSpaceLogThreshold |
2.5, 3.0, 4.0, 5.0 |
| Origini dati esterne: MySQL e ODBC | EXECUTE STATEMENT ... ON EXTERNAL verso MySQL e ODBC |
- | 3.0, 4.0, 5.0 |
| Streaming / CDC (Kafka, RabbitMQ, JSON, Mongo) | Invia gli INSERT/UPDATE/DELETE delle tabelle scelte, in base alla replica. Su richiesta | - | 4.0, 5.0 |
| Ricerca a testo intero (Lucene) | UDR open source, e un plugin basato sullo streaming | - | 3.0, 4.0, 5.0 |
| Correzione automatica dei parametri di cache | Corregge i valori errati di DefaultDbCachePages in firebird.conf / databases.conf |
DefaultDbCachePages, MinDbCachePages, MaxDbCachePages |
4.0, 5.0 |
| Mascheramento della versione HQbird | Stabilisce se l’API Firebird restituisce la stringa di versione HQbird | HQbirdVersionString |
2.5, 3.0, 4.0, 5.0 |
| Cifratura del database (plugin) | AES-256, sovraccarico del 4-20%. Su richiesta | - | 3.0, 4.0, 5.0 |
| Ottimizzatore dei JOIN | I join interni impliciti diventano espliciti | LeftJoinConversion |
3.0, 4.0 |
| Cache delle query preparate | Le query preparate restano nella memoria della connessione | DSQLCacheSize |
3.0, 4.0 |
| Backup, ripristino, sweep e creazione di indici multithread | Backup e sweep fino a 4-6x più veloci, ripristino 2-4x più veloce (8 core, SSD) | - | 2.5, 3.0, 4.0 |
| Replica nativa | Plugin; i record senza PK/UK possono essere esclusi | - | 2.5, 3.0 |
| Ottimizzatore degli ordinamenti grandi | Piano di refetch | SortDataStorageThreshold |
2.5, 3.0 |
| Lettura parallela dei dati | make_dbkey() e uno snapshot condiviso |
- | 2.5, 3.0 |
| Pool di connessioni esterne | Query esterne parallele verso Firebird | ExtConnPoolSize, ExtConnPoolLifeTime |
2.5, 3.0 |
| Backup verso Amazon S3 (plugin) | Su richiesta | - | non indicato |
5. fbagent: l’agent che sostituisce FBDataGuard
Un agent serve un’istanza Firebird. Più agent possono girare su un solo host. L’agent funziona con Firebird 2.5, 3.0, 4.0 e 5.0 su Windows e Linux.
5.1 Backup
- Backup verificato (gbak) per un database o un gruppo di database in cartelle, con un ripristino di prova facoltativo.
- nbackup incrementale, livelli da 0 a 4, in modalità semplice, avanzata o di gruppo.
- Modalità piano di nbackup: le regole danno il livello, i giorni e l’ora. L’editor mostra un calendario e una previsione dello spazio. La conservazione tiene un livello 0 con i suoi incrementi.
- Ciclo backup-ripristino: backup, ripristino e scambio del database in uso, con rollback dopo un crash.
- Job di ripristino da
.fbko.nbk, in locale o da S3. - Compressione: deflate, zip, gz, zstd.
- Cifratura: archivi zip AES-256 con deposito della chiave.
- Cloud: backup in streaming verso S3 senza file locale; copia verso S3 e FTP/FTPS.
- Inventario dei backup: una registrazione di ogni file di backup e di ogni ripristino, con dimensione, ora e risultato della verifica.
- Cronologia dei comandi: fino a 50 avvii per job, con i log di gbak.
5.2 Manutenzione
- Sweep, statistiche degli indici, validazione
gfix, script SQL con una finestra di esecuzione, tracciamento dei metadati. - Una pianificazione cron e una finestra di esecuzione per ogni job.
- Esegui ora per i job importanti: in locale, oppure da remoto tramite HQCenter, con avanzamento e annullamento.
- Un test di velocità del disco in una finestra notturna.
5.3 Controlli di stato
- Stato del server circa ogni 10 minuti. Ogni rilievo ha un livello, una riga di evidenza e un suggerimento. Lo stato mostra le tendenze (per esempio, il tempo prima che un disco sia pieno) e nomina la transazione o il programma dietro un problema.
- Metriche dell’host: CPU e memoria per programma, latenza del disco e IOPS per disco, quale servizio usa il disco, database nella cache del sistema operativo.
- Limiti Linux: TasksMax, NPROC, NOFILE, OOM kills.
- Spazio su disco: soglie minime di spazio libero e rilevamento del riempimento rapido.
- Log:
firebird.logereplication.logsono classificati per firma, per esempio una corruzione probabile. - Stato del database dalla pagina di intestazione: arresto, blocco nbackup, replica, sola lettura.
- Modalità Firebird: SuperServer, SuperClassic o Classic, con un rilievo quando un cambio di modalità attende un riavvio.
- Prometheus, endpoint
/metricscon un token. - Una protezione delle risorse limita la CPU e la memoria dell’agent stesso. Non mette mai in pausa un backup.
5.4 Prestazioni
- Trace continuo con un watchdog.
- Report delle prestazioni per finestra di tempo: classifiche per durata, frequenza, tempo totale, fetch, letture e scritture; piani, procedure, trigger; chi ha eseguito un’istruzione, quando e da dove; esecuzioni fallite.
- Report delle prestazioni su richiesta per un intervallo e un database scelti.
- Conflitti di lock e deadlock con l’SQL di entrambi i lati.
- Errori di trace per classe, con l’applicazione client e l’indirizzo.
- Monitoraggio leggero tramite il plugin
fblwmon.
5.5 Configurazione
- L’agent ricarica la propria configurazione senza riavvio: validazione, copia di backup e rollback in caso di errore.
- Editor di
databases.conf(aliases.confsu 2.5): controlli secondo la versione del motore, una copia di backup prima del salvataggio, i commenti sono conservati. - Utenti: l’elenco degli utenti di un database di sicurezza, e Crea utente.
- Distribuzione della configurazione da HQCenter, con uno stato per ogni modifica: inviata, applicata, rifiutata, deriva.
5.6 Invio dei log (fblogspacker)
- L’agent invia a HQCenter solo i dati nuovi: la nuova coda di
firebird.loge direplication.log, i file di trace e di monitoraggio al minuto, le metriche, lo stato del server. - Gli archivi hanno un tetto di dimensione (120 MiB per impostazione predefinita). I file grandi partono a pezzi.
- I backup e i database non vengono mai inviati.
6. HQbird Monitor: la nuova console web
Una console per istanza Firebird (porta 20000 + la porta di Firebird, per esempio 23050), oppure una console centrale per tutti i server di un HQCenter.
- Server: tutti i server con stato, versione e modalità di Firebird, versione dell’agent, licenza e piccoli grafici.
- Dashboard: CPU, memoria, connessioni; CPU per programma; chi usa il disco e la memoria; file temporanei; spazio su disco, latenza e velocità; una tabella dei database con badge di stato. Un clic su un minuto mostra quel minuto.
- Report sullo stato del server: una matrice di 18 sistemi per 24 ore, 7 giorni o 14 giorni; una cronologia dei problemi; rilievi per area; tabelle per dischi, transazioni, replica, errori, query e backup. I pulsanti di azione aprono la correzione nell’editor.
- Pagina del database: grafici di monitoraggio, I/O e transazioni; query e connessioni principali per un minuto scelto.
- Perf Report: 10 classifiche, esecuzioni per ora, un confronto di due finestre, una cronologia di 30 giorni di un’istruzione, un report su richiesta.
- Errori e conflitti: errori di trace con export CSV; conflitti di lock e deadlock al minuto.
- Statistiche: analisi gstat con raccomandazioni, tendenze e previsioni, export Excel e JSON.
- Log e configurazioni:
firebird.logereplication.logper giorno, con filtri; la cronologia delle modifiche dei file.conf. - Job, backup, attività: l’editor di configurazione incorporato e l’inventario dei backup.
- Licenze, aggiornamenti, utenti, cluster, impostazioni.
- Pagina Notifiche (il pulsante è sulla pagina Server): chi invia (l’agent, HQCenter, entrambi o nessuno), i canali, i messaggi di prova, il chat ID di un bot Telegram, le ultime 50 consegne. La pagina non mostra mai un token, un URL o una password memorizzati.
- Lingue: inglese, russo, tedesco, portoghese brasiliano, spagnolo.
- Accesso: un solo login o molti utenti con un elenco di server e un ruolo di amministratore; un log di audit; temi chiaro, scuro e ad alto contrasto; una modalità demo che maschera i nomi e i letterali SQL. Funziona senza Internet.
7. HQbird Cluster: RCM e nodo
HQbird 2024 aveva la replica, ma non un gestore di cluster. HQbird 2027 ne aggiunge uno.
- Parti. Un nodo accanto a ogni istanza Firebird, e un RCM per cluster, con una console web (HTTPS, porta 7444), una riga di comando e un’API.
- La replica è asincrona. Firebird 4.0 e 5.0 usano la replica nativa. HQbird 2.5 e 3.0 usano il plugin di replica.
- Un cluster senza HQCenter.
fbagent --cluster-initcrea l’RCM e il primo amministratore. La pagina Collega gli host unisce gli altri server con un token monouso. Il cluster è spento per impostazione predefinita; lo accendi in installazione o da HQbird Monitor. - Configurazione delle repliche dalla console: iscrivere un database, impostare la pubblicazione, inizializzare. La copia è fatta con nbackup. Reinizializzazione graduale attende le transazioni di scrittura lunghe. Il nodo non sovrascrive mai un database in funzione.
- Presa in carico dei database che già replicano da una configurazione fatta a mano.
- Più repliche di uno stesso master.
- Stati e ritardo per ogni database (allineato, in ritardo, da reinizializzare, e altri), ciascuno con un motivo.
- Verifica: un confronto del numero di righe fra master e replica, su richiesta o in base a una pianificazione.
- Servizi: un database logico su più host.
- Switchover senza perdita di dati, poi il vecchio master rientra come replica.
- Failover manuale quando l’host master è perso, con un rapporto sulla perdita di dati.
- Failover automatico per servizio, spento per impostazione predefinita. Richiede i router.
- Router (HAProxy, Linux) danno ai client un indirizzo stabile.
- Console: 6 lingue, un ruolo di sola lettura, un log di audit, avvisi con un runbook per ogni codice.
- Canali di avviso (Telegram, webhook, e-mail) per i problemi di gravità
warne superiore. La pagina Avvisi ha un pulsante Test per ogni canale. - Sicurezza: TLS reciproco sotto un’autorità di certificazione del cluster, rinnovo automatico dei certificati, rilasci firmati.
Limiti: nessuna replica sincrona attraverso il cluster; sono pubblicate solo le tabelle con una chiave primaria o univoca; al massimo 3 host per cluster secondo la licenza; un RCM per cluster; router solo su Linux. Lo switchover è stato provato in laboratorio su Firebird 5.0 su Linux.
Guide: guida del cluster, runbook del cluster.
8. HQCenter: un server centrale per molti server HQbird
- Che cos’è. Un server Linux nella tua rete. Gli agent vi si iscrivono e vi caricano i propri dati. Ha un HQbird Monitor centrale e un pannello di amministrazione.
- Installazione con un solo comando su Ubuntu 22.04 / 24.04 / 26.04 o AlmaLinux 9 / 10. Una rete chiusa è supportata: installazione da un pacchetto che porti con te.
- Iscrizione: l’agent crea la propria chiave. Un operatore la approva, oppure un token di licenza la approva finché ci sono posti liberi. Tutto il traffico degli agent usa il TLS reciproco.
- Tabella della flotta: versioni dell’agent e di Firebird, ultimo contatto, canale di rilascio.
- Distribuzione della configurazione agli agent, con cronologia e ripristino. Esegui ora i job importanti su qualsiasi server.
- Aggiornamenti per la flotta: l’agent, HQbird Monitor, i programmi del cluster e Firebird arrivano dal catalogo di HQCenter. Le firme del fornitore sono verificate.
- HQCenter si aggiorna da solo da uno stack firmato, con controlli e rollback automatico. Il proprietario può disattivarlo.
- Monitoraggio dello stato: problemi nuovi, aggravati e chiusi di tutti i server, con e-mail e un report settimanale. Canali Telegram, webhook e SMTP, ore di silenzio ed eventi «server silenzioso».
- Licenze: caricamento, assegnazione agli agent, numero di posti.
- Audit delle richieste: chi ha cambiato che cosa su un server.
- API con token ad ambito limitato; metriche Prometheus e una dashboard Grafana per HQCenter stesso.
- Pannello di amministrazione in 4 lingue: inglese, portoghese brasiliano, russo, tedesco.
Guida: site-install.md.
9. fbmcp: strumenti Firebird per gli assistenti IA
- Un server MCP sull’host del database. Un client IA (per esempio Claude Desktop o Claude Code) lo usa per ispezionare e gestire Firebird da 2.5 a 5.0.
- Circa 120 strumenti: query con piano e statistiche, schema, sessioni,
consigli sugli indici, gstat, tendenze; backup, ripristino di prova,
validazione, sweep; DDL e migrazioni; utenti e privilegi; trace;
firebird.conf; un pianificatore; circa 30 strumenti per fbagent (stato, report, job, licenza, aggiornamenti); il cluster (collega, iscrivi, reinizializza, verifica, switchover, failover). - Sicurezza per livelli:
- La lettura non richiede approvazione. Gira in una transazione di sola lettura.
- Una modifica ordinaria è confermata nel client IA con un token monouso.
- Una modifica ad alto impatto è approvata solo fuori dal client IA (una finestra nell’area di notifica su Windows, o un comando sul server). Richiede anche una finestra di manutenzione aperta e un backup verificato di meno di 24 ore.
- L’eliminazione di un database è disattivata.
- Ogni decisione va in un log di audit.
- I setup di HQbird installano fbmcp per impostazione predefinita, solo per l’uso locale. L’uso remoto richiede HTTPS e una chiave API.
10. Programmi di installazione
Windows
- Quattro setup, uno per ogni versione maggiore di Firebird (
fb25,fb30,fb40,fb50). Ciascuno è offline: tutti i file sono al suo interno. - Ogni setup installa Firebird, fbagent, HQbird Monitor e fbmcp. I programmi del cluster sono copiati e restano spenti finché non li accendi.
- Più versioni maggiori di Firebird su un solo server, e più istanze di una stessa versione maggiore.
- Pagine della procedura guidata per la prova, un file di licenza, la connessione a HQCenter e gli aggiornamenti automatici.
- Installazione silenziosa con un’opzione per ogni pagina.
- 8 lingue della procedura guidata: inglese, portoghese brasiliano, tedesco, russo, spagnolo, polacco, turco, cinese semplificato.
- Il setup e il programma di disinstallazione hanno una firma Authenticode.
- La disinstallazione rimuove un’istanza o tutte. I database sono sempre conservati.
Guida: Guida all’installazione di HQbird su Windows.
Linux
- Un file
.runoffline per ogni versione maggiore di Firebird. Vengono scaricati solo i pacchetti del sistema operativo mancanti. - Host: x86_64 con systemd e apt, dnf/yum o zypper (Ubuntu, Debian, AlmaLinux, Rocky, RHEL, Oracle Linux, openSUSE, RED OS). SELinux in modalità enforcing funziona.
- Interfaccia testuale a schermo intero per impostazione predefinita, in
inglese, russo, portoghese brasiliano e tedesco.
--no-tuidà la modalità testo semplice. - Più istanze su un solo host (Firebird 2.5: una sola istanza).
- Installazione non presidiata con
--yese delle opzioni.
Guida: Guida all’installazione di HQbird su Linux.
Docker
- Immagini pubbliche
ghcr.io/ibsurgeon/hqbird2027-fb25,-fb30,-fb40,-fb50. Un container contiene un’istanza con tutti i componenti. - Le immagini sono firmate con cosign.
- Ruolo del cluster
HQBIRD_CLUSTER_ROLE=master|replicacon file compose. - Le cartelle dell’immagine sono chiuse agli altri utenti, e un nuovo container mantiene l’account RCM.
Guida: Guida Docker.
11. Licenze e prova
- File di licenza firmati. L’agent verifica la firma del fornitore. La licenza non ferma mai un database.
- Prova: 7 giorni senza un passaggio in rete. Un’e-mail di lavoro e un codice di 6 cifre la estendono a 30 giorni.
- Zone di licenza EU, RU e BR, ciascuna con le proprie chiavi.
- Offline: un file di licenza in installazione; il setup Windows può creare un file di richiesta della licenza.
- Con HQCenter: le licenze sono caricate una volta e assegnate agli agent.
- Una nuova licenza arriva da sola. Un agent che ha ottenuto la licenza con una richiesta di prova interroga il server delle licenze del fornitore una volta all’ora. Installa la licenza che il server ha per lui: una prova più lunga, una licenza a pagamento creata dalla prova, o il periodo successivo di un abbonamento. Non c’è nulla da fare sul server. I server delle licenze del fornitore iniziano a fornire queste licenze in modo graduale.
- Una richiesta di prova può essere inviata anche dopo i 30 giorni della prova: l’indirizzo e-mail può appartenere a un cliente che ha una licenza.
12. Aggiornamenti automatici
- L’agent si aggiorna da solo. Verifica la firma del fornitore, rifiuta una versione più vecchia e può fare rollback.
- L’agent aggiorna HQbird Monitor, fbmcp, i programmi del cluster e Firebird. Un aggiornamento di Firebird ha un backup, una finestra di applicazione, un controllo di stato e un ripristino.
- Con HQCenter: gli aggiornamenti arrivano dal catalogo di HQCenter secondo il canale di rilascio.
- Senza HQCenter: gli aggiornamenti arrivano dalla zona del fornitore.
Modalità:
all,agent(Firebird attende l’amministratore),off. La pagina Aggiornamenti di HQbird Monitor mostra lo stato.
13. Avvisi e notifiche
- Il monitoraggio dello stato di HQCenter invia e-mail sui problemi della flotta. La console del cluster mostra gli avvisi.
- L’agent invia i propri messaggi sui problemi del server: quando un problema è nuovo, quando peggiora e quando è sparito. Tutte le modifiche di uno stesso controllo di stato vanno in un solo messaggio.
- I canali sono un bot Telegram tuo, webhook (Slack, Teams, Discord, Mattermost, Rocket.Chat, ntfy) ed e-mail (SMTP), con un filtro di gravità e ore di silenzio. Puoi avere più canali. Non viene inviato nulla finché non aggiungi un canale.
- Riepilogo giornaliero: un messaggio al giorno con i problemi aperti
(
notify.daily_summary, spento per impostazione predefinita). - Con più agent su una stessa macchina, solo uno di essi invia i problemi della macchina stessa (disco, memoria).
- Due comandi dell’agent:
--notify-history [N]stampa le ultime consegne,--notify-test <channel>invia un messaggio di prova. - L’agent non invia nulla finché la sua licenza non lo consente.
- Bot Telegram di HQbird: un server o un HQCenter con una licenza valida collega una chat con un codice monouso. Non serve un bot proprio. I server del fornitore non offrono ancora questo servizio; finché non lo fanno, usa un tuo bot Telegram, un webhook o l’e-mail.
- RCM invia gli avvisi del cluster agli stessi tipi di canali
(
notify.channelsinrcm.json).
14. Sicurezza
- TLS reciproco per gli agent, HQCenter e il cluster.
- Rilasci firmati: l’agent rifiuta un aggiornamento senza una firma valida del fornitore.
- Authenticode sui setup e sui programmi Windows; cosign sulle immagini Docker.
- Cifratura AES-256 degli archivi di backup.
- I segreti restano fuori dalle righe di comando e dalle istantanee di configurazione.
- Un log di audit delle richieste sull’agent; log di audit in HQbird Monitor, HQCenter, RCM e fbmcp.
- I comandi remoti si possono spegnere su un server
(
--remote-commands off).
15. Aggiornamento da HQbird 2024
- Il setup 2027 trova HQbird 2024, aggiorna Firebird sul posto e mantiene la vecchia cartella come copia.
- I job di FBDataGuard sono importati una volta, al primo avvio: gbak, nbackup (livelli da 0 a 4), backup di gruppo, sweep e statistiche degli indici. L’agent prosegue i set di backup esistenti.
- Non importati: replica, trace, trasferimento di file, backup cloud, ripristino, validazione. Impostali di nuovo nell’editor.
- La licenza 2024 non viene trasferita. Il nuovo agent parte in modalità di prova. Installa una licenza 2027.
- Rimossi: la console di FBDataGuard sulla porta 8082, AMV, il backup VSS, il server FTP, il caricamento SFTP.
- Script per il setup 2024: le opzioni che hanno un equivalente 2027 sono accettate. Le altre opzioni sono rifiutate con un messaggio che indica il sostituto.
- L’import registra i database di FBDataGuard nel file degli alias di
Firebird (
databases.conf, oppurealiases.confsu Firebird 2.5). Il vecchio file viene prima copiato. Un database viene escluso quando il suo percorso è già nel file o il suo file non esiste. Un file con una direttivaincludenon viene modificato. - L’import rimuove i vecchi log di monitoraggio di FBDataGuard (le
cartelle
mon\outcomingemon\outtrace). Non viene rimosso nulla mentre è in esecuzione un servizio del vecchio HQbird. La rimozione non può essere annullata. - Entrambi sono attivi per impostazione predefinita. Per disattivarli,
imposta
hqbird_import.register_databasesohqbird_import.clean_mon_logssufalse, oppure usa--no-register-databasese--no-clean-mon-logscon--import-hqbird-config.