HQbird Cluster: clustering e replica
Cluster e replica HQbird Cluster
Il master scrive le modifiche nei segmenti e li invia alle repliche tramite un canale sicuro. Il nodo crea da solo la copia del database per una nuova replica, tramite nbackup, mentre gli utenti continuano a lavorare. Il gestore del cluster (RCM) mostra il ritardo, le code e gli errori di tutti i nodi. Sposta inoltre il master su un altro host: come spostamento pianificato, senza perdita di dati, o come spostamento di emergenza, quando l'host master viene perso.
- Firebird 2.5 · 3 · 4 · 5
- nbackup copia senza fermare il master
- switchover senza perdita di dati
- failover manuale o tramite regola
- router la stringa di connessione non cambia
- mTLS su tutti i canali
Nodi · RCM · layout
Come funziona il cluster
Un nodo viene eseguito accanto a ogni Firebird. Un nodo ha un solo ruolo: master o replica. Il nodo master invia i segmenti, il nodo replica li riceve e il Firebird della replica li applica alla propria copia del database.
C'è un solo RCM per cluster. Viene eseguito su qualsiasi host che possa raggiungere tutti i nodi. I nodi gli inviano statistiche ed esso trasmette loro i comandi dell'operatore. RCM collega un master e una replica tramite il GUID del database, non tramite il nome del nodo.
RCM non viene installato da solo. Lo si attiva su un host quando serve un cluster. Si può mettere un router davanti alle applicazioni: le indirizza sempre al master corrente.
| Componente | Quanti | Cosa fa |
|---|---|---|
| Firebird (HQbird) | su ogni server di database | Memorizza i database e scrive i segmenti di replica. |
| fbagent | uno per istanza Firebird | Arresta e avvia Firebird quando il nodo lo richiede. |
| hqclusternode | uno per istanza e ruolo | Configura la replica, invia i segmenti, crea la copia del database per una replica. |
| hqbirdrcm (RCM) | uno per cluster | Interfaccia web, comandi, avvisi, statistiche. Esegue switchover e failover. |
| Router (hqclusternode router) | opzionale, sull'host dell'applicazione, Linux | Mantiene HAProxy puntato al master di ciascun servizio. Le applicazioni si connettono al router. |
- Stessa versione principale5.0 sul master, 5.0 sulla replica. Altrimenti la replica rifiuta prima di qualsiasi trasferimento di dati.
- HQbird 2.5 e 3.0Replica tramite il plugin replconf. I filtri definiscono l'insieme delle tabelle.
- Cartella propria per ogni masterLa replica colloca il database in una cartella con il nome del nodo master. Database con lo stesso nome provenienti da master diversi non entrano in conflitto.
- Senza fbagent, nessuna modificaSe fbagent non è disponibile, il nodo rifiuta qualsiasi azione che modifichi la configurazione. Non funziona “in parte”.
- Nodo senza RCMUn nodo può funzionare da solo. RCM è necessario per la panoramica e i comandi.
- Compressione del canalePer reti lente: zstd per peer, ha effetto immediato.
- Fino a 3 host senza HQCenterOgni host con un master o una replica occupa un posto nel cluster. RCM non accetta un quarto host.
RCM · finestra di pairing · Link hosts · slot
Come creare un cluster
Il setup di HQbird installa i programmi del cluster su ogni server, ma non li attiva. RCM e la finestra di pairing sono disattivati per impostazione predefinita. Si crea un cluster in tre passaggi: attivare RCM su un host, aprire la finestra di pairing sugli altri host, collegare gli host con un solo pulsante.
- 1Attivare RCMsu un host: in HQ Monitor o con
fbagent --cluster-init - 2Aprire la finestra di pairingsugli altri host, per 24 ore
- 3Collegare gli hostRCM trova gli agent, emette i certificati e avvia i nodi
Passaggio 1. RCM su un host
In HQ Monitor, aprire la sezione “Cluster on this server” e attivare RCM. Un comando sull'host fa lo stesso. L'agent crea la CA del cluster, il certificato RCM e il primo utente. Le porte 7443 e 7444 si aprono nel firewall.
fbagent --cluster-init <id>
Durante il setup, l'opzione --rcm on (Linux) o /RCM (Windows) fa lo stesso.
Passaggio 2. Finestra di pairing
Su ogni host che entrerà nel cluster, l'agent apre la porta di pairing per 24 ore. La porta si chiude da sola quando la finestra termina o quando l'agent è entrato nel cluster.
fbagent --cluster-pairing on
Un pulsante in HQ Monitor fa lo stesso. Durante il setup: --cluster-pairing on o /DISCOVERY.
Passaggio 3. Collegare gli host
In RCM, aprire Settings → Link hosts e inserire gli host, uno per riga. Il pulsante Check hosts legge le porte 7450–7459 di ciascun host. Ogni agent che ha risposto è una riga della tabella.
- Una riga mostra: porta, istanza, versione e porta di Firebird, porta del nodo, impronta del certificato.
- Selezionare le righe con le caselle di controllo e scegliere il master. Una riga con errore non blocca le altre righe.
- Link emette un certificato a ciascun agent, crea i membri e i collegamenti master → replica.
- RCM attende fino a 10 minuti il certificato dell'agent e fino a 20 minuti l'avvio dei nodi.
hqbirdrcm cluster link -hosts db1,db2,db3 -master db1
Confrontare l'impronta nella riga con quella mostrata dall'agent sul suo host. In questo modo si sa di collegare il server corretto.
- Più agent su un hostOgni agent ha il proprio slot da 0 a 9. Porta di pairing 7450 + slot, porte del nodo 7051 + slot e 7061 + slot. Il setup sceglie lo slot; l'opzione
--pairing-portlo imposta esplicitamente. - Add memberLa pagina Cluster suggerisce una porta del nodo libera e rifiuta una porta usata da un altro membro di questo host.
- Nomi dei membri
<host name>-mastere<host name>-replica. RCM non rinomina un membro: un nuovo nome è un nuovo membro. - Senza la finestra di pairingRCM emette un token per un agent, per 24 ore. Sul nuovo host:
fbagent --cluster-joincon questo token e l'hash della CA.
- Proprietario RCML'agent che ha attivato RCM sull'host. Un secondo agent su questo host riceve un rifiuto. Se il proprietario viene rimosso,
fbagent --cluster-init --rcm-takeoversposta RCM su un altro agent. Il cluster ottiene una nuova CA e i membri devono essere collegati di nuovo. - Uscita dal cluster
fbagent --cluster-leavearresta i nodi, chiude le loro porte ed elimina i certificati del cluster. Le cartelle dei nodi restano;--remove-datale elimina. L'agent esce da solo se RCM lo ha revocato o ha rimosso il suo ultimo membro. - FirewallL'agent apre e chiude da solo le proprie porte del cluster. Non chiude una porta che era già aperta prima.
- Rimozione di HQbirdIl proprietario RCM non viene rimosso finché altri agent usano il suo RCM. La procedura guidata di setup lo chiede; la modalità silenziosa richiede
--forceo/FORCE.
La pagina Clusters nell'HQ Monitor locale funziona tramite l'agent sull'host RCM. Non richiede la password RCM. Solo un amministratore vede la sezione “Cluster on this server”.
Inizializzazione · reinit
Nuova replica senza fermare il master
Una replica ottiene il database solo dal master. Il nodo master blocca il file con nbackup -L, lo invia a parti e rimuove subito il lock. Gli utenti del master continuano a lavorare per tutto il tempo: le loro modifiche vanno in .delta e successivamente tornano nel database.
gbak e una copia manuale del file non funzionano qui. gbak cambia il GUID del database e interrompe il collegamento master–replica. Una copia del file di un database in esecuzione non è coerente.
Utenti del master
File
- Perdita di connessioneIl trasferimento riprende dall'ultima parte ricevuta. Una copia incompleta resta sulla replica per 24 ore.
- ErroreIl nodo rimuove il lock, elimina il file incompleto e imposta il database su FAILED. Il tentativo successivo parte da uno stato noto.
- Transazioni durante il lockNon vengono perse. Firebird 4 e 5: il nodo individua le transazioni aperte al momento di
nbackup -Le la replica le ripete dai segmenti. HQbird 2.5 e 3.0: il nodo attende la fine di tali transazioni (circa un minuto), altrimenti la copia non parte.
- Un database alla voltaPer impostazione predefinita il nodo master copia un database. Gli altri attendono in coda.
- Altre repliche di questo databaseMentre la copia è in corso, non ricevono i segmenti di questo database. Successivamente si allineano.
- Reinizializzazione automaticaRCM può copiare di nuovo da solo un database nello stato NEEDS_REINIT, solo in una finestra impostata. Disattivato per impostazione predefinita.
La modalità delicata attende le transazioni lunghe
Prima del lock, il nodo cerca le transazioni di scrittura iniziate prima del segmento più vecchio nell'archivio del master. Se l'archivio è vuoto (prima copia), il limite è il momento in cui il nodo ha attivato la pubblicazione. La replica non può ripetere tali transazioni e si fermerebbe. Quindi la copia non parte finché tali transazioni sono aperte.
RCM mostra le cinque connessioni con le transazioni più vecchie: utente, client, età, query corrente. Puoi disconnetterle e ripetere subito la copia. Mentre la copia attende, l'archivio del master non viene ripulito, ma per non più di 1000 segmenti. Poi la pulizia continua e RCM genera un avviso.
La modalità normale blocca subito il database, senza il controllo.
Spazio e velocità
| Dove | Cosa serve |
|---|---|
| Master, volume del database | Almeno il 105 % della dimensione del database libero. .delta cresce durante la copia. |
| Replica, volume del database | 105 % più la riserva del volume free_space_floor_gb (1 GB per impostazione predefinita). Il nodo riserva in anticipo la dimensione completa; non serve una seconda copia. In una copia ripetuta, il vecchio file resta fino alla fine. Se non c'è spazio per entrambi i file, la casella “Remove the old replica” elimina il vecchio file prima del trasferimento. |
| Velocità notturna | Nella finestra di trasferimento (23:00–05:00 per impostazione predefinita) è costante, 100 MB/s per impostazione predefinita. |
| Velocità diurna | Una quota della velocità del disco misurata, metà per impostazione predefinita. Una copia avviata di giorno accelera da sola di notte. |
Lo spazio viene controllato due volte e solo prima del lock: prima da RCM dalle statistiche, poi dai nodi con una misurazione in tempo reale su entrambi i lati. Il controllo del nodo non può essere saltato: protegge il disco dal riempimento a metà della copia.
Firebird 4 e 5 · HQbird 2.5 e 3.0
Pubblicazione: quali tabelle vanno alla replica
Firebird 4 e 5 scrivono nei segmenti solo le modifiche delle tabelle pubblicate, e solo quando la pubblicazione è attiva. Senza di essa, le modifiche non raggiungono la replica. Il nodo se ne accorge e genera un avviso. Il pulsante “Sync publication” la attiva e costruisce l'elenco corretto delle tabelle.
Cosa fa la sincronizzazione
- attiva la pubblicazione, a meno che l'operatore l'abbia disattivata di proposito;
- aggiunge tutte le tabelle con una chiave primaria o un indice univoco;
- rimuove le tabelle senza chiave e le tabelle escluse dall'operatore;
- disattiva l'aggiunta automatica delle nuove tabelle.
Senza una chiave, la replica non può trovare la riga per UPDATE e DELETE. Quindi una tale tabella non può essere pubblicata: aggiungi una chiave e sincronizza di nuovo.
- Controllo orarioSe la pubblicazione è disattivata, il nodo la controlla ogni 2 minuti. Per un database con una replica, questo è un avviso.
- Elenco di esclusioneMemorizzato sul nodo master. Quando una replica viene promossa a master, l'elenco passa al nuovo master.
- Nuova tabellaNon entra da sola nella pubblicazione. Crea una chiave e fai clic su “Sync publication”.
- Copia senza pubblicazioneIl nodo master rifiuta di copiare il database se la pubblicazione è disattivata o non ha tabelle (
publication_off). La finestra di inizializzazione offre “Sync publication and initialize”. - HQbird 2.5 e 3.0Nessuna pubblicazione. I filtri di inclusione ed esclusione nelle impostazioni di replica definiscono l'insieme delle tabelle.
Le modifiche effettuate mentre la pubblicazione è disattivata o una tabella è esclusa non raggiungono la replica, anche dopo averla attivata. “Verify” confronta solo il numero di righe; non trova gli UPDATE persi. Se il database ha ricevuto scritture mentre la pubblicazione era disattivata, copia di nuovo il database.
Ritardo · archivio · avvisi · controllo dei dati
Monitoraggio: la replica non resta indietro in silenzio
I nodi inviano statistiche a RCM ogni 30 secondi. Per ogni coppia master–replica vedi: l'ultimo segmento, quanti sono stati inviati, confermati e applicati, la coda e il ritardo in secondi.
| Stato del database | Gruppo in RCM | Significato |
|---|---|---|
IN_SYNC | Ok | La replica ha ricevuto tutti i segmenti. |
LAGGING | Pending | La replica è in ritardo, i segmenti sono in coda. |
SEEDING | Pending | Il database è in fase di copia sulla replica. |
NEEDS_REINIT | Error | La replica deve essere copiata di nuovo. |
FAILED | Error | L'ultima copia non è riuscita. |
L'archivio del master viene ripulito in fasi
Il master conserva i segmenti inviati affinché una replica possa richiederli di nuovo. Se lo spazio è scarso, elimina prima ciò che sicuramente non serve.
- 1Applicati da tutti, più vecchi del limiteil limite predefinito è 2 giorni
- 2Applicati, ma più recenti del limitese sono liberi meno di 1 GB; avviso
- 3Non ancora applicaticome ultimo passo; la replica necessita di una nuova copia
Avvisi con istruzioni
RCM conosce più di 20 tipi di avviso e ognuno ha un'istruzione su cosa fare. Puoi confermare un avviso, silenziarlo per 60 minuti o eliminarlo. Se la causa persiste, l'avviso ricompare.
Non ci sono e-mail o webhook: controlla la pagina “Alerts” o interroga l'API di RCM.
| Codice | Cosa è successo |
|---|---|
backlog_warn / backlog_critical | Il master ha 32 / 48 segmenti non archiviati. |
apply_error, replication_stopped | La replica non riesce ad applicare un segmento. |
replication_guid_mismatch | Il GUID del database master è cambiato: restore o sostituzione del file. |
segment_missing, sequence_gap | La sequenza dei segmenti è interrotta. |
firebird_down, firebird_log_error | Firebird è inattivo o scrive errori. |
firebird_not_answering | La porta di Firebird è aperta, ma una connessione al database non riesce da un minuto. |
master_publication_off | La pubblicazione è disattivata per un database con una replica. |
data_mismatch | Il controllo periodico dei dati ha trovato una differenza. Il controllo dei dati si attiva separatamente. |
Confronto tra master e replica
Verify conta le righe delle tabelle selezionate sul master e sulla replica e le confronta. Non confronta il contenuto delle righe: non troverà righe modificate. Eseguilo in un momento di quiete: con scritture attive i conteggi possono differire.
Il controllo periodico è disattivato per impostazione predefinita: COUNT(*) legge l'intera tabella. Attivalo con il parametro del nodo data_check_enabled; viene eseguito una volta ogni 2 ore. Le nuove impostazioni del controllo hanno effetto immediato, senza riavviare il nodo. Il controllo confronta i dati quando il master e la replica sono allo stesso segmento. Una differenza genera un avviso. Una tabella esclusa dalla pubblicazione viene mostrata come "non pubblicata", non come errore.
- Sospendi l'invioPer uno o più database. Dopo "Riprendi", l'invio continua dall'ultimo segmento, senza una nuova copia. Nel frattempo l'archivio cresce.
- Log dei nodi remotireplication.log, firebird.log e il log del nodo direttamente in RCM, senza accedere al server.
- Nessuna licenzaIl master interrompe l'invio; Firebird e i database continuano a funzionare. Dopo aver installato una licenza, l'invio riprende da solo entro un minuto.
- Log dei comandiOgni comando RCM viene registrato con autore e risultato. Report del cluster in un unico file JSON.
Servizio · epoca · dove si trova il master
Servizi: un database su più host
Un servizio è un database logico su più host. Il master può spostarsi da un host all'altro, ma il nome del servizio e l'alias del database non cambiano. Le applicazioni e i router chiedono a RCM dove si trova ora il master del servizio.
Ogni cambio di master riceve il numero successivo: l'epoca. RCM conserva la cronologia delle epoche: quando il master è cambiato e perché. RCM trova un servizio tramite il nodo e il percorso del file, non tramite il GUID: allo switchover il GUID del database cambia, ma il percorso resta lo stesso.
Cosa descrive un servizio
- alias: il nome del database in
databases.conf. Il nuovo master lo scrive da solo. - members: una voce per host: nodo master, nodo replica, percorso del file, priorità.
- router_port: la porta su cui i router accettano le applicazioni di questo servizio.
- policy: le regole del failover automatico e la modalità che chiude il vecchio master.
Ogni host di un servizio esegue due nodi su un unico Firebird: un nodo master e un nodo replica. È la stessa disposizione "Due nodi per host" del diagramma sopra.
Il nodo master necessita dell'indirizzo Firebird per i client: il parametro advertise_addr. Senza di esso, RCM non può indicare a un'applicazione dove connettersi.
Dove si trova ora il master
hqbirdrcm services put -id shop -file shop.json hqbirdrcm services hqbirdrcm where -service shop hqbirdrcm where -db shop
where risponde con: l'host e l'indirizzo del master, il numero dell'epoca, le repliche e i problemi rilevati. Tramite l'API, un'applicazione può attendere una nuova epoca senza interrogare RCM ogni secondo.
La pagina Services in RCM mostra lo stesso per ogni servizio: lo stato, l'epoca, il master, l'indirizzo Firebird, le repliche e i problemi. Il campo Find trova un database per alias, nome del servizio, GUID o percorso.
Servizi nel browser
Tutto ciò che i comandi hqbirdrcm fanno per i servizi è disponibile anche nell'interfaccia web di RCM. Non serve la riga di comando.
- Pagina del servizioLo stato e il suo motivo, il master, le repliche con il loro ritardo, gli host e i loro ruoli, i router, i vecchi master in attesa di essere chiusi, la regola di failover automatico, l'operazione in corso passo per passo e la cronologia dei master.
- Pulsanti di azioneSwitchover, Failover, Rejoin, Resume. Ogni pulsante esegue prima un controllo e mostra i problemi. L'azione parte solo dopo la conferma. Un secondo clic non avvia una seconda operazione.
- Modulo del servizioIl pulsante New service crea un servizio: nome, alias, porta del router e una riga per ogni host. Il modulo propone i nodi e i database che vede. Check verifica il modulo, Save mostra prima l'elenco delle modifiche.
- OperazioniUna pagina con tutti gli switchover, i failover e i rejoin, i più recenti per primi. Mentre un'operazione è in corso, l'intestazione di ogni pagina mostra un'etichetta con un link ad essa.
- Eliminazione di un servizioViene eliminato solo il record in RCM. La finestra di dialogo indica cosa resta (database, replica, ruoli dei nodi, alias) e cosa si perde (cronologia, regola, porta sui router), e chiede di digitare il nome del servizio.
- Ruolo ViewerUn utente con questo ruolo vede tutte le pagine ed esegue i controlli, ma non ha pulsanti di azione.
| Stato del servizio | Significato | Cosa fare |
|---|---|---|
ok | Il master funziona, la replica su un altro host lo segue. | Niente. |
rejoining | Il vecchio master sta tornando come replica. | Attendere: il database è in fase di copia. |
degraded_no_replica | Il master funziona, non c'è replica. Succede dopo un failover o dopo un errore di rejoin. | hqbirdrcm rejoin |
failed | RCM non riesce a determinare lo stato, oppure il Firebird del master non risponde. | hqbirdrcm resume dopo un controllo |
Un servizio nello stato failed non avvia né uno switchover né un failover automatico. Solo l'operatore può farlo uscire da questo stato: con il comando resume, con un rejoin o con un failover manuale.
Spostamento pianificato del master · senza perdita di dati
Switchover: il master si sposta su un altro host
Lo switchover sposta il master di un servizio su un altro host senza perdita di dati. RCM stesso interrompe le scritture sul vecchio master, attende che la replica applichi l'ultimo segmento e la rende master. Poi il vecchio master rientra nel cluster come replica del nuovo, allo stesso percorso.
Serve per lavori pianificati: aggiornamento del sistema operativo, sostituzione del disco, spostamento del carico su un altro server. Prima il controllo, poi l'avvio:
hqbirdrcm switchover -service shop -check # solo controllo, non cambia nulla hqbirdrcm switchover -service shop -to db2 # sposta il master su db2
Il comando esegue l'operazione fino in fondo e stampa ogni passo. Il codice di uscita 0 indica successo. Il pulsante Switchover nella pagina del servizio in RCM fa lo stesso: prima il controllo, poi la conferma, poi i passi dell'operazione sullo schermo.
Applicazioni
Host e servizio
Cosa verifica RCM prima dell'avvio
- Il servizio è nello stato
ok, il master è noto. - La replica di destinazione è nello stato
IN_SYNC. - Tutti e quattro i nodi dei due host rispondono.
- La replica di destinazione non è sospesa a causa della licenza.
- Nessuna copia o promozione del database è in corso su questi nodi.
Se qualcosa non va, RCM rifiuta e indica il motivo come codice. Fino a questo punto nulla è cambiato.
Se qualcosa va storto
- Prima del punto di non ritorno. Un errore, un timeout o un annullamento riportano online il vecchio master. Il servizio resta
oksul vecchio host. Se il vecchio master non torna online, il servizio passa afailed: riporta il database online congfix -online normaled eseguiresume. - Dopo il punto di non ritorno. Non puoi annullare. Un errore imposta il servizio su
failed. - Errore durante il rejoin. Il nuovo master funziona, non c'è replica:
degraded_no_replica. Eseguihqbirdrcm rejoin -service shop.
hqbirdrcm operations show -id <id> hqbirdrcm operations cancel -id <id>
Nel browser, questa è la pagina Operations e il pulsante Cancel nella pagina del servizio.
- Arresto delle scrittureIl vecchio master va in arresto completo. Il nodo attende la fine delle connessioni: 120 secondi per impostazione predefinita, 900 al massimo. L'opzione
-force Ninterrompe le connessioni dopo N secondi. - Recupero del ritardoOgni secondo, RCM chiede alla replica se ha applicato l'ultimo segmento. Il limite predefinito è 300 secondi.
- Un solo riavvio di FirebirdSul nuovo master, senza attendere la finestra. Durante il rejoin, il Firebird del vecchio host si riavvia solo se il nodo replica lo richiede.
- Il rejoin è una copia del databaseIl nuovo master copia il database sul vecchio host tramite nbackup. Per un database di grandi dimensioni questo richiede molto tempo, quindi il comando attende l'operazione fino a 2 ore.
- RCM riavviatoOgni passo viene scritto su disco prima della chiamata al nodo. Dopo un riavvio, RCM continua l'operazione dal passo corrente.
- Blocco del servizioMentre è in corso uno switchover o un rejoin, RCM rifiuta altre modifiche su questi nodi: impostazioni, riavvio di Firebird, copia, pausa della spedizione.
Le connessioni al vecchio master si chiudono al passo di arresto delle scritture. L'applicazione deve riconnettersi. Con un router, la stringa di connessione resta la stessa. Senza un router, l'applicazione va all'indirizzo del nuovo master: hqbirdrcm where -service shop lo fornisce.
HAProxy · Linux · una sola stringa di connessione
Router: le applicazioni mantengono lo stesso indirizzo
Un router viene eseguito sull'host dell'applicazione e mantiene HAProxy puntato al master di ciascun servizio. Le applicazioni si connettono a <router host>:<service port>. Dopo uno switchover o un failover, la stringa di connessione resta la stessa.
Come il router sceglie un host
- Riceve la tabella dei servizi da RCM: epoca, host master, indirizzi Firebird.
- Ogni 2 secondi chiede al nodo master: "sei il master di questa epoca e il database è online?".
- Risposta "sì": l'host accetta connessioni.
- Risposta "no": nessuna nuova connessione, le connessioni aperte restano.
- Nuova epoca: le sessioni del vecchio master si chiudono subito.
Se RCM non è disponibile, il router lavora con l'ultima tabella. Il router la conserva sul proprio disco.
Come aggiungere un router
Un router è un membro del cluster con il ruolo router. Aggiungilo nella pagina Cluster, come un master o una replica. L'fbagent su questo host riceve un certificato, scrive la configurazione e registra il servizio. HAProxy deve essere installato sull'host.
Il router_port nella descrizione del servizio imposta la porta del servizio. Puoi avere più router: uno su ciascun host dell'applicazione.
La pagina Settings → Routers in RCM mostra i router e i loro report: quale epoca il router ha applicato e verso quale host conduce.
- Le connessioni si interromponoQuando il master cambia, le connessioni aperte si chiudono. L'applicazione deve riconnettersi, allo stesso indirizzo.
- Indirizzo del clientFirebird vede l'indirizzo di HAProxy, non quello dell'applicazione. Le regole di accesso per IP del client non funzionano dietro un router.
- Solo LinuxIl router funziona su Linux. I server di database possono essere su Windows e Linux.
- WitnessI router comunicano a RCM se riescono a raggiungere la porta Firebird del master. Il failover automatico non si attiva senza di essi.
Host master perso · manuale o tramite una regola
Failover: la replica assume il ruolo di master
Hai bisogno del failover quando l'host master non risponde. La replica diventa il master con i segmenti che ha ricevuto. Ciò che il master non ha inviato è perso. Quindi l'operatore deve accettare la perdita esplicitamente.
hqbirdrcm failover -service shop -check # what will be lost hqbirdrcm failover -service shop -to db2 -accept-data-loss # start
Senza l'opzione -accept-data-loss, il comando esegue solo il controllo e mostra la stima della perdita: l'ultimo segmento del master, quanti segmenti la replica ha ricevuto e applicato, e quanti segmenti sono persi come minimo.
Nel browser, questo è il pulsante Failover nella pagina del servizio. Avvia l'operazione solo quando l'operatore ha spuntato la casella di perdita dati e digitato il nome del servizio.
- 1Controlloil master non risponde, la replica ha una copia utilizzabile
- 2Recupero del ritardola replica applica tutto ciò che ha ricevuto; limite 60 s
- 3Promozionepunto di non ritorno: nuovo GUID, riavvio di Firebird
- 4Nuova epocala replica è il master; il vecchio master attende di essere chiuso
- Il master risponde ancoraRCM rifiuta:
master_reachable. Esegui uno switchover, oppure prima arresta il nodo master. - Replica in ritardoLo stato
LAGGINGè accettato. Una replica che necessita di una nuova copia non è adatta. - Più replichePer impostazione predefinita, RCM sceglie quella che ha applicato più segmenti, poi quella con la priorità più alta.
- Dopo il failoverIl servizio è nello stato
degraded_no_replica: il master funziona, non c'è replica. Non c'è rejoin finché il vecchio host non è di nuovo attivo. - Servizio in stato failedAnche per esso funziona un failover manuale. È la via d'uscita quando il Firebird del master si blocca e non puoi riavviarlo rapidamente.
- Tabelle escluseRCM prende il loro elenco dalla replica o dalle ultime statistiche del vecchio master. Se non c'è un elenco, imposta le tabelle nella pagina di pubblicazione del nuovo master.
- Limite di recuperoL'opzione
-apply-timeout, 60 secondi per impostazione predefinita, 3600 al massimo.
Failover automatico opzionale
RCM può avviare un failover da solo. Questo è disattivato per impostazione predefinita. Attivi la regola per ciascun servizio separatamente: nella pagina del servizio nel browser o con un comando.
hqbirdrcm policy -service shop # show the rule
hqbirdrcm policy -service shop -auto-failover on -max-data-loss 30
RCM controlla le condizioni ogni 10 secondi e avvia un failover solo quando tutte sono vere.
| Condizione | Motivo |
|---|---|
| Il nodo master è silenzioso per 90 secondi | Il master non invia statistiche. |
| Una chiamata diretta da RCM al nodo master fallisce (5 secondi) | Non si tratta solo di statistiche in ritardo. |
| Più della metà dei router non riesce a raggiungere la porta Firebird del master | Anche le applicazioni non riescono a connettersi. |
| Il nodo replica non vede il master da 90 secondi | Terzo witness. |
| Il ritardo della replica è di 30 secondi o meno | Limite di perdita dati. |
| È trascorsa un'ora dall'ultimo failover automatico | Il master non salta tra gli host. |
| RCM è in esecuzione da più di 90 secondi | Dopo un riavvio, RCM non ha dati aggiornati. |
Il servizio è ok, nessuna copia o promozione è in esecuzione sui nodi | Nessun conflitto con il lavoro in corso. |
- Sono necessari i routerLa regola richiede sia i router sia una porta di servizio. Se manca uno dei due, la regola non si attiva:
no_witnesses. Posiziona i router in modo che la maggior parte di essi non si trovi sull'host master. - Una sola voltaDopo un failover automatico, la regola si disattiva da sola. Solo l'operatore la riattiva.
- Perché non è partitaRCM conserva il motivo dell'attesa insieme alla regola del servizio e scrive ogni nuovo motivo nel proprio log una sola volta.
- LogL'operazione viene eseguita come
system:autofailover. La prima voce indica ciò che hanno visto i witness.
Il limite di 30 secondi copre solo la coda che la replica ha ricevuto e non ha ancora applicato. I segmenti che il master ha scritto ma non ha inviato non sono inclusi. Il report dell'operazione ne mostra il numero.
Fence · rejoin · master bloccato · resume
Rejoin e ripristino
Dopo un failover, il cluster ha due file che sono stati il master. Devi chiudere quello vecchio in modo che non accetti scritture e riportarlo come replica. RCM esegue il primo passo da solo, il secondo su comando dell'operatore.
Chiusura del vecchio master (fence)
RCM tenta di chiudere il vecchio master ogni 10 secondi. Quando il suo nodo risponde, riceve il ruolo "chiuso" e smette di inviare segmenti. Ogni fence viene scritto nel log di audit.
- Modalità
route(predefinita). Il database del vecchio master resta online. I router non lo usano più. - Modalità
shutdown. RCM arresta prima il database. Le connessioni si chiudono dopo 5 secondi.
hqbirdrcm policy -service shop -fence-mode shutdown
Ripristino del vecchio master (rejoin)
Quando il vecchio host funziona di nuovo, avvia il rejoin. RCM chiude prima il vecchio master, se non è già stato fatto. Poi il nuovo master copia il proprio database sul vecchio host, allo stesso percorso.
hqbirdrcm rejoin -service shop
Il vecchio file non viene eliminato. Resta accanto a quello nuovo come <name>.pre-reinit-<time>.fdb. Questo file e l'archivio del vecchio master contengono modifiche che il nuovo master non ha.
In modalità route, le applicazioni che si connettono direttamente al vecchio host, non tramite un router, possono ancora scrivere nel vecchio database. Queste modifiche non raggiungono il nuovo master. Se alcune applicazioni lavorano senza router, attiva la modalità shutdown.
Master bloccato
Firebird può bloccarsi in modo che la porta sia aperta, ma non sia possibile connettersi al database. Un controllo della porta non se ne accorge. Perciò il nodo stesso si connette al database ogni minuto, con un limite di 10 secondi.
- Un minuto senza risposta: l'avviso grave
firebird_not_answering. - RCM imposta il servizio su
failede scrive il motivo: nodo, host, ora. - Il failover automatico non parte in questo stato.
Cosa fare: salva gli stack dei thread di Firebird e firebird.log, riavvia Firebird sull'host master, poi esegui resume. Se non puoi riavviare rapidamente, arresta il nodo master e avvia un failover.
Uscita dallo stato failed
hqbirdrcm resume -service shop -check hqbirdrcm resume -service shop
RCM interroga direttamente il nodo master e verifica:
- nessuna operazione è in esecuzione sul servizio;
- il nodo master risponde;
- il suo Firebird accetta connessioni;
- l'host è il master dell'epoca corrente, il database è online.
Il servizio passa a ok se una replica su un altro host segue il master. Altrimenti passa a degraded_no_replica: in tal caso esegui rejoin.
Riporta alla normalità · promuovi a master
Promozione manuale della replica: passo dopo passo
Per un database che fa parte di un servizio, usa switchover e failover: eseguono da soli tutti i passaggi seguenti. Il percorso manuale resta per i database senza servizio. "Riporta alla normalità" rende la replica un database di lavoro separato: per report, test o un guasto. "Promuovi a master" rende la replica il nuovo master.
La promozione funziona per una coppia di nodi companion: un nodo replica e un nodo master sulla stessa istanza Firebird. Il file del database resta al suo posto; il controllo passa al companion. Ogni passaggio è visibile nella riga del database. Se un passaggio è stato interrotto, fai clic di nuovo sul pulsante: i passaggi completati non vengono ripetuti.
Connessioni
Cosa mostra RCM
Perché un nuovo GUID
Senza di esso, il nuovo master scriverebbe i segmenti con il GUID del vecchio master e le sue repliche li rifiuterebbero. Il nodo assegna al database un nuovo GUID sul posto, tramite nbackup, senza riavviare Firebird. Funziona su 2.5, 3.0, 4.0 e 5.0.
Dopo un nuovo GUID, la vecchia catena nbackup non è più adatta. Crea una nuova copia di livello 0.
Switchover manuale senza servizio
- Interrompi le scritture delle applicazioni sul vecchio master.
- Attendi
IN_SYNCe una coda vuota. - Fai clic su "Verifica": i conteggi delle righe corrispondono. Questo verifica solo i conteggi delle righe.
- "Promuovi a master", attendi il passaggio FINALIZE.
- Sposta le applicazioni sul nuovo master.
- Crea una copia nbackup di livello 0 e collega una nuova replica.
La promozione manuale non verifica se le applicazioni scrivono sul vecchio master e non riporta il vecchio master come replica. Interrompi tu stesso le scritture prima. Switchover esegue entrambi i passaggi per te: interrompe le scritture e riporta il vecchio master.
Riavvio · parametri · certificati
Impostazioni e sicurezza
Firebird legge le impostazioni di replica solo all'avvio. Quindi conta chi lo riavvia e quando. La regola è semplice: il Firebird del master non viene mai riavviato automaticamente. C'è un'eccezione: switchover e failover. In questi casi il riavvio fa parte di un'operazione avviata dall'operatore, o avviata da una regola attivata dall'operatore.
| Nodo | Chi riavvia Firebird |
|---|---|
| Master | Solo tu. Il nodo master non riavvia Firebird da solo. |
| Replica, la stessa istanza Firebird ha database master | Tu. L'autorizzazione nella finestra di copia consente al nodo solo di arrestare Firebird per sostituire o eliminare il vecchio file della replica. |
| Replica, riavvio automatico non consentito | Tu. |
| Altre repliche | Il nodo, nella sua finestra di riavvio. Una volta dopo una serie di copie, non dopo ogni database. |
Parametri di replica per molti database
Seleziona i database: RCM li raggruppa per versione di Firebird e ruolo. Per ogni parametro, scegli un'azione: mantieni, imposta, reimposta al livello superiore o non scrivere. Vedi da dove proviene il valore corrente: il database, il nodo o Firebird.
Anteprima verifica i valori sui nodi e non modifica nulla. Mostra anche chi riavvierà Firebird e quanti database saranno interessati.
- Finestre temporaliUn riavvio del master richiesto da te: 22:00–05:00. Replica: in qualsiasi momento. La promozione manuale a master riavvia entrambi i server Firebird contemporaneamente, senza finestra. Lo switchover riavvia un solo Firebird: sul nuovo master. Velocità di copia completa: 23:00–05:00.
- Velocità dei segmenti50 MB/s per impostazione predefinita, picco breve di 200 MB. Modifica immediata, senza riavvio.
- Spostamento del file della replicaIn un'altra sottocartella senza una nuova copia; rollback in caso di errore.
- Replica configurata manualmentePuoi prenderla in gestione senza una nuova copia. RCM abbina i file tramite GUID.
- Riga di comandoCopia, verifica, pausa, promozione e altri comandi RCM sono disponibili anche in
hqbirdrcm. Switchover, failover e la regola del servizio sono disponibili in tre modi: nel browser, con un comando e tramite l'API. - Ruolo visualizzatoreUn utente RCM con ruolo visualizzatore vede tutto ed esegue i controlli. Qualsiasi modifica è vietata a questo utente.
- 6 lingueInterfaccia RCM. Le istruzioni degli avvisi sono in inglese.
Un documento descrive il cluster
I membri, i loro ruoli e i collegamenti master → replica si impostano nella pagina Cluster di HQ Monitor o in RCM. L'fbagent su ciascun host riceve la descrizione e installa e configura i nodi da solo. Senza HQCenter, RCM gestisce un cluster di massimo 3 host.
mTLS e certificati
Tutti i canali del cluster sono protetti da mTLS con una CA condivisa. La chiave viene creata sull'host membro e non lo lascia mai: esce solo la richiesta di certificato. Un certificato è valido per 90 giorni e si rinnova da solo 30 giorni prima della scadenza. Una nuova chiave e una nuova CA vengono emesse su comando dell'amministratore.
L'interfaccia web di RCM funziona su HTTPS sulla porta 7444. L'agente apre questa porta nel firewall quando RCM è attivato sull'host. L'accesso avviene con nome utente e password; è necessario cambiare la prima password. Si trova nel file rcm-initial-password sull'host RCM e non viene mostrata sullo schermo. Dopo il cambio della password, l'agente elimina questo file. La pagina di accesso mostra l'hash della CA del cluster: confrontalo con la riga "CA hash" nel riepilogo della configurazione sull'host RCM. Ogni modifica e ogni accesso vengono registrati nel log di audit.
Comandi · timeout · porte · codici di rifiuto
Riferimento
Comandi
| Attività | Comando |
|---|---|
| Attivare RCM su un host | fbagent --cluster-init <id> |
| Aprire o chiudere la finestra di pairing | fbagent --cluster-pairing on|off |
| Collegare gli host | hqbirdrcm cluster link -hosts db1,db2 -master db1 |
| Token per un host senza la finestra di pairing | hqbirdrcm cluster join-token -note db2 |
| Uscire dal cluster | fbagent --cluster-leave |
| Descrivere un servizio | hqbirdrcm services put -id shop -file shop.json |
| Dove si trova il master | hqbirdrcm where -service shop |
| Spostamento pianificato del master | hqbirdrcm switchover -service shop [-to db2] [-check] |
| Spostamento di emergenza | hqbirdrcm failover -service shop -accept-data-loss |
| Riportare il vecchio master come replica | hqbirdrcm rejoin -service shop |
| Uscire dallo stato di errore | hqbirdrcm resume -service shop [-check] |
| Regola di failover automatico | hqbirdrcm policy -service shop -auto-failover on|off |
| Avanzamento e annullamento di un'operazione | hqbirdrcm operations show|cancel -id <id> |
Timeout e intervalli
| Cosa | Predefinito | Come modificarlo |
|---|---|---|
| Switchover: attesa della fine delle connessioni | 120 s, al massimo 900 s | -quiesce-timeout |
| Switchover: la replica applica l'ultimo segmento | 300 s | -apply-timeout |
| Switchover: il comando attende la fine dell'operazione | 2 ore | -timeout |
| Failover: la replica applica ciò che ha ricevuto | 60 s, al massimo 3600 s | -apply-timeout |
| Failover automatico: il master è silente | 90 s | -failover-delay |
| Failover automatico: limite di ritardo | 30 s | -max-data-loss |
| Failover automatico: pausa tra due | 1 ora | -min-interval |
| Verifica delle condizioni di failover e del fence del vecchio master | ogni 10 s | non modificabile |
| Firebird bloccato: sonda di connessione | una volta al minuto, limite 10 s | non modificabile |
| Router: polling del nodo master | ogni 2 s | non modificabile |
| Finestra di pairing, join token | 24 ore | finestra: numero di ore nella richiesta |
| Collegamento host: certificato dell'agente, avvio del nodo | fino a 10 minuti, fino a 20 minuti | non modificabile |
Porte
| Porta | Scopo |
|---|---|
7443 | RCM: nodi, agenti e router, mTLS. |
7444 | RCM: interfaccia web e comandi dell'operatore, HTTPS. |
7450–7459 | Finestra di pairing dell'agente: 7450 + slot. |
7051–7060 | Primo nodo dell'agente: 7051 + slot. |
7061–7070 | Secondo nodo dell'agente: 7061 + slot. |
router_port | Porta del servizio sul router, ad esempio 3051. |
Codici di rifiuto
| Codice | Significato |
|---|---|
not_in_sync | La replica di destinazione è in ritardo: lo switchover non parte. |
busy | Sui nodi è in corso una copia del database o una promozione. |
service_busy | Sul servizio è già in corso un'operazione. |
master_reachable | Il master risponde: il failover non è necessario. |
replica_unusable | La replica non ha una copia del database utilizzabile. |
data_loss_not_accepted | Failover senza l'opzione -accept-data-loss. |
past_no_return | Annullamento dopo il punto di non ritorno. |
no_witnesses | Failover automatico senza router. |
node_port_clash | Un altro membro dell'host usa la porta del nodo. |
seats_exceeded | Il cluster ha già 3 host. |
I punti principali in breve
Domande frequenti
Qual è la differenza tra switchover e failover?
Lo switchover è pianificato: entrambi gli host funzionano, nessun dato va perso, il vecchio master torna da solo come replica. Il failover è un'emergenza: l'host master è perso, ciò che il master non ha inviato va perso e il vecchio master va riportato con un comando separato.
Cosa vede l'applicazione durante uno switchover?
Le connessioni al vecchio master si chiudono quando RCM interrompe le scritture. Finché la replica non diventa il master, non c'è dove scrivere. Dopo la nuova epoca, l'applicazione si riconnette: allo stesso indirizzo del router o all'indirizzo del nuovo master.
Quanto dura uno switchover?
La pausa di scrittura ha tre parti: l'attesa della fine delle connessioni (fino a 120 secondi per impostazione predefinita), il recupero dell'ultimo segmento e un riavvio di Firebird sul nuovo master. Il rejoin del vecchio master avviene dopo, in background. Il suo tempo è il tempo della copia del database.
Posso lavorare senza router?
Sì. Lo switchover e il failover manuale funzionano senza router. L'applicazione ottiene quindi l'indirizzo del master da RCM stesso. Il failover automatico non si attiva senza router: i router sono i suoi testimoni.
Quanti dati può perdere un failover automatico?
La regola non parte se la replica è in ritardo di più di 30 secondi. Ma i segmenti che il master ha scritto e non ha inviato vanno persi. Il report dell'operazione ne mostra il numero. Il vecchio file del database viene conservato: queste modifiche restano in esso e nell'archivio del vecchio master.
Il servizio è nello stato di errore. Cosa faccio?
Consulta il motivo nella pagina Servizi. Se il Firebird del master si è bloccato, riavvialo. Poi hqbirdrcm resume -service <id> -check mostra cosa blocca il servizio, e resume senza lo switch riporta il servizio al lavoro.
Quanto spazio richiede il rejoin del vecchio master?
Il rejoin è una nuova copia del database. Valgono le stesse regole di qualsiasi copia: 105 % della dimensione del database. Dopo un failover, il vecchio file resta accanto a quello nuovo, quindi il vecchio host ha bisogno di spazio per entrambi i file.
Funziona su Windows?
I nodi e RCM funzionano su Windows e Linux. Il router funziona solo su Linux.