Cluster HQbird 2027 su Linux: master e replica con RCM
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
.deltacresce durante il lock). Replica: libero ≥ 105 % della dimensione del database più il minimolimits.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:
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.runIn 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.
sudo sh hqbird2027-fb50-linux-$V.run --rcm on # master
sudo sh hqbird2027-fb50-linux-$V.run --cluster-pairing on # replicaL’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):
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:
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 hostUn 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:
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 # replicaMentre 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:
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.
Il nome utente è rcmadmin. La password è nel file della riga Password::
# the path is from the Password: line of your output
sudo cat /opt/hqbird/fbagent-fb50/clusterca/hq27d-m/rcm-initial-passwordRCM chiede subito una nuova password (almeno 12 caratteri):
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:
# 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.
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.
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.
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:
Avanzamento: “Joining → Joined → The node starts → Running”. Nell’esecuzione, il collegamento ha richiesto 56 secondi (l’esecuzione del 2026-11-17: 47 secondi).
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”.
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:
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.fdbNon 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.
Preview → seleziona i database → Enroll selected e conferma.
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.
I database attendono il 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.
Dopo il riavvio, il nodo master è CONFIGURED. Ogni database ha il
badge publication OFF, e la replica mostra “not paired”.
Passo 6. Inizializza la replica
Nella riga del database, nella colonna della replica → Initialize. La finestra di dialogo ha il titolo “Initialize database?”.
- 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:
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.
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.
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:
È 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.
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.
Publication tables mostra quali tabelle vengono replicate. Non puoi pubblicare una tabella senza chiave: assegnale una chiave primaria.
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.
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).
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.
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’avvisoreplica_removed_for_reinit(warn), e un nuovo tentativo è una nuova reinizializzazione completa. Una reinizializzazione automatica elimina la vecchia copia solo se la chiave RCMauto_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:
Senza scritture, i conteggi corrispondono:
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).
Cosa osservare in seguito
-
Overview: i nodi, il loro stato, la radice del database e lo spazio su disco.
Overview -
Alerts: problemi dei nodi e dei database. L’esecuzione ha avuto due avvisi, e puoi confermarli entrambi:
replication_conflict_resolveddopo la reinizializzazione smooth (passo 7), eparse_no_observationssul master (“no events parsed from /opt/firebird/replication.log”). Firebird del master scrive solo errori inreplication.log, quindi un log vuoto è normale (rilevamento G-06 nel report).
Alerts RCM 2027.5.12 e successivi (kit 2027.2.33) possono inviare gli avvisi di gravità
warne superiore a un bot Telegram tuo, a un webhook o via e-mail. Puoi impostare i canali nel file/opt/hqbirdrcm/rcm.json, chiavenotify.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:"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 -
HQ Monitor:
http://<server>:23050/, nome utenteadmin, 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
cd /opt/hqbird/fbagent-fb50
sudo ./fbagent --cluster-leaveL’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) |