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

Instalación sin sorpresas

Un instalador por línea de Firebird. Detecta Firebird, el antiguo HQbird y los agentes en el servidor, muestra un plan y no cambia nada hasta que digas «Sí». Después, el agente se actualiza a sí mismo, la consola y Firebird de forma autónoma, con comprobaciones y rollback.

  • 4 instaladores: Firebird 2.5 · 3.0 · 4.0 · 5.0
  • 0 cambios antes de que confirmes el plan
  • sin necesidad de internet todo en un solo archivo
  • Windows y Linux asistente, modo silencioso, .run
  • rollback si falla una instalación o actualización

setup.exe · .run

Qué incluye el kit

El instalador es un solo archivo: hqbird2027-fb50-setup-<version>.exe para Windows o hqbird2027-fb50-linux-<version>.run para Linux. Contiene todo lo que necesita el servidor. No se descarga nada.

Cada instalador instala una línea de Firebird. Elige la línea en la que se ejecutan tus bases de datos. La instalación la realiza el agente incluido en el kit: comprueba el servidor, elabora un plan y lo ejecuta.

ComponenteQué haceWindowsLinux
Firebird, compilación HQbirdUn servidor nuevo o una actualización in situ. Para un servidor ya instalado, se añade una línea a firebird.conf: MonitoringPlugin = fblwmon. Para un servidor nuevo, el instalador también configura el puerto. databases.conf, la base de datos de seguridad y la contraseña de SYSDBA no cambian.servicio FirebirdServer…/opt/firebird
agente fbagentCopias de seguridad, monitorización, mantenimiento, actualizaciones.HQbirdFBAgent-fb50hqbirdfbagent-fb50, usuario firebird
HQbird MonitorConsola web para este servidor. Puerto = 20000 + puerto de Firebird: para 3050 es 23050. El puerto se elige durante la instalación y no cambia después, aunque cambies el puerto de Firebird.HQbirdMonitor-fb50hqbirdmonitor-fb50
Componentes de clústerLos programas de clúster se colocan en el servidor pero no se activan: RCM y la ventana de emparejamiento están desactivados por defecto. RCM convierte el servidor en el centro de un nuevo clúster y abre los puertos 7443 y 7444. La ventana de emparejamiento abre los puertos 7450–7459 durante 24 horas: a través de ella, el RCM de otro servidor puede invitar a este servidor. También puedes activar ambos después de la instalación.página del asistente «Replication and cluster setup»; /RCM, /DISCOVERY--rcm on, --cluster-pairing on
servidor MCP fbmcpAcceso de clientes de IA a Firebird. Por defecto, solo desde este servidor.casilla en el asistente o /NOFBMCP--no-fbmcp
Archivos de depuración de FirebirdSímbolos para analizar fallos de Firebird.—sí, --no-debug lo desactiva
  • WindowsCompatible con: Windows 10 y 11, Windows Server 2016 y posteriores, 64 bits. Se requieren derechos de administrador. El instalador está firmado por IBSurgeon Software: Windows muestra el editor en la solicitud de permisos.
  • Asistente o modo silenciosoCada página del asistente también está disponible como conmutador: /VERYSILENT /YES /LOG=…. Ideal para scripts y para cien servidores.
  • Asistente en 8 idiomasInglés, portugués (Brasil), alemán, ruso, español, polaco, turco, chino simplificado. El valor predeterminado es el idioma de Windows. Conmutador: /LANG=en|pt_BR|de|ru|es|pl|tr|zh_CN.
  • Nombre del servidorEl asistente solicita el nombre del nuevo agente; HQCenter muestra el servidor con este nombre. El valor predeterminado es el nombre del equipo. Modo silencioso: /AGENTID=, en Linux --agent-id. Un agente ya instalado conserva su nombre.
  • Linuxx86_64, kernel 3.2 o posterior, systemd, root. Ubuntu, Debian, AlmaLinux, Rocky, RHEL, Oracle Linux, openSUSE, RED OS y otros con apt, dnf, yum o zypper.
  • Servidor sin internetEl instalador obtiene algunas bibliotecas del SO (libtommath, ICU) del repositorio. Si no hay repositorio, muestra los comandos exactos y no cambia nada.

El kit se comprueba dos veces. Antes de descomprimir: el sha256 de todo el kit. Antes de instalar Firebird y el agente: la firma de cada archivo. Una descarga dañada detiene la instalación antes de cualquier cambio en Firebird, el agente o la consola.

fbagent --install-plan

Primero el plan, después los cambios

Primero, el instalador solo lee: servicios, el registro, las carpetas de Firebird y HQbird. Después muestra lo que encontró y lo que hará. Los cambios comienzan después de que digas «Sí».

Selecciona lo que hay en el servidor y consulta el plan. Los textos están abreviados y traducidos; el orden y las decisiones son los mismos que en el instalador de Firebird 5.0.

En el servidor

        


          


          

  1. 1Comprobación del servidorpermisos, arquitectura; en Linux también systemd y el kernel
  2. 2Comprobación del kitsha256 antes de descomprimir; firmas de archivos antes de la instalación
  3. 3Planlo que se encontró y lo que se hará
  4. 4Preguntasnombre del servidor para HQCenter; ¿detener Firebird? ¿otra versión?
  5. 5InstalaciónFirebird, agente, consola, servicios
  6. 6✓ Resultadoservicios, dirección de la consola, inicio de sesión

Si algo sale mal

Un rechazo en la fase de plan (puerto en uso, carpeta no vacía) no cambia nada: el instalador indica el motivo. En el asistente, no puedes salir de una página mientras un valor sea incorrecto.

Un fallo durante la instalación, antes de que se inicie el servicio del agente: los servicios vuelven a su estado anterior. El antiguo HQbird, si se detuvo, se inicia de nuevo.

CódigoSignificado (.run de Linux)
0Hecho
1Rechazado: servidor, conmutador o plan. Nada cambió
2La instalación falló, cambios revertidos
3Rollback incompleto: el resultado indica qué comprobar
4Se necesita una respuesta: no hay terminal ni --yes
5El kit no superó la comprobación: descárgalo de nuevo
6No hay bibliotecas del SO ni repositorio
7Firebird de paquetes de la distribución
CódigoSignificado (setup.exe de Windows)
0Instalado
1Rechazado antes de la instalación: conmutador o archivo incorrecto, hay una versión más reciente instalada, sin derechos de administrador
4El instalador tenía una pregunta, pero no hay conmutador /YES
7Falló la comprobación del servidor o la instalación. El motivo está en el registro y en el archivo de resultado
10Instalado, pero falló la conexión con HQCenter
Plan en el asistente. «Found on this computer» y «Setup will do the following». Abajo: nada cambia hasta que hagas clic en Install.
Resultado. Qué está instalado, la dirección de la consola desde este equipo y desde otro, dónde está la contraseña de inicio de sesión. Tomado de una compilación temprana: allí, los nombres del servicio del agente y de las carpetas usan el puerto (-p3050); las nuevas instalaciones reciben -fb50.

FBDataGuard → fbagent

Migrar desde HQbird 2024

El instalador detecta el antiguo HQbird y el Firebird que este sirve. Este Firebird se actualiza en el mismo lugar, los trabajos de FBDataGuard pasan al agente y los servicios antiguos se detienen. Las bases de datos, las configuraciones y las contraseñas se conservan.

Migrar desde HQbird 2024: los trabajos de FBDataGuard pasan al agente de HQbird 2027, Firebird se actualiza en el mismo lugar, los servicios antiguos de HQbird se deshabilitan
  • Qué no cambiadatabases.conf o aliases.conf, la base de datos de seguridad, la contraseña de SYSDBA, las bases de datos, las copias de seguridad y los archivos antiguos de HQbird. En firebird.conf, solo se añade la línea MonitoringPlugin = fblwmon, si falta.
  • Copia del Firebird antiguoLa carpeta del programa del Firebird antiguo se conserva junto a él como <folder>.old_<time>.
  • TrabajosCopias de seguridad con gbak y nbackup, sweep, estadísticas de índices. La importación se ejecuta una vez y pasa por la comprobación de la nueva configuración; la configuración antigua se conserva.
  • Copias de seguridad antiguasEl agente toma las copias de seguridad de los diarios de FBDataGuard y las incorpora a sus propios registros. Las reglas de retención y la restauración las ven igual que las nuevas. Los nombres de los niveles de nbackup se mantienen igual.
  • Nombres de trabajosEl nombre del trabajo termina con el nombre de la base de datos de FBDataGuard, por ejemplo "Verified backup - MANUAL". Los trabajos de grupo reproducen el árbol de las carpetas de origen.
  • Servicios antiguos: tres opcionesAutomático (recomendado): deshabilitarlos cuando cada Firebird servido por FBDataGuard tenga un agente. Deshabilitar todos: /DISABLEHQBIRD. Dejar como está: /NOHQBIRD.
  • Puede volver atrásEl estado de cada servicio antes de ser deshabilitado se guarda en fbagent-hqbird-takeover.json. Con este archivo, el antiguo HQbird puede volver a activarse.
  • LicenciaLa licencia antigua de HQbird no se transfiere. Hay un período de prueba hasta que obtenga una nueva licencia o se conecte a HQCenter.
  • Ruta poco claraSi la importación no puede expandir una sustitución en una ruta de FBDataGuard, la deja como está y deja el trabajo deshabilitado. Corrija la ruta y habilite el trabajo.

Si los trabajos se importan pero los servicios antiguos siguen en ejecución (por ejemplo, el servidor tiene dos servidores Firebird bajo FBDataGuard), los trabajos llegan deshabilitados. De este modo, un trabajo no se ejecuta dos veces.

Puertos · carpetas · servicios

Varios servidores Firebird en una sola máquina

Un agente por cada Firebird. Una nueva instancia se instala junto a las demás, en su propio puerto, con su propio agente y su propia consola. Las instancias instaladas no cambian.

Añada servidores Firebird y vea qué nombres y puertos elige el instalador.

Añadir
  • Puertos por líneaEl primer Firebird en el servidor obtiene el 3050. El siguiente: 3052 para 2.5, 3053 para 3.0, 3054 para 4.0, 3055 para 5.0. El instalador no toma un puerto que esté en uso.
  • Segunda instancia de la misma líneaNúmero -2 en los nombres de carpeta y de servicio. En Windows, esta es la opción del asistente "Install another instance"; el puerto es el primero libre en el rango de la línea.
  • Actualizaciones solo dentro de una línea5.0.x → 5.0.y. Pasar de 3.0 a 5.0 significa una segunda instancia junto a la primera; una persona traslada las bases de datos con copia de seguridad y restauración.
  • XNET en WindowsUn Firebird que no está en el puerto 3050 obtiene su propio nombre IpcName = FIREBIRD_<port>. Las conexiones locales XNET al segundo servidor funcionan.
  • Una consola por agenteHQbird Monitor en 20000 + puerto de Firebird: 23050, 23055. Un archivo de inicio de sesión para todas las instancias del servidor.
  • Los puertos son fijosLos puertos de la consola y de la API local del agente se escriben en la instalación. Si cambia el puerto de Firebird más adelante, permanecen igual. El agente no acepta puertos iguales.
  • Clúster: una ranura para cada agenteCada agente en el servidor obtiene su propia ranura de 0 a 9: puerto de emparejamiento 7450 + ranura, puertos de nodo 7051 + ranura y 7061 + ranura. Así, dos agentes de un mismo servidor pueden unirse a un clúster. El conmutador --pairing-port establece la ranura explícitamente.
Dos instancias de una línea. El plan ve ambos servidores Firebird y ambos agentes y cambia solo la instancia seleccionada.

Imágenes · compose · puertos

HQbird en Docker

Hay una imagen lista para cada línea de Firebird. Firebird, el agente y HQbird Monitor se ejecutan en el contenedor. El agente instala el nodo del clúster dentro del propio contenedor cuando el servidor se une a un clúster. Solo instala RCM cuando este servidor se asigna como el RCM del clúster.

ImagenFirebirdPuerto de FirebirdHQbird Monitor
ghcr.io/ibsurgeon/hqbird2027-fb505.0305023050
ghcr.io/ibsurgeon/hqbird2027-fb404.0305023050
ghcr.io/ibsurgeon/hqbird2027-fb303.0305023050
ghcr.io/ibsurgeon/hqbird2027-fb252.5305023050
  • Primer inicioCopie compose.yaml del kit, coloque la contraseña de SYSDBA en un archivo secreto, elimine el # de las líneas secrets: y ejecute docker compose up -d. El servidor está listo cuando docker compose ps muestra healthy.
  • Puerto de FirebirdLa variable HQBIRD_FB_PORT, 3050 por defecto. HQbird Monitor escucha en 20000 + este puerto.
  • Firma de la imagenLas imágenes están firmadas con la herramienta cosign. La clave pública para la verificación aún no está publicada.
  • Varias instancias en un mismo hostFirebird en 3050 + N, HQbird Monitor en 20000 + puerto de Firebird, nodo del clúster en 7051 + N. Solo una instancia en el host puede tener RCM.
  • El mismo número de puerto fuera y dentroPublique 3051:3051, no 3051:3050. El agente y el clúster informan el puerto que ven dentro del contenedor.
  • ClústerLa dirección del miembro es la dirección del host de Docker. Publique el puerto del nodo y, para RCM, los puertos 7443 y 7444.

Docker publica puertos más allá de ufw. Una regla de ufw "solo puerto 22" no cierra los puertos del contenedor. Publique el puerto en una dirección del host o ciérrelo con un firewall externo.

Nube y Docker: configuraciones, volúmenes, puertos, actualizaciones

Agente · consola · clúster · Firebird

Actualizaciones después de la instalación

Después de conectarse a HQCenter, el agente se actualiza a sí mismo, a HQbird Monitor, a los componentes del clúster, a fbmcp y a Firebird por su cuenta. Un servidor sin HQCenter también se actualiza a sí mismo: el agente toma las nuevas versiones del servidor de actualizaciones de IBSurgeon.

El agente ve una nueva versión de sí mismo en HQCenter en un minuto. Las nuevas versiones de HQbird Monitor, fbmcp y Firebird: en una hora. Cada actualización sigue un mismo patrón: comprobar, guardar un punto de reversión, reemplazar, asegurarse de que funciona. Si no funciona, restaurar la anterior.

Actualizaciones sin HQCenter

  • Qué se actualiza por sí soloEl agente, HQbird Monitor y el servidor MCP. La comprobación se ejecuta una vez cada 6 horas.
  • Firebird espera una ordenEl paquete de Firebird se descarga y espera. El administrador lo aplica: con el botón en la página Updates o con el comando fbagent --firebird-update --apply.
  • Usted elige el modoEl conmutador de instalación --auto-update all|agent|off, en Windows /AUTOUPDATE=all|agent|off. agent es el predeterminado. all también instala Firebird, en la ventana de actualización. off no comprueba nada.
  • Página Updates en HQbird MonitorMuestra de dónde toma las versiones el agente, el modo y la última respuesta del servidor, el estado de las actualizaciones de Firebird, la consola y el servidor MCP. El administrador cambia el modo y aplica el paquete de Firebird.
  • Comprobación del origenEl servidor de actualizaciones se comprueba contra una clave fijada. La firma del proveedor siempre es obligatoria.
  • El clúster pasa por el centroUn nodo del clúster y RCM no se actualizan de esta manera: los actualiza HQCenter o RCM.

Autoactualización del agente

Autoactualización del agente: comprobaciones, punto de reversión, reemplazo, listo en 180 s, 45 s en ejecución; en caso de fallo: reversión, pausa de 30 min, versión bloqueada tras el segundo fallo
  • Solo hacia adelanteEl agente no instala una versión anterior a la suya, ni siquiera una obligatoria. La comprobación se ejecuta antes de descargar el primer byte. De este modo, un servidor falso no puede restaurar una compilación antigua vulnerable. La excepción es una versión antigua permitida en la propia configuración del agente (allow_downgrade_to).
  • FirmaLas versiones están firmadas con una clave Ed25519; la clave pública está integrada en el agente. Una firma incorrecta siempre se rechaza. El modo "solo firmadas" se activa en la propia configuración del agente, no desde el servidor.
  • Reversión manualJunto al agente hay un script rollback_to_version_NNN: restaura el agente y la configuración anteriores y bloquea la versión fallida. Se conservan los dos últimos puntos de reversión; los más antiguos se eliminan automáticamente.
  • Linux: root ejecuta solo su propia copiaEl agente se ejecuta como firebird. El reemplazo lo realiza una copia verificada en una carpeta en la que solo root puede escribir.

Actualización de Firebird

Firebird se actualiza solo dentro de su línea y solo a una compilación más reciente. El agente puede descargar y preparar el paquete en cualquier momento, pero detiene Firebird solo en la ventana de actualización.

  1. 1Preparacióndescarga, firma, compilación no anterior al motor
  2. 2Ventanaventana diaria; una versión obligatoria también espera a la ventana
  3. 3Tareasgbak, nbackup o un script SQL en ejecución: el intento se pospone
  4. 4Reemplazolos archivos del motor antiguo se apartan, las configuraciones se mantienen
  5. 5ComprobaciónFirebird arranca y responde en su puerto
  6. 6✓ o reversiónlos archivos antiguos vuelven, la compilación se bloquea
Qué se actualizaProtecciónSi falla
agente fbagentFirma, solo más reciente, listo en 180 s y 45 s en ejecuciónReversión, pausa de 30 minutos; un segundo fallo bloquea la versión
HQbird Monitor, clúster, fbmcpFirma, solo más reciente que la instaladaSe mantiene la versión anterior; se conservan las 2 copias más recientes
FirebirdVentana, espera a las copias de seguridad, comprobación tras el arranqueEl motor antiguo vuelve, la compilación pasa a la lista de bloqueo

Una versión bloqueada no se instala de nuevo, pero la siguiente versión se instala con normalidad. De este modo, el servidor no entra en un bucle de "actualizar → revertir → actualizar".

Carpetas · registros · desinstalación

Dónde están los archivos y cómo desinstalar

Windows

C:\HQbird\
  Firebird50\            Firebird 5.0, configuraciones, BD de seguridad
  fbagent-fb50\          agente y HQbird Monitor
    agent_config.json    configuración del agente
    logs\  bak\  update\ registros, copias, caché de actualización
C:\HQbirdData\           datos de trabajo del agente y la consola
  config\access.properties  inicio de sesión de la consola
C:\ProgramData\fbagent\  resultado y registro de la instalación

Linux

/opt/firebird/           Firebird 5.0 (segunda línea: /opt/fb50)
/opt/hqbird/
  conf/access.properties inicio de sesión de la consola, 0600
  fbagent-fb50/          agente y HQ Monitor
    agent_config.json    configuración del agente
    logs/  bak/  update/ registros, copias, caché de actualización
/var/lib/hqmonitor/      datos de la consola
/var/log/fbagent/install.log  registro de instalación, sin contraseñas
  • La desinstalación no toca tus bases de datosTus bases de datos y copias de seguridad (*.fdb, *.gdb, *.fbk, *.nbk) siempre se conservan. La eliminación de datos borra solo la BD de seguridad y los ejemplos del paquete de Firebird.
  • Windows"Aplicaciones": elimina el agente, la consola, el RCM de este agente, las reglas de firewall y el Firebird que este instalador instaló como nuevo. Si otros agentes usan el RCM de este agente, el asistente pregunta "¿Eliminar esta instancia de todos modos?"; una desinstalación silenciosa requiere /FORCE. Un Firebird actualizado se mantiene. Las configuraciones y la BD de seguridad se eliminan solo si seleccionas "eliminar datos".
  • Linux--uninstall elimina los servicios del agente y la consola, el RCM de este agente, las reglas de sudoers y los puertos que el instalador abrió en firewalld o ufw. El agente primero abandona el clúster. Si otros agentes usan su RCM, necesitas el modificador --force. Firebird se mantiene. --remove-data también elimina la configuración, los registros y los datos de la consola.
  • HQbird antiguoDesinstalar HQbird 2027 no vuelve a activar los servicios antiguos: el administrador lo decide usando el archivo de estado.
Linux, desinstalar una instancia (Firebird y las bases de datos se mantienen):
sudo sh hqbird2027-fb50-linux-<version>.run --uninstall --agent-dir /opt/hqbird/fbagent-fb50-2

← Volver a la descripción general de HQbird 2027 · Estado del servidor →