HQbird Cluster: clúster y replicación
Clúster y replicación HQbird Cluster
El maestro escribe los cambios en segmentos y los envía a las réplicas por un canal seguro. El nodo hace la copia de la base de datos para una nueva réplica por sí mismo, mediante nbackup, mientras los usuarios siguen trabajando. El gestor del clúster (RCM) muestra el retraso, las colas y los errores de todos los nodos. También mueve el maestro a otro host: como un movimiento planificado, sin pérdida de datos, o como un movimiento de emergencia, cuando se pierde el host maestro.
- Firebird 2.5 · 3 · 4 · 5
- nbackup copia sin detener el maestro
- switchover sin pérdida de datos
- failover manual o por una regla
- router la cadena de conexión no cambia
- mTLS en todos los canales
Nodos · RCM · diseños
Cómo funciona el clúster
Un nodo se ejecuta junto a cada Firebird. Un nodo tiene un solo rol: maestro o réplica. El nodo maestro envía segmentos, el nodo réplica los recibe y el Firebird de la réplica los aplica a su copia de la base de datos.
Hay un RCM por clúster. Se ejecuta en cualquier host que pueda alcanzar todos los nodos. Los nodos le envían estadísticas y él les transmite los comandos del operador. RCM vincula un maestro y una réplica por el GUID de la base de datos, no por el nombre del nodo.
RCM no se instala por sí mismo. Lo activas en un host cuando necesitas un clúster. Puedes poner un router delante de las aplicaciones: siempre las envía al maestro actual.
| Componente | Cuántos | Qué hace |
|---|---|---|
| Firebird (HQbird) | en cada servidor de base de datos | Almacena las bases de datos y escribe los segmentos de replicación. |
| fbagent | uno por instancia de Firebird | Detiene e inicia Firebird cuando el nodo lo solicita. |
| hqclusternode | uno por instancia y rol | Configura la replicación, envía segmentos, hace la copia de la base de datos para una réplica. |
| hqbirdrcm (RCM) | uno por clúster | Interfaz web, comandos, alertas, estadísticas. Ejecuta switchover y failover. |
| Router (hqclusternode router) | opcional, en el host de la aplicación, Linux | Mantiene HAProxy apuntando al maestro de cada servicio. Las aplicaciones se conectan al router. |
- Misma versión mayor5.0 en el maestro, 5.0 en la réplica. De lo contrario, la réplica rechaza antes de cualquier transferencia de datos.
- HQbird 2.5 y 3.0Replicación mediante el plugin replconf. Los filtros definen el conjunto de tablas.
- Carpeta propia para cada maestroLa réplica coloca la base de datos en una carpeta con el nombre del nodo maestro. Las bases de datos con el mismo nombre de distintos maestros no entran en conflicto.
- Sin fbagent, sin cambiosSi fbagent no está disponible, el nodo rechaza cualquier acción que cambie la configuración. No funciona “en parte”.
- Nodo sin RCMUn nodo puede funcionar por sí solo. RCM es necesario para la visión general y los comandos.
- Compresión del canalPara una red lenta: zstd por par, surte efecto de inmediato.
- Hasta 3 hosts sin HQCenterCada host con un maestro o una réplica ocupa un lugar en el clúster. RCM no acepta un cuarto host.
RCM · ventana de emparejamiento · Link hosts · slots
Cómo construir un clúster
La instalación de HQbird coloca los programas del clúster en cada servidor, pero no los activa. RCM y la ventana de emparejamiento están desactivados por defecto. Construyes un clúster en tres pasos: activar RCM en un host, abrir la ventana de emparejamiento en los otros hosts, vincular los hosts con un botón.
- 1Activar RCMen un host: en HQ Monitor o con
fbagent --cluster-init - 2Abrir la ventana de emparejamientoen los otros hosts, durante 24 horas
- 3Vincular hostsRCM encuentra los agentes, emite certificados e inicia los nodos
Paso 1. RCM en un host
En HQ Monitor, abre la sección “Cluster on this server” y activa RCM. Un comando en el host hace lo mismo. El agente crea la CA del clúster, el certificado de RCM y el primer usuario. Los puertos 7443 y 7444 se abren en el firewall.
fbagent --cluster-init <id>
Durante la instalación, el conmutador --rcm on (Linux) o /RCM (Windows) hace lo mismo.
Paso 2. Ventana de emparejamiento
En cada host que se unirá al clúster, el agente abre el puerto de emparejamiento durante 24 horas. El puerto se cierra por sí solo cuando termina la ventana o cuando el agente se ha unido al clúster.
fbagent --cluster-pairing on
Un botón en HQ Monitor hace lo mismo. Durante la instalación: --cluster-pairing on o /DISCOVERY.
Paso 3. Vincular hosts
En RCM, abre Settings → Link hosts e introduce los hosts, uno por línea. El botón Check hosts lee los puertos 7450–7459 de cada host. Cada agente que respondió es una fila de la tabla.
- Una fila muestra: puerto, instancia, versión y puerto de Firebird, puerto del nodo, huella del certificado.
- Selecciona las filas con las casillas y elige el maestro. Una fila con error no bloquea las demás filas.
- Link emite un certificado a cada agente, crea los miembros y los vínculos maestro → réplica.
- RCM espera hasta 10 minutos el certificado del agente y hasta 20 minutos a que se inicien los nodos.
hqbirdrcm cluster link -hosts db1,db2,db3 -master db1
Compara la huella de la fila con la que el agente mostró en su host. Así sabes que vinculas el servidor correcto.
- Varios agentes en un hostCada agente tiene su propio slot de 0 a 9. Puerto de emparejamiento 7450 + slot, puertos del nodo 7051 + slot y 7061 + slot. La instalación elige el slot; el conmutador
--pairing-portlo establece explícitamente. - Add memberLa página Cluster sugiere un puerto de nodo libre y rechaza un puerto que use otro miembro de este host.
- Nombres de miembros
<host name>-mastery<host name>-replica. RCM no renombra un miembro: un nombre nuevo es un miembro nuevo. - Sin la ventana de emparejamientoRCM emite un token para un agente, durante 24 horas. En el nuevo host:
fbagent --cluster-joincon este token y el hash de la CA.
- Propietario de RCMEl agente que activó RCM en el host. Un segundo agente en este host recibe un rechazo. Si se elimina el propietario,
fbagent --cluster-init --rcm-takeovermueve RCM a otro agente. El clúster obtiene una nueva CA y debes vincular los miembros de nuevo. - Salir del clúster
fbagent --cluster-leavedetiene los nodos, cierra sus puertos y elimina los certificados del clúster. Las carpetas de los nodos permanecen;--remove-datalas elimina. El agente sale por sí solo si RCM lo revocó o eliminó su último miembro. - FirewallEl agente abre y cierra sus puertos del clúster por sí mismo. No cierra un puerto que ya estaba abierto antes.
- Desinstalar HQbirdEl propietario de RCM no se elimina mientras otros agentes usen su RCM. El asistente de instalación pregunta; el modo silencioso necesita
--forceo/FORCE.
La página Clusters del HQ Monitor local funciona a través del agente en el host de RCM. No necesita la contraseña de RCM. Solo un administrador ve la sección “Cluster on this server”.
Inicialización · reinit
Nueva réplica sin detener el maestro
Una réplica obtiene la base de datos solo del maestro. El nodo maestro congela el archivo con nbackup -L, lo envía por partes y elimina el bloqueo de inmediato. Los usuarios del maestro siguen trabajando todo el tiempo: sus cambios van a .delta y luego regresan a la base de datos.
gbak y una copia manual del archivo no funcionan aquí. gbak cambia el GUID de la base de datos y rompe el vínculo maestro–réplica. Una copia del archivo de una base de datos en ejecución no es consistente.
Usuarios del maestro
Archivos
- Pérdida de conexiónLa transferencia continúa desde la última parte recibida. Una copia sin terminar permanece en la réplica durante 24 horas.
- ErrorEl nodo elimina el bloqueo, borra el archivo sin terminar y marca la base de datos como FAILED. El siguiente intento comienza desde un estado conocido.
- Transacciones durante el bloqueoNo se pierden. Firebird 4 y 5: el nodo encuentra las transacciones abiertas en el momento de
nbackup -L, y la réplica las repite desde los segmentos. HQbird 2.5 y 3.0: el nodo espera a que terminen dichas transacciones (aproximadamente un minuto); de lo contrario, la copia no comienza.
- Una base de datos a la vezPor defecto, el nodo maestro copia una base de datos. Las demás esperan en una cola.
- Otras réplicas de esta base de datosMientras se ejecuta la copia, no reciben segmentos de esta base de datos. Más tarde se ponen al día.
- Reinicialización automáticaRCM puede volver a copiar por sí mismo una base de datos en estado NEEDS_REINIT, solo dentro de una ventana establecida. Desactivado por defecto.
El modo suave espera a las transacciones largas
Antes del bloqueo, el nodo busca transacciones de escritura que comenzaron antes del segmento más antiguo en el archivo del maestro. Si el archivo está vacío (primera copia), el límite es el momento en que el nodo activó la publicación. La réplica no puede repetir dichas transacciones y se detendría. Por eso la copia no comienza mientras dichas transacciones estén abiertas.
RCM muestra las cinco conexiones con las transacciones más antiguas: usuario, cliente, antigüedad, consulta actual. Puede desconectarlas y repetir la copia de inmediato. Mientras la copia espera, el archivo del maestro no se limpia, pero durante no más de 1000 segmentos. Luego la limpieza continúa y RCM genera una alerta.
El modo normal bloquea la base de datos de inmediato, sin la comprobación.
Espacio y velocidad
| Dónde | Qué se necesita |
|---|---|
| Maestro, volumen de la base de datos | Al menos un 105 % del tamaño de la base de datos libre. .delta crece durante la copia. |
| Réplica, volumen de la base de datos | 105 % más la reserva del volumen free_space_floor_gb (1 GB por defecto). El nodo reserva el tamaño completo de antemano; no se necesita una segunda copia. En una copia repetida, el archivo antiguo permanece hasta el final. Si no hay espacio para ambos archivos, la casilla «Eliminar la réplica antigua» borra el archivo antiguo antes de la transferencia. |
| Velocidad nocturna | En la ventana de transferencia (23:00–05:00 por defecto) es constante, 100 MB/s por defecto. |
| Velocidad diurna | Una parte de la velocidad medida del disco, la mitad por defecto. Una copia iniciada de día se acelera por sí sola por la noche. |
El espacio se comprueba dos veces y solo antes del bloqueo: primero RCM a partir de las estadísticas, luego los nodos con una medición en vivo en ambos lados. La comprobación del nodo no se puede omitir: protege el disco de llenarse en medio de la copia.
Firebird 4 y 5 · HQbird 2.5 y 3.0
Publicación: qué tablas van a la réplica
Firebird 4 y 5 escriben en los segmentos solo los cambios de las tablas publicadas, y solo cuando la publicación está activada. Sin ella, los cambios no llegan a la réplica. El nodo lo detecta y genera una alerta. El botón «Sincronizar publicación» la activa y construye la lista correcta de tablas.
Qué hace la sincronización
- activa la publicación, a menos que el operador la haya desactivado a propósito;
- añade todas las tablas con clave primaria o índice único;
- elimina las tablas sin clave y las tablas que el operador excluyó;
- desactiva la adición automática de nuevas tablas.
Sin una clave, la réplica no puede encontrar la fila para UPDATE y DELETE. Por eso dicha tabla no se puede publicar: añada una clave y sincronice de nuevo.
- Comprobación cada horaSi la publicación está desactivada, el nodo la comprueba cada 2 minutos. Para una base de datos con réplica, esto es una alerta.
- Lista de exclusiónSe almacena en el nodo maestro. Cuando una réplica se promueve a maestro, la lista pasa al nuevo maestro.
- Nueva tablaNo se une a la publicación por sí sola. Cree una clave y haga clic en «Sincronizar publicación».
- Copia sin publicaciónEl nodo maestro se niega a copiar la base de datos si la publicación está desactivada o no tiene tablas (
publication_off). La ventana de inicialización ofrece «Sincronizar publicación e inicializar». - HQbird 2.5 y 3.0Sin publicaciones. Los filtros de inclusión y exclusión en la configuración de replicación definen el conjunto de tablas.
Los cambios realizados mientras la publicación está desactivada o una tabla está excluida no llegan a la réplica, ni siquiera después de activarla. «Verificar» compara solo recuentos de filas; no detecta UPDATE perdidos. Si la base de datos recibió escrituras mientras la publicación estaba desactivada, copie la base de datos de nuevo.
Retraso · archivo · alertas · comprobación de datos
Monitorización: la réplica no se queda atrás en silencio
Los nodos envían estadísticas a RCM cada 30 segundos. Para cada par maestro–réplica se ve: el último segmento, cuántos se enviaron, confirmaron y aplicaron, la cola y el retraso en segundos.
| Estado de la base de datos | Grupo en RCM | Significado |
|---|---|---|
IN_SYNC | Ok | La réplica recibió todos los segmentos. |
LAGGING | Pendiente | La réplica va retrasada, hay segmentos en la cola. |
SEEDING | Pendiente | La base de datos se está copiando a la réplica. |
NEEDS_REINIT | Error | La réplica debe copiarse de nuevo. |
FAILED | Error | La última copia falló. |
El archivo del maestro se limpia por etapas
El maestro conserva los segmentos enviados para que una réplica pueda solicitarlos de nuevo. Si queda poco espacio, primero elimina lo que con seguridad no se necesita.
- 1Aplicados por todos, más antiguos que el límiteel límite por defecto es 2 días
- 2Aplicados, pero más recientes que el límitesi hay menos de 1 GB libre; alerta
- 3Aún no aplicadoscomo último paso; la réplica necesita una nueva copia
Alertas con instrucciones
RCM conoce más de 20 tipos de alertas, y cada una tiene una instrucción sobre qué hacer. Puede confirmar una alerta, silenciarla durante 60 minutos o eliminarla. Si la causa persiste, la alerta vuelve a aparecer.
No hay correo electrónico ni webhook: vigile la página «Alertas» o consulte la API de RCM.
| Código | Qué ocurrió |
|---|---|
backlog_warn / backlog_critical | El maestro tiene 32 / 48 segmentos sin archivar. |
apply_error, replication_stopped | La réplica no puede aplicar un segmento. |
replication_guid_mismatch | El GUID de la base de datos maestra cambió: restauración o reemplazo de archivo. |
segment_missing, sequence_gap | La secuencia de segmentos está rota. |
firebird_down, firebird_log_error | Firebird está caído o escribe errores. |
firebird_not_answering | El puerto de Firebird está abierto, pero una conexión a la base de datos ha fallado durante un minuto. |
master_publication_off | La publicación está desactivada para una base de datos con réplica. |
data_mismatch | La comprobación periódica de datos encontró una diferencia. La comprobación de datos se activa por separado. |
Comparación entre maestro y réplica
Verify cuenta las filas de las tablas seleccionadas en el maestro y en la réplica y las compara. No compara el contenido de las filas: no encontrará filas modificadas. Ejecútalo en un momento de calma: con escrituras activas los recuentos pueden diferir.
La comprobación periódica está desactivada por defecto: COUNT(*) lee la tabla completa. Actívala con el parámetro de nodo data_check_enabled; se ejecuta una vez cada 2 horas. Los nuevos ajustes de comprobación surten efecto de inmediato, sin reiniciar el nodo. La comprobación compara los datos cuando el maestro y la réplica están en el mismo segmento. Una diferencia genera una alerta. Una tabla excluida de la publicación aparece como «no publicada», no como un error.
- Pausar el envíoPara una o muchas bases de datos. Tras «Reanudar», el envío continúa desde el último segmento, sin una nueva copia. Mientras tanto, el archivo crece.
- Registros de nodos remotosreplication.log, firebird.log y el registro del nodo directamente en RCM, sin iniciar sesión en el servidor.
- Sin licenciaEl maestro deja de enviar; Firebird y las bases de datos siguen funcionando. Después de instalar una licencia, el envío se reanuda por sí solo en un minuto.
- Registro de comandosCada comando de RCM se registra con su autor y resultado. Informe del clúster en un único archivo JSON.
Servicio · época · dónde está el maestro
Servicios: una base de datos en varios hosts
Un servicio es una base de datos lógica en varios hosts. El maestro puede pasar de un host a otro, pero el nombre del servicio y el alias de la base de datos no cambian. Las aplicaciones y los routers preguntan a RCM dónde está ahora el maestro del servicio.
Cada cambio de maestro recibe el siguiente número: la época. RCM guarda el historial de épocas: cuándo cambió el maestro y por qué. RCM encuentra un servicio por el nodo y la ruta del archivo, no por el GUID: en el switchover el GUID de la base de datos cambia, pero la ruta sigue igual.
Qué describe un servicio
- alias: el nombre de la base de datos en
databases.conf. El nuevo maestro lo escribe él mismo. - members: una entrada por host: nodo maestro, nodo réplica, ruta del archivo, prioridad.
- router_port: el puerto en el que los routers aceptan las aplicaciones de este servicio.
- policy: las reglas del failover automático y el modo que cierra el antiguo maestro.
Cada host de un servicio ejecuta dos nodos sobre un mismo Firebird: un nodo maestro y un nodo réplica. Es la misma disposición «Dos nodos por host» que en el diagrama anterior.
El nodo maestro necesita la dirección de Firebird para los clientes: el parámetro advertise_addr. Sin él, RCM no puede indicar a una aplicación dónde conectarse.
Dónde está el maestro ahora
hqbirdrcm services put -id shop -file shop.json hqbirdrcm services hqbirdrcm where -service shop hqbirdrcm where -db shop
where responde con: el host y la dirección del maestro, el número de época, las réplicas y los problemas encontrados. A través de la API, una aplicación puede esperar una nueva época sin consultar RCM cada segundo.
La página Services de RCM muestra lo mismo para cada servicio: el estado, la época, el maestro, la dirección de Firebird, las réplicas y los problemas. El campo Find encuentra una base de datos por alias, nombre de servicio, GUID o ruta.
Servicios en el navegador
Todo lo que hacen los comandos hqbirdrcm para los servicios también está en la interfaz web de RCM. No necesitas la línea de comandos para esto.
- Página del servicioEl estado y su motivo, el maestro, las réplicas con su retraso, los hosts y sus roles, los routers, los antiguos maestros que esperan ser cerrados, la regla de failover automático, la operación en curso paso a paso y el historial de maestros.
- Botones de acciónSwitchover, Failover, Rejoin, Resume. Cada botón ejecuta primero una comprobación y muestra los problemas. La acción solo comienza tras confirmarla. Un segundo clic no inicia una segunda operación.
- Formulario de servicioEl botón New service crea un servicio: nombre, alias, puerto del router y una línea por cada host. El formulario ofrece los nodos y las bases de datos que ve. Check valida el formulario, Save muestra primero la lista de cambios.
- OperacionesUna página con todos los switchovers, failovers y rejoins, los más recientes primero. Mientras se ejecuta una operación, la cabecera de cada página tiene una etiqueta con un enlace a ella.
- Eliminar un servicioSolo se elimina el registro en RCM. El diálogo indica qué permanece (bases de datos, replicación, roles de los nodos, alias) y qué se pierde (historial, regla, puerto en los routers), y te pide que escribas el nombre del servicio.
- Rol de visorUn usuario con este rol ve todas las páginas y ejecuta comprobaciones, pero no tiene botones de acción.
| Estado del servicio | Significado | Qué hacer |
|---|---|---|
ok | El maestro funciona, la réplica en otro host lo sigue. | Nada. |
rejoining | El antiguo maestro está volviendo como réplica. | Espera: la base de datos se está copiando. |
degraded_no_replica | El maestro funciona, no hay réplica. Esto ocurre tras un failover o tras un error de rejoin. | hqbirdrcm rejoin |
failed | RCM no puede determinar el estado, o el Firebird del maestro no responde. | hqbirdrcm resume tras una comprobación |
Un servicio en estado failed no inicia ni un switchover ni un failover automático. Solo el operador puede sacarlo de este estado: con el comando resume, con un rejoin o con un failover manual.
Movimiento planificado del maestro · sin pérdida de datos
Switchover: el maestro se traslada a otro host
Switchover traslada el maestro de un servicio a otro host sin pérdida de datos. RCM mismo detiene las escrituras en el antiguo maestro, espera a que la réplica aplique el último segmento y la convierte en maestra. Después, el antiguo maestro vuelve al clúster como réplica del nuevo, en la misma ruta.
Lo necesitas para trabajos planificados: actualización del sistema operativo, reemplazo de disco, trasladar la carga a otro servidor. Primero la comprobación, luego el inicio:
hqbirdrcm switchover -service shop -check # solo comprobación, no cambia nada hqbirdrcm switchover -service shop -to db2 # mover el maestro a db2
El comando ejecuta la operación hasta el final e imprime cada paso. El código de salida 0 significa éxito. El botón Switchover en la página del servicio en RCM hace lo mismo: primero la comprobación, luego la confirmación, luego los pasos de la operación en pantalla.
Aplicaciones
Hosts y servicio
Qué comprueba RCM antes del inicio
- El servicio está en estado
ok, el maestro es conocido. - La réplica de destino está en estado
IN_SYNC. - Los cuatro nodos de los dos hosts responden.
- La réplica de destino no está pausada por la licencia.
- No se ejecuta ninguna copia de base de datos ni promoción en estos nodos.
Si algo va mal, RCM se niega y da el motivo como un código. Hasta este punto, nada ha cambiado.
Si algo sale mal
- Antes del punto de no retorno. Un error, un tiempo de espera agotado o una cancelación devuelven el antiguo maestro a línea. El servicio sigue
oken el antiguo host. Si el antiguo maestro no vuelve a línea, el servicio pasa afailed: pon la base de datos en línea congfix -online normaly ejecutaresume. - Después del punto de no retorno. No puedes cancelar. Un error pone el servicio en
failed. - Error durante el rejoin. El nuevo maestro funciona, no hay réplica:
degraded_no_replica. Ejecutahqbirdrcm rejoin -service shop.
hqbirdrcm operations show -id <id> hqbirdrcm operations cancel -id <id>
En el navegador, esta es la página Operations y el botón Cancel en la página del servicio.
- Detener las escriturasEl maestro antiguo pasa a apagado completo. El nodo espera hasta que terminen las conexiones: 120 segundos por defecto, 900 como máximo. El modificador
-force Ncorta las conexiones después de N segundos. - Ponerse al díaCada segundo, RCM pregunta a la réplica si ha aplicado el último segmento. El límite por defecto es de 300 segundos.
- Un reinicio de FirebirdEn el nuevo maestro, sin esperar a la ventana. Durante la reincorporación, el Firebird del host antiguo se reinicia solo si el nodo réplica lo necesita.
- La reincorporación es una copia de la base de datosEl nuevo maestro copia la base de datos al host antiguo mediante nbackup. Para una base de datos grande esto tarda mucho, por lo que el comando espera la operación hasta 2 horas.
- RCM reiniciadoCada paso se escribe en disco antes de la llamada al nodo. Después de un reinicio, RCM continúa la operación desde el paso actual.
- Bloqueo del servicioMientras se ejecuta un switchover o una reincorporación, RCM rechaza otros cambios en estos nodos: ajustes, reinicio de Firebird, copia, pausa del envío.
Las conexiones al maestro antiguo se cierran en el paso de detener las escrituras. La aplicación debe conectarse de nuevo. Con un router, la cadena de conexión sigue siendo la misma. Sin un router, la aplicación va a la dirección del nuevo maestro: hqbirdrcm where -service shop la proporciona.
HAProxy · Linux · una sola cadena de conexión
Routers: las aplicaciones conservan la misma dirección
Un router se ejecuta en el host de la aplicación y mantiene HAProxy apuntando al maestro de cada servicio. Las aplicaciones se conectan a <router host>:<service port>. Después de un switchover o un failover, la cadena de conexión sigue siendo la misma.
Cómo elige un host el router
- Obtiene la tabla de servicios de RCM: época, host maestro, direcciones de Firebird.
- Cada 2 segundos pregunta al nodo maestro: «¿eres el maestro de esta época y está la base de datos en línea?».
- Respuesta «sí»: el host acepta conexiones.
- Respuesta «no»: no hay nuevas conexiones, las conexiones abiertas se mantienen.
- Nueva época: las sesiones del maestro antiguo se cierran de inmediato.
Si RCM no está disponible, el router trabaja con la última tabla. El router la guarda en su disco.
Cómo añadir un router
Un router es un miembro del clúster con el rol router. Añádelo en la página Cluster, como un maestro o una réplica. El fbagent en este host recibe un certificado, escribe la configuración y registra el servicio. HAProxy debe estar instalado en el host.
El router_port en la descripción del servicio establece el puerto del servicio. Puedes tener varios routers: uno en cada host de aplicación.
La página Settings → Routers en RCM muestra los routers y sus informes: qué época aplicó el router y a qué host dirige.
- Las conexiones se cortanCuando cambia el maestro, las conexiones abiertas se cierran. La aplicación debe conectarse de nuevo, a la misma dirección.
- Dirección del clienteFirebird ve la dirección de HAProxy, no la dirección de la aplicación. Las reglas de acceso por IP de cliente no funcionan detrás de un router.
- Solo LinuxEl router funciona en Linux. Los servidores de base de datos pueden estar en Windows y Linux.
- WitnessesLos routers informan a RCM si pueden alcanzar el puerto de Firebird del maestro. El failover automático no se activa sin ellos.
Host maestro perdido · manual o por una regla
Failover: la réplica asume el rol de maestro
Necesitas failover cuando el host maestro no responde. La réplica se convierte en maestro con los segmentos que ha recibido. Lo que el maestro no envió se pierde. Por eso el operador debe aceptar la pérdida explícitamente.
hqbirdrcm failover -service shop -check # what will be lost hqbirdrcm failover -service shop -to db2 -accept-data-loss # start
Sin el modificador -accept-data-loss, el comando solo comprueba y muestra la estimación de la pérdida: el último segmento del maestro, cuántos segmentos recibió y aplicó la réplica, y cuántos segmentos se pierden como mínimo.
En el navegador, este es el botón Failover en la página del servicio. Inicia la operación solo cuando el operador ha marcado la casilla de pérdida de datos y ha escrito el nombre del servicio.
- 1Comprobarel maestro no responde, la réplica tiene una copia utilizable
- 2Ponerse al díala réplica aplica todo lo que recibió; límite 60 s
- 3Promociónpunto de no retorno: nuevo GUID, reinicio de Firebird
- 4Nueva épocala réplica es el maestro; el maestro antiguo espera a ser cerrado
- El maestro aún respondeRCM lo rechaza:
master_reachable. Ejecuta un switchover, o primero detén el nodo maestro. - Réplica retrasadaSe acepta el estado
LAGGING. Una réplica que necesita una nueva copia no es adecuada. - Varias réplicasPor defecto, RCM toma la que aplicó más segmentos, luego la de mayor prioridad.
- Después del failoverEl servicio está en el estado
degraded_no_replica: el maestro funciona, no hay réplica. No hay reincorporación hasta que el host antiguo vuelva a estar activo. - Servicio en estado fallidoUn failover manual también funciona para él. Esta es la salida cuando el Firebird del maestro se cuelga y no puedes reiniciarlo rápidamente.
- Tablas excluidasRCM toma su lista de la réplica o de las últimas estadísticas del maestro antiguo. Si no hay lista, establece las tablas en la página de publicación del nuevo maestro.
- Límite de puesta al díaEl modificador
-apply-timeout, 60 segundos por defecto, 3600 como máximo.
Failover automático opcional
RCM puede iniciar un failover por sí mismo. Esto está desactivado por defecto. Activas la regla para cada servicio por separado: en la página del servicio en el navegador o con un comando.
hqbirdrcm policy -service shop # show the rule
hqbirdrcm policy -service shop -auto-failover on -max-data-loss 30
RCM comprueba las condiciones cada 10 segundos e inicia un failover solo cuando todas son verdaderas.
| Condición | Por qué |
|---|---|
| El nodo maestro está en silencio durante 90 segundos | El maestro no envía estadísticas. |
| Una llamada directa de RCM al nodo maestro falla (5 segundos) | No se trata solo de estadísticas tardías. |
| Más de la mitad de los routers no pueden alcanzar el puerto de Firebird del maestro | Las aplicaciones tampoco pueden conectarse. |
| El nodo réplica no ha visto al maestro durante 90 segundos | Tercer testigo. |
| El retraso de la réplica es de 30 segundos o menos | Límite de pérdida de datos. |
| Ha pasado una hora desde el último failover automático | El maestro no salta entre hosts. |
| RCM lleva ejecutándose más de 90 segundos | Tras un reinicio, RCM no tiene datos recientes. |
El servicio está ok, no se ejecuta ninguna copia ni promoción en los nodos | Sin conflicto con el trabajo en curso. |
- Se necesitan routersLa regla necesita tanto routers como un puerto de servicio. Si falta uno de ellos, la regla no se activa:
no_witnesses. Coloque los routers de modo que la mayoría de ellos no estén en el host maestro. - Una vezTras un failover automático, la regla se desactiva sola. Solo el operador la vuelve a activar.
- Por qué no se inicióRCM guarda el motivo de la espera junto con la regla del servicio y escribe cada nuevo motivo en su registro una vez.
- RegistroLa operación se ejecuta como
system:autofailover. La primera entrada indica lo que vieron los witnesses.
El límite de 30 segundos cubre solo la cola que la réplica recibió y aún no ha aplicado. Los segmentos que el maestro escribió pero no envió no están incluidos. El informe de la operación muestra su número.
Fence · rejoin · maestro colgado · resume
Reincorporación y recuperación
Tras un failover, el clúster tiene dos archivos que fueron el maestro. Debe cerrar el antiguo para que no acepte escrituras y devolverlo como réplica. RCM hace lo primero por sí mismo y lo segundo mediante un comando del operador.
Cerrar el antiguo maestro (fence)
RCM intenta cerrar el antiguo maestro cada 10 segundos. Cuando su nodo responde, recibe el rol «cerrado» y deja de enviar segmentos. Cada fence se escribe en el registro de auditoría.
- Modo
route(predeterminado). La base de datos del antiguo maestro permanece en línea. Los routers ya no la usan. - Modo
shutdown. RCM primero detiene la base de datos. Las conexiones se cierran tras 5 segundos.
hqbirdrcm policy -service shop -fence-mode shutdown
Devolver el antiguo maestro (rejoin)
Cuando el antiguo host vuelva a funcionar, inicie el rejoin. RCM primero cierra el antiguo maestro, si aún no se ha hecho. Después, el nuevo maestro copia su base de datos al antiguo host, en la misma ruta.
hqbirdrcm rejoin -service shop
El archivo antiguo no se elimina. Permanece junto al nuevo como <name>.pre-reinit-<time>.fdb. Este archivo y el archivo del antiguo maestro contienen cambios que el nuevo maestro no tiene.
En modo route, las aplicaciones que se conectan directamente al antiguo host, no a través de un router, aún pueden escribir en la base de datos antigua. Estos cambios no llegan al nuevo maestro. Si algunas aplicaciones funcionan sin router, active el modo shutdown.
Maestro colgado
Firebird puede colgarse de forma que el puerto esté abierto, pero no se pueda conectar a la base de datos. Una comprobación del puerto no lo detecta. Por eso el propio nodo se conecta a la base de datos cada minuto, con un límite de 10 segundos.
- Un minuto sin respuesta: la alerta grave
firebird_not_answering. - RCM marca el servicio como
failedy escribe el motivo: nodo, host, hora. - El failover automático no se inicia en este estado.
Qué hacer: guarde las pilas de hilos de Firebird y firebird.log, reinicie Firebird en el host maestro y luego ejecute resume. Si no puede reiniciar rápidamente, detenga el nodo maestro e inicie un failover.
Salir del estado fallido
hqbirdrcm resume -service shop -check hqbirdrcm resume -service shop
RCM pregunta directamente al nodo maestro y comprueba:
- que no se ejecuta ninguna operación en el servicio;
- que el nodo maestro responde;
- que su Firebird acepta conexiones;
- que el host es el maestro de la época actual y la base de datos está en línea.
El servicio pasa a ok si una réplica en otro host sigue al maestro. De lo contrario, pasa a degraded_no_replica: entonces ejecute rejoin.
Convertir a normal · promover a maestro
Promoción manual de réplica: paso a paso
Para una base de datos que forma parte de un servicio, use switchover y failover: ellos realizan todos los pasos siguientes por sí mismos. La ruta manual queda para bases de datos sin servicio. «Convertir a normal» convierte la réplica en una base de datos de trabajo independiente: para informes, pruebas o un fallo. «Promover a maestro» convierte la réplica en el nuevo maestro.
La promoción funciona para un par de nodos compañeros: un nodo réplica y un nodo maestro en la misma instancia de Firebird. El archivo de base de datos permanece en su sitio; el control pasa al compañero. Cada paso es visible en la fila de la base de datos. Si un paso se interrumpió, haga clic de nuevo en el botón: los pasos completados no se repiten.
Conexiones
Lo que muestra RCM
Por qué un nuevo GUID
Sin él, el nuevo maestro escribiría segmentos bajo el GUID del antiguo maestro, y sus réplicas los rechazarían. El nodo asigna a la base de datos un nuevo GUID en su sitio, mediante nbackup, sin reiniciar Firebird. Esto funciona en 2.5, 3.0, 4.0 y 5.0.
Tras un nuevo GUID, la antigua cadena de nbackup ya no encaja. Haga una nueva copia de nivel 0.
Switchover manual sin servicio
- Detenga las escrituras de las aplicaciones en el antiguo maestro.
- Espere a
IN_SYNCy a una cola vacía. - Haga clic en «Verificar»: los recuentos de filas coinciden. Esto solo comprueba los recuentos de filas.
- «Promover a maestro», espere al paso FINALIZE.
- Cambie las aplicaciones al nuevo maestro.
- Haga una copia nbackup de nivel 0 y conecte una nueva réplica.
La promoción manual no comprueba si las aplicaciones escriben en el antiguo maestro ni devuelve el antiguo maestro como réplica. Detenga usted mismo las escrituras primero. Switchover hace ambos pasos por usted: detiene las escrituras y devuelve el antiguo maestro.
Reinicio · parámetros · certificados
Configuración y seguridad
Firebird lee los parámetros de replicación solo al iniciarse. Por eso importa quién lo reinicia y cuándo. La regla es simple: el Firebird del maestro nunca se reinicia automáticamente. Hay una excepción: switchover y failover. Ahí, el reinicio forma parte de una operación que inició el operador, o que inició una regla activada por el operador.
| Nodo | Quién reinicia Firebird |
|---|---|
| Maestro | Solo usted. El nodo maestro no reinicia Firebird por sí mismo. |
| Réplica, el mismo Firebird tiene bases de datos maestras | Usted. El permiso de la ventana de copia permite al nodo solo detener Firebird para reemplazar o eliminar el archivo de réplica antiguo. |
| Réplica, reinicio automático no permitido | Usted. |
| Otras réplicas | El nodo, en su ventana de reinicio. Una vez tras una serie de copias, no tras cada base de datos. |
Parámetros de replicación para muchas bases de datos
Seleccione bases de datos: RCM las agrupa por versión de Firebird y rol. Para cada parámetro, elija una acción: mantener, establecer, restablecer al nivel superior o no escribir. Verá de dónde procede el valor actual: la base de datos, el nodo o Firebird.
Vista previa comprueba los valores en los nodos y no cambia nada. También muestra quién reiniciará Firebird y cuántas bases de datos se verán afectadas.
- Ventanas de tiempoUn reinicio del maestro que usted solicitó: 22:00–05:00. Réplica: cualquier hora. La promoción manual a maestro reinicia ambos servidores Firebird a la vez, sin ventana. El switchover reinicia un Firebird: en el nuevo maestro. Velocidad de copia completa: 23:00–05:00.
- Velocidad de segmentos50 MB/s por defecto, pico breve de 200 MB. Cambia al instante, sin reinicio.
- Mover el archivo de réplicaA otra subcarpeta sin una nueva copia; reversión en caso de error.
- Réplica configurada manualmentePuede ponerla bajo gestión sin una nueva copia. RCM empareja los archivos por GUID.
- Línea de comandosCopiar, comprobar, pausar, promoción y otros comandos de RCM también están en
hqbirdrcm. Switchover, failover y la regla del servicio están disponibles de tres formas: en el navegador, con un comando y a través de la API. - Rol de visorUn usuario de RCM con el rol de visor lo ve todo y ejecuta comprobaciones. Este usuario no puede realizar ningún cambio.
- 6 idiomasInterfaz de RCM. Las instrucciones de alerta están en inglés.
Un documento describe el clúster
Los miembros, sus roles y los enlaces maestro → réplica se configuran en la página Clusters de HQ Monitor o en RCM. El fbagent de cada host recibe la descripción e instala y configura los nodos por sí mismo. Sin HQCenter, RCM gestiona un clúster de hasta 3 hosts.
mTLS y certificados
Todos los canales del clúster están protegidos por mTLS con una CA compartida. La clave se crea en el host miembro y nunca lo abandona: solo sale la solicitud de certificado. Un certificado es válido durante 90 días y se renueva solo 30 días antes de caducar. Se emiten una nueva clave y una nueva CA por orden del administrador.
La interfaz web de RCM funciona sobre HTTPS en el puerto 7444. El agente abre este puerto en el firewall cuando RCM se activa en el host. El inicio de sesión es con nombre de usuario y contraseña; debe cambiar la primera contraseña. Está en el archivo rcm-initial-password del host de RCM y no se muestra en pantalla. Tras el cambio de contraseña, el agente elimina este archivo. La página de inicio de sesión muestra el hash de la CA del clúster: compárelo con la línea «CA hash» del resumen de configuración en el host de RCM. Cada cambio e inicio de sesión se registra en el registro de auditoría.
Comandos · tiempos de espera · puertos · códigos de rechazo
Referencia
Comandos
| Tarea | Comando |
|---|---|
| Activar RCM en un host | fbagent --cluster-init <id> |
| Abrir o cerrar la ventana de emparejamiento | fbagent --cluster-pairing on|off |
| Vincular hosts | hqbirdrcm cluster link -hosts db1,db2 -master db1 |
| Token para un host sin la ventana de emparejamiento | hqbirdrcm cluster join-token -note db2 |
| Salir del clúster | fbagent --cluster-leave |
| Describir un servicio | hqbirdrcm services put -id shop -file shop.json |
| Dónde está el maestro | hqbirdrcm where -service shop |
| Movimiento planificado del maestro | hqbirdrcm switchover -service shop [-to db2] [-check] |
| Movimiento de emergencia | hqbirdrcm failover -service shop -accept-data-loss |
| Reincorporar el antiguo maestro como réplica | hqbirdrcm rejoin -service shop |
| Salir del estado fallido | hqbirdrcm resume -service shop [-check] |
| Regla de failover automático | hqbirdrcm policy -service shop -auto-failover on|off |
| Progreso y cancelación de una operación | hqbirdrcm operations show|cancel -id <id> |
Tiempos de espera e intervalos
| Qué | Predeterminado | Cómo cambiarlo |
|---|---|---|
| Switchover: esperar a que terminen las conexiones | 120 s, 900 s como máximo | -quiesce-timeout |
| Switchover: la réplica aplica el último segmento | 300 s | -apply-timeout |
| Switchover: el comando espera el fin de la operación | 2 horas | -timeout |
| Failover: la réplica aplica lo que recibió | 60 s, 3600 s como máximo | -apply-timeout |
| Failover automático: el maestro no responde | 90 s | -failover-delay |
| Failover automático: límite de retraso | 30 s | -max-data-loss |
| Failover automático: pausa entre dos | 1 hora | -min-interval |
| Comprobación de las condiciones de failover y del aislamiento del antiguo maestro | cada 10 s | no se puede cambiar |
| Firebird bloqueado: sonda de conexión | una vez por minuto, límite 10 s | no se puede cambiar |
| Router: sondeo del nodo maestro | cada 2 s | no se puede cambiar |
| Ventana de emparejamiento, token de unión | 24 horas | ventana: número de horas en la solicitud |
| Vincular hosts: certificado del agente, inicio del nodo | hasta 10 minutos, hasta 20 minutos | no se puede cambiar |
Puertos
| Puerto | Propósito |
|---|---|
7443 | RCM: nodos, agentes y routers, mTLS. |
7444 | RCM: interfaz web y comandos de operador, HTTPS. |
7450–7459 | Ventana de emparejamiento del agente: 7450 + slot. |
7051–7060 | Primer nodo del agente: 7051 + slot. |
7061–7070 | Segundo nodo del agente: 7061 + slot. |
router_port | Puerto de servicio en el router, por ejemplo 3051. |
Códigos de rechazo
| Código | Significado |
|---|---|
not_in_sync | La réplica de destino va retrasada: el switchover no comienza. |
busy | Se ejecuta una copia de base de datos o una promoción en los nodos. |
service_busy | Ya se ejecuta una operación en el servicio. |
master_reachable | El maestro responde: no se necesita failover. |
replica_unusable | La réplica no tiene una copia de base de datos utilizable. |
data_loss_not_accepted | Failover sin el modificador -accept-data-loss. |
past_no_return | Cancelación después del punto de no retorno. |
no_witnesses | Failover automático sin routers. |
node_port_clash | Otro miembro del host usa el puerto del nodo. |
seats_exceeded | El clúster ya tiene 3 hosts. |
Los puntos principales en breve
Preguntas frecuentes
¿Cuál es la diferencia entre switchover y failover?
El switchover es planificado: ambos hosts funcionan, no se pierden datos y el antiguo maestro vuelve como réplica por sí mismo. El failover es una emergencia: se pierde el host maestro, se pierde lo que el maestro no envió y debe reincorporar el antiguo maestro con un comando aparte.
¿Qué ve la aplicación durante un switchover?
Las conexiones al antiguo maestro se cierran cuando RCM detiene las escrituras. Hasta que la réplica se convierte en maestro, no hay dónde escribir. Tras la nueva época, la aplicación se conecta de nuevo: a la misma dirección del router o a la dirección del nuevo maestro.
¿Cuánto tarda un switchover?
La pausa de escritura tiene tres partes: esperar a que terminen las conexiones (hasta 120 segundos por defecto), ponerse al día con el último segmento y un reinicio de Firebird en el nuevo maestro. La reincorporación del antiguo maestro se ejecuta después, en segundo plano. Su tiempo es el tiempo de la copia de la base de datos.
¿Puedo trabajar sin router?
Sí. El switchover y el failover manual funcionan sin routers. La aplicación obtiene entonces la dirección del maestro del propio RCM. El failover automático no se activa sin routers: los routers son sus testigos.
¿Cuántos datos puede perder un failover automático?
La regla no se activa si la réplica va retrasada más de 30 segundos. Pero se pierden los segmentos que el maestro escribió y no envió. El informe de la operación muestra su número. El archivo de base de datos antiguo se conserva: estos cambios permanecen en él y en el archivo del antiguo maestro.
El servicio está en estado fallido. ¿Qué hago?
Consulte el motivo en la página Services. Si el Firebird del maestro se bloqueó, reinícielo. Después, hqbirdrcm resume -service <id> -check muestra qué bloquea el servicio, y resume sin el switch devuelve el servicio al funcionamiento.
¿Cuánto espacio necesita la reincorporación del antiguo maestro?
La reincorporación es una nueva copia de la base de datos. Se aplican las mismas reglas que para cualquier copia: el 105 % del tamaño de la base de datos. Tras un failover, el archivo antiguo permanece junto al nuevo, por lo que el host antiguo necesita espacio para ambos archivos.
¿Funciona en Windows?
Los nodos y RCM funcionan en Windows y Linux. El router funciona solo en Linux.