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

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.

Diagrama del clúster: los nodos maestros envían segmentos a los nodos réplica, RCM vigila todos los nodos
ComponenteCuántosQué hace
Firebird (HQbird)en cada servidor de base de datosAlmacena las bases de datos y escribe los segmentos de replicación.
fbagentuno por instancia de FirebirdDetiene e inicia Firebird cuando el nodo lo solicita.
hqclusternodeuno por instancia y rolConfigura la replicación, envía segmentos, hace la copia de la base de datos para una réplica.
hqbirdrcm (RCM)uno por clústerInterfaz web, comandos, alertas, estadísticas. Ejecuta switchover y failover.
Router (hqclusternode router)opcional, en el host de la aplicación, LinuxMantiene 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.

  1. 1Activar RCMen un host: en HQ Monitor o con fbagent --cluster-init
  2. 2Abrir la ventana de emparejamientoen los otros hosts, durante 24 horas
  3. 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-port lo 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>-master y <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-join con 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-takeover mueve RCM a otro agente. El clúster obtiene una nueva CA y debes vincular los miembros de nuevo.
  • Salir del clústerfbagent --cluster-leave detiene los nodos, cierra sus puertos y elimina los certificados del clúster. Las carpetas de los nodos permanecen; --remove-data las 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 --force o /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

    trabajando

    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.

    Inicio de la copia. Modo (suave o normal), carpeta de réplica con comprobación, permiso para detener el Firebird de la réplica.

    Espacio y velocidad

    DóndeQué se necesita
    Maestro, volumen de la base de datosAl menos un 105 % del tamaño de la base de datos libre. .delta crece durante la copia.
    Réplica, volumen de la base de datos105 % 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 nocturnaEn la ventana de transferencia (23:00–05:00 por defecto) es constante, 100 MB/s por defecto.
    Velocidad diurnaUna 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.

    Tablas de publicación. La clave de cada tabla y su estado: publicada, aún no publicada, retirada, sin clave.

    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.

    Transferencia y colas. Una fila por ruta maestro → réplica: segmentos, cola y retraso.
    Estado de la base de datosGrupo en RCMSignificado
    IN_SYNCOkLa réplica recibió todos los segmentos.
    LAGGINGPendienteLa réplica va retrasada, hay segmentos en la cola.
    SEEDINGPendienteLa base de datos se está copiando a la réplica.
    NEEDS_REINITErrorLa réplica debe copiarse de nuevo.
    FAILEDErrorLa ú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.

    1. 1Aplicados por todos, más antiguos que el límiteel límite por defecto es 2 días
    2. 2Aplicados, pero más recientes que el límitesi hay menos de 1 GB libre; alerta
    3. 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.

    Alertas. Código, nodo, mensaje y acciones.
    CódigoQué ocurrió
    backlog_warn / backlog_criticalEl maestro tiene 32 / 48 segmentos sin archivar.
    apply_error, replication_stoppedLa réplica no puede aplicar un segmento.
    replication_guid_mismatchEl GUID de la base de datos maestra cambió: restauración o reemplazo de archivo.
    segment_missing, sequence_gapLa secuencia de segmentos está rota.
    firebird_down, firebird_log_errorFirebird está caído o escribe errores.
    firebird_not_answeringEl puerto de Firebird está abierto, pero una conexión a la base de datos ha fallado durante un minuto.
    master_publication_offLa publicación está desactivada para una base de datos con réplica.
    data_mismatchLa comprobación periódica de datos encontró una diferencia. La comprobación de datos se activa por separado.
    Comprobación de datos. Recuento de filas de cada tabla en el maestro y en la réplica.

    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 servicioSignificadoQué hacer
    okEl maestro funciona, la réplica en otro host lo sigue.Nada.
    rejoiningEl antiguo maestro está volviendo como réplica.Espera: la base de datos se está copiando.
    degraded_no_replicaEl maestro funciona, no hay réplica. Esto ocurre tras un failover o tras un error de rejoin.hqbirdrcm rejoin
    failedRCM 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

      funcionando

      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 ok en el antiguo host. Si el antiguo maestro no vuelve a línea, el servicio pasa a failed: pon la base de datos en línea con gfix -online normal y ejecuta resume.
      • 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. Ejecuta hqbirdrcm 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 N corta 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.

      Diagrama del router: antes del cambio de época, las aplicaciones van a través del router a db1; después del cambio, a db2 epoch 4 · master on db1 Applications router:3051 Router HAProxy db1 master db2 replica epoch 5 · master on db2 Applications router:3051 Router HAProxy db1 closed (fenced) db2 master
      Cambio de época. El router cierra las sesiones del maestro antiguo de inmediato y abre el nuevo maestro cuando este responde «ready». La dirección y el puerto para las aplicaciones no cambian.

      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.

      1. 1Comprobarel maestro no responde, la réplica tiene una copia utilizable
      2. 2Ponerse al díala réplica aplica todo lo que recibió; límite 60 s
      3. 3Promociónpunto de no retorno: nuevo GUID, reinicio de Firebird
      4. 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ónPor qué
      El nodo maestro está en silencio durante 90 segundosEl 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 maestroLas aplicaciones tampoco pueden conectarse.
      El nodo réplica no ha visto al maestro durante 90 segundosTercer testigo.
      El retraso de la réplica es de 30 segundos o menosLímite de pérdida de datos.
      Ha pasado una hora desde el último failover automáticoEl maestro no salta entre hosts.
      RCM lleva ejecutándose más de 90 segundosTras un reinicio, RCM no tiene datos recientes.
      El servicio está ok, no se ejecuta ninguna copia ni promoción en los nodosSin 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 failed y 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

        conservadas

        Lo que muestra RCM

        Pasos en la fila de la base de datos. Los pasos completados están en verde, el actual en rojo y los siguientes en gris.

        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

        1. Detenga las escrituras de las aplicaciones en el antiguo maestro.
        2. Espere a IN_SYNC y a una cola vacía.
        3. Haga clic en «Verificar»: los recuentos de filas coinciden. Esto solo comprueba los recuentos de filas.
        4. «Promover a maestro», espere al paso FINALIZE.
        5. Cambie las aplicaciones al nuevo maestro.
        6. 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.

        NodoQuién reinicia Firebird
        MaestroSolo usted. El nodo maestro no reinicia Firebird por sí mismo.
        Réplica, el mismo Firebird tiene bases de datos maestrasUsted. 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 permitidoUsted.
        Otras réplicasEl 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.

        Parámetros de replicación. Una sugerencia para cada clave, valores del nodo y de Firebird, vista previa: «usted lo reinicia».
        • 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.
        Descripción del clúster en HQ Monitor (modo demo). Miembros y roles, enlaces maestro → réplica, la caducidad del certificado de cada miembro.

        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

        TareaComando
        Activar RCM en un hostfbagent --cluster-init <id>
        Abrir o cerrar la ventana de emparejamientofbagent --cluster-pairing on|off
        Vincular hostshqbirdrcm cluster link -hosts db1,db2 -master db1
        Token para un host sin la ventana de emparejamientohqbirdrcm cluster join-token -note db2
        Salir del clústerfbagent --cluster-leave
        Describir un serviciohqbirdrcm services put -id shop -file shop.json
        Dónde está el maestrohqbirdrcm where -service shop
        Movimiento planificado del maestrohqbirdrcm switchover -service shop [-to db2] [-check]
        Movimiento de emergenciahqbirdrcm failover -service shop -accept-data-loss
        Reincorporar el antiguo maestro como réplicahqbirdrcm rejoin -service shop
        Salir del estado fallidohqbirdrcm resume -service shop [-check]
        Regla de failover automáticohqbirdrcm policy -service shop -auto-failover on|off
        Progreso y cancelación de una operaciónhqbirdrcm operations show|cancel -id <id>

        Tiempos de espera e intervalos

        QuéPredeterminadoCómo cambiarlo
        Switchover: esperar a que terminen las conexiones120 s, 900 s como máximo-quiesce-timeout
        Switchover: la réplica aplica el último segmento300 s-apply-timeout
        Switchover: el comando espera el fin de la operación2 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 responde90 s-failover-delay
        Failover automático: límite de retraso30 s-max-data-loss
        Failover automático: pausa entre dos1 hora-min-interval
        Comprobación de las condiciones de failover y del aislamiento del antiguo maestrocada 10 sno se puede cambiar
        Firebird bloqueado: sonda de conexiónuna vez por minuto, límite 10 sno se puede cambiar
        Router: sondeo del nodo maestrocada 2 sno se puede cambiar
        Ventana de emparejamiento, token de unión24 horasventana: número de horas en la solicitud
        Vincular hosts: certificado del agente, inicio del nodohasta 10 minutos, hasta 20 minutosno se puede cambiar

        Puertos

        PuertoPropósito
        7443RCM: nodos, agentes y routers, mTLS.
        7444RCM: interfaz web y comandos de operador, HTTPS.
        7450–7459Ventana de emparejamiento del agente: 7450 + slot.
        7051–7060Primer nodo del agente: 7051 + slot.
        7061–7070Segundo nodo del agente: 7061 + slot.
        router_portPuerto de servicio en el router, por ejemplo 3051.

        Códigos de rechazo

        CódigoSignificado
        not_in_syncLa réplica de destino va retrasada: el switchover no comienza.
        busySe ejecuta una copia de base de datos o una promoción en los nodos.
        service_busyYa se ejecuta una operación en el servicio.
        master_reachableEl maestro responde: no se necesita failover.
        replica_unusableLa réplica no tiene una copia de base de datos utilizable.
        data_loss_not_acceptedFailover sin el modificador -accept-data-loss.
        past_no_returnCancelación después del punto de no retorno.
        no_witnessesFailover automático sin routers.
        node_port_clashOtro miembro del host usa el puerto del nodo.
        seats_exceededEl 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.

        ← Volver a la descripción general de HQbird 2027