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

Altri linguaggi: Русский, Português.

Questa guida va da due server puliti a una replica Firebird 5.0 funzionante. Fai tutto nel browser, nella console RCM, tranne l’installazione e una cartella. Gli screenshot provengono dall’esecuzione del 2026-11-17: kit 2027.2.33, RCM e nodi 2027.5.12, Ubuntu 24.04, l’interfaccia in inglese. Il report dell’esecuzione precedente del 2026-11-08: hqbird2027-rcm-cluster-check-report.ru.md (in russo, sezione “Прогон 2”). Solo comandi, senza screenshot: hqbird2027-linux-cluster-runbook.md. Ogni pagina RCM in dettaglio: la guida utente RCM (repository hqcluster-node, docs/user-guide/).

Questa guida è per il kit 2027.2.24 e successivi. Per il kit 2027.2.22, vedi la versione di questo file del 2026-11-07 nella cronologia git.

Il kit da scaricare è 2027.2.33 (2026-11-16): agent 3.4.0, HQ Monitor 1.57.0, RCM e nodi 2027.5.12, Firebird 5.0.5.1917. Questa guida è stata verificata con esso il 2026-11-17 (due server, Ubuntu 24.04, database da 3 MB e 167 MB): tutti i passaggi sono andati a buon fine. Il testo indica i risultati di quell’esecuzione come “l’esecuzione del 2026-11-17”. Gli screenshot provengono da una seconda passata di quel giorno con lo stesso kit (database da 3 MB e 2,88 GB). Gli altri numeri provengono ancora dall’esecuzione del 2026-11-08. Cosa hanno cambiato i kit successivi al 2027.2.27 per un cluster:

Kit Modifica
2027.2.29 (agent 3.1.0, RCM 2027.5.9) Nessun cluster per impostazione predefinita (vedi sotto). Più agent di un host possono unirsi a un cluster: ognuno ha la propria porta di pairing (7450–7459) e porta del nodo. fbagent --cluster-leave. La pagina Clusters di HQ Monitor
2027.2.30 (RCM 2027.5.10) Switchover e failover di un servizio, router
2027.2.31 (agent 3.3.0, RCM 2027.5.11) L’installer apre un’interfaccia testuale in un terminale (passaggio 1). Le pagine Services di RCM. Un server che non è collegato a nessun HQCenter aggiorna da solo l’agent, HQ Monitor e fbmcp
2027.2.33 (agent 3.4.0, RCM 2027.5.12) RCM invia i suoi avvisi a Telegram, a un webhook o via e-mail (“Cosa guardare dopo”). Un cluster di due container Docker: guida Docker

Tutte le modifiche: What’s New.

Kit con agent (fbagent) 3.1.0 e successivi (dal 2027.2.29) non creano nessun cluster per impostazione predefinita: nessun RCM, nessuna finestra di pairing e le porte del cluster restano chiuse nel firewall. Nel passaggio 1 attivi RCM sul master e la modalità discovery sulla replica.

Tempo: ≈30 minuti più la copia dei database (≈1 minuto per 3 GB su una rete a 1 Gbit/s).

Cosa ottieni

Server 1 Server 2
Ruolo master + console RCM replica
Database /databases/master/*.fdb /databases/replica/<replica node>/<master node>/*.fdb
Servizi firebird, hqbirdfbagent-fb50, hqbirdmonitor-fb50, fbmcp, hqbirdrcm, hqclusternode-master-p3050 gli stessi, ma hqclusternode-replica-p3050 e senza hqbirdrcm (un kit più vecchio lascia lì il proprio RCM, fermo)

Cosa ti serve

  • Due server Linux x86-64 (verificati su Ubuntu 24.04), 2 core, 4 GB di memoria.
  • Spazio su disco. Master: libero ≥ 105 % della dimensione del database (il file .delta cresce durante il lock). Replica: libero ≥ 105 % della dimensione del database più il minimo limits.free_space_floor_gb (predefinito 1 GB). Una reinit su una replica esistente mantiene il vecchio file fino alla fine, quindi il volume della replica necessita di circa 2 × la dimensione del database. Con la casella Remove the old replica if space is short (passaggio 8), basta il 105 % più il minimo.
  • Rete tra i server: porte 3050, 7051, 7443, 7444, 7450. Queste sono le porte della prima istanza di un server (slot 0). Una seconda istanza di un server usa la porta di pairing 7451 e la porta del nodo 7052.
  • Il tuo PC può raggiungere la porta 7444 del master (la console RCM), direttamente o tramite un tunnel SSH.
  • Un utente con sudo.

Firewall. L’installer apre le porte in un firewalld o ufw abilitato (con qualsiasi lingua di sistema): 3050 e 23050 sempre, le porte del cluster solo per le opzioni del passaggio 1. Master: 7443, 7444, 7051. Replica: 7450, 7051. L’agent richiude la 7450 quando la finestra di pairing termina o l’host è collegato. Su Ubuntu, ufw è di solito disabilitato. Allora l’installer scrive una riga, per esempio sul master: no active firewall (firewalld or ufw): ports 3050, 23050, 7443, 7444, 7051/tcp are not opened by this install; they are reachable from every network; close them or enable a firewall. In un cloud, chiudi le porte con il firewall del cloud: dall’esterno, solo il tuo indirizzo; tra i server, la rete interna.

Di seguito sono riportati gli indirizzi dell’esecuzione: master 10.114.0.5, replica 10.114.0.6 (rete privata). Usa i tuoi indirizzi.

Passaggio 1. Installa su entrambi i server

Su ciascun server:

Command
V=2027.2.33
wget https://ib-aid.com/download/hqbird/v2027/hqbird2027-fb50-linux-$V.run
wget https://ib-aid.com/download/hqbird/v2027/hqbird2027-fb50-linux-$V.run.sha256
sha256sum -c hqbird2027-fb50-linux-$V.run.sha256
sudo sh hqbird2027-fb50-linux-$V.run

In un terminale, l’installer apre la sua interfaccia testuale (kit dal 2027.2.31). La prima pagina ha la riga Cluster RCM off, discovery mode off. Apri Cluster e cambia una riga:

Riga della pagina Cluster Master Replica
Cluster manager (RCM) on off
Discovery mode (24 h) off (questo agent esegue l’RCM) on

Le righe Cluster id (predefinito: il nome dell’host), RCM admin password (predefinito: generata) e Pairing port (predefinito: la prima libera, 7450) possono restare come sono. Torna indietro (Esc) e scegli Install. L' installer mostra il piano: premi Invio. Poi chiede Nothing on this host was changed yet. Start the install now?. Il cursore è su No: spostalo su Yes e premi Invio. L’installer aggiunge da solo le librerie mancanti (per esempio, libtommath1). L’interfaccia testuale per intero: hqbird2027-linux-setup-guide.md.

Con --no-tui, e nei kit 2027.2.29–2027.2.30, l’installer pone domande. La prima è Install as planned? Yes/No: rispondi y. Poi pone due domande sul cluster. La risposta è No per impostazione predefinita (Invio):

Domanda Master Replica
Install the cluster manager (RCM) on this host and make a new cluster? [y/N] y Invio (No)
Turn on discovery mode for 24 hours (an RCM on the network may invite this agent into its cluster; port 7450)? [y/N] non posta: questo agent esegue l’RCM y

Oppure fornisci le risposte come opzioni: in un terminale impostano i valori della pagina Cluster prima che si apra. Usale anche per un’esecuzione senza terminale: --yes da solo significa No per entrambe.

Command
sudo sh hqbird2027-fb50-linux-$V.run --rcm on               # master
sudo sh hqbird2027-fb50-linux-$V.run --cluster-pairing on   # replica

L’installazione richiede circa un minuto (l’esecuzione del 2026-11-17: 61 secondi sul master, 43 secondi sulla replica). La fine dell’output sul master con il kit 2027.2.33 (l’hash è abbreviato qui; l’id del cluster degli esempi seguenti è hq27d-m, dall’esecuzione del 2026-11-08):

text
Done: agent hqbirdfbagent-fb50 in /opt/hqbird/fbagent-fb50, Firebird 5.0.5.1917 in /opt/firebird (port 3050).
HQ Monitor: http://localhost:23050/ (login admin; password in /opt/hqbird/conf/access.properties)
RCM:        https://10.114.0.5:7444 (cluster hq27d-m)
CA hash:    sha256:9754e0be…087cb195
Login:      rcmadmin
Password:   in /opt/hqbird/fbagent-fb50/clusterca/hq27d-m/rcm-initial-password (read it with sudo; RCM asks for a new one at the first login)
Pairing:    not needed: this agent runs the RCM; other agents link through it
fbmcp:      2027.2.24, service running; local only (remote mode: sudo fbmcp ctl hqbird-install --allow-from CIDR)

Sulla replica:

text
RCM:        off; turn it on in HQbird Monitor or with fbagent --cluster-init <id>
Pairing:    port 7450 open until 2026-11-09T16:25:27Z (fingerprint sha256:0d137a71…09fe44cf); an RCM may invite this host

Un kit più vecchio stampa Pairing: not opened (this agent runs the RCM) sul master.

Annota le righe RCM: e CA hash: del master e la riga Pairing: della replica. Ti serve il fingerprint nel passaggio 3.

Kit più vecchi (agent precedente alla 3.1.0, per esempio il kit 2027.2.27) non pongono domande sul cluster. Installano RCM su ogni server e aprono la finestra di pairing ovunque. Usa l’RCM del master; l’RCM del secondo server si ferma da solo dopo il collegamento.

Successivamente, senza l’installer. In HQ Monitor del server, apri Clusters, sezione Cluster on this server. Sul master: Enable the cluster console (RCM); HQ Monitor apre 7443 e 7444 nel firewall. Sulla replica: Open the pairing window for 24 hours. Lo stesso con i comandi, come utente dell’agent:

Command
cd /opt/hqbird/fbagent-fb50
sudo -u firebird ./fbagent --cluster-init hq27d-m     # master; open 7443 and 7444 yourself
sudo -u firebird ./fbagent --cluster-pairing on       # replica

Mentre la finestra di pairing è aperta, l’agent apre la sua porta di pairing nel firewall. Chiude la porta quando la finestra termina o l’host è collegato.

L’output non contiene password. La password RCM è nel file della riga Password:, la password SYSDBA è in /root/fbagent-install-sysdba.txt, e la password di HQ Monitor è in /opt/hqbird/conf/access.properties.

Non devi installare una licenza: un nuovo agent avvia da solo una prova di 7 giorni, e i nodi del cluster funzionano.

Passaggio 2. Accedi a RCM

Apri l’indirizzo dalla riga RCM: del master. Se la porta 7444 è chiusa per il tuo PC, usa un tunnel SSH e https://localhost:7444:

Command
ssh -L 7444:127.0.0.1:7444 <user>@<master>

Se la porta 7444 è occupata sul tuo PC, usa un’altra porta locale, per esempio -L 17444:127.0.0.1:7444 e https://localhost:17444.

Il browser avverte sul certificato: la CA del cluster ha firmato il certificato RCM. La pagina di accesso mostra il Cluster CA hash: confrontalo con la riga CA hash: dell’output dell’installer. Se corrispondono, installa il certificato CA (il link Download the CA certificate (hqcluster-ca.crt) sulla stessa pagina) come attendibile, oppure accetta l’avviso. Se non corrispondono, non accedere e controlla l’indirizzo.

RCM sign-in
RCM sign-in

Il nome utente è rcmadmin. La password è nel file della riga Password::

Command
# the path is from the Password: line of your output
sudo cat /opt/hqbird/fbagent-fb50/clusterca/hq27d-m/rcm-initial-password

RCM chiede subito una nuova password (almeno 12 caratteri):

New password at the first sign-in
New password at the first sign-in

Un RCM precedente alla 2027.5.12 poteva ricaricare questa pagina ancora e ancora. RCM 2027.5.12 (kit 2027.2.33) ha la correzione.

Dopo il cambio della password, l’agent del master elimina da solo il file rcm-initial-password entro un minuto. Con un kit più vecchio, anche il secondo server ha un proprio RCM. Dopo il collegamento, l’agent sposta quel cluster precedente nella cartella cluster/left/. L’agent 3.1.0 elimina lì il suo rcm-initial-password; un agent più vecchio no. Allora elimina il file tu stesso:

Command
# on server 2, after step 3
sudo find /opt/hqbird -name rcm-initial-password
sudo rm <path from the find output>

Non eliminare il file /opt/hqbirdrcm/initial-admin.json: contiene solo l’hash della vecchia password, e senza di esso un RCM che ha perso il suo file utente parte con la password predefinita.

Dopo il cambio della password, RCM apre subito Settings → Link hosts: il cluster non ha ancora nodi. L’elenco Releases in the mirror mostra le release hqbirdrcm e hqclusternode da cui gli agent installano i nodi.

Collega gli host dopo l'accesso
Collega gli host dopo l'accesso

Passo 3. Collega gli host

La prima riga dell’elenco è già compilata (l’host RCM). Aggiungi una seconda riga: l’indirizzo della replica che il master può raggiungere. Inserisci un IP se i server non hanno un DNS comune: RCM mantiene la stringa così com’è, e i nodi si trovano l’un l’altro tramite essa.

Elenco degli host
Elenco degli host

Clicca Check hosts. Per un host senza porta, RCM legge le porte di pairing 7450–7459 e mostra una riga per ogni agente che risponde, come host:port (qui 10.114.0.6:7450). Scrivi host:port per leggere una sola porta. L’host RCM non necessita di una finestra di pairing: RCM trova il suo agente nel proprio registro. Confronta il Certificate fingerprint con l’output dell’installer (la riga Pairing: della replica): devono corrispondere. Lo stato del secondo host è Ready to link. La colonna Member ID mostra il nome che l’host riceve nel cluster: <host name>-<role>, per esempio hq27d-m-master. Il suffisso dell’istanza (-fb50) viene aggiunto solo quando l’host ha più agenti.

Verifica degli host
Verifica degli host

Ogni riga ha una casella di controllo, la porta, l’istanza e la porta del nodo. Link prende solo le righe selezionate. Una riga in errore non può essere selezionata e non blocca le altre. Sotto la tabella, RCM 2027.5.12 scrive righe come 10.114.0.6, no agent: closed or no answer: 7451-7459: indicano le porte di pairing dell’host su cui nessun altro agente risponde. Non sono errori.

Il master è l’host dove si troveranno i database di produzione. Clicca Link e conferma:

Conferma
Conferma

Avanzamento: “Joining → Joined → The node starts → Running”. Nell’esecuzione, il collegamento ha richiesto 56 secondi (l’esecuzione del 2026-11-17: 47 secondi).

Avanzamento del collegamento
Avanzamento del collegamento
Completato
Completato

La Overview ora mostra due nodi: il master e la replica. Subito dopo il collegamento, la replica può essere “stale” per un minuto; poi è “online”.

Overview: due nodi
Overview: due nodi

Se clicchi di nuovo Check hosts per un host già collegato, viene mostrato che nessun agente risponde sulle porte di pairing, o che l’host è irraggiungibile: la finestra di pairing su quell’host è chiusa, e così è la sua porta di pairing nel firewall. Questo non è un errore.

Un host in un cluster che ha un master. Un collegamento di una sola riga viene rifiutato con lone_master: specifica cosa diventa la riga. Aggiungi -replica-of <master member> per una replica di quel master, oppure -new-master (la casella di controllo nella pagina Link hosts) per un master proprio.

Passo 4. Cartella dei database sul master

Sul master, il database deve trovarsi in una cartella a cui l’utente firebird può accedere:

Command
sudo install -d -o firebird -g firebird -m 0770 /databases/master
# example: the sample database from the kit
sudo cp /opt/firebird/examples/empbuild/employee.fdb /databases/master/
sudo chown firebird:firebird /databases/master/employee.fdb

Non devi preparare nulla sulla replica: il pulsante Create folder nella finestra di dialogo Initialize crea la cartella per le copie (passo 6).

Passo 5. Registra i database sul master

Databases → nella tabella Nodes, nella riga del master → Enroll.

  • Folder path on that server: /databases/master, recursive.
  • Include file mask: *.fdb.
  • Sync tracking tables: le tabelle i cui conteggi di righe il pulsante Verify confronta. Imposti l’elenco per ogni database che registri. Lascia il campo vuoto: allora il database conta le proprie tabelle di pubblicazione. Per un database già gestito, modifica l’elenco nella pagina del database master.
Modulo di registrazione
Modulo di registrazione

Preview → seleziona i database → Enroll selected e conferma.

Conferma della registrazione
Conferma della registrazione

Il risultato è “Enrolled: 2.” e un suggerimento: Firebird del master deve essere riavviato. Il testo “No new databases matched.” sotto di esso non è un errore: i database sono già registrati.

Risultato della registrazione
Risultato della registrazione

I database attendono il riavvio:

In attesa del riavvio
In attesa del riavvio

Clicca Restart Firebird of the master nella riga di qualsiasi database del master (un solo riavvio è sufficiente per tutti) e conferma. Tutte le connessioni a Firebird del master si interrompono per alcuni secondi (4 secondi nell’esecuzione): scegli un momento opportuno.

Riavvio di Firebird del master
Riavvio di Firebird del master

Dopo il riavvio, il nodo master è CONFIGURED. Ogni database ha il badge publication OFF, e la replica mostra “not paired”.

Dopo il riavvio
Dopo il riavvio

Passo 6. Inizializza la replica

Nella riga del database, nella colonna della replica → Initialize. La finestra di dialogo ha il titolo “Initialize database?”.

Finestra di dialogo Initialize
Finestra di dialogo Initialize
  • Publication. Finché la pubblicazione del database è disattivata, Firebird non scrive le modifiche nel journal, e la replica non riceve nulla. La finestra di dialogo lo dice e mostra un pulsante Sync publication and initialize. Cliccalo: RCM aggiunge tutte le tabelle con una chiave primaria o unica alla pubblicazione e avvia subito l’inizializzazione. Il pulsante Initialize non aiuta mentre la pubblicazione è disattivata: il nodo master rifiuta (publication_off).
  • Replica folder: la finestra di dialogo propone /databases/replica/<replica node>, nell’esecuzione /databases/replica/hq27d-r-replica. Ogni nodo replica di un host necessita della propria cartella. Mantienila. Se il campo mostra “✗ The folder does not exist”, clicca Create folder; poi vedi “✓ The folder was created.” La copia va in /databases/replica/hq27d-r-replica/hq27d-m-master/. Per i successivi database la cartella è già impostata, e la finestra di dialogo non la modifica.
  • Method: Smooth (il valore predefinito). Controlla le transazioni di scrittura prima del lock. Standard blocca il database immediatamente.
  • Non hai bisogno delle caselle “Let … stop its Firebird for this reinit” e “Remove the old replica if space is short” per una nuova replica.

Riconnetti le applicazioni dopo la prima sincronizzazione della pubblicazione. Una connessione al database master aperta prima che la pubblicazione fosse attivata non viene registrata nel journal finché non si riconnette. Nell’esecuzione del 2026-11-17, una connessione aperta prima di Sync publication and initialize ha scritto circa 9.500 righe dopo la copia, e la replica non ne ha ricevuta nessuna. RCM mostrava “Ok” per entrambi i lati; solo Verify (passo 9) mostrava “Not ok (desynced)”. Le righe di una nuova connessione venivano replicate subito. Quindi, dopo la prima Sync publication di un database: riconnetti le applicazioni (o riavvia Firebird del master), poi esegui Verify senza scritture. Se la replica perde righe, esegui un reinit (passo 7).

Prima inizializzazione sotto carico. Finché l’archivio del master non ha ancora un segmento di journal, Smooth può rifiutare se il database è in fase di scrittura. La riga del database mostra long_transactions: … the archive holds no segment yet e un suggerimento nella lingua dell’interfaccia:

Rifiuto del metodo smooth
Rifiuto del metodo smooth

Nell’esecuzione, questo è accaduto anche dopo Sync publication and initialize (riscontro G-04 nel report). A questo punto la pubblicazione è già attiva. Attendi finché il database master mostra “archive: 1 seg” o più (15 secondi nell’esecuzione), e clicca di nuovo Initialize con il metodo Smooth. Oppure scegli Standard. Nell’esecuzione del 2026-11-17 (≈49 transazioni/s da una connessione), Smooth non è stato rifiutato.

L’avanzamento viene mostrato nella riga del database: SPACE CHECK → LOCKING → COPYING TO NODE (%) → UNLOCKING → SEEDING → RESTARTING REPLICA. L’avanzamento è visibile anche dopo un ricaricamento della pagina. Il pulsante Initialize è inattivo durante questo periodo.

Avanzamento dell'inizializzazione
Avanzamento dell'inizializzazione

Dopo la copia, il nodo replica riavvia Firebird della replica stessa al minuto pianificato. La riga indica quando; il pulsante Restart Firebird of the replica lo fa immediatamente. Tutte le connessioni a Firebird della replica si interrompono in questo momento.

In attesa del riavvio di Firebird della replica
In attesa del riavvio di Firebird della replica

Un database di grandi dimensioni funziona allo stesso modo. Nell’esecuzione, bulk.fdb (3,13 GB) è stato inizializzato con il pulsante Sync publication and initialize, senza alcun carico su di esso:

Copia del database di grandi dimensioni
Copia del database di grandi dimensioni

È completato quando il master e la replica mostrano “Ok”, e il “last applied seg” della replica raggiunge il “last seg” del master. Un database senza nuove scritture (qui bulk.fdb) mostra “Pending” con segmento 0 per la replica: questo è normale.

Entrambi i database pronti
Entrambi i database pronti

Misurazioni dell’esecuzione (employee.fdb sotto un carico di ≈55 transazioni/s):

Database Dimensione Master: dall’inizio alla fine Lock sul master Coppia “Ok”
employee.fdb 4 MB 0,7 s 0,35 s dopo ≈1 min (in attesa del riavvio della replica)
bulk.fdb 3,13 GB 64 s (≈55 MB/s) 59 s dopo ≈2 min

L’esecuzione del 2026-11-17 (kit 2027.2.33): employee.fdb (3 MB) ha richiesto 3 secondi

sul master, bulk.fdb (167 MB) 15 secondi. Il lato replica è stato accoppiato ≈40 secondi dopo l’avvio (attendeva il riavvio di Firebird della replica).

Durante il lock il database master funziona: le modifiche vanno nel file .delta.

Pubblicazione successiva. Serve il pulsante Sync publication di un database master quando nel database compaiono nuove tabelle. Fa corrispondere la pubblicazione alle tabelle in un’unica transazione; Firebird non si riavvia.

Sync publication
Sync publication

Publication tables mostra quali tabelle vengono replicate. Non puoi pubblicare una tabella senza chiave: assegnale una chiave primaria.

Publication tables
Publication tables

Passo 7. Reinizializzazione

Serve quando la replica differisce dal master, o quando il nodo la richiede (NEEDS_REINIT). Nella riga della replica → Reinit, metodo Smooth. C’è già un archivio dei segmenti, e il metodo smooth funziona sotto carico. Attende le transazioni di scrittura più vecchie della cronologia del journal e le mostra.

Reinit, smooth method
Reinit, smooth method

L’avanzamento è lo stesso dell’inizializzazione. Una reinizializzazione di solito non richiede un riavvio di Firebird della replica. Nell’esecuzione del 2026-11-17 la reinizializzazione di employee.fdb ha riavviato Firebird della replica: prevedi un' interruzione delle connessioni alla replica. Quella reinizializzazione ha impiegato 4 secondi sul master sotto ≈49 transazioni/s; dopo l’arresto delle scritture, i conteggi delle righe corrispondevano (14.418 righe nella tabella di carico su entrambi i lati).

Copy at the reinit
Copy at the reinit

Misure dell’esecuzione:

Database Carico Tempo Lock Altro
employee.fdb ≈55 transazioni/s 1,7 s 0,32 s 417 transazioni riprodotte dai segmenti
bulk.fdb nessuno 61 s 55 s nessun riavvio di Firebird della replica

Dopo una reinizializzazione smooth sotto carico, la replica può mostrare l’avviso info replication_conflict_resolved (“Record being inserted … already exists, updating instead”): la replica ha riprodotto transazioni già presenti nella copia. I dati corrispondono: nell’esecuzione, i conteggi delle righe di tutte le tabelle corrispondevano. Puoi confermare l’avviso (rilevamento G-07 nel report).

Passo 8. Spazio su disco insufficiente sulla replica

Il volume della replica necessita di ≥ 105 % della dimensione del database più 1 GB oltre la vecchia copia: la vecchia copia resta fino alla fine, e il nuovo file occupa la sua dimensione completa in una volta. Se lo spazio è insufficiente, la finestra di dialogo mostra quanto spazio serve, quanto è libero e quanto occupa la vecchia copia (una stima RCM; decide il nodo della replica). Se lo spazio è sufficiente senza la vecchia copia, la finestra di dialogo suggerisce la casella Remove the old replica if space is short.

Low space: the “Remove the old replica if space is short” box
Low space: the “Remove the old replica if space is short” box

Con la casella, il nodo della replica, dopo il lock sul master, arresta Firebird della replica, elimina la vecchia copia e riavvia Firebird. Nell' esecuzione (2,97 GB liberi, la nuova copia richiede 3,29 GB, la vecchia copia è 3,13 GB), la reinizializzazione di bulk.fdb con la casella ha impiegato 65 secondi. Senza la casella, il nodo rifiuta con insufficient disk space on replica.

La finestra di dialogo può non mostrare numeri quando manca solo il minimo di 1 GB. Nell' esecuzione del 2026-11-17 (1,1 GB liberi, il database è 167 MB) la finestra di dialogo non mostrava alcuna stima, e la reinizializzazione senza la casella è fallita in 3 secondi. La riga del database e la pagina Commands mostravano il motivo: insufficient disk space on replica: need 184125850 bytes (105% of the database) + 1073741824 bytes free_space_floor_gb; free 1152950272 … Removing the old replica copy would free 175357952 bytes: ask again with remove_old_replica. La stessa reinizializzazione con la casella ha impiegato 9 secondi.

Rischio della casella. Mentre la copia è in corso, non c’è replica di questo database. Se la reinizializzazione fallisce, la coppia è NEEDS_REINIT, la replica ha l’avviso replica_removed_for_reinit (warn), e un nuovo tentativo è una nuova reinizializzazione completa. Una reinizializzazione automatica elimina la vecchia copia solo se la chiave RCM auto_reinit.remove_old_replica_when_short è attiva (disattivata per impostazione predefinita).

Passo 9. Verifica

Verify nella riga della replica confronta COUNT(*) delle tabelle di tracciamento sul master e sulla replica. Non confronta le righe stesse. La riga “Table list source” indica l’elenco: l’elenco proprio del database, l' elenco del nodo, le tabelle della pubblicazione, o RDB$FIELDS. I conteggi delle righe hanno gruppi di cifre.

Sotto carico, la replica è indietro di qualche secondo, e Verify dà “Not ok” per le tabelle su cui si sta scrivendo:

Verify under load
Verify under load

Senza scritture, i conteggi corrispondono:

Verify without load
Verify without load

Una tabella che non è in nessuno dei due database è “not in the database”: questa non è una discrepanza. Una tabella presente solo su un lato è “no table”: questa è una discrepanza.

Un controllo più sicuro è il conteggio delle righe di tutte le tabelle su entrambi i lati dopo l’arresto delle scritture (lo script è nel hqbird2027-linux-cluster-runbook.md). Nell' esecuzione, tutte le 11 tabelle corrispondevano (employee.fdb: 10, bulk.fdb: 1, con 2.800.000 righe).

Il controllo periodico (Data check) è disattivato per impostazione predefinita. Fai clic su Turn on for all nodes e conferma: ogni nodo conta le sue righe, e il master confronta i conteggi. Non serve un riavvio: RCM mostra “Saved and in force now: the node needs no restart.” Il primo controllo viene eseguito un intervallo dopo (per impostazione predefinita 2 ore).

Periodic check
Periodic check

Cosa osservare in seguito

  • Overview: i nodi, il loro stato, la radice del database e lo spazio su disco.

    Overview
    Overview
  • Alerts: problemi dei nodi e dei database. L’esecuzione ha avuto due avvisi, e puoi confermarli entrambi: replication_conflict_resolved dopo la reinizializzazione smooth (passo 7), e parse_no_observations sul master (“no events parsed from /opt/firebird/replication.log”). Firebird del master scrive solo errori in replication.log, quindi un log vuoto è normale (rilevamento G-06 nel report).

    Alerts
    Alerts

    RCM 2027.5.12 e successivi (kit 2027.2.33) possono inviare gli avvisi di gravità warn e superiore a un bot Telegram tuo, a un webhook o via e-mail. Puoi impostare i canali nel file /opt/hqbirdrcm/rcm.json, chiave notify.channels, e riavviare RCM (sudo systemctl restart hqbirdrcm). Il blocco Notification channels di questa pagina elenca quindi i canali, ciascuno con un pulsante Send test. Senza alcun canale dice “No channel is configured: RCM sends its alerts nowhere.” Un canale Telegram:

    json
    "notify": { "channels": [ { "name": "ops", "type": "telegram",
        "token_file": "secrets/telegram-ops.token", "chat_id": "-1001234567890" } ] }

    L’esecuzione del 2026-11-17 ha verificato il blocco senza un canale; nessun messaggio è stato inviato.

  • Services (RCM 2027.5.11 e successivi, kit da 2027.2.31): il master, le repliche e i router di un servizio, e le operazioni switchover, failover e rejoin. Questa guida non le tratta: vedi la guida utente RCM. Aggiorna RCM e i nodi alla stessa versione prima di usarli.

  • Commands: ogni operazione RCM con il suo risultato. L’ora è l’ora locale del browser con il suo fuso orario (per esempio, 17:59:45 UTC+1); il tooltip mostra l’ora in UTC. I log dei nodi usano UTC.

    Commands
    Commands
  • HQ Monitor: http://<server>:23050/, nome utente admin, la password è in /opt/hqbird/conf/access.properties. Mostra il server e i database. Nei kit con agent 3.1.0 e successivi, HQ Monitor ha la pagina Clusters. Sul master (l’host RCM) mostra il cluster tramite l’agent, senza impostazioni RCM in HQ Monitor. Sulla replica indica l’host dell’RCM e collega alla sua console. HQ Monitor 1.49.0 non ha stato di replica né collegamento a RCM. Dal kit 2027.2.33 (agent 3.4.0) l’agent invia anche i problemi del suo server ai tuoi canali: Servers → Notifications.

Aggiornare il cluster

Aggiorna prima HQbird RCM, poi i nodi. Dal kit 2027.2.31, un server che non è collegato a nessun HQCenter aggiorna l’agent, HQ Monitor e fbmcp da solo (“Updates without HQCenter” in hqbird2027-linux-setup-guide.md); un server collegato a un HQCenter riceve i suoi aggiornamenti da quell’HQCenter.

Rimuovere un host dal cluster

Command
cd /opt/hqbird/fbagent-fb50
sudo ./fbagent --cluster-leave

L’agent si arresta e annulla la registrazione dei suoi servizi di nodo, chiude le loro porte di nodo, elimina i suoi certificati di cluster e imposta cluster.source su none. La cartella del nodo resta (--remove-data la elimina). L’agent che esegue l’RCM viene rifiutato. L’agent esce anche da solo quando RCM lo revoca o gli toglie il suo ultimo membro. Una disinstallazione lascia sempre il cluster: una reinstallazione nella stessa cartella parte libera. Nell’esecuzione del 2026-11-17 il comando ha stampato Cluster: left <cluster id>, i database della replica sono rimasti nella loro cartella, e RCM mostrava ancora il nodo di quell’host un minuto dopo. La rimozione di HQbird da un server del cluster, anche dal server che esegue l’RCM: hqbird2027-removal-guide.md, sezione 4.

Errori comuni

Cosa vedi Causa Cosa fare
publication_off all’inizializzazione la pubblicazione è disattivata, o non ha tabelle sebbene il database abbia tabelle con una chiave il pulsante Sync publication and initialize (passo 6)
long_transactions … the archive holds no segment yet prima inizializzazione con il metodo smooth mentre si sta scrivendo nel database, e l’archivio del master è vuoto attendi “archive: 1 seg” e riprova Smooth, oppure scegli Standard
reinit_pre_publication_transactions una transazione di scrittura è iniziata prima che la pubblicazione fosse attivata ed è aperta da più di un minuto concludila (COMMIT o ROLLBACK) e riprova
“✗ The folder does not exist on …” nella finestra di dialogo nessuno ha creato la cartella della replica il pulsante Create folder nella finestra di dialogo, oppure install -d -o firebird -g firebird -m 0770 <folder> sulla replica
“Not ok (desynced)” in Verify si sta scrivendo nel database, e la replica è indietro di secondi riprova senza carico; guarda la colonna Match
“Not ok (desynced)” in Verify senza scritture; entrambi i lati mostrano “Ok” una connessione dell’applicazione è stata aperta prima che la pubblicazione fosse attivata: non è registrata nel journal riconnetti l’applicazione, poi Reinit (passo 6, la nota sulla prima sincronizzazione della pubblicazione)

| Host “irraggiungibile” o “nessun agente” in Link hosts | la finestra di pairing dell’host è chiusa (disattivata per impostazione predefinita, oppure le 24 h sono terminate), oppure un firewall tra i server chiude le porte 7450–7459 | apri la finestra sull’host: HQ Monitor → Clusters → Open the pairing window for 24 hours, oppure fbagent --cluster-pairing on; apri la porta nel firewall cloud | | insufficient disk space on replica durante una reinizializzazione | la vecchia replica resta fino alla fine, e il nuovo file occupa la sua dimensione completa | libera ≥ 105 % della dimensione del database + 1 GB oltre il vecchio file sul volume della replica, oppure la casella Remove the old replica if space is short (passo 8) | | Il nodo non compare dopo Link hosts | il mirror RCM non ha una release hqclusternode firmata | Releases in the mirror nella pagina Link hosts (passo 2) |