Esta página fue traducida automáticamente. Lee el original en inglés. English

Otros idiomas: Русский, Português.

Esta guía va desde dos servidores limpios hasta una réplica de Firebird 5.0 en funcionamiento. Todo se hace en el navegador, en la consola de RCM, excepto la instalación y una carpeta. Las capturas de pantalla provienen de la ejecución del 2026-11-17: kit 2027.2.33, RCM y nodos 2027.5.12, Ubuntu 24.04, la interfaz en inglés. El informe de la ejecución anterior del 2026-11-08: hqbird2027-rcm-cluster-check-report.ru.md (en ruso, sección «Прогон 2»). Solo comandos, sin capturas de pantalla: hqbird2027-linux-cluster-runbook.md. Cada página de RCM en detalle: la guía de usuario de RCM (repositorio hqcluster-node, docs/user-guide/).

Esta guía es para el kit 2027.2.24 y posteriores. Para el kit 2027.2.22, consulte la edición de este archivo del 2026-11-07 en el historial de git.

El kit que hay que descargar es 2027.2.33 (2026-11-16): agent 3.4.0, HQ Monitor 1.57.0, RCM y nodos 2027.5.12, Firebird 5.0.5.1917. Esta guía se comprobó con él el 2026-11-17 (dos servidores, Ubuntu 24.04, bases de datos de 3 MB y 167 MB): todos los pasos pasaron. El texto denomina los resultados de esa ejecución como “la ejecución del 2026-11-17”. Las capturas de pantalla provienen de una segunda pasada de ese día con el mismo kit (bases de datos de 3 MB y 2.88 GB). Las demás cifras siguen proviniendo de la ejecución del 2026-11-08. Qué cambiaron los kits posteriores a 2027.2.27 para un clúster:

Kit Cambio
2027.2.29 (agent 3.1.0, RCM 2027.5.9) Sin clúster por defecto (ver más abajo). Varios agentes de un mismo host pueden unirse a un clúster: cada uno tiene su propio puerto de emparejamiento (7450–7459) y puerto de nodo. fbagent --cluster-leave. La página Clusters de HQ Monitor
2027.2.30 (RCM 2027.5.10) Switchover y failover de un servicio, routers
2027.2.31 (agent 3.3.0, RCM 2027.5.11) El instalador abre una interfaz de texto en un terminal (paso 1). Las páginas Services de RCM. Un servidor que no está vinculado a ningún HQCenter actualiza el agent, HQ Monitor y fbmcp por sí mismo
2027.2.33 (agent 3.4.0, RCM 2027.5.12) RCM envía sus alertas a Telegram, a un webhook o por correo electrónico (“Qué observar a continuación”). Un clúster de dos contenedores Docker: guía de Docker

Todos los cambios: What’s New.

Los kits con agent (fbagent) 3.1.0 y posteriores (a partir de 2027.2.29) no crean clúster por defecto: ni RCM, ni ventana de emparejamiento, y los puertos del clúster permanecen cerrados en el firewall. En el paso 1 se activa RCM en el maestro y el modo de descubrimiento en la réplica.

Tiempo: ≈30 minutos más la copia de las bases de datos (≈1 minuto por cada 3 GB en una red de 1 Gbit/s).

Qué se obtiene

Servidor 1 Servidor 2
Rol maestro + consola RCM réplica
Bases de datos /databases/master/*.fdb /databases/replica/<replica node>/<master node>/*.fdb
Servicios firebird, hqbirdfbagent-fb50, hqbirdmonitor-fb50, fbmcp, hqbirdrcm, hqclusternode-master-p3050 los mismos, pero hqclusternode-replica-p3050 y sin hqbirdrcm (un kit anterior deja allí su propio RCM, detenido)

Qué se necesita

  • Dos servidores Linux x86-64 (comprobados en Ubuntu 24.04), 2 núcleos, 4 GB de memoria.
  • Espacio en disco. Maestro: libre ≥ 105 % del tamaño de la base de datos (el archivo .delta crece durante el bloqueo). Réplica: libre ≥ 105 % del tamaño de la base de datos más el mínimo limits.free_space_floor_gb (por defecto 1 GB). Una reinicialización sobre una réplica existente conserva el archivo antiguo hasta el final, por lo que el volumen de la réplica necesita aproximadamente 2 × el tamaño de la base de datos. Con la casilla Remove the old replica if space is short (paso 8), basta con el 105 % más el mínimo.
  • Red entre los servidores: puertos 3050, 7051, 7443, 7444, 7450. Estos son los puertos de la primera instancia de un servidor (slot 0). Una segunda instancia de un servidor usa el puerto de emparejamiento 7451 y el puerto de nodo 7052.
  • Su PC puede alcanzar el puerto 7444 del maestro (la consola de RCM), directamente o mediante un túnel SSH.
  • Un usuario con sudo.

Firewall. El instalador abre puertos en un firewalld o ufw habilitado (con cualquier idioma del sistema): 3050 y 23050 siempre, los puertos del clúster solo para las opciones del paso 1. Maestro: 7443, 7444, 7051. Réplica: 7450, 7051. El agent vuelve a cerrar 7450 cuando termina la ventana de emparejamiento o el host está vinculado. En Ubuntu, ufw suele estar deshabilitado. Entonces el instalador escribe una línea, por ejemplo en el maestro: 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. En la nube, cierre los puertos con el firewall de la nube: desde fuera, solo su dirección; entre los servidores, la red interna.

A continuación figuran las direcciones de la ejecución: maestro 10.114.0.5, réplica 10.114.0.6 (red privada). Utilice sus propias direcciones.

Paso 1. Instalar en ambos servidores

En cada servidor:

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

En un terminal, el instalador abre su interfaz de texto (kits a partir de 2027.2.31). La primera página tiene la línea Cluster RCM off, discovery mode off. Abra Cluster y cambie una línea:

Línea de la página Cluster Maestro Réplica
Cluster manager (RCM) on off
Discovery mode (24 h) off (este agent ejecuta el RCM) on

Las líneas Cluster id (por defecto: el nombre del host), RCM admin password (por defecto: generada) y Pairing port (por defecto: el primero libre, 7450) pueden quedar como están. Vuelva atrás (Esc) y elija Install. El instalador muestra el plan: pulse Enter. Luego pregunta Nothing on this host was changed yet. Start the install now?. El cursor está en No: muévalo a Yes y pulse Enter. El instalador añade las bibliotecas que faltan (por ejemplo, libtommath1) por sí mismo. La interfaz de texto completa: hqbird2027-linux-setup-guide.md.

Con --no-tui, y en los kits 2027.2.29–2027.2.30, el instalador hace preguntas. La primera es Install as planned? Yes/No: responda y. Luego hace dos preguntas sobre el clúster. La respuesta es No por defecto (Enter):

Pregunta Maestro Réplica
Install the cluster manager (RCM) on this host and make a new cluster? [y/N] y Enter (No)
Turn on discovery mode for 24 hours (an RCM on the network may invite this agent into its cluster; port 7450)? [y/N] no se pregunta: este agent ejecuta el RCM y

O dé las respuestas como opciones: en un terminal establecen los valores de la página Cluster antes de que se abra. Úselas también para una ejecución sin terminal: --yes por sí solo significa No para ambas.

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

La instalación tarda aproximadamente un minuto (la ejecución del 2026-11-17: 61 segundos en el maestro, 43 segundos en la réplica). El final de la salida en el maestro con el kit 2027.2.33 (el hash está acortado aquí; el id del clúster de los ejemplos siguientes es hq27d-m, de la ejecución 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)

En la réplica:

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 anterior imprime Pairing: not opened (this agent runs the RCM) en el maestro.

Anote las líneas RCM: y CA hash: del maestro y la línea Pairing: de la réplica. Necesita el fingerprint en el paso 3.

Kits anteriores (agent anterior a 3.1.0, por ejemplo el kit 2027.2.27) no hacen preguntas sobre el clúster. Instalan RCM en cada servidor y abren la ventana de emparejamiento en todas partes. Use el RCM del maestro; el RCM del segundo servidor se detiene por sí mismo tras el vínculo.

Más adelante, sin el instalador. En HQ Monitor del servidor, abra Clusters, sección Cluster on this server. En el maestro: Enable the cluster console (RCM); HQ Monitor abre 7443 y 7444 en el firewall. En la réplica: Open the pairing window for 24 hours. Lo mismo con comandos, como el usuario del 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

Mientras la ventana de emparejamiento está abierta, el agent abre su puerto de emparejamiento en el firewall. Cierra el puerto cuando termina la ventana o el host está vinculado.

La salida no contiene contraseñas. La contraseña de RCM está en el archivo de la línea Password:, la contraseña de SYSDBA está en /root/fbagent-install-sysdba.txt, y la contraseña de HQ Monitor está en /opt/hqbird/conf/access.properties.

No es necesario instalar una licencia: un agent nuevo inicia una prueba de 7 días por sí mismo, y los nodos del clúster funcionan.

Paso 2. Iniciar sesión en RCM

Abra la dirección de la línea RCM: del maestro. Si el puerto 7444 está cerrado para su PC, use un túnel SSH y https://localhost:7444:

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

Si el puerto 7444 está ocupado en su PC, use otro puerto local, por ejemplo -L 17444:127.0.0.1:7444 y https://localhost:17444.

El navegador advierte sobre el certificado: la CA del clúster firmó el certificado de RCM. La página de inicio de sesión muestra el Cluster CA hash: compárelo con la línea CA hash: de la salida del instalador. Si coinciden, instale el certificado de la CA (el enlace Download the CA certificate (hqcluster-ca.crt) en la misma página) como de confianza, o acepte la advertencia. Si no coinciden, no inicie sesión, y compruebe la dirección.

RCM sign-in
RCM sign-in

El nombre de usuario es rcmadmin. La contraseña está en el archivo de la línea 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 pide una nueva contraseña de inmediato (al menos 12 caracteres):

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

Un RCM anterior a 2027.5.12 podía cargar esta página una y otra vez. RCM 2027.5.12 (kit 2027.2.33) tiene la corrección.

Tras el cambio de contraseña, el agent del maestro elimina el archivo rcm-initial-password por sí mismo en el plazo de un minuto. Con un kit anterior, el segundo servidor también tiene un RCM propio. Tras el vínculo, el agent mueve ese clúster anterior a la carpeta cluster/left/. El agent 3.1.0 elimina su rcm-initial-password allí; un agent anterior no lo hace. Entonces elimine el archivo usted mismo:

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

No elimine el archivo /opt/hqbirdrcm/initial-admin.json: solo contiene el hash de la contraseña antigua, y sin él un RCM que perdió su archivo de usuario arranca con la contraseña por defecto.

Tras el cambio de contraseña, RCM abre Settings → Link hosts de inmediato: el clúster aún no tiene nodos. La lista Releases in the mirror muestra las versiones de hqbirdrcm y hqclusternode desde las que los agents instalan los nodos.

Vincular hosts después del inicio de sesión
Vincular hosts después del inicio de sesión

Paso 3. Vincular los hosts

La primera fila de la lista ya está completada (el host RCM). Añada una segunda fila: la dirección de la réplica a la que el maestro puede llegar. Introduzca una IP si los servidores no tienen un DNS común: RCM mantiene la cadena tal cual, y los nodos se encuentran entre sí mediante ella.

Lista de hosts
Lista de hosts

Haga clic en Check hosts. Para un host sin puerto, RCM lee los puertos de emparejamiento 7450–7459 y muestra una fila por cada agente que responde, como host:port (aquí 10.114.0.6:7450). Escriba host:port para leer un solo puerto. El host RCM no necesita ventana de emparejamiento: RCM encuentra su agente en su propio registro. Compare el Certificate fingerprint con la salida del instalador (la línea Pairing: de la réplica): deben coincidir. El estado del segundo host es Ready to link. La columna Member ID muestra el nombre que recibe el host en el clúster: <host name>-<role>, por ejemplo hq27d-m-master. El sufijo de instancia (-fb50) se añade solo cuando el host tiene varios agentes.

Comprobación de los hosts
Comprobación de los hosts

Cada fila tiene una casilla de verificación, el puerto, la instancia y el puerto del nodo. Link toma solo las filas marcadas. Una fila con error no se puede marcar y no detiene a las demás. Bajo la tabla, RCM 2027.5.12 escribe líneas como 10.114.0.6, no agent: closed or no answer: 7451-7459: nombran los puertos de emparejamiento del host donde no responde ningún otro agente. No son errores.

El master es el host donde estarán las bases de datos de producción. Haga clic en Link y confirme:

Confirmación
Confirmación

Progreso: «Joining → Joined → The node starts → Running». En la ejecución, la vinculación tardó 56 segundos (la ejecución del 2026-11-17: 47 segundos).

Progreso de la vinculación
Progreso de la vinculación
Hecho
Hecho

La Overview ahora muestra dos nodos: el maestro y la réplica. Justo después de la vinculación, la réplica puede estar «stale» durante un minuto; luego está «online».

Overview: dos nodos
Overview: dos nodos

Si hace clic de nuevo en Check hosts para un host que ya está vinculado, muestra que ningún agente responde en los puertos de emparejamiento, o que el host es inaccesible: la ventana de emparejamiento en ese host está cerrada, y también lo está su puerto de emparejamiento en el firewall. Esto no es un error.

Un host en un clúster que tiene un maestro. Una vinculación de una fila se rechaza con lone_master: indique qué será la fila. Añada -replica-of <master member> para una réplica de ese maestro, o -new-master (la casilla en la página Link hosts) para un maestro propio.

Paso 4. Carpeta de bases de datos en el maestro

En el master, la base de datos debe estar en una carpeta a la que el usuario firebird pueda acceder:

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

No necesita preparar nada en la réplica: el botón Create folder del diálogo Initialize crea la carpeta para las copias (paso 6).

Paso 5. Registrar las bases de datos en el maestro

Databases → en la tabla Nodes, en la fila del maestro → Enroll.

  • Folder path on that server: /databases/master, recursive.
  • Include file mask: *.fdb.
  • Sync tracking tables: las tablas cuyos recuentos de filas compara el botón Verify. Usted establece la lista para cada base de datos que registra. Deje el campo vacío: entonces la base de datos cuenta sus tablas de publicación. Para una base de datos que ya está gestionada, cambie la lista en la página de la base de datos maestra.
Formulario de registro
Formulario de registro

Preview → seleccione las bases de datos → Enroll selected y confirme.

Confirmación del registro
Confirmación del registro

El resultado es «Enrolled: 2.» y una sugerencia: Firebird del maestro debe reiniciarse. El texto «No new databases matched.» debajo no es un error: las bases de datos ya están registradas.

Resultado del registro
Resultado del registro

Las bases de datos esperan el reinicio:

Espera el reinicio
Espera el reinicio

Haga clic en Restart Firebird of the master en la fila de cualquier base de datos del maestro (un reinicio basta para todas ellas) y confirme. Todas las conexiones a Firebird del maestro se interrumpen durante unos segundos (4 segundos en la ejecución): elija un buen momento.

Reinicio de Firebird del maestro
Reinicio de Firebird del maestro

Tras el reinicio, el nodo maestro está CONFIGURED. Cada base de datos tiene la insignia publication OFF, y la réplica muestra «not paired».

Después del reinicio
Después del reinicio

Paso 6. Inicializar la réplica

En la fila de la base de datos, en la columna de la réplica → Initialize. El diálogo tiene el título «Initialize database?».

Diálogo Initialize
Diálogo Initialize
  • Publication. Mientras la publicación de la base de datos está desactivada, Firebird no escribe los cambios en el journal, y la réplica no recibe nada. El diálogo lo indica y muestra un botón Sync publication and initialize. Haga clic en él: RCM añade todas las tablas con clave primaria o única a la publicación e inicia la inicialización de inmediato. El botón Initialize no ayuda mientras la publicación está desactivada: el nodo maestro lo rechaza (publication_off).
  • Replica folder: el diálogo propone /databases/replica/<replica node>, en la ejecución /databases/replica/hq27d-r-replica. Cada nodo de réplica de un host necesita su propia carpeta. Consérvela. Si el campo muestra «✗ The folder does not exist», haga clic en Create folder; entonces verá «✓ The folder was created.» La copia va a /databases/replica/hq27d-r-replica/hq27d-m-master/. Para las siguientes bases de datos la carpeta ya está establecida, y el diálogo no la cambia.
  • Method: Smooth (el predeterminado). Comprueba las transacciones de escritura antes del bloqueo. Standard bloquea la base de datos de inmediato.
  • No necesita las casillas «Let … stop its Firebird for this reinit» y «Remove the old replica if space is short» para una réplica nueva.

Reconecte las aplicaciones después de la primera sincronización de publicación. Una conexión a la base de datos maestra que se abrió antes de que la publicación estuviera activada no se registra en el journal hasta que se vuelve a conectar. En la ejecución del 2026-11-17, una conexión que se abrió antes de Sync publication and initialize escribió unas 9.500 filas después de la copia, y la réplica no recibió ninguna de ellas. RCM mostró «Ok» para ambos lados; solo Verify (paso 9) mostró «Not ok (desynced)». Las filas de una conexión nueva se replicaron de inmediato. Por lo tanto, después de la primera Sync publication de una base de datos: reconecte las aplicaciones (o reinicie Firebird del maestro), luego ejecute Verify sin escrituras. Si la réplica pierde filas, ejecute una reinicialización (paso 7).

Primera inicialización bajo carga. Mientras el archivo del maestro no tiene aún ningún segmento de journal, Smooth puede rechazar si se está escribiendo en la base de datos. La fila de la base de datos muestra long_transactions: … the archive holds no segment yet y una sugerencia en el idioma de la interfaz:

Rechazo del método smooth
Rechazo del método smooth

En la ejecución, esto ocurrió también después de Sync publication and initialize (hallazgo G-04 en el informe). La publicación ya está activada en este punto. Espere hasta que la base de datos maestra muestre «archive: 1 seg» o más (15 segundos en la ejecución), y haga clic en Initialize de nuevo con el método Smooth. O elija Standard. En la ejecución del 2026-11-17 (≈49 transacciones/s desde una conexión), Smooth no fue rechazado.

El progreso se muestra en la fila de la base de datos: SPACE CHECK → LOCKING → COPYING TO NODE (%) → UNLOCKING → SEEDING → RESTARTING REPLICA. El progreso es visible también tras recargar la página. El botón Initialize está inactivo durante este tiempo.

Progreso de la inicialización
Progreso de la inicialización

Tras la copia, el nodo de réplica reinicia Firebird de la réplica por sí mismo en el minuto planificado. La fila indica cuándo; el botón Restart Firebird of the replica lo hace de inmediato. Todas las conexiones a Firebird de la réplica se interrumpen en ese momento.

Espera el reinicio de Firebird de la réplica
Espera el reinicio de Firebird de la réplica

Una base de datos grande funciona de la misma manera. En la ejecución, bulk.fdb (3,13 GB) se inicializó con el botón Sync publication and initialize, sin carga sobre ella:

Copia de la base de datos grande
Copia de la base de datos grande

Está hecho cuando el maestro y la réplica muestran «Ok», y el «last applied seg» de la réplica alcanza el «last seg» del maestro. Una base de datos sin nuevas escrituras (aquí bulk.fdb) muestra «Pending» con el segmento 0 para la réplica: esto es normal.

Ambas bases de datos listas
Ambas bases de datos listas

Mediciones de la ejecución (employee.fdb bajo una carga de ≈55 transacciones/s):

Base de datos Tamaño Maestro: de inicio a fin Bloqueo en el maestro Par «Ok»
employee.fdb 4 MB 0,7 s 0,35 s tras ≈1 min (esperó el reinicio de la réplica)
bulk.fdb 3,13 GB 64 s (≈55 MB/s) 59 s tras ≈2 min

La ejecución del 2026-11-17 (kit 2027.2.33): employee.fdb (3 MB) tardó 3 segundos

en el maestro, bulk.fdb (167 MB) 15 segundos. El lado de la réplica se emparejó ≈40 segundos después del inicio (esperó el reinicio de Firebird de la réplica).

Durante el bloqueo la base de datos maestra funciona: los cambios van al archivo .delta.

Publicación posterior. Necesita el botón Sync publication de una base de datos maestra cuando aparecen nuevas tablas en la base de datos. Hace que la publicación coincida con las tablas en una sola transacción; Firebird no se reinicia.

Sync publication
Sync publication

Publication tables muestra qué tablas se replican. No puede publicar una tabla sin una clave: asígnele una clave primaria.

Publication tables
Publication tables

Paso 7. Reinitialization

Lo necesita cuando la réplica difiere del maestro, o cuando el nodo lo solicita (NEEDS_REINIT). En la fila de la réplica → Reinit, método Smooth. Ya hay un archivo de segmentos, y el método smooth funciona bajo carga. Espera a las transacciones de escritura que son más antiguas que el historial del journal, y las muestra.

Reinit, smooth method
Reinit, smooth method

El progreso es el mismo que en la inicialización. Un reinit normalmente no necesita un reinicio de Firebird de la réplica. En la ejecución del 2026-11-17 el reinit de employee.fdb sí reinició Firebird de la réplica: prevea una interrupción de las conexiones a la réplica. Ese reinit tomó 4 segundos en el maestro bajo ≈49 transacciones/s; después de que se detuvieran las escrituras, los recuentos de filas coincidieron (14.418 filas en la tabla de carga en ambos lados).

Copy at the reinit
Copy at the reinit

Mediciones de la ejecución:

Base de datos Carga Tiempo Bloqueo Otro
employee.fdb ≈55 transacciones/s 1,7 s 0,32 s 417 transacciones reproducidas desde los segmentos
bulk.fdb ninguna 61 s 55 s sin reinicio de Firebird de la réplica

Después de un reinit smooth bajo carga, la réplica puede mostrar la alerta info replication_conflict_resolved (“Record being inserted … already exists, updating instead”): la réplica reprodujo transacciones que ya estaban en la copia. Los datos coinciden: en la ejecución, los recuentos de filas de todas las tablas coincidieron. Puede reconocer la alerta (hallazgo G-07 en el informe).

Paso 8. Poco espacio en disco en la réplica

El volumen de la réplica necesita ≥ 105 % del tamaño de la base de datos más 1 GB por encima de la copia antigua: la copia antigua permanece hasta el final, y el nuevo archivo toma su tamaño completo de una vez. Si el espacio es escaso, el diálogo muestra cuánto espacio se necesita, cuánto está libre y cuánto ocupa la copia antigua (una estimación del RCM; el nodo de la réplica decide). Si el espacio es suficiente sin la copia antigua, el diálogo sugiere la casilla 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 casilla, el nodo de la réplica, después del bloqueo en el maestro, detiene Firebird de la réplica, elimina la copia antigua y vuelve a iniciar Firebird. En la ejecución (2,97 GB libres, la nueva copia necesita 3,29 GB, la copia antigua es de 3,13 GB), el reinit de bulk.fdb con la casilla tomó 65 segundos. Sin la casilla, el nodo se niega con insufficient disk space on replica.

El diálogo puede no mostrar números cuando solo falta el mínimo de 1 GB. En la ejecución del 2026-11-17 (1,1 GB libres, la base de datos es de 167 MB) el diálogo no mostró ninguna estimación, y el reinit sin la casilla falló en 3 segundos. La fila de la base de datos y la página Commands mostraron el 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. El mismo reinit con la casilla tomó 9 segundos.

Riesgo de la casilla. Mientras se ejecuta la copia, no hay réplica de esta base de datos. Si el reinit falla, el par queda en NEEDS_REINIT, la réplica tiene la alerta replica_removed_for_reinit (warn), y un reintento es un nuevo reinit completo. Un reinit automático elimina la copia antigua solo si la clave del RCM auto_reinit.remove_old_replica_when_short está activada (desactivada por defecto).

Paso 9. Verification

Verify en la fila de la réplica compara COUNT(*) de las tablas de seguimiento en el maestro y en la réplica. No compara las filas en sí. La línea “Table list source” nombra la lista: la lista propia de la base de datos, la lista del nodo, las tablas de la publicación, o RDB$FIELDS. Los recuentos de filas tienen grupos de dígitos.

Bajo carga, la réplica va unos segundos por detrás, y Verify da “Not ok” para las tablas en las que se está escribiendo:

Verify under load
Verify under load

Sin escrituras, los recuentos coinciden:

Verify without load
Verify without load

Una tabla que no está en ninguna de las dos bases de datos es “not in the database”: esto no es una discrepancia. Una tabla en un solo lado es “no table”: esto es una discrepancia.

Una comprobación más segura es el recuento de filas de todas las tablas en ambos lados después de que se detengan las escrituras (el script está en el hqbird2027-linux-cluster-runbook.md). En la ejecución, las 11 tablas coincidieron (employee.fdb: 10, bulk.fdb: 1, con 2.800.000 filas).

La comprobación periódica (Data check) está desactivada por defecto. Haga clic en Turn on for all nodes y confirme: cada nodo cuenta sus filas, y el maestro compara los recuentos. No necesita un reinicio: el RCM muestra “Saved and in force now: the node needs no restart.” La primera comprobación se ejecuta un intervalo después (por defecto 2 horas).

Periodic check
Periodic check

Qué observar a continuación

  • Overview: los nodos, su estado, la raíz de la base de datos y el espacio en disco.

    Overview
    Overview
  • Alerts: problemas de nodos y bases de datos. La ejecución tuvo dos alertas, y puede reconocer ambas: replication_conflict_resolved después del reinit smooth (paso 7), y parse_no_observations en el maestro (“no events parsed from /opt/firebird/replication.log”). Firebird del maestro escribe solo errores en replication.log, así que un log vacío es normal (hallazgo G-06 en el informe).

    Alerts
    Alerts

    RCM 2027.5.12 y posteriores (kit 2027.2.33) pueden enviar las alertas de gravedad warn y superior a un bot de Telegram propio, un webhook o correo electrónico. Usted configura los canales en el archivo /opt/hqbirdrcm/rcm.json, clave notify.channels, y reinicia el RCM (sudo systemctl restart hqbirdrcm). El bloque Notification channels de esta página entonces lista los canales, cada uno con un botón Send test. Sin ningún canal dice “No channel is configured: RCM sends its alerts nowhere.” Un canal de Telegram:

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

    La ejecución del 2026-11-17 comprobó el bloque sin ningún canal; no se envió ningún mensaje.

  • Services (RCM 2027.5.11 y posteriores, kits desde 2027.2.31): el maestro, las réplicas y los routers de un servicio, y las operaciones switchover, failover y rejoin. Esta guía no las cubre: consulte la guía de usuario del RCM. Actualice el RCM y los nodos a la misma versión antes de usarlas.

  • Commands: cada operación del RCM con su resultado. La hora es la hora local del navegador con su zona (por ejemplo, 17:59:45 UTC+1); la información emergente muestra la hora en UTC. Los logs de los nodos usan UTC.

    Commands
    Commands
  • HQ Monitor: http://<server>:23050/, usuario admin, la contraseña está en /opt/hqbird/conf/access.properties. Muestra el servidor y las bases de datos. En los kits con agente 3.1.0 y posteriores, HQ Monitor tiene la página Clusters. En el maestro (el host del RCM) muestra el clúster a través del agente, sin ajustes del RCM en HQ Monitor. En la réplica nombra el host del RCM y enlaza a su consola. HQ Monitor 1.49.0 no tiene estado de replicación ni enlace al RCM. Desde el kit 2027.2.33 (agente 3.4.0) el agente envía los problemas de su servidor también a sus canales: Servers → Notifications.

Actualizar el clúster

Actualice primero HQbird RCM, luego los nodos. Desde el kit 2027.2.31, un servidor que no está adjunto a ningún HQCenter actualiza el agente, HQ Monitor y fbmcp por sí mismo (“Updates without HQCenter” en hqbird2027-linux-setup-guide.md); un servidor adjunto a un HQCenter toma sus actualizaciones de ese HQCenter.

Sacar un host del clúster

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

El agente se detiene y desregistra sus servicios de nodo, cierra sus puertos de nodo, elimina sus certificados de clúster y establece cluster.source en none. La carpeta del nodo permanece (--remove-data la elimina). El agente que ejecuta el RCM es rechazado. El agente también se va por sí mismo cuando el RCM lo revoca o le quita su último miembro. Una desinstalación siempre abandona el clúster: una reinstalación en la misma carpeta comienza libre. En la ejecución del 2026-11-17 el comando imprimió Cluster: left <cluster id>, las bases de datos de la réplica permanecieron en su carpeta, y el RCM seguía mostrando el nodo de ese host un minuto después. La eliminación de HQbird de un servidor del clúster, también del servidor que ejecuta el RCM: hqbird2027-removal-guide.md, sección 4.

Errores comunes

Lo que ve Causa Qué hacer
publication_off en la inicialización la publicación está desactivada, o no tiene ninguna tabla aunque la base de datos tiene tablas con una clave el botón Sync publication and initialize (paso 6)
long_transactions … the archive holds no segment yet primera inicialización con el método smooth mientras se está escribiendo en la base de datos, y el archivo del maestro está vacío espere a “archive: 1 seg” y reintente Smooth, o elija Standard
reinit_pre_publication_transactions una transacción de escritura comenzó antes de que se activara la publicación y está abierta más de un minuto termínela (COMMIT o ROLLBACK) y reintente
“✗ The folder does not exist on …” en el diálogo nadie creó la carpeta de la réplica el botón Create folder en el diálogo, o install -d -o firebird -g firebird -m 0770 <folder> en la réplica
“Not ok (desynced)” en Verify se está escribiendo en la base de datos, y la réplica va segundos por detrás reintente sin carga; mire la columna Match
“Not ok (desynced)” en Verify sin escrituras; ambos lados muestran “Ok” se abrió una conexión de aplicación antes de que se activara la publicación: no está registrada en el journal reconecte la aplicación, luego Reinit (paso 6, la nota sobre la primera sincronización de la publicación)

| Host “unreachable” o “no agent” en Link hosts | la ventana de emparejamiento del host está cerrada (desactivada por defecto, o las 24 h terminaron), o un firewall entre los servidores cierra 7450–7459 | abra la ventana en el host: HQ Monitor → Clusters → Open the pairing window for 24 hours, o fbagent --cluster-pairing on; abra el puerto en el firewall de la nube | | insufficient disk space on replica en una reinicialización | la réplica antigua permanece hasta el final, y el nuevo archivo ocupa su tamaño completo | libere ≥ 105 % del tamaño de la base de datos + 1 GB por encima del archivo antiguo en el volumen de la réplica, o la casilla Remove the old replica if space is short (paso 8) | | El nodo no aparece después de Link hosts | el espejo RCM no tiene una versión firmada de hqclusternode | Releases in the mirror en la página Link hosts (paso 2) |