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

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.

Diagramma del cluster: i nodi master inviano segmenti ai nodi replica, RCM controlla tutti i nodi
ComponenteQuantiCosa fa
Firebird (HQbird)su ogni server di databaseMemorizza i database e scrive i segmenti di replica.
fbagentuno per istanza FirebirdArresta e avvia Firebird quando il nodo lo richiede.
hqclusternodeuno per istanza e ruoloConfigura la replica, invia i segmenti, crea la copia del database per una replica.
hqbirdrcm (RCM)uno per clusterInterfaccia web, comandi, avvisi, statistiche. Esegue switchover e failover.
Router (hqclusternode router)opzionale, sull'host dell'applicazione, LinuxMantiene 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.

  1. 1Attivare RCMsu un host: in HQ Monitor o con fbagent --cluster-init
  2. 2Aprire la finestra di pairingsugli altri host, per 24 ore
  3. 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-port lo 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>-master e <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-join con 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-takeover sposta RCM su un altro agent. Il cluster ottiene una nuova CA e i membri devono essere collegati di nuovo.
  • Uscita dal clusterfbagent --cluster-leave arresta i nodi, chiude le loro porte ed elimina i certificati del cluster. Le cartelle dei nodi restano; --remove-data le 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 --force o /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

    al lavoro

    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 -L e 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.

    Avvio della copia. Modalità (delicata o normale), cartella della replica con verifica, autorizzazione a fermare il Firebird della replica.

    Spazio e velocità

    DoveCosa serve
    Master, volume del databaseAlmeno il 105 % della dimensione del database libero. .delta cresce durante la copia.
    Replica, volume del database105 % 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à notturnaNella finestra di trasferimento (23:00–05:00 per impostazione predefinita) è costante, 100 MB/s per impostazione predefinita.
    Velocità diurnaUna 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.

    Tabelle della pubblicazione. La chiave di ogni tabella e il suo stato: pubblicata, non ancora pubblicata, esclusa, senza chiave.

    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.

    Trasferimento e code. Una riga per ogni percorso master → replica: segmenti, coda e ritardo.
    Stato del databaseGruppo in RCMSignificato
    IN_SYNCOkLa replica ha ricevuto tutti i segmenti.
    LAGGINGPendingLa replica è in ritardo, i segmenti sono in coda.
    SEEDINGPendingIl database è in fase di copia sulla replica.
    NEEDS_REINITErrorLa replica deve essere copiata di nuovo.
    FAILEDErrorL'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.

    1. 1Applicati da tutti, più vecchi del limiteil limite predefinito è 2 giorni
    2. 2Applicati, ma più recenti del limitese sono liberi meno di 1 GB; avviso
    3. 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.

    Avvisi. Codice, nodo, messaggio e azioni.
    CodiceCosa è successo
    backlog_warn / backlog_criticalIl master ha 32 / 48 segmenti non archiviati.
    apply_error, replication_stoppedLa replica non riesce ad applicare un segmento.
    replication_guid_mismatchIl GUID del database master è cambiato: restore o sostituzione del file.
    segment_missing, sequence_gapLa sequenza dei segmenti è interrotta.
    firebird_down, firebird_log_errorFirebird è inattivo o scrive errori.
    firebird_not_answeringLa porta di Firebird è aperta, ma una connessione al database non riesce da un minuto.
    master_publication_offLa pubblicazione è disattivata per un database con una replica.
    data_mismatchIl controllo periodico dei dati ha trovato una differenza. Il controllo dei dati si attiva separatamente.
    Controllo dei dati. Numero di righe di ogni tabella sul master e sulla replica.

    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 servizioSignificatoCosa fare
    okIl master funziona, la replica su un altro host lo segue.Niente.
    rejoiningIl vecchio master sta tornando come replica.Attendere: il database è in fase di copia.
    degraded_no_replicaIl master funziona, non c'è replica. Succede dopo un failover o dopo un errore di rejoin.hqbirdrcm rejoin
    failedRCM 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

      funzionanti

      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 ok sul vecchio host. Se il vecchio master non torna online, il servizio passa a failed: riporta il database online con gfix -online normal ed esegui resume.
      • 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. Esegui hqbirdrcm 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 N interrompe 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.

      Schema del router: prima del cambio di epoca, le applicazioni passano attraverso il router a db1; dopo il cambio, a db2 epoch 4 · master on db1 Applications router:3051 Router HAProxy db1 master db2 replica epoch 5 · master on db2 Applications router:3051 Router HAProxy db1 closed (fenced) db2 master
      Cambio di epoca. Il router chiude subito le sessioni del vecchio master e apre il nuovo master quando risponde "ready". L'indirizzo e la porta per le applicazioni non cambiano.

      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.

      1. 1Controlloil master non risponde, la replica ha una copia utilizzabile
      2. 2Recupero del ritardola replica applica tutto ciò che ha ricevuto; limite 60 s
      3. 3Promozionepunto di non ritorno: nuovo GUID, riavvio di Firebird
      4. 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.

      CondizioneMotivo
      Il nodo master è silenzioso per 90 secondiIl 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 masterAnche le applicazioni non riescono a connettersi.
      Il nodo replica non vede il master da 90 secondiTerzo witness.
      Il ritardo della replica è di 30 secondi o menoLimite di perdita dati.
      È trascorsa un'ora dall'ultimo failover automaticoIl master non salta tra gli host.
      RCM è in esecuzione da più di 90 secondiDopo un riavvio, RCM non ha dati aggiornati.
      Il servizio è ok, nessuna copia o promozione è in esecuzione sui nodiNessun 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 failed e 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

        mantenute

        Cosa mostra RCM

        Passaggi nella riga del database. I passaggi completati sono verdi, quello corrente è rosso, i successivi sono grigi.

        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

        1. Interrompi le scritture delle applicazioni sul vecchio master.
        2. Attendi IN_SYNC e una coda vuota.
        3. Fai clic su "Verifica": i conteggi delle righe corrispondono. Questo verifica solo i conteggi delle righe.
        4. "Promuovi a master", attendi il passaggio FINALIZE.
        5. Sposta le applicazioni sul nuovo master.
        6. 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.

        NodoChi riavvia Firebird
        MasterSolo tu. Il nodo master non riavvia Firebird da solo.
        Replica, la stessa istanza Firebird ha database masterTu. 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 consentitoTu.
        Altre replicheIl 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.

        Parametri di replica. Un suggerimento per ogni chiave, valori del nodo e di Firebird, anteprima: "lo riavvii tu".
        • 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.
        Descrizione del cluster in HQ Monitor (modalità demo). Membri e ruoli, collegamenti master → replica, la scadenza del certificato di ciascun membro.

        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 hostfbagent --cluster-init <id>
        Aprire o chiudere la finestra di pairingfbagent --cluster-pairing on|off
        Collegare gli hosthqbirdrcm cluster link -hosts db1,db2 -master db1
        Token per un host senza la finestra di pairinghqbirdrcm cluster join-token -note db2
        Uscire dal clusterfbagent --cluster-leave
        Descrivere un serviziohqbirdrcm services put -id shop -file shop.json
        Dove si trova il masterhqbirdrcm where -service shop
        Spostamento pianificato del masterhqbirdrcm switchover -service shop [-to db2] [-check]
        Spostamento di emergenzahqbirdrcm failover -service shop -accept-data-loss
        Riportare il vecchio master come replicahqbirdrcm rejoin -service shop
        Uscire dallo stato di errorehqbirdrcm resume -service shop [-check]
        Regola di failover automaticohqbirdrcm policy -service shop -auto-failover on|off
        Avanzamento e annullamento di un'operazionehqbirdrcm operations show|cancel -id <id>

        Timeout e intervalli

        CosaPredefinitoCome modificarlo
        Switchover: attesa della fine delle connessioni120 s, al massimo 900 s-quiesce-timeout
        Switchover: la replica applica l'ultimo segmento300 s-apply-timeout
        Switchover: il comando attende la fine dell'operazione2 ore-timeout
        Failover: la replica applica ciò che ha ricevuto60 s, al massimo 3600 s-apply-timeout
        Failover automatico: il master è silente90 s-failover-delay
        Failover automatico: limite di ritardo30 s-max-data-loss
        Failover automatico: pausa tra due1 ora-min-interval
        Verifica delle condizioni di failover e del fence del vecchio masterogni 10 snon modificabile
        Firebird bloccato: sonda di connessioneuna volta al minuto, limite 10 snon modificabile
        Router: polling del nodo masterogni 2 snon modificabile
        Finestra di pairing, join token24 orefinestra: numero di ore nella richiesta
        Collegamento host: certificato dell'agente, avvio del nodofino a 10 minuti, fino a 20 minutinon modificabile

        Porte

        PortaScopo
        7443RCM: nodi, agenti e router, mTLS.
        7444RCM: interfaccia web e comandi dell'operatore, HTTPS.
        7450–7459Finestra di pairing dell'agente: 7450 + slot.
        7051–7060Primo nodo dell'agente: 7051 + slot.
        7061–7070Secondo nodo dell'agente: 7061 + slot.
        router_portPorta del servizio sul router, ad esempio 3051.

        Codici di rifiuto

        CodiceSignificato
        not_in_syncLa replica di destinazione è in ritardo: lo switchover non parte.
        busySui nodi è in corso una copia del database o una promozione.
        service_busySul servizio è già in corso un'operazione.
        master_reachableIl master risponde: il failover non è necessario.
        replica_unusableLa replica non ha una copia del database utilizzabile.
        data_loss_not_acceptedFailover senza l'opzione -accept-data-loss.
        past_no_returnAnnullamento dopo il punto di non ritorno.
        no_witnessesFailover automatico senza router.
        node_port_clashUn altro membro dell'host usa la porta del nodo.
        seats_exceededIl 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.

        ← Torna alla panoramica di HQbird 2027