Installazione e aggiornamenti
Installazione senza sorprese
Un installer per ogni linea di Firebird. Trova Firebird, il vecchio HQbird e gli agenti sul server, mostra un piano e non cambia nulla finché non dici "Sì". Dopodiché, l'agente si aggiorna da solo, insieme alla console e a Firebird, con controlli e rollback.
- 4 installer: Firebird 2.5 · 3.0 · 4.0 · 5.0
- 0 modifiche prima della conferma del piano
- nessuna connessione internet necessaria tutto in un unico file
- Windows e Linux procedura guidata, modalità silenziosa, .run
- rollback se un'installazione o un aggiornamento fallisce
setup.exe · .run
Cosa contiene il kit
L'installer è un unico file: hqbird2027-fb50-setup-<version>.exe per Windows o hqbird2027-fb50-linux-<version>.run per Linux. Contiene tutto ciò che serve al server. Non viene scaricato nulla.
Ogni installer installa una linea di Firebird. Scegli la linea su cui girano i tuoi database. L'installazione è eseguita dall'agente incluso nel kit: controlla il server, costruisce un piano e lo esegue.
| Componente | Cosa fa | Windows | Linux |
|---|---|---|---|
| Firebird, build HQbird | Un nuovo server o un aggiornamento in-place. Per un server già installato, viene aggiunta una riga a firebird.conf: MonitoringPlugin = fblwmon. Per un nuovo server, l'installer imposta anche la porta. databases.conf, il database di sicurezza e la password di SYSDBA non cambiano. | servizio FirebirdServer… | /opt/firebird |
| agente fbagent | Backup, monitoraggio, manutenzione, aggiornamenti. | HQbirdFBAgent-fb50 | hqbirdfbagent-fb50, utente firebird |
| HQbird Monitor | Console web per questo server. Porta = 20000 + porta di Firebird: per 3050 è 23050. La porta viene scelta durante l'installazione e non cambia in seguito, anche se modifichi la porta di Firebird. | HQbirdMonitor-fb50 | hqbirdmonitor-fb50 |
| Componenti del cluster | I programmi del cluster vengono collocati sul server ma non sono attivati: RCM e la finestra di pairing sono disattivati per impostazione predefinita. RCM rende il server il centro di un nuovo cluster e apre le porte 7443 e 7444. La finestra di pairing apre le porte 7450–7459 per 24 ore: tramite essa, l'RCM di un altro server può invitare questo server. Puoi attivare entrambi anche dopo l'installazione. | pagina della procedura guidata "Replication and cluster setup"; /RCM, /DISCOVERY | --rcm on, --cluster-pairing on |
| server MCP fbmcp | Accesso per i client AI a Firebird. Per impostazione predefinita, solo da questo server. | casella di controllo nella procedura guidata o /NOFBMCP | --no-fbmcp |
| File di debug di Firebird | Simboli per analizzare i crash di Firebird. | — | sì, --no-debug li disattiva |
- WindowsSupportati: Windows 10 e 11, Windows Server 2016 e successivi, 64 bit. Diritti di amministratore. L'installer è firmato da IBSurgeon Software: Windows mostra l'editore nella richiesta dei diritti.
- Procedura guidata o modalità silenziosaOgni pagina della procedura guidata è disponibile anche come parametro:
/VERYSILENT /YES /LOG=…. Utile per script e per cento server. - Procedura guidata in 8 lingueInglese, portoghese (Brasile), tedesco, russo, spagnolo, polacco, turco, cinese semplificato. Il valore predefinito è la lingua di Windows. Parametro:
/LANG=en|pt_BR|de|ru|es|pl|tr|zh_CN. - Nome del serverLa procedura guidata chiede il nome del nuovo agente; HQCenter mostra il server con questo nome. Il valore predefinito è il nome del computer. Modalità silenziosa:
/AGENTID=, su Linux--agent-id. Un agente già installato mantiene il suo nome.
- Linuxx86_64, kernel 3.2 o successivo, systemd, root. Ubuntu, Debian, AlmaLinux, Rocky, RHEL, Oracle Linux, openSUSE, RED OS e altri con apt, dnf, yum o zypper.
- Server senza internetL'installer preleva alcune librerie del sistema operativo (libtommath, ICU) dal repository. Se non c'è un repository, stampa i comandi esatti e non cambia nulla.
Il kit viene verificato due volte. Prima dell'estrazione: lo sha256 dell'intero kit. Prima dell'installazione di Firebird e dell'agente: la firma di ogni file. Un download danneggiato interrompe l'installazione prima di qualsiasi modifica a Firebird, all'agente o alla console.
fbagent --install-plan
Prima il piano, poi le modifiche
All'inizio, l'installer si limita a leggere: servizi, registro, cartelle di Firebird e HQbird. Poi mostra cosa ha trovato e cosa farà. Le modifiche iniziano dopo che dici "Sì".
Seleziona cosa c'è sul server e guarda il piano. I testi sono abbreviati e tradotti; l'ordine e le decisioni sono gli stessi dell'installer di Firebird 5.0.
- 1Controllo del serverdiritti, bitness; su Linux anche systemd e il kernel
- 2Controllo del kitsha256 prima dell'estrazione; firme dei file prima dell'installazione
- 3Pianocosa è stato trovato e cosa verrà fatto
- 4Domandenome del server per HQCenter; fermare Firebird? un'altra versione?
- 5InstallazioneFirebird, agente, console, servizi
- 6✓ Risultatoservizi, indirizzo della console, login
Se qualcosa va storto
Un rifiuto in fase di piano (porta in uso, cartella non vuota) non cambia nulla: l'installer indica il motivo. Nella procedura guidata, non puoi lasciare una pagina con un valore errato.
Un errore durante l'installazione, prima dell'avvio del servizio dell'agente: i servizi tornano allo stato precedente. Il vecchio HQbird, se era stato fermato, si riavvia.
| Codice | Significato (.run Linux) |
|---|---|
| 0 | Completato |
| 1 | Rifiutato: server, parametro o piano. Nulla è cambiato |
| 2 | Installazione fallita, modifiche annullate |
| 3 | Rollback incompleto: il risultato indica cosa controllare |
| 4 | Risposta necessaria: nessun terminale e nessun --yes |
| 5 | Il kit non ha superato il controllo: scaricalo di nuovo |
| 6 | Nessuna libreria del sistema operativo e nessun repository |
| 7 | Firebird dai pacchetti della distribuzione |
| Codice | Significato (setup.exe Windows) |
|---|---|
| 0 | Installato |
| 1 | Rifiutato prima dell'installazione: parametro o file errato, è installata una versione più recente, nessun diritto di amministratore |
| 4 | L'installer aveva una domanda, ma manca il parametro /YES |
| 7 | Controllo del server o installazione falliti. Il motivo è nel log e nel file di risultato |
| 10 | Installato, ma la connessione a HQCenter non è riuscita |
-p3050); le nuove installazioni ricevono -fb50.FBDataGuard → fbagent
Passaggio da HQbird 2024
Il programma di installazione trova il vecchio HQbird e il Firebird che serve. Questo Firebird viene aggiornato sul posto, i job di FBDataGuard passano all'agente, i vecchi servizi vengono arrestati. Database, configurazioni e password restano.
- Cosa non cambia
databases.confoaliases.conf, il database di sicurezza, la password SYSDBA, i database, i backup e i vecchi file di HQbird. Infirebird.confviene aggiunta solo la rigaMonitoringPlugin = fblwmon, se manca. - Copia del vecchio FirebirdLa cartella del programma del vecchio Firebird viene conservata accanto ad esso come
<folder>.old_<time>. - JobBackup gbak e nbackup, sweep, statistiche degli indici. L'importazione viene eseguita una volta e passa attraverso il controllo della nuova configurazione; la vecchia configurazione viene conservata.
- Vecchi backupL'agente prende i backup dai registri di FBDataGuard e li inserisce nei propri record. Le regole di conservazione e il ripristino li vedono allo stesso modo dei nuovi. I nomi dei livelli nbackup restano gli stessi.
- Nomi dei jobIl nome del job termina con il nome del database da FBDataGuard, ad esempio "Verified backup - MANUAL". I job di gruppo ripetono l'albero delle cartelle di origine.
- Vecchi servizi: tre opzioniAutomatico (consigliato): disabilitarli quando ogni Firebird servito da FBDataGuard ha un agente. Disabilita tutto:
/DISABLEHQBIRD. Lascia com'è:/NOHQBIRD. - Si può tornare indietroLo stato di ogni servizio prima della disabilitazione viene salvato in
fbagent-hqbird-takeover.json. Con questo file, il vecchio HQbird può essere riattivato. - LicenzaLa vecchia licenza di HQbird non viene trasferita. Un periodo di prova è attivo finché non si ottiene una nuova licenza o ci si connette a HQCenter.
- Percorso non chiaroSe l'importazione non riesce a espandere una sostituzione in un percorso di FBDataGuard, la mantiene così com'è e lascia il job disabilitato. Correggere il percorso e abilitare il job.
Se i job vengono importati ma i vecchi servizi sono ancora in esecuzione (ad esempio, il server ha due server Firebird sotto FBDataGuard), i job arrivano disabilitati. In questo modo, un job non viene eseguito due volte.
Porte · cartelle · servizi
Più server Firebird su una sola macchina
Un agente per ogni Firebird. Una nuova istanza viene installata accanto alle altre, sulla propria porta, con il proprio agente e la propria console. Le istanze installate non cambiano.
Aggiungi server Firebird e vedi quali nomi e porte sceglie il programma di installazione.
- Porte per lineaIl primo Firebird sul server ottiene la 3050. Il successivo: 3052 per 2.5, 3053 per 3.0, 3054 per 4.0, 3055 per 5.0. Il programma di installazione non prende una porta già in uso.
- Seconda istanza della stessa lineaNumero
-2nei nomi delle cartelle e dei servizi. Su Windows, questa è l'opzione della procedura guidata "Installa un'altra istanza"; la porta è la prima libera nell'intervallo della linea.
- Aggiornamenti solo all'interno di una linea5.0.x → 5.0.y. Passare da 3.0 a 5.0 significa una seconda istanza accanto alla prima; una persona sposta i database con backup e ripristino.
- XNET su WindowsUn Firebird che non è sulla porta 3050 ottiene il proprio nome
IpcName = FIREBIRD_<port>. Le connessioni XNET locali al secondo server funzionano. - Una console per agenteHQbird Monitor su 20000 + porta Firebird: 23050, 23055. Un file di login per tutte le istanze sul server.
- Le porte sono fisseLe porte della console e dell'API locale dell'agente vengono scritte al momento dell'installazione. Se si cambia la porta di Firebird in seguito, restano le stesse. L'agente non accetta porte uguali.
- Cluster: uno slot per ogni agenteOgni agente sul server ottiene il proprio slot da 0 a 9: porta di pairing 7450 + slot, porte dei nodi 7051 + slot e 7061 + slot. Così due agenti di uno stesso server possono unirsi a un cluster. L'opzione
--pairing-portimposta lo slot esplicitamente.
Immagini · compose · porte
HQbird in Docker
C'è un'immagine pronta per ogni linea di Firebird. Firebird, l'agente e HQbird Monitor vengono eseguiti nel container. L'agente installa il nodo del cluster all'interno del container stesso quando il server si unisce a un cluster. Installa RCM solo quando questo server è assegnato come RCM del cluster.
| Immagine | Firebird | Porta Firebird | HQbird Monitor |
|---|---|---|---|
ghcr.io/ibsurgeon/hqbird2027-fb50 | 5.0 | 3050 | 23050 |
ghcr.io/ibsurgeon/hqbird2027-fb40 | 4.0 | 3050 | 23050 |
ghcr.io/ibsurgeon/hqbird2027-fb30 | 3.0 | 3050 | 23050 |
ghcr.io/ibsurgeon/hqbird2027-fb25 | 2.5 | 3050 | 23050 |
- Primo avvioCopia
compose.yamldal kit, inserisci la password SYSDBA in un file secret, rimuovi il#dalle righesecrets:ed eseguidocker compose up -d. Il server è pronto quandodocker compose psmostrahealthy. - Porta FirebirdLa variabile
HQBIRD_FB_PORT, 3050 per impostazione predefinita. HQbird Monitor è in ascolto su 20000 + questa porta. - Firma dell'immagineLe immagini sono firmate con lo strumento cosign. La chiave pubblica per la verifica non è ancora pubblicata.
- Più istanze su un solo hostFirebird su 3050 + N, HQbird Monitor su 20000 + porta Firebird, nodo del cluster su 7051 + N. Solo un'istanza sull'host può avere RCM.
- Lo stesso numero di porta fuori e dentroPubblica
3051:3051, non3051:3050. L'agente e il cluster riportano la porta che vedono all'interno del container. - ClusterL'indirizzo del membro è l'indirizzo dell'host Docker. Pubblica la porta del nodo e, per RCM, le porte 7443 e 7444.
Docker pubblica le porte oltre ufw. Una regola ufw "solo porta 22" non chiude le porte del container. Pubblica la porta su un indirizzo dell'host o chiudila con un firewall esterno.
Cloud e Docker: impostazioni, volumi, porte, aggiornamentiAgente · console · cluster · Firebird
Aggiornamenti dopo l'installazione
Dopo essersi connesso a HQCenter, l'agente aggiorna da solo se stesso, HQbird Monitor, i componenti del cluster, fbmcp e Firebird. Anche un server senza HQCenter si aggiorna da solo: l'agente prende le nuove versioni dal server di aggiornamento IBSurgeon.
L'agente vede una nuova versione di se stesso in HQCenter entro un minuto. Nuove versioni di HQbird Monitor, fbmcp e Firebird: entro un'ora. Ogni aggiornamento segue uno schema: verifica, salva un punto di rollback, sostituisci, assicurati che funzioni. Se non funziona, ripristina il vecchio.
Aggiornamenti senza HQCenter
- Cosa si aggiorna da soloL'agente, HQbird Monitor e il server MCP. La verifica viene eseguita ogni 6 ore.
- Firebird attende un comandoIl pacchetto Firebird viene scaricato e attende. L'amministratore lo applica: con il pulsante nella pagina Aggiornamenti o con il comando
fbagent --firebird-update --apply. - Scegli la modalitàL'opzione di installazione
--auto-update all|agent|off, su Windows/AUTOUPDATE=all|agent|off.agentè l'impostazione predefinita.allinstalla anche Firebird, nella finestra di aggiornamento.offnon verifica nulla.
- Pagina Aggiornamenti in HQbird MonitorMostra da dove l'agente prende le versioni, la modalità e l'ultima risposta del server, lo stato degli aggiornamenti di Firebird, console e server MCP. L'amministratore cambia la modalità e applica il pacchetto Firebird.
- Verifica dell'origineIl server di aggiornamento viene verificato rispetto a una chiave fissata. La firma del fornitore è sempre richiesta.
- Il cluster passa dal centroUn nodo del cluster e RCM non si aggiornano in questo modo: li aggiorna HQCenter o RCM.
Auto-aggiornamento dell'agente
- Solo in avantiL'agente non installa una versione precedente alla propria, nemmeno se obbligatoria. Il controllo avviene prima che venga scaricato il primo byte. In questo modo, un server falso non può ripristinare una vecchia build vulnerabile. L'eccezione è una vecchia versione consentita nella configurazione dell'agente stesso (
allow_downgrade_to). - FirmaLe release sono firmate con una chiave Ed25519; la chiave pubblica è integrata nell'agente. Una firma errata viene sempre rifiutata. La modalità "solo firmate" si attiva nella configurazione dell'agente stesso, non dal server.
- Rollback manualeAccanto all'agente c'è uno script
rollback_to_version_NNN: ripristina l'agente e la configurazione precedenti e blocca la versione non funzionante. Vengono conservati gli ultimi due punti di rollback; quelli più vecchi vengono eliminati automaticamente. - Linux: root esegue solo la propria copiaL'agente viene eseguito come
firebird. La sostituzione viene effettuata da una copia verificata in una cartella scrivibile solo da root.
Aggiornamento di Firebird
Firebird viene aggiornato solo all'interno della sua linea e solo a una build più recente. L'agente può scaricare e preparare il pacchetto in qualsiasi momento, ma arresta Firebird solo nella finestra di aggiornamento.
- 1Preparazionedownload, firma, build non precedente al motore
- 2Finestrafinestra giornaliera; anche una release obbligatoria attende la finestra
- 3Jobgbak, nbackup o uno script SQL in esecuzione: il tentativo viene posticipato
- 4Sostituzionei vecchi file del motore vengono messi da parte, le configurazioni restano
- 5ControlloFirebird si avvia e risponde sulla sua porta
- 6✓ o rollbacki vecchi file tornano, la build viene bloccata
| Cosa viene aggiornato | Protezione | In caso di errore |
|---|---|---|
| agente fbagent | Firma, solo versioni più recenti, pronto entro 180 s e 45 s di esecuzione | Rollback, pausa di 30 minuti; un secondo errore blocca la versione |
| HQbird Monitor, cluster, fbmcp | Firma, solo versioni più recenti di quella installata | Resta la versione precedente; vengono conservate le 2 copie più recenti |
| Firebird | Finestra, attesa dei backup, controllo dopo l'avvio | Il vecchio motore torna, la build va nella lista dei blocchi |
Una versione bloccata non viene installata di nuovo, ma la versione successiva si installa come al solito. In questo modo, il server non entra in un ciclo "aggiorna → rollback → aggiorna".
Cartelle · log · disinstallazione
Dove sono i file e come disinstallare
Windows
C:\HQbird\ Firebird50\ Firebird 5.0, configurazioni, DB di sicurezza fbagent-fb50\ agente e HQbird Monitor agent_config.json configurazione dell'agente logs\ bak\ update\ log, copie, cache di aggiornamento C:\HQbirdData\ dati di lavoro dell'agente e della console config\access.properties login della console C:\ProgramData\fbagent\ esito e log dell'installazione
Linux
/opt/firebird/ Firebird 5.0 (seconda linea: /opt/fb50) /opt/hqbird/ conf/access.properties login della console, 0600 fbagent-fb50/ agente e HQ Monitor agent_config.json configurazione dell'agente logs/ bak/ update/ log, copie, cache di aggiornamento /var/lib/hqmonitor/ dati della console /var/log/fbagent/install.log log dell'installazione, senza password
- La disinstallazione non tocca i tuoi databaseI tuoi database e backup (
*.fdb,*.gdb,*.fbk,*.nbk) restano sempre. La rimozione dei dati elimina solo il DB di sicurezza e gli esempi dal pacchetto Firebird. - Windows"App": rimuove l'agente, la console, l'RCM di questo agente, le regole del firewall e il Firebird che questo installer ha installato come nuovo. Se altri agenti usano l'RCM di questo agente, la procedura guidata chiede "Rimuovere comunque questa istanza?"; una disinstallazione silenziosa richiede
/FORCE. Un Firebird aggiornato resta. Le configurazioni e il DB di sicurezza vengono rimossi solo se selezioni "rimuovi dati".
- Linux
--uninstallrimuove i servizi dell'agente e della console, l'RCM di questo agente, le regole sudoers e le porte aperte dall'installer in firewalld o ufw. L'agente esce prima dal cluster. Se altri agenti usano il suo RCM, è necessario l'opzione--force. Firebird resta.--remove-datarimuove anche la configurazione, i log e i dati della console. - Vecchio HQbirdLa disinstallazione di HQbird 2027 non riattiva i vecchi servizi: l'amministratore decide in base al file di stato.
sudo sh hqbird2027-fb50-linux-<version>.run --uninstall --agent-dir /opt/hqbird/fbagent-fb50-2