HQbird 2027 para Linux: guía de instalación
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. Qué instala el instalador
- 2. La instalación de un vistazo
- 3. Instalación nueva
- 4. Después de la instalación
- 5. Actualización de un HQbird anterior (2024 y anteriores)
- 6. Actualización de HQbird 2027 a una nueva versión
- 7. Comandos de mantenimiento
- 8. Conectar a su HQCenter
- 9. Instalación desatendida y scripts
- 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.confpara 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-debuglos omite. - Agente de HQbird (
fbagent): la unidad systemdhqbirdfbagent-fb50, que se ejecuta con el usuariofirebird, 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ónhttp://<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/hqbirdrcmy se ejecuta como la unidadhqbirdrcm; el resumen imprime su dirección en la líneaRCM:. El nodo obtiene su unidad (por ejemplohqclusternode-master-p3050) cuando vincula el host en RCM. Los kits desde 2027.2.19 con un agente anterior instalan RCM en cada servidor (--rcm offlo 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 unidadhqbirdrcmni líneaRCM:.
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
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
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.sha256Las 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)
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
sudo sh hqbird2027-fb50-linux-2027.2.9.runLos 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.
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: quitLas 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 variableHQBIRD_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; TERMesdumbo no está definido;- la ventana es menor que 80 columnas por 24 filas (dentro de
tmuxcon 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:
[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 --uninstallEste 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:
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]yTurn 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.--yesy 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 porrooty 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:
- la opción
--lang en|ru|pt-BR|de; - la variable
HQBIRD_LANG; - la configuración regional de la consola (
LC_ALL, luegoLC_MESSAGES, luegoLANG), cuando es una configuración regional UTF-8; - 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:
[install] Language: Русский (auto). Use --lang en to change.Notas:
- PuTTY no envía
LANGal 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.--langsigue funcionando ahí. - El instalador necesita una configuración regional UTF-8 en el host para los otros idiomas
(
C.UTF-8oen_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:
[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 IDda 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-idahí 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
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.fdbUse 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).
/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--jsonpara 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:
Lo que se ve en la terminal:
[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-rooty--portno 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 versionse pregunta cuando el HQbird anterior gestiona un Firebird de otra versión (actualice ese, o uno nuevo junto a él).--yesresponde a todas las preguntas con Yes; sin una terminal y sin--yesel instalador se detiene con el código de salida 4 y no cambia nada. --disable-hqbirddesactiva las unidades del HQbird anterior en cualquier caso;--no-hqbirddeja 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.propertiesse conserva, así que inicie sesión con el usuario y la contraseña que usaba antes. El instalador entrega el archivo afirebirdcon 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, oaliases.confpara 2.5) como líneasname = 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 directivaincludeno se modifica. - Elimina los registros de monitorización antiguos del HQbird anterior: el contenido de
las carpetas
mon/outcomingymon/outtracede 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:
sudo sh hqbird2027-fb50-linux-2027.2.9.run --yes --disable-hqbird6. 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.
sudo sh hqbird2027-fb50-linux-2027.2.9.runEn 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:
[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
sudo sh hqbird2027-fb50-linux-2027.2.9.run --fb-root /opt/fb50-2 --port 3056El 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:
# 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-dataSin --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:
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:
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 $B8. 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.
- 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 guardeattach.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 cuandoadmin_panel.install_script_urlestá establecido. - Copie
attach.jsonal servidor. - Conecte de una de dos maneras:
# 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.jsonCon 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:
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:
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.txtNueva instalación con el correo electrónico de prueba, un archivo de licencia y el archivo attach:
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.jsonActualización de un HQbird anterior, todas las unidades del HQbird anterior desactivadas:
sudo sh hqbird2027-fb50-linux-2027.2.9.run --yes --disable-hqbirdActualización de HQbird 2027 a una nueva versión (una instancia; con varias, añada
--fb-root y --port):
sudo sh hqbird2027-fb50-linux-2027.2.9.run --yesUna segunda instancia de Firebird 5.0 en el puerto 3056:
sudo sh hqbird2027-fb50-linux-2027.2.9.run --yes --fb-root /opt/fb50-2 --port 3056Eliminación:
sudo sh hqbird2027-fb50-linux-2027.2.9.run --uninstall
sudo sh hqbird2027-fb50-linux-2027.2.9.run --uninstall --remove-dataUn script que se detiene ante una instalación fallida:
#!/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:
[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 ./*.debEn 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 |