Instalación y actualizaciones
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.
| Componente | Qué hace | Windows | Linux |
|---|---|---|---|
| Firebird, compilación HQbird | Un 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 fbagent | Copias de seguridad, monitorización, mantenimiento, actualizaciones. | HQbirdFBAgent-fb50 | hqbirdfbagent-fb50, usuario firebird |
| HQbird Monitor | Consola 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-fb50 | hqbirdmonitor-fb50 |
| Componentes de clúster | Los 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 fbmcp | Acceso 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 Firebird | Sí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.
- 1Comprobación del servidorpermisos, arquitectura; en Linux también systemd y el kernel
- 2Comprobación del kitsha256 antes de descomprimir; firmas de archivos antes de la instalación
- 3Planlo que se encontró y lo que se hará
- 4Preguntasnombre del servidor para HQCenter; ¿detener Firebird? ¿otra versión?
- 5InstalaciónFirebird, agente, consola, servicios
- 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ódigo | Significado (.run de Linux) |
|---|---|
| 0 | Hecho |
| 1 | Rechazado: servidor, conmutador o plan. Nada cambió |
| 2 | La instalación falló, cambios revertidos |
| 3 | Rollback incompleto: el resultado indica qué comprobar |
| 4 | Se necesita una respuesta: no hay terminal ni --yes |
| 5 | El kit no superó la comprobación: descárgalo de nuevo |
| 6 | No hay bibliotecas del SO ni repositorio |
| 7 | Firebird de paquetes de la distribución |
| Código | Significado (setup.exe de Windows) |
|---|---|
| 0 | Instalado |
| 1 | Rechazado antes de la instalación: conmutador o archivo incorrecto, hay una versión más reciente instalada, sin derechos de administrador |
| 4 | El instalador tenía una pregunta, pero no hay conmutador /YES |
| 7 | Falló la comprobación del servidor o la instalación. El motivo está en el registro y en el archivo de resultado |
| 10 | Instalado, pero falló la conexión con HQCenter |
-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.
- Qué no cambia
databases.confoaliases.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. Enfirebird.conf, solo se añade la líneaMonitoringPlugin = 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.
- 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
-2en 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-portestablece la ranura explícitamente.
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.
| Imagen | Firebird | Puerto de Firebird | HQbird Monitor |
|---|---|---|---|
ghcr.io/ibsurgeon/hqbird2027-fb50 | 5.0 | 3050 | 23050 |
ghcr.io/ibsurgeon/hqbird2027-fb40 | 4.0 | 3050 | 23050 |
ghcr.io/ibsurgeon/hqbird2027-fb30 | 3.0 | 3050 | 23050 |
ghcr.io/ibsurgeon/hqbird2027-fb25 | 2.5 | 3050 | 23050 |
- Primer inicioCopie
compose.yamldel kit, coloque la contraseña de SYSDBA en un archivo secreto, elimine el#de las líneassecrets:y ejecutedocker compose up -d. El servidor está listo cuandodocker compose psmuestrahealthy. - 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, no3051: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, actualizacionesAgente · 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.agentes el predeterminado.alltambién instala Firebird, en la ventana de actualización.offno 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
- 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.
- 1Preparacióndescarga, firma, compilación no anterior al motor
- 2Ventanaventana diaria; una versión obligatoria también espera a la ventana
- 3Tareasgbak, nbackup o un script SQL en ejecución: el intento se pospone
- 4Reemplazolos archivos del motor antiguo se apartan, las configuraciones se mantienen
- 5ComprobaciónFirebird arranca y responde en su puerto
- 6✓ o reversiónlos archivos antiguos vuelven, la compilación se bloquea
| Qué se actualiza | Protección | Si falla |
|---|---|---|
| agente fbagent | Firma, solo más reciente, listo en 180 s y 45 s en ejecución | Reversión, pausa de 30 minutos; un segundo fallo bloquea la versión |
| HQbird Monitor, clúster, fbmcp | Firma, solo más reciente que la instalada | Se mantiene la versión anterior; se conservan las 2 copias más recientes |
| Firebird | Ventana, espera a las copias de seguridad, comprobación tras el arranque | El 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
--uninstallelimina 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-datatambié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.
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 →