Questa pagina è stata tradotta automaticamente. Leggi l'originale in inglese. English

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.

ComponenteCosa faWindowsLinux
Firebird, build HQbirdUn 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 fbagentBackup, monitoraggio, manutenzione, aggiornamenti.HQbirdFBAgent-fb50hqbirdfbagent-fb50, utente firebird
HQbird MonitorConsole 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-fb50hqbirdmonitor-fb50
Componenti del clusterI 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 fbmcpAccesso 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 FirebirdSimboli 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.

Sul server

        


          


          

  1. 1Controllo del serverdiritti, bitness; su Linux anche systemd e il kernel
  2. 2Controllo del kitsha256 prima dell'estrazione; firme dei file prima dell'installazione
  3. 3Pianocosa è stato trovato e cosa verrà fatto
  4. 4Domandenome del server per HQCenter; fermare Firebird? un'altra versione?
  5. 5InstallazioneFirebird, agente, console, servizi
  6. 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.

CodiceSignificato (.run Linux)
0Completato
1Rifiutato: server, parametro o piano. Nulla è cambiato
2Installazione fallita, modifiche annullate
3Rollback incompleto: il risultato indica cosa controllare
4Risposta necessaria: nessun terminale e nessun --yes
5Il kit non ha superato il controllo: scaricalo di nuovo
6Nessuna libreria del sistema operativo e nessun repository
7Firebird dai pacchetti della distribuzione
CodiceSignificato (setup.exe Windows)
0Installato
1Rifiutato prima dell'installazione: parametro o file errato, è installata una versione più recente, nessun diritto di amministratore
4L'installer aveva una domanda, ma manca il parametro /YES
7Controllo del server o installazione falliti. Il motivo è nel log e nel file di risultato
10Installato, ma la connessione a HQCenter non è riuscita
Piano nella procedura guidata. "Found on this computer" e "Setup will do the following". In basso: nulla cambia finché non fai clic su Install.
Risultato. Cosa è installato, l'indirizzo della console da questo computer e da un altro, dove si trova la password di login. Tratto da una build iniziale: lì, i nomi del servizio dell'agente e delle cartelle usano la porta (-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.

Passaggio da HQbird 2024: i job di FBDataGuard passano all'agente di HQbird 2027, Firebird viene aggiornato sul posto, i vecchi servizi di HQbird vengono disabilitati
  • Cosa non cambiadatabases.conf o aliases.conf, il database di sicurezza, la password SYSDBA, i database, i backup e i vecchi file di HQbird. In firebird.conf viene aggiunta solo la riga MonitoringPlugin = 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.

Aggiungi
  • 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 -2 nei 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-port imposta lo slot esplicitamente.
Due istanze di una stessa linea. Il piano vede entrambi i server Firebird ed entrambi gli agenti e modifica solo l'istanza selezionata.

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.

ImmagineFirebirdPorta FirebirdHQbird Monitor
ghcr.io/ibsurgeon/hqbird2027-fb505.0305023050
ghcr.io/ibsurgeon/hqbird2027-fb404.0305023050
ghcr.io/ibsurgeon/hqbird2027-fb303.0305023050
ghcr.io/ibsurgeon/hqbird2027-fb252.5305023050
  • Primo avvioCopia compose.yaml dal kit, inserisci la password SYSDBA in un file secret, rimuovi il # dalle righe secrets: ed esegui docker compose up -d. Il server è pronto quando docker compose ps mostra healthy.
  • 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, non 3051: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, aggiornamenti

Agente · 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. all installa anche Firebird, nella finestra di aggiornamento. off non 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

Auto-aggiornamento dell'agente: controlli, punto di rollback, sostituzione, pronto entro 180 s, 45 s di esecuzione; in caso di errore: rollback, pausa di 30 min, versione bloccata dopo il 2° errore
  • 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.

  1. 1Preparazionedownload, firma, build non precedente al motore
  2. 2Finestrafinestra giornaliera; anche una release obbligatoria attende la finestra
  3. 3Jobgbak, nbackup o uno script SQL in esecuzione: il tentativo viene posticipato
  4. 4Sostituzionei vecchi file del motore vengono messi da parte, le configurazioni restano
  5. 5ControlloFirebird si avvia e risponde sulla sua porta
  6. 6✓ o rollbacki vecchi file tornano, la build viene bloccata
Cosa viene aggiornatoProtezioneIn caso di errore
agente fbagentFirma, solo versioni più recenti, pronto entro 180 s e 45 s di esecuzioneRollback, pausa di 30 minuti; un secondo errore blocca la versione
HQbird Monitor, cluster, fbmcpFirma, solo versioni più recenti di quella installataResta la versione precedente; vengono conservate le 2 copie più recenti
FirebirdFinestra, attesa dei backup, controllo dopo l'avvioIl 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--uninstall rimuove 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-data rimuove 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.
Linux, disinstallazione di una singola istanza (Firebird e database restano):
sudo sh hqbird2027-fb50-linux-<version>.run --uninstall --agent-dir /opt/hqbird/fbagent-fb50-2

← Torna alla panoramica di HQbird 2027 · Stato del server →