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

Esta guía está dirigida al administrador que instala HQbird 2027 en un servidor Linux con el instalador offline hqbird2027-fbNN-linux-<version>.run. Cubre una instalación nueva, la actualización de un HQbird anterior y de un HQbird 2027 previo, los comandos de mantenimiento, la conexión a su HQCenter, la instalación desatendida (mediante scripts) y dónde quedan los archivos después de la instalación.

Los ejemplos muestran el instalador para Firebird 5.0 en Ubuntu 24.04. Los instaladores para Firebird 2.5, 3.0 y 4.0 funcionan de la misma manera; solo difieren la versión, el puerto predeterminado y los nombres de las carpetas. La configuración de Windows se describe en Windows installation.

Contenido

  1. 1. Qué instala el instalador
  2. 2. La instalación de un vistazo
  3. 3. Instalación nueva
  4. 4. Después de la instalación
  5. 5. Actualización de un HQbird anterior (2024 y anteriores)
  6. 6. Actualización de HQbird 2027 a una nueva versión
  7. 7. Comandos de mantenimiento
  8. 8. Conectar a su HQCenter
  9. 9. Instalación desatendida y scripts
  10. 10. Solución de problemas

1. Qué instala el instalador

Un archivo .run = una línea de Firebird. Elija el instalador de la versión de Firebird que usan sus bases de datos:

Instalador Firebird que instala o actualiza Primer Firebird en el host Tamaño
hqbird2027-fb50-linux-<version>.run Firebird 5.0 (compilación de HQbird) /opt/firebird, puerto 3050 unos 250 MB
hqbird2027-fb40-linux-<version>.run Firebird 4.0 (compilación de HQbird) /opt/firebird, puerto 3050 unos 220 MB
hqbird2027-fb30-linux-<version>.run Firebird 3.0 (compilación de HQbird) /opt/firebird, puerto 3050 unos 130 MB
hqbird2027-fb25-linux-<version>.run Firebird 2.5 (compilación de HQbird) /opt/firebird, puerto 3050 unos 80 MB

Cada instalador contiene e instala sin Internet:

  • Firebird (la compilación de HQbird de esa línea): un servidor nuevo, o una actualización in situ del Firebird de esa línea que ya está en el host. Se conservan su firebird.conf, databases.conf (aliases.conf para 2.5), la base de datos de seguridad y la contraseña de SYSDBA.
  • Archivos de depuración de Firebird (símbolos para el análisis de fallos), instalados en la carpeta de Firebird. --no-debug los omite.
  • Agente de HQbird (fbagent): la unidad systemd hqbirdfbagent-fb50, que se ejecuta con el usuario firebird, y que realiza las copias de seguridad, la monitorización, las tareas de mantenimiento y las actualizaciones. El nombre termina con la línea de Firebird (-fb25 … -fb50); una segunda instancia de la línea tiene -fb50-2.
  • HQ Monitor: la consola web de esta instancia de HQbird, unidad hqbirdmonitor-fb50, dirección http://<server>:<20000 + Firebird port>/ (para Firebird en el puerto 3050: http://localhost:23050/).
  • Componentes de clúster: la consola de clúster RCM (hqbirdrcm) y el nodo de clúster (hqclusternode) se copian en la caché del agente. Los kits con agente (fbagent) 3.1.0 y posteriores no crean ningún clúster de forma predeterminada: sin RCM, sin ventana de emparejamiento, sin puerto de clúster en el firewall. Dos preguntas (o --rcm on, --cluster-pairing on) los activan (“Next: cluster” en la sección 3). Con RCM, se instala en /opt/hqbirdrcm y se ejecuta como la unidad hqbirdrcm; el resumen imprime su dirección en la línea RCM:. El nodo obtiene su unidad (por ejemplo hqclusternode-master-p3050) cuando vincula el host en RCM. Los kits desde 2027.2.19 con un agente anterior instalan RCM en cada servidor (--rcm off lo deja en la caché) y abren la ventana de emparejamiento. Los kits anteriores a 2027.2.19 solo copian ambos componentes en la caché del agente: no hay unidad hqbirdrcm ni línea RCM:.

Las instancias instaladas antes de 2027.2.9 tienen el puerto de Firebird en los nombres del agente: carpeta /opt/hqbird/fbagent-p3050, unidades hqbirdfbagent-p3050 y hqbirdmonitor-p3050. Una actualización no cambia estos nombres. Solo las instancias nuevas reciben los nombres -fb<NN>, por lo que un host puede tener ambas formas.

Requisitos: x86_64, kernel 3.2 o posterior, systemd; un Linux con apt, dnf/yum o zypper (Ubuntu, Debian, AlmaLinux, Rocky, RHEL, Oracle Linux, openSUSE, RED OS y otros); root. Unos 300 MB libres en /var/tmp durante la instalación (una carpeta donde los programas pueden ejecutarse; véase --tmpdir). Algunas bibliotecas del SO (libtommath, ICU) se toman del repositorio de la distribución; un servidor sin Internet recibe los comandos exactos para prepararlas (sección 9).

No compatible: un Firebird instalado desde los paquetes de la distribución (firebird3.0-server, rpm firebird). El instalador se detiene antes de cambiar nada (código de salida 7); elimine primero los paquetes (conserve una copia de seguridad gbak de sus bases de datos) o use el instalador en línea con --import-firebird.

Varias líneas de Firebird en un mismo servidor: cada línea tiene su propio instalador. El primer Firebird en el host va a /opt/firebird; una segunda línea va a /opt/fb<NN> (/opt/fb50, /opt/fb40, /opt/fb30) en el puerto de su línea: 3053 para 3.0, 3054 para 4.0, 3055 para 5.0. Cuando ese puerto está en uso, el instalador se detiene y solicita --port N. Varias instancias de una misma línea (un segundo Firebird 5.0 en otro puerto) se instalan con --fb-root <new folder> --port <port> (sección 7). Firebird 2.5 tiene una sola instancia, en /opt/firebird; para un segundo servidor junto a él use otra línea (por ejemplo Firebird 5.0 en /opt/fb50).

Un runbook paso a paso para dos instancias en los puertos 3050 y 3051, para cada línea, con comandos para copiar y pegar, está en hqbird2027-linux-two-instances-runbook.ru.md (ruso) y hqbird2027-linux-two-instances-runbook.pt.md (portugués).

Prueba: sin licencia, el agente ejecuta una prueba de 7 días. El correo electrónico de prueba (--email) la amplía a 30 días. Un archivo de licencia (--license) o la conexión a su HQCenter (sección 8) reemplaza la prueba.

Actualizaciones: a partir del kit 2027.2.31 (agente 3.3.0), un servidor que no está conectado a ningún HQCenter consulta el servidor de actualizaciones del proveedor. De forma predeterminada, el agente, HQ Monitor y fbmcp se actualizan por sí mismos, y un nuevo paquete de Firebird se descarga y espera por usted. --auto-update all|agent|off o la línea Updates de la interfaz de texto cambian esto (“Updates without HQCenter” en la sección 4). Un servidor conectado a un HQCenter toma sus actualizaciones de ese HQCenter.

2. La instalación de un vistazo

Diagram

La comprobación del servidor y la propia instalación las realiza el agente de HQbird que lleva el instalador (fbagent --install-plan, fbagent --setup-install). No se descarga nada excepto los paquetes del SO que falten. No se cambia nada antes de confirmar el plan: los paquetes del SO se instalan después de la confirmación. En una terminal, los kits posteriores a 2027.2.30 abren la interfaz de texto (paso 3 de la sección 3); --no-tui ejecuta el instalador simple, que formula sus preguntas como líneas de texto. Sin terminal y sin --yes, el instalador se detiene en la confirmación con el código de salida 4. Si la instalación falla antes de que se inicie la unidad del agente, el agente revierte las unidades al estado que tenían antes (código de salida 2; código 3 cuando la reversión no fue completa, el resumen indica qué comprobar).

3. Instalación nueva

Paso 1: Descargue el instalador y compruébelo

Command
KIT=hqbird2027-fb50-linux-2027.2.9.run
curl -fL -O https://ib-aid.com/download/hqbird/v2027/$KIT -O https://ib-aid.com/download/hqbird/v2027/$KIT.sha256
sha256sum -c $KIT.sha256

Las demás líneas tienen los mismos nombres con fb40, fb30, fb25. Esperado: hqbird2027-fb50-linux-2027.2.9.run: OK. Un servidor sin Internet: descargue los dos archivos en un PC con los mismos enlaces y cópielos al servidor (scp, una unidad USB, un recurso compartido).

El instalador también comprueba su propia carga útil antes de descomprimir nada: una descarga cortada o dañada se detiene con el código de salida 5 (“download it again”).

Paso 2: Compruebe el host sin cambiarlo (opcional)

Command
sudo sh hqbird2027-fb50-linux-2027.2.9.run --check

--check ejecuta la comprobación del host, informa de las bibliotecas del SO que faltan (y de los comandos para obtenerlas en un servidor sin Internet), muestra lo que el agente encontró y lo que haría, y sale. No se instala nada.

Paso 3: Ejecute el instalador

Command
sudo sh hqbird2027-fb50-linux-2027.2.9.run

Los kits posteriores a 2027.2.30 abren la interfaz de texto cuando los inicia en una terminal: páginas a pantalla completa con el plan y la configuración. Los kits hasta 2027.2.30, y los casos de “The plain installer” a continuación, formulan sus preguntas como líneas de texto. Ambos realizan la misma instalación con las mismas opciones.

La interfaz de texto

El instalador comprueba el host, se descomprime, lee el plan y muestra la primera página. No se cambia nada en el host hasta que inicie la instalación en la página Install.

text
 HQbird 2027 setup <version> | Firebird 5.0 (5.0.5.1917)

 Plan M1: New Firebird and HQbird agent
   Firebird: new /opt/firebird (unit firebird, port 3050)
   Agent: new, in /opt/hqbird/fbagent-fb50
   OS packages to install: libtommath1 (see Plan details)

   Language         English (auto)
   Firebird folder  automatic (/opt/firebird)
   Firebird port    automatic (3050)
   Agent id         automatic (srv1261114-fb50)
   SYSDBA password  generated (for a new Firebird)
   HQ Monitor       port automatic, login admin
   License          not now (add it later in HQ Monitor)
   HQCenter         not attached
   Cluster          RCM off, discovery mode off
   Components       debug files: yes, fbmcp: yes
   Updates          HQbird only (recommended)

 > Install
   Plan details
   About plans
   Quit

 Up/Down: move   Enter: change or start   Esc: quit

Las líneas superiores son el plan para la configuración actual: su código y lo que el instalador hará con Firebird y el agente. Un plan que no es posible aparece en rojo, con el motivo, y el cursor se sitúa en la configuración que lo corrige. Después de cada cambio, el instalador vuelve a leer el plan.

Tecla Qué hace
Arriba, Abajo Mueve el cursor (también k, j)
Enter Abre la configuración bajo el cursor, selecciona un elemento, acepta un valor escrito
Espacio Activa o desactiva un componente (la página Components)
Esc Vuelve a la página anterior; en la primera página: sale del instalador (pregunta primero)
Ctrl+C Detiene el instalador de inmediato (código de salida 2). No se cambió nada antes de la página Install

En una página donde se escribe un valor (una carpeta, un puerto, una dirección), Enter lo acepta y un valor vacío significa “automático”. Esc no sale de una página de este tipo.

Configuración Qué elige Lo mismo que la opción
Language Inglés, ruso, portugués de Brasil, alemán; las páginas cambian de inmediato --lang
Firebird folder La carpeta de un Firebird nuevo, o del Firebird que se va a actualizar. Firebird 2.5 tiene una sola carpeta, por lo que su instalador no tiene esta línea --fb-root
Firebird port El puerto TCP de Firebird --port
Agent id Automático, el nombre del host, el nombre del host y la instancia, o su propio valor. Solo para un agente nuevo: un agente instalado conserva su id y la línea no se muestra --agent-id
SYSDBA password Para un Firebird nuevo: generada, o la suya propia --sysdba-pass-file
HQ Monitor El puerto y el inicio de sesión de la consola web --hqmonitor-port, --hqmonitor-login, --hqmonitor-password-file
License No ahora, una prueba de 30 días por correo electrónico (dirección, aviso de privacidad, zona), o un archivo de licencia --email --accept-privacy --trial-zone, --license
HQCenter El archivo attach.json de su HQCenter --attach
Cluster El gestor de clúster RCM (id de clúster, contraseña de administrador), el modo de descubrimiento, el puerto de emparejamiento --rcm, --cluster-id, --rcm-password-file, --cluster-pairing, --pairing-port
Components Archivos de depuración de Firebird; fbmcp y las direcciones de su modo remoto --no-debug, --no-fbmcp, --fbmcp-allow-from

| Actualizaciones | Solo HQbird (el agente, HQ Monitor y fbmcp se actualizan por sí mismos, un nuevo Firebird espera por usted), HQbird y Firebird (Firebird también se actualiza por sí mismo, de noche de 03:30 a 04:00, con un reinicio de Firebird), o Desactivado. Kits desde 2027.2.31; solo para un nuevo agente sin archivo attach.json: un HQCenter controla las actualizaciones de un agente adjunto | --auto-update |

Las opciones en la línea de comandos son los valores con los que comienzan las páginas: sudo sh hqbird2027-fb50-linux-<ver>.run --rcm on --port 3055 abre la primera página con RCM activado y el puerto 3055.

Las cuatro líneas bajo los ajustes:

  • Install muestra el plan completo y luego pregunta Start the install now? con el cursor en No. Las preguntas del plan (un HQbird anterior, un Firebird en ejecución que detener) están en la misma página: Sí las responde todas. Tras el Sí las páginas se cierran, y la instalación imprime su registro y el resumen en la pantalla normal, como en el instalador simple de abajo.
  • Plan details muestra qué significa el código del plan, qué encontró el instalador en el host, las advertencias y los paquetes del SO que instalará.
  • About plans enumera todos los códigos (M1 … M17). Intro sobre un código lo explica. Un * marca el código del plan actual.
  • Quit sale del instalador (código de salida 1). No se cambió nada.

El instalador simple

El instalador simple se ejecuta cuando se cumple una de estas condiciones:

  • la opción --no-tui, o la variable HQBIRD_NO_TUI=1;
  • --yes, --check, --uninstall, --extract, --plan-help, --help;
  • stdin o stdout no es un terminal: un script, ssh host 'command' sin un terminal, o una tubería como ... 2>&1 | tee install.log;
  • TERM es dumb o no está definido;
  • la ventana es menor que 80 columnas por 24 filas (dentro de tmux con su línea de estado un terminal de 80x24 tiene 23 filas: haga la ventana más grande, o use --no-tui);
  • bash en el host es anterior a 4.4 (RHEL 7, CentOS 7);
  • el kit es 2027.2.30 o anterior.

Para la ventana y para bash, la primera línea de la salida dice por qué no se abrieron las páginas.

Una ejecución típica del instalador simple en un servidor sin Firebird:

text
[install] HQbird 2027 setup 2027.2.9, Firebird 5.0 (5.0.5.1916)
[install] host: Ubuntu 24.04.5 LTS, kernel 6.8.0-142-generic
[install] checking the payload (sha256) ...
[install] unpacking into /var/tmp/hqbird2027.k3Qf1x ...
[install] OS libraries missing: libtommath.so.1 (packages: libtommath1)
[install] plan M1: Firebird new /opt/firebird (unit firebird, port 3050)
[install]              agent new in /opt/hqbird/fbagent-fb50 (unit hqbirdfbagent-fb50), HQ Monitor hqbirdmonitor-fb50
[install]              OS packages to install: libtommath1
[install] Install as planned? Yes/No y
[install] installing from the package repository: libtommath1
[install] OS libraries: installed
[install] installing (fbagent --setup-install; log /var/log/fbagent/install.log) ...
...
Done: agent hqbirdfbagent-fb50 in /opt/hqbird/fbagent-fb50, Firebird 5.0.5.1916 in /opt/firebird (port 3050).
HQ Monitor: http://localhost:23050/ (login admin; password in /opt/hqbird/conf/access.properties)
[install] done. Uninstall: sudo sh hqbird2027-fb50-linux-2027.2.9.run --uninstall

Este ejemplo es del kit 2027.2.9. A partir del kit 2027.2.19 el resumen también tiene las líneas RCM: y Pairing: de la consola del clúster (“Next: cluster” abajo). Con el agente 3.1.0 y posteriores y sin clúster elegido, son:

text
RCM:        off; turn it on in HQbird Monitor or with fbagent --cluster-init <id>
Pairing:    off; turn it on in HQbird Monitor or with fbagent --cluster-pairing on (port 7450)

Qué significan las líneas:

  • host: la distribución y el kernel; el instalador rechaza un host que no sea x86_64, no tenga systemd, o ejecute un kernel anterior a 3.2.
  • OS libraries: lo que el Firebird de esta línea necesita del SO (sección 9). El plan enumera los paquetes faltantes (OS packages to install); tras la confirmación el instalador los toma del repositorio de la distribución. Sin un repositorio se detiene con el código de salida 6 e imprime los comandos.
  • plan: lo que encontró el agente (líneas found Firebird ..., HQbird: ...) y lo que hará: Firebird new (un nuevo servidor), update (el Firebird de esta línea se actualiza en su lugar), o un rechazo con el motivo (código de salida 1, nada cambiado).
  • Install as planned? Yes/No: la última pregunta antes de que se cambie nada. Responda y. Cuando el plan tiene sus propias preguntas (un HQbird anterior, otra versión), vienen en su lugar (sección 5). Sin un terminal, pase --yes; de lo contrario el instalador se detiene con el código de salida 4.
  • Cluster questions (agente 3.1.0 y posteriores): Install the cluster manager (RCM) on this host and make a new cluster? [y/N] y Turn on discovery mode for 24 hours (an RCM on the network may invite this agent into its cluster; port 7450)? [y/N]. El valor predeterminado es No. La primera se pregunta solo cuando el host no tiene RCM y el agente no está en ningún clúster; la segunda no cuando el agente está en un clúster o ejecuta el RCM. --yes y una ejecución sin terminal responden No (sin código de salida 4).
  • HQ Monitor: la dirección y el inicio de sesión. Una nueva instalación obtiene el inicio de sesión admin; su contraseña generada está en /opt/hqbird/conf/access.properties (modo 0600, legible solo por root y el agente). Todas las instancias de HQbird 2027 del host comparten este archivo. Cambie la contraseña en HQ Monitor.

La contraseña SYSDBA de un nuevo Firebird se genera y se guarda en /root/fbagent-install-sysdba.txt (modo 0600): una línea de comentario, luego la línea SYSDBA_PASS=<password>. Un Firebird adicional instalado en el mismo host más tarde obtiene la misma contraseña de este archivo. Para establecer la suya, pase --sysdba-pass-file <file> (primera línea del archivo) o --sysdba-pass <password>.

Idioma del instalador

Los kits posteriores a 2027.2.30 hablan cuatro idiomas: inglés, ruso (ru), portugués de Brasil (pt-BR) y alemán (de). El instalador elige el idioma en este orden:

  1. la opción --lang en|ru|pt-BR|de;
  2. la variable HQBIRD_LANG;
  3. la configuración regional de la consola (LC_ALL, luego LC_MESSAGES, luego LANG), cuando es una configuración regional UTF-8;
  4. inglés.

La segunda línea de la salida dice qué idioma es y cómo cambiarlo. Esta línea siempre está en inglés:

text
[install] Language: Русский (auto). Use --lang en to change.

Notas:

  • PuTTY no envía LANG al servidor. Cuenta la configuración regional propia del servidor, así que el idioma suele ser inglés. Use --lang.
  • Con --yes, y sin un terminal, el idioma automático es inglés: los scripts leen esa salida. --lang sigue funcionando ahí.
  • El instalador necesita una configuración regional UTF-8 en el host para los otros idiomas (C.UTF-8 o en_US.UTF-8). Establece una para sí mismo. Sin una habla inglés.
  • En la interfaz de texto la línea Language de la primera página cambia el idioma de inmediato. El terminal debe mostrar UTF-8 (PuTTY: Window, Translation, Remote character set UTF-8, que es su valor predeterminado).
  • El inglés permanece en: las líneas de progreso de la propia instalación, el resumen Done:, /var/log/fbagent/install.log, y las advertencias del escaneo del host.

El código del plan

El plan tiene un código: M1, M2, … Nombra el caso que el instalador encontró en el host. El instalador imprime qué significa el código:

text
[install] plan M1: New Firebird and HQbird agent
[install]              This host has no Firebird and no older HQbird. Setup installs a new Firebird and a new HQbird agent.
[install] plan M1: Firebird new /opt/firebird (unit firebird, port 3050)

--plan-help imprime todos los códigos y sale. No cambia nada. En la interfaz de texto la primera página muestra el código y su título, “Plan details” muestra el texto, y “About plans” enumera todos los códigos.

Código Qué encontró el instalador Firebird Agente HQbird anterior
M1 nada nuevo nuevo —
M2 Firebird de esta línea, sin HQbird anterior actualizar nuevo —
M3 Firebird de otra línea, sin HQbird anterior nuevo, puerto 305N nuevo —
M4 HQbird anterior que sirve al Firebird de esta línea actualizar nuevo desactivado, sus tareas importadas como habilitadas
M5 HQbird anterior de otra línea; hay un Firebird de esta línea actualizar, tras una pregunta nuevo sigue funcionando
M6 HQbird anterior de otra línea; sin Firebird de esta línea nuevo, tras una pregunta nuevo sigue funcionando
M7 HQbird anterior sin un Firebird local de una versión conocida actualizar o nuevo nuevo sigue funcionando, una advertencia
M8 un agente HQbird 2027 para otro Firebird actualizar o nuevo nuevo, junto al primero sin cambios
M9 como M8, y un HQbird anterior sirve a esta línea actualizar nuevo, junto al primero desactivado, sus tareas importadas como habilitadas
M10 un agente ya sirve a este Firebird (una ejecución repetida) actualizar en su lugar desactivado cuando se ejecuta
M11 --fb-root es un Firebird de esta línea actualizar nuevo o en su lugar como arriba
M13 --fb-root es una carpeta vacía o nueva nuevo en esa carpeta nuevo como arriba

Códigos de un rechazo (código de salida 1, nada cambiado): M12 la carpeta tiene un Firebird que el instalador no puede actualizar (otra línea, una versión que no puede leer, un servicio deshabilitado); M14 la carpeta no está vacía y no tiene Firebird; M16 varios servidores Firebird de esta línea, indique --fb-root; M17 Firebird 2.5 funciona solo en /opt/firebird. M15 es el kit solo de agente: Firebird no se instala ni se actualiza.

El id del agente

El id del agente nombra al agente en HQCenter, en la licencia y en el clúster. Se establece solo en la primera instalación:

  • Predeterminado: nombre del host + fecha + instancia, por ejemplo srv1261114-fb50.
  • --agent-id ID da su propio id (1-128 letras, dígitos, ., _ o -; el primero una letra o dígito).
  • El instalador rechaza un id que ya tenga otro agente del host.
  • En la interfaz de texto la página Agent id ofrece el id automático, el nombre del host, el nombre del host con la instancia, y su propio valor, y enumera los ids que el host ya tiene.
  • Un agente instalado conserva su id. Una ejecución repetida lo muestra en el plan (id srv1 (kept)), la interfaz de texto no tiene entonces una línea Agent id, y --agent-id ahí solo da una advertencia. Un nuevo agente en una carpeta que una instalación anterior dejó con su configuración también conserva el id de esa configuración.

Paso 4: Comprobar el resultado

Command
systemctl status firebird hqbirdfbagent-fb50 hqbirdmonitor-fb50 --no-pager
ss -ltnp | grep -E ':3050|:23050'
ISC_PASSWORD="$(sed -n 's/^SYSDBA_PASS=//p' /root/fbagent-install-sysdba.txt)" \
  /opt/firebird/bin/isql -user SYSDBA localhost/3050:/opt/firebird/examples/empbuild/employee.fdb

Use la ruta completa de la base de datos de ejemplo: funciona para todas las líneas y también tras una actualización, mientras que el databases.conf conservado de una instalación anterior puede no tener el alias employee (una nueva instalación de 2027.2.3 lo tiene).

Abra http://<server>:23050/ en un navegador e inicie sesión como admin con la contraseña de /opt/hqbird/conf/access.properties. El puerto de Firebird y el puerto de HQ Monitor se abren en firewalld (zona public) cuando se ejecuta, si no en ufw cuando está activo; con otro firewall ábralos usted mismo. Los puertos del clúster se abren solo para una opción de clúster: 7443, 7444 y el puerto del nodo con --rcm on; el puerto del nodo y el puerto de emparejamiento con --cluster-pairing on. Sin un firewall activo el instalador imprime una línea con los puertos que no abrió. Un puerto que estaba abierto antes de la instalación se deja como está.

Siguiente: clúster

Para replicar sus bases de datos de un servidor maestro a un servidor réplica, vincule los dos servidores en la consola del clúster RCM. Con el agente 3.1.0 y posteriores, instale RCM solo en el maestro (--rcm on, o responda y) y active el modo de descubrimiento en la réplica (--cluster-pairing on). El modo de descubrimiento abre la ventana de emparejamiento durante 24 horas: el puerto de emparejamiento de la ranura del agente (7450 para la primera instancia, 7451 para la segunda, hasta 7459) está abierto en el firewall, y el RCM puede invitar al agente. Un host tiene un RCM (puertos 7443 y 7444); el agente que lo creó lo ejecuta y no abre ninguna ventana de emparejamiento.

Después, sin el instalador: HQ Monitor → Clusters → Cluster on this server, o fbagent --cluster-init <id> y fbagent --cluster-pairing on. Los kits desde 2027.2.19 con un agente más antiguo inician RCM en cada servidor e imprimen su dirección en la línea RCM: del resumen; una instalación anterior a 2027.2.19 obtiene RCM cuando la actualiza con un kit más nuevo (sección 6). La guía del clúster (para el kit 2027.2.33) va paso a paso desde dos servidores nuevos hasta una réplica funcional, con capturas de pantalla: Guía del clúster de Linux (también en ruso y portugués). Los mismos pasos como solo comandos: hqbird2027-linux-cluster-runbook.md (hqbird2027-linux-cluster-runbook.ru.md, hqbird2027-linux-cluster-runbook.pt.md).

4. Después de la instalación

Unidades

Unidad Qué Se ejecuta como
firebird (2.5, 4.0, 5.0 en /opt/firebird); firebird-superserver (3.0 en /opt/firebird); para otra carpeta, el nombre de la carpeta con / → _: firebird.opt_fb50, firebird.opt_fb40-2 (4.0, 5.0 en /opt/fb50, /opt/fb40-2), firebird.opt_fb30-superserver (3.0 en /opt/fb30) Servidor Firebird firebird
hqbirdfbagent-fb50 (segunda instancia hqbirdfbagent-fb50-2; antes de 2027.2.9 hqbirdfbagent-p<puerto de Firebird>) Agente de HQbird firebird
hqbirdmonitor-fb50 (hqbirdmonitor-fb50-2; antes de 2027.2.9 hqbirdmonitor-p<puerto de Firebird>) HQ Monitor firebird

Las tres están habilitadas y se inician al arrancar. journalctl -u hqbirdfbagent-fb50 muestra el registro de la unidad del agente. Firebird 3.0 también tiene las unidades firebird-classic.socket y [email protected] (firebird.opt_fb30-classic.* en otra carpeta), y Firebird 2.5 tiene firebird.socket: permanecen inactive, esto es normal. El proceso de Firebird 2.5 es fb_smp_server (SuperClassic).

Dónde están los archivos

El ejemplo es la primera instancia de Firebird 5.0 en /opt/firebird en el puerto 3050. Una segunda instancia de la línea tiene -2 en los nombres de los agentes (fbagent-fb50-2, hqbirdfbagent-fb50-2, hqbirdmonitor-fb50-2). Las instancias instaladas antes de 2027.2.9 tienen el puerto en estos nombres (fbagent-p3050, hqbirdfbagent-p3050, hqbirdmonitor-p3050).

text
/opt/firebird/                         Firebird 5.0 server: bin/, lib/, plugins/, firebird.conf,
                                       databases.conf, security5.fdb, *.debug files (symbols)
/opt/fb50/                             a Firebird 5.0 next to another line (/opt/fb40, /opt/fb30)
/opt/hqbird/                           root of the HQbird agents
  conf/access.properties               HQ Monitor sign-in, shared by all instances of the host (0600)
  fbagent-fb50/                        HQbird agent of this Firebird
    fbagent                            the agent (unit hqbirdfbagent-fb50)
    hqmonitor                          HQ Monitor (unit hqbirdmonitor-fb50)
    agent_config.json                  agent configuration (encrypted secrets: config_secret.key)
    config.properties                  HQ Monitor configuration
    hqbird2027-firebird.json           the Firebird this installer installed
    hqbird2027-hqmonitor-firewall.json the HQ Monitor port this installer opened in firewalld or ufw
    conf/                              trace and job settings
    logs/                              agent log (firebird-agent_<date>.jsonl), license_state.json;
                                       journal.log and server_status.json after the first checks
    bak/                               backups of the configuration
    outcoming/                         status reports for HQCenter
    update/                            update cache: hqmonitor/, hqclusternode/, hqbirdrcm/
    certs/                             certificates after the attach to HQCenter
  fbagent-hqbird-takeover.json         state of the older HQbird units before the takeover (section 5)
/opt/hqbirdrcm/                        the cluster console RCM (unit hqbirdrcm, owner firebird):
                                       with agent 3.1.0 only after --rcm on (or HQ Monitor);
                                       kits 2027.2.19+ with an older agent: unless --rcm off
/opt/hqclusternode/                    the cluster node (owner firebird), empty until the host is
                                       linked in RCM or HQCenter adds it to a cluster
/var/lib/hqmonitor/<server id>/        HQ Monitor data
/var/log/fbagent/install.log           log of the installer's steps (passwords are hidden)
/root/fbagent-install-sysdba.txt       SYSDBA password of a new Firebird (root only, 0600)
/etc/sysctl.d/90-hqbird-firebird.conf  kernel settings for Firebird (vm.max_map_count), only when
                                       the system value is lower (Ubuntu 24.04 needs none)
/etc/sudoers.d/                        the agent's sudoers rules for its root helpers (updates, HQ Monitor)

El instalador no deja nada en /var/tmp: su carpeta de trabajo /var/tmp/hqbird2027.XXXXXX se elimina al final, también después de un error.

Registros

Registro Dónde
Instalador la terminal; /var/log/fbagent/install.log
Agente /opt/hqbird/fbagent-fb50/logs/firebird-agent_<fecha>.jsonl, journal.log; journalctl -u hqbirdfbagent-fb50
HQ Monitor journalctl -u hqbirdmonitor-fb50; registro de auditoría /opt/hqbird/fbagent-fb50/hqmonitor_audit.log
Firebird /opt/firebird/firebird.log

Actualizaciones sin HQCenter

Desde el kit 2027.2.31 (agente 3.3.0), un agente que no está conectado a ningún HQCenter toma las nuevas versiones del servidor de actualizaciones del proveedor. El modo de actualización es la clave update.mode de agent_config.json:

Modo Qué se actualiza por sí solo
agent (predeterminado) El agente, HQ Monitor y fbmcp. Un nuevo paquete de Firebird se descarga y espera al administrador
all Lo mismo, y Firebird también, en su ventana de aplicación (por la noche de 03:30 a 04:00; la actualización reinicia Firebird)
off Nada: el agente no hace comprobaciones de actualización. Para actualizar, ejecute el instalador de una nueva versión (sección 6)
  • En la instalación: la línea Updates de la interfaz de texto, o --auto-update all|agent|off. Sin ellas, el instalador no cambia el modo.
  • Más tarde: la página Updates de HQ Monitor, o el instalador de nuevo con --auto-update <modo>.
  • El estado: sudo /opt/hqbird/fbagent-fb50/fbagent --update-status (añada --json para un script). Muestra la fuente de la versión, la zona y la última respuesta del servidor de actualizaciones.

El agente abre conexiones HTTPS salientes solo a estas direcciones. No se necesita ningún puerto entrante.

Propósito Dirección
Actualizaciones, zona EU liceu.ibsurgeon.com:9443
Actualizaciones, zona BR licbr.ibsurgeon.com:9443
Actualizaciones, zona RU licru.ibsurgeon.com:20943
Licencia de prueba trialeu.ibsurgeon.com:9443, trialbr.ibsurgeon.com:19443, trialru.ibsurgeon.com:23943

Un servidor conectado a un HQCenter no usa las direcciones de actualización: toma sus actualizaciones de ese HQCenter (sección 8).

Notificaciones

Desde el kit 2027.2.33 (agente 3.4.0), el agente envía mensajes sobre problemas del servidor a un bot de Telegram propio, un webhook o correo electrónico (SMTP). El instalador no configura ningún canal, y no se envía nada hasta que añada uno: HQ Monitor → Servers → Notifications. Para probar un canal desde la línea de comandos: sudo -u firebird /opt/hqbird/fbagent-fb50/fbagent --notify-test <canal>; --notify-history muestra las últimas entregas.

5. Actualización de un HQbird anterior (2024 y anteriores)

El instalador encuentra un HQbird (FBDataGuard) instalado en /opt/hqbird y sus unidades, y los servidores Firebird que gestiona. Luego sigue las mismas reglas que los scripts de instalación de HQbird:

Diagram

Lo que se ve en la terminal:

text
[install]   found Firebird 5.0.5.1878: /opt/firebird, port 3050, unit firebird, no agent
[install] plan M4: Firebird update /opt/firebird (unit firebird, port 3050)
[install]              agent new in /opt/hqbird/fbagent-fb50 (unit hqbirdfbagent-fb50), HQ Monitor hqbirdmonitor-fb50
[install]              HQbird services to turn off: hqbird
[install] Firebird 5.0.5.1878: unit firebird, port 3050, 0 TCP connections
[install] Confirm to stop running Firebird 5.0.5.1878? Yes/No y
  • El plan nombra el Firebird que se actualiza; --fb-root y --port no pueden moverlo (su unidad está tomada).
  • La pregunta Confirm to stop running Firebird? se hace cuando el motor debe detenerse; la línea anterior muestra las conexiones abiertas. Another version se pregunta cuando el HQbird anterior gestiona un Firebird de otra versión (actualice ese, o uno nuevo junto a él). --yes responde a todas las preguntas con Yes; sin una terminal y sin --yes el instalador se detiene con el código de salida 4 y no cambia nada.
  • --disable-hqbird desactiva las unidades del HQbird anterior en cualquier caso; --no-hqbird deja intacto el HQbird anterior (sigue ejecutándose junto a HQbird 2027).
  • No se pide la contraseña SYSDBA: el agente la toma del HQbird anterior.
  • HQ Monitor usa el inicio de sesión del HQbird anterior: su archivo /opt/hqbird/conf/access.properties se conserva, así que inicie sesión con el usuario y la contraseña que usaba antes. El instalador entrega el archivo a firebird con modo 0600 (el HQbird anterior lo dejaba legible por todos los usuarios). El inicio de sesión de invitado del HQbird anterior (access.guest-login) no lo usa HQ Monitor.

Lo que se conserva: firebird.conf, databases.conf / aliases.conf, la base de datos de seguridad, la contraseña SYSDBA, las bases de datos, las copias de seguridad y los archivos del HQbird anterior. La actualización reemplaza los archivos de programa de Firebird en su lugar; los archivos reemplazados se conservan en /opt/fbagent-update-backup/<nombre de carpeta>-<id>/<hora>_<versión anterior>_to_<versión nueva>/ (las dos actualizaciones más recientes se conservan). Los trabajos de HQbird (copias de seguridad, sweeps, monitorización) se importan al nuevo agente. La licencia de HQbird del HQbird anterior no se transfiere: el nuevo agente ejecuta la prueba hasta que se instala una licencia o el servidor se conecta a su HQCenter.

Desde el kit 2027.2.33 (agente 3.4.0), la importación de la configuración del HQbird anterior hace dos cosas más:

  • Registra las bases de datos del HQbird anterior en el archivo de alias de Firebird (databases.conf, o aliases.conf para 2.5) como líneas name = path. El archivo antiguo se copia primero. Una base de datos se omite cuando su ruta ya está en el archivo, o cuando su archivo no existe. Un archivo con una directiva include no se modifica.
  • Elimina los registros de monitorización antiguos del HQbird anterior: el contenido de las carpetas mon/outcoming y mon/outtrace de su carpeta de salida (las carpetas permanecen). No se elimina nada mientras se ejecuta un servicio del HQbird anterior. La eliminación no se puede deshacer: si necesita estos registros, cópielos antes de la instalación.

Ambas están activadas de forma predeterminada. Las claves hqbird_import.register_databases y hqbird_import.clean_mon_logs de agent_config.json (ambas están en el editor de configuración de HQ Monitor) las desactivan para una importación posterior; el instalador no tiene opción para ellas.

El estado de las unidades del HQbird anterior antes de la toma de control se guarda en /opt/hqbird/fbagent-hqbird-takeover.json. --uninstall no las vuelve a activar.

Forma desatendida:

Command
sudo sh hqbird2027-fb50-linux-2027.2.9.run --yes --disable-hqbird

6. Actualización de HQbird 2027 a una nueva versión

Un instalador más nuevo de la misma línea, ejecutado en un host con HQbird 2027, actualiza la instancia instalada en su lugar: Firebird, los archivos de depuración, el agente y HQ Monitor. La configuración, las bases de datos, el estado de prueba o licencia, el puerto de HQ Monitor y el inicio de sesión se conservan.

Command
sudo sh hqbird2027-fb50-linux-2027.2.9.run

En la interfaz de texto, la primera página muestra Plan M10: Update of an installed HQbird 2027, el agente con su id (kept), y ninguna línea Agent id; Install inicia la actualización. El instalador simple imprime:

text
[install] HQbird 2027 setup 2027.2.9, Firebird 5.0 (5.0.5.1916)
[install]   found Firebird 5.0.5.1880: /opt/firebird, port 3050, unit firebird, agent hqbirdfbagent-p3050
[install] plan M10: Firebird update /opt/firebird (unit firebird, port 3050)
[install]              agent in_place in /opt/hqbird/fbagent-p3050 (unit hqbirdfbagent-p3050), HQ Monitor hqbirdmonitor-p3050
[install] Firebird 5.0.5.1880: unit firebird, port 3050, 2 TCP connections
[install] Confirm to stop running Firebird 5.0.5.1880? Yes/No y
...
Firebird updated: 5.0.5.1880 -> 5.0.5.1916
HQ Monitor updated 1.31.0 -> 1.33.0 (...)
Done: agent hqbirdfbagent-p3050 in /opt/hqbird/fbagent-p3050, Firebird 5.0.5.1916 in /opt/firebird (port 3050).

Una actualización no cambia los nombres de la carpeta del agente ni de las unidades: la instancia de este ejemplo se instaló antes de 2027.2.9 y conserva fbagent-p3050.

Cuando la compilación de Firebird del instalador es la que ya está instalada (por ejemplo Firebird 2.5.9.27194 en cada HQbird 2027 para 2.5), solo se actualizan el agente y HQ Monitor: Firebird no se detiene y no hay pregunta Confirmar detener.

El databases.conf conservado de una instancia instalada por un HQbird 2027 anterior puede no tener el alias employee; conéctese a la base de datos de ejemplo por su ruta completa (sección 3, paso 4). En Firebird 3.0 una actualización desde 2027.2.0 deja /opt/firebird/examples/empbuild/employee.fdb con modo 0444, y Firebird no puede abrirlo (no permission for read-write access); si necesita la base de datos de ejemplo: sudo chmod 660 /opt/firebird/examples/empbuild/employee.fdb. Sus propias bases de datos no se tocan.

  • Con varias instancias de la línea, indique la que se va a actualizar: --fb-root /opt/fb50-2 --port 3056.
  • Ejecutar el mismo instalador de nuevo sobre la versión instalada es una reparación: los archivos del programa y las unidades se escriben de nuevo, los datos permanecen.
  • Tras la conexión a un HQCenter (sección 8) el agente, HQ Monitor, Firebird y los componentes del clúster se actualizan desde el catálogo de HQCenter; entonces ya no se necesita un instalador nuevo.
  • Un servidor no conectado a ningún HQCenter con agente 3.3.0 o posterior (kits de 2027.2.31) actualiza el agente, HQ Monitor y fbmcp por sí mismo, a menos que el modo de actualización sea off (“Actualizaciones sin HQCenter” en la sección 4). Una instalación hecha antes de 2027.2.31 obtiene esto tras una actualización con un instalador más nuevo. Una actualización con el instalador conserva el modo de actualización; --auto-update <mode> lo cambia.

7. Comandos de mantenimiento

Cada acción de mantenimiento es una ejecución del instalador con opciones, o un comando del agente en la carpeta del agente. En una terminal, una ejecución sin --yes abre la interfaz de texto con estas opciones ya establecidas (kits posteriores a 2027.2.30): revise el plan en la primera página y luego elija Install.

Acción Comando
Otra instancia de esta línea sudo sh hqbird2027-fb50-linux-<ver>.run --fb-root /opt/fb50-2 --port 3056
Reparar / actualizar sudo sh hqbird2027-fb50-linux-<ver>.run (con varias instancias: --fb-root <folder> --port <port>)
Conectar a HQCenter sudo sh hqbird2027-fb50-linux-<ver>.run --attach attach.json durante la instalación, o más tarde cd /opt/hqbird/fbagent-fb50 && sudo ./fbagent --attach --file /path/attach.json
Enviar el correo de prueba cd /opt/hqbird/fbagent-fb50 && sudo -u firebird ./fbagent --trial-email [email protected] --accept-privacy
Confirmar el código de prueba del correo cd /opt/hqbird/fbagent-fb50 && sudo -u firebird ./fbagent --trial-confirm <code> (o en HQ Monitor)
Instalar un archivo de licencia --license <file> durante la instalación, o cd /opt/hqbird/fbagent-fb50 && sudo -u firebird ./fbagent --license-install /path/license.json
Estado de la instalación sudo /opt/hqbird/fbagent-fb50/fbagent --install-state --json
Estado de las actualizaciones (sin HQCenter) sudo /opt/hqbird/fbagent-fb50/fbagent --update-status
Cambiar el modo de actualización (sin HQCenter) HQ Monitor, la página Updates; o sudo sh hqbird2027-fb50-linux-<ver>.run --auto-update all|agent|off
Eliminar sudo sh hqbird2027-fb50-linux-<ver>.run --uninstall [--remove-data] [--force] [--agent-dir /opt/hqbird/fbagent-fb50]

Otra instancia

Command
sudo sh hqbird2027-fb50-linux-2027.2.9.run --fb-root /opt/fb50-2 --port 3056

El nuevo Firebird va a /opt/fb50-2 (una carpeta nueva o vacía), unidad firebird.opt_fb50-2, con su propio agente (/opt/hqbird/fbagent-fb50-2, unidad hqbirdfbagent-fb50-2) y su propio HQ Monitor (http://localhost:23056/, unidad hqbirdmonitor-fb50-2). El agente obtiene el número libre más bajo de la línea: fb50-2 para la segunda instancia, también junto a un agente instalado antes de 2027.2.9 (fbagent-p3050). El archivo de inicio de sesión de HQ Monitor /opt/hqbird/conf/access.properties es compartido por las instancias del host: una nueva instancia sin --hqmonitor-login conserva el inicio de sesión existente, y --hqmonitor-login/--hqmonitor-password-file en cualquier instancia cambian el inicio de sesión de todas ellas (el archivo antiguo se conserva como access.properties.bak-<time>). Firebird 2.5 no admite una segunda instancia: el instalador se detiene con refused (M17): Firebird 2.5 works only in /opt/firebird, not in <folder> (código de salida 1, nada cambiado). Instale un Firebird de otra línea junto a él, por ejemplo sudo sh hqbird2027-fb50-linux-<ver>.run --fb-root /opt/fb50 --port 3051.

Eliminar

La eliminación en Windows y Linux, los servidores en un clúster y lo que queda en el disco se describen en su totalidad en guía de eliminación. En resumen:

Command
# the agent and HQ Monitor of this instance; Firebird, the databases, configs and logs stay
sudo sh hqbird2027-fb50-linux-2027.2.9.run --uninstall
# the same, and the agent's configuration, logs, license state and HQ Monitor data too
sudo sh hqbird2027-fb50-linux-2027.2.9.run --uninstall --remove-data

Sin --agent-dir el instalador elimina el único agente en /opt/hqbird. Con varios agentes en el host se detiene (código de salida 1), enumera sus carpetas y solicita --agent-dir:

Command
sudo sh hqbird2027-fb50-linux-2027.2.9.run --uninstall --agent-dir /opt/hqbird/fbagent-fb50-2

--uninstall detiene y elimina las unidades del agente y de su HQ Monitor (hqbirdfbagent-fb50, hqbirdmonitor-fb50), las reglas de sudoers del agente y sus programas (fbagent, hqmonitor), y cierra el puerto de HQ Monitor que la instalación abrió en firewalld o ufw. La carpeta del agente permanece con la configuración y los registros; --remove-data elimina también la carpeta y los datos de HQ Monitor en /var/lib/hqmonitor/. Firebird permanece instalado (unidad, carpeta del programa, bases de datos); las unidades de HQbird anteriores que se desactivaron permanecen desactivadas. Con varios agentes en el host, el archivo de inicio de sesión compartido de HQ Monitor permanece hasta que se elimina el último agente.

Si el agente ejecuta el RCM del host y otros agentes usan ese RCM, --uninstall se niega con código de salida 5 y no cambia nada: this agent runs the RCM of the host, and other agents use it: remove the cluster in the RCM console, or run again with --force. --force elimina el agente de todos modos; el clúster entonces pierde su CA (no hay nuevos certificados, no hay nuevos miembros). La unidad RCM permanece mientras otros agentes del host la usen. Para hacer que otro agente sea el propietario de un nuevo RCM cuando el propietario anterior ya no está: fbagent --cluster-init <id> --rcm-takeover (una nueva CA: vuelva a vincular los miembros).

La sugerencia al final de una instalación (Uninstall: sudo sh ... --uninstall) no tiene --agent-dir: con varias instancias agréguelo como se muestra arriba.

Para eliminar también el Firebird de una instancia (el instalador no lo hace; haga primero copias de seguridad gbak de sus bases de datos), por ejemplo el Firebird en /opt/fb50-2:

Command
B=/opt/fb50-2
U=firebird.$(echo ${B#/} | tr / _)          # /opt/fb50-2 -> firebird.opt_fb50-2
systemctl list-unit-files "$U*"             # the units that will be removed
sudo systemctl disable --now $(systemctl list-unit-files "$U*" --no-legend | awk '$1 !~ /@/ {print $1}')
sudo rm -f /usr/lib/systemd/system/$U* /etc/systemd/system/$U*
sudo systemctl daemon-reload
sudo rm -rf $B

8. Conectar a su HQCenter

HQCenter es el servidor central de su empresa que gestiona los agentes de HQbird: licencias, configuración, actualizaciones, resumen de copias de seguridad. Sin un HQCenter el agente funciona por sí solo con las versiones del instalador y el archivo de prueba o de licencia.

Diagram
  1. En el panel de administración de HQCenter abra Tokens (https://<hqcenter>:8443/admin/tokens). En el formulario Install script elija la licencia (o ninguna), el modo, el número de servidores y la validez (de 1 a 365 días); los campos de plataforma y Firebird no se usan. Haga clic en Download connection file y guarde attach.json. El archivo contiene un token secreto: manténgalo seguro (chmod 600), elimínelo después de usarlo y revoque el token en la lista de la misma página. El formulario se muestra solo cuando admin_panel.install_script_url está establecido.
  2. Copie attach.json al servidor.
  3. Conecte de una de dos maneras:
Command
# during the installation
sudo sh hqbird2027-fb50-linux-2027.2.9.run --yes --attach /root/attach.json
# later, for an installed agent
cd /opt/hqbird/fbagent-fb50 && sudo ./fbagent --attach --file /root/attach.json

Con un token ordinario el comando espera hasta que el administrador de HQCenter apruebe la solicitud (hasta 30 minutos). Con un token de licencia el agente se conecta de inmediato y obtiene la licencia. Tras la conexión, la prueba termina cuando HQCenter le da una licencia al agente; el agente, HQ Monitor, Firebird y los componentes del clúster se actualizan entonces desde el catálogo de HQCenter. Una conexión fallida durante la instalación no deshace la instalación: el resumen lo indica, y el comando anterior la repite.

Requisitos: HQCenter (goafts) 1.15.0 o posterior (las versiones anteriores no tienen botón de archivo de conexión); el servidor alcanza el puerto bootstrap de HQCenter una vez para la conexión y luego el puerto de los agentes (443 por defecto). HQCenter puede estar sin Internet. Una segunda conexión del mismo servidor al mismo HQCenter requiere la aprobación del administrador incluso con un token de licencia.

9. Instalación desatendida y scripts

Todas las opciones funcionan también en la terminal. Una ejecución desatendida necesita --yes (responde las preguntas del plan; sin una terminal y sin --yes el instalador se detiene con código de salida 4). --yes nunca abre la interfaz de texto. Un script que inicia el instalador en una terminal y responde sus preguntas por sí mismo (por ejemplo con expect) debe agregar --no-tui o establecer HQBIRD_NO_TUI=1: los kits posteriores a 2027.2.30 abren las páginas allí. El código de salida indica el resultado; los detalles están en la terminal y en /var/log/fbagent/install.log.

Opciones

Opción Significado Predeterminado
--fb-root DIR Carpeta del nuevo Firebird (nueva o vacía); o la carpeta del Firebird a actualizar /opt/firebird, luego /opt/fb<NN>
--port N Puerto de Firebird 3050 para el primer Firebird; para otra línea el puerto de la línea (3053 para 3.0, 3054 para 4.0, 3055 para 5.0)
--sysdba-pass-file F, --sysdba-pass P Contraseña de SYSDBA de un nuevo Firebird (primera línea de F; P se escribe en un archivo 0600) generada, guardada en /root/fbagent-install-sysdba.txt; otro Firebird en el host toma la contraseña de ese archivo
--agent-id ID agent.id del nuevo agente; solo en la primera instalación, un agente instalado conserva su id (“The agent id” en la sección 3) nombre del host + fecha + instancia
--hqmonitor-port N Puerto de HQ Monitor 20000 + puerto de Firebird
--hqmonitor-login L --hqmonitor-password-file F Inicio de sesión de HQ Monitor, compartido por todas las instancias del host: dado en una instancia, cambia el inicio de sesión de todas admin + contraseña generada; una actualización u otra instancia conserva el inicio de sesión existente
--email ADDR --accept-privacy [--trial-zone RU|EU|BR] Correo de prueba (30 días); la dirección se envía al servidor de prueba del proveedor ninguno
--auto-update all|agent|off Actualizaciones de un servidor no conectado a ningún HQCenter (kits desde 2027.2.31): agent = el agente, HQ Monitor y fbmcp se actualizan por sí mismos, un paquete de Firebird espera por usted; all = Firebird también, en su ventana; off = sin comprobaciones de actualización (“Actualizaciones sin HQCenter” en la sección 4) el modo no se cambia; un agente nuevo tiene agent

| --license F | Archivo de licencia que se va a instalar | ninguno | | --attach F | Adjuntar a su HQCenter (attach.json) | ninguno | | --no-hqbird, --disable-hqbird | Dejar intacto el HQbird anterior / desactivar todas sus unidades | automático | | --no-debug | No instalar los archivos de depuración de Firebird | instalados | | --no-fbmcp | No instalar fbmcp (el servidor MCP para clientes de IA) y no cambiar el fbmcp de este host | instalado | | --fbmcp-allow-from A,B | Activar el modo remoto de fbmcp para estas direcciones de administración (IP o CIDR) | solo local | | --fbmcp-port N, --fbmcp-dns NAME,..., --fbmcp-ip ADDR | El puerto remoto de fbmcp; nombres adicionales para su certificado; la dirección para el certificado y el listener | puerto 8650 | | --rcm on\|off | Instalar la consola de clúster RCM en este host y crear un nuevo clúster (agente 3.1.0 y posteriores) | se pregunta; No | | --rcm-password-file F | Contraseña de administrador de RCM con --rcm on (primera línea de F) | generada, se muestra al final | | --cluster-id ID | Id del clúster con --rcm on | el nombre del host | | --cluster-pairing on\|off | Modo de descubrimiento: la ventana de emparejamiento durante 24 horas, un RCM puede invitar a este agente | se pregunta; No | | --rcm-allow A,B,... | Solo estos RCM pueden invitar a este host en modo de descubrimiento (IP, CIDR o nombre de host) | cualquier RCM | | --pairing-port N | Puerto de emparejamiento 7450–7459 de un nuevo agente; elige la ranura (puertos de nodo 7051+k, 7061+k). Una configuración posterior conserva la ranura | la primera ranura libre | | --cluster-node on\|off | Poner el servicio de nodo de clúster en la caché del agente | on | | --yes | Responder Sí a las preguntas del plan (No a las preguntas del clúster) | preguntar | | --check | Solo las comprobaciones, las bibliotecas y el plan; no se cambia nada | — | | --plan-help | Imprimir qué significan los códigos del plan (M1, M2, …) y salir | — | | --no-tui | El instalador simple, sin la interfaz de texto; también la variable HQBIRD_NO_TUI=1 (“The plain installer” en la sección 3) | la interfaz de texto en una terminal | | --lang en\|ru\|pt-BR\|de | Idioma del instalador; también la variable HQBIRD_LANG (“Language of the installer” en la sección 3) | la configuración regional UTF-8 de la consola, si no, inglés | | --tmpdir DIR | Descomprimir aquí (una carpeta donde se puedan ejecutar programas) | /var/tmp | | --extract DIR | Solo descomprimir la carga útil en DIR/payload y salir | — | | --uninstall [--remove-data] [--force] [--agent-dir DIR] | Eliminar el agente y HQ Monitor (Firebird permanece); --force también elimina el agente que ejecuta el RCM del host mientras otros agentes lo usan | — |

Las opciones se pueden escribir como --port 3055 o --port=3055. Las rutas relativas se cuentan desde la carpeta actual.

Ejemplos

Nueva instalación con los valores predeterminados:

Command
sudo sh hqbird2027-fb50-linux-2027.2.9.run --yes
echo "exit code $?"

Nueva instalación en una carpeta y un puerto elegidos, con una contraseña de SYSDBA desde un archivo y un inicio de sesión de HQ Monitor:

Command
umask 077
printf '%s\n' 'S3cret-Sysdba' > /root/sysdba.txt
printf '%s\n' 'S3cret-Monitor' > /root/hqm.txt
sudo sh hqbird2027-fb50-linux-2027.2.9.run --yes \
  --fb-root /opt/firebird --port 3050 \
  --sysdba-pass-file /root/sysdba.txt \
  --hqmonitor-port 24000 --hqmonitor-login ops --hqmonitor-password-file /root/hqm.txt
rm -f /root/sysdba.txt /root/hqm.txt

Nueva instalación con el correo electrónico de prueba, un archivo de licencia y el archivo attach:

Command
sudo sh hqbird2027-fb50-linux-2027.2.9.run --yes \
  --email [email protected] --accept-privacy --trial-zone EU \
  --license /root/hqbird-license.json \
  --attach /root/attach.json

Actualización de un HQbird anterior, todas las unidades del HQbird anterior desactivadas:

Command
sudo sh hqbird2027-fb50-linux-2027.2.9.run --yes --disable-hqbird

Actualización de HQbird 2027 a una nueva versión (una instancia; con varias, añada --fb-root y --port):

Command
sudo sh hqbird2027-fb50-linux-2027.2.9.run --yes

Una segunda instancia de Firebird 5.0 en el puerto 3056:

Command
sudo sh hqbird2027-fb50-linux-2027.2.9.run --yes --fb-root /opt/fb50-2 --port 3056

Eliminación:

Command
sudo sh hqbird2027-fb50-linux-2027.2.9.run --uninstall
sudo sh hqbird2027-fb50-linux-2027.2.9.run --uninstall --remove-data

Un script que se detiene ante una instalación fallida:

Command
#!/bin/sh
set -e
sh hqbird2027-fb50-linux-2027.2.9.run --yes || {
  rc=$?
  echo "HQbird setup failed with code $rc, see /var/log/fbagent/install.log" >&2
  exit $rc
}
echo "HQbird 2027 installed"

Servidor sin Internet: bibliotecas del SO

El Firebird de una línea necesita estas bibliotecas del SO (además de glibc):

Línea Paquetes (Debian/Ubuntu) Paquetes (familia RHEL)
5.0 libtommath1, libicu<NN>, libgssapi-krb5-2 libtommath (EPEL), libicu, krb5-libs
4.0 libtommath1, libicu<NN> libtommath (EPEL), libicu
3.0 libtommath1, libicu<NN> libtommath (EPEL), libicu
2.5 normalmente nada (libstdc++6 está en el sistema base) normalmente nada

Los kits posteriores a 2027.2.30 de las líneas 3.0, 4.0 y 5.0 también necesitan el programa colrm, que usa el script de instalación de Firebird: paquete bsdextrautils (bsdmainutils en Debian y Ubuntu más antiguos). Un Debian mínimo no tiene ninguno; la familia RHEL lo tiene en util-linux, que siempre está presente.

Cuando falta un paquete y el repositorio no es accesible, el instalador se detiene con el código de salida 6 y no se cambia nada:

text
[install] ERROR: no access to the package repository, or a package is not there; nothing was changed.
[install] Missing: libtommath1
[install] Install them, then run this file again:
[install]   apt-get install -y libtommath1
[install] On a server without internet: on a PC with the same Ubuntu 24.04.5 LTS
[install]   apt-get download libtommath1
[install] copy the .deb files here and run:  apt-get install -y ./*.deb

En la familia RHEL, libtommath está en EPEL: con un repositorio accesible, el instalador añade epel-release por sí mismo. Sin uno, los comandos son dnf install -y epel-release, dnf download --resolve <packages> y dnf install -y ./*.rpm. --check imprime la misma lista de antemano, para que los paquetes se puedan preparar antes de la ventana de instalación.

Códigos de salida

Código Significado Cambios en el host
0 Hecho (las advertencias sobre el correo electrónico de prueba, el attach o la licencia están en el resumen) sí
1 Rechazado: el host, una opción, un archivo o el plan (se imprime el motivo). También: Salir en la interfaz de texto ninguno
2 La instalación falló y se revirtió. También: el instalador se detuvo por una señal (Ctrl+C) revertido; ninguno cuando se detuvo antes de la instalación
3 La instalación falló y la reversión no fue completa (el resumen indica qué comprobar) parcialmente
4 Una pregunta del plan no se confirmó (sin terminal, sin --yes). ninguno
5 La carga útil no pasó la comprobación (sha256, firmas): descargue el archivo de nuevo. Con --uninstall: rechazado, el agente ejecuta el RCM del host y otros agentes lo usan (sección 7) ninguno
6 Faltan bibliotecas del SO y el repositorio de paquetes no es accesible ninguno
7 Hay instalado un Firebird de los paquetes de la distribución ninguno

10. Solución de problemas

Problema Qué hacer
run as root (sudo sh ...) Ejecute el instalador con sudo o como root
Las páginas de la interfaz de texto no se abren La primera línea dice por qué: needs a window of 80x24 or larger (haga la ventana más grande; tmux con una línea de estado ocupa una fila) o needs bash 4.4 or newer. El instalador simple que se ejecuta entonces hace la misma instalación
Caracteres incorrectos o líneas rotas en las páginas Configure la terminal en UTF-8, o ejecute con --lang en; --no-tui ejecuta el instalador simple
/var/tmp is mounted noexec Ejecute de nuevo con --tmpdir /root (cualquier carpeta donde se puedan ejecutar programas)
is damaged or cut (código de salida 5) Copie el archivo .run de nuevo y compare su sha256sum con el valor publicado
Código de salida 6, faltan bibliotecas Prepare los paquetes como se indica (sección 9), luego ejecute el instalador de nuevo
Código de salida 7, Firebird de los paquetes de la distro Elimine los paquetes (apt-get remove firebird3.0-server, conserve una copia de seguridad con gbak) o use el instalador en línea con --import-firebird
refused (M17): Firebird 2.5 works only in /opt/firebird Un segundo Firebird 2.5 no es posible; instale otra línea junto a él (sección 7)
--uninstall rechazado (código de salida 1) con varios agentes Añada --agent-dir con una carpeta de la lista, por ejemplo --agent-dir /opt/hqbird/fbagent-fb50-2
--uninstall rechazado (código de salida 5): this agent runs the RCM of the host Elimine primero el clúster en la consola de RCM, o ejecute de nuevo con --force (sección 7)
no permission for read-write access a employee.fdb después de una actualización (3.0) sudo chmod 660 /opt/firebird/examples/empbuild/employee.fdb (sección 6)
refused (M14): the folder is not empty Elija una carpeta vacía o nueva con --fb-root, o indique el Firebird que se va a actualizar
Código de salida 2 o 3 Lea /var/log/fbagent/install.log; las unidades vuelven a su estado anterior a la ejecución (código 2) o necesitan una comprobación (código 3)
HQ Monitor no se abre systemctl status hqbirdmonitor-fb50 (hqbirdmonitor-p<port> antes de 2027.2.9); compruebe que nada más escuche en el puerto; abra el puerto en el firewall; --hqmonitor-port para otro puerto
Se perdió la contraseña de HQ Monitor Ejecute el instalador de nuevo (reparación) con --hqmonitor-login admin --hqmonitor-password-file <file>; el antiguo /opt/hqbird/conf/access.properties se conserva como access.properties.bak-<time>. El nuevo inicio de sesión vale para todas las instancias del host
El correo electrónico de prueba no se envió (sin red) Envíelo más tarde: cd /opt/hqbird/fbagent-fb50 && sudo -u firebird ./fbagent --trial-email <address> --accept-privacy
SELinux (AlmaLinux, RHEL) Compatible en modo enforcing: el instalador restaura los contextos de los archivos que escribe; no hay nada que hacer