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

Esta guía está dirigida al administrador que elimina HQbird 2027 de un servidor. Cubre el instalador de Windows hqbird2027-fbNN-setup-<version>.exe y el instalador de Linux hqbird2027-fbNN-linux-<version>.run.

Los ejemplos muestran Firebird 5.0 (fb50). Para Firebird 2.5, 3.0 y 4.0 use fb25, fb30, fb40 en los nombres de archivos, carpetas y servicios. La instalación se describe en Windows installation y Linux setup.

HQbird 2024 se elimina con las instrucciones anteriores.

1. Antes de empezar

  1. Haga una copia de seguridad de cada base de datos (gbak o nbackup) y cópiela a otro disco o servidor. La desinstalación no elimina los archivos de base de datos, pero una copia de seguridad le protege de un error.
  2. Detenga las aplicaciones que usan las bases de datos. En Windows la desinstalación detiene el Firebird que instaló el instalador.
  3. Servidores en clúster: si este servidor ejecuta la consola de clúster RCM, elimine el clúster en RCM y desvincule sus agentes primero (sección 4).
  4. HQCenter: la desinstalación no elimina el registro del servidor en su HQCenter. Elimine el agente allí después de la desinstalación, si no planea instalar HQbird de nuevo.
  5. Licencia: la desinstalación con los datos elimina el estado de licencia del agente. Conserve su archivo de licencia si planea instalar HQbird de nuevo.

2. Qué se elimina y qué permanece

Elemento Windows Linux
Agente HQbird (servicio o unidad, programas) eliminado eliminado
HQbird Monitor (servicio o unidad, regla de firewall) eliminado eliminado
Firebird que HQbird 2027 instaló nuevo eliminado (servicio, archivos de programa, regla de firewall) permanece
Firebird que existía antes y solo se actualizó permanece permanece
Archivos de base de datos (*.fdb, *.gdb, *.fbk, *.nbk) siempre permanecen siempre permanecen
Configuración del agente, registros, estado de licencia, datos de HQbird Monitor permanecen; se eliminan con la opción de datos permanecen; se eliminan con --remove-data
Base de datos de seguridad y archivos *.conf de Firebird permanecen; se eliminan con la opción de datos permanecen
Servicios de un HQbird anterior (2024 y anteriores) que la actualización desactivó permanecen desactivados permanecen desactivados

La opción de datos en Windows elimina solo lo que creó un instalador de HQbird 2027. Los datos de un agente que existía antes del primer instalador de HQbird 2027 permanecen.

3. Windows

Una entrada en Aplicaciones y características = una línea de Firebird. El desinstalador de una línea elimina todas las instancias de esa línea. Ejecútelo como administrador.

3.1. Eliminar una línea completa

  1. Abra Configuración → Aplicaciones → Aplicaciones y características (o Programas y características).
  2. Seleccione HQbird 2027 (Firebird 5.0) y haga clic en Desinstalar.
  3. Confirme la desinstalación.
  4. Responda a la pregunta sobre los datos: No conserva la configuración y la base de datos de seguridad, Sí las elimina también.
  5. Espere el mensaje de que HQbird se eliminó.

Repita estos pasos para cada línea de Firebird en el servidor (una entrada por línea).

3.2. Eliminar una instancia

Use esto cuando una línea tiene varias instancias y elimina solo una.

  1. Abra Inicio → HQbird 2027 (Firebird 5.0) maintenance.
  2. Seleccione Remove an instance y seleccione la instancia.
  3. Confirme, luego responda a la pregunta sobre los datos.

Cuando elimina la última instancia, HQbird 2027 de esta línea se elimina.

3.3. Desinstalación silenciosa

Command
# programs and services; databases, configs and the security database stay
& 'C:\HQbird\setup\fb50\unins000.exe' /VERYSILENT
# the same, and the agent data, HQbird Monitor data, the security database and *.conf too
& 'C:\HQbird\setup\fb50\unins000.exe' /VERYSILENT /REMOVEDATA
# remove also an instance that runs the RCM of a cluster (section 4)
& 'C:\HQbird\setup\fb50\unins000.exe' /VERYSILENT /FORCE

La carpeta del desinstalador es <HQbird folder>\setup\fb50. Las líneas instaladas por instaladores anteriores a 2027.2.8 la tienen en C:\Program Files\IBSurgeon\HQbird 2027\fb50. La carpeta exacta es el valor InstallLocation de la entrada de Aplicaciones:

Command
Get-ItemProperty 'HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\*' | Where-Object DisplayName -like 'HQbird 2027*' | Select-Object DisplayName, InstallLocation, UninstallString

3.4. Comprobar el resultado

Command
Get-Service | Where-Object Name -match 'HQbird|Firebird|hqbirdrcm|hqclusternode'
Test-Path 'HKLM:\SOFTWARE\IBSurgeon\HQbird2027\fb50'
Get-NetFirewallRule -DisplayName 'HQbird Monitor*', 'Firebird *' -ErrorAction SilentlyContinue

Esperado: ningún servicio de HQbird de esta línea, y False para la clave del registro. El desinstalador elimina la clave del registro solo después de una desinstalación completa. Si la clave sigue ahí, ejecute el desinstalador de nuevo.

3.5. Qué permanece en el disco

Carpeta Contenido ¿Eliminar a mano?
C:\HQbird\Firebird50\ Archivos de base de datos, y sin la opción de datos la base de datos de seguridad y *.conf Después de mover las bases de datos
C:\HQbird\fbagent-fb50\ Configuración y registros del agente, cuando conservó los datos Sí, si no los necesita
C:\HQbirdData\ Datos de trabajo del agente, datos de HQbird Monitor y archivo de inicio de sesión, cuando conservó los datos Sí, si no los necesita
C:\HQbird\hqbirdrcm\ Datos de RCM (solo se van con la opción de datos) Sí, después de que el clúster desaparezca
C:\ProgramData\fbagent\ install.log, resultado de la última ejecución del instalador Sí
C:\ProgramData\HQbird\fbagent\ Archivo de contraseña de SYSDBA de una instalación silenciosa Sí
<Firebird folder>.old_<time> Copia de la carpeta de programas de Firebird antigua de una actualización Sí, cuando la actualización esté confirmada

El servicio fbmcp es compartido por todas las líneas del servidor. Permanece mientras otra línea lo use, y se elimina con la última línea.

4. Servidores en un clúster

El agente que ejecuta el RCM posee la CA del clúster. Cuando otros agentes usan ese RCM, la desinstalación se rechaza y no se cambia nada.

Orden recomendado:

  1. Elimine el clúster en la consola RCM y desvincule sus agentes.
  2. Elimine HQbird de los servidores miembros.
  3. Elimine HQbird del servidor que ejecuta el RCM.

Para eliminar el propietario del RCM de todos modos:

  • Windows, diálogo: el desinstalador pregunta “Remove this instance anyway? The cluster loses its RCM CA.” Responda Sí.
  • Windows, silencioso: agregue /FORCE. Sin él, la instancia que ejecuta el RCM permanece, y el registro indica el motivo.
  • Linux: el instalador se detiene con el código de salida 5. Ejecútelo de nuevo con --force.

Después de una desinstalación forzada el clúster no tiene CA: ni nuevos certificados ni nuevos miembros. Para hacer que otro agente sea el propietario de un nuevo RCM, ejecute fbagent --cluster-init <id> --rcm-takeover allí y vincule los miembros de nuevo.

5. Linux

Ejecute el mismo archivo .run que instaló HQbird (o uno más nuevo de la misma línea) como root. Los ejemplos usan la versión 2027.2.33.

5.1. Eliminar el agente y HQbird Monitor

Command
# the agent and HQbird Monitor; Firebird, databases, configuration and logs stay
sudo sh hqbird2027-fb50-linux-2027.2.33.run --uninstall
Command
# the same, and the agent folder (configuration, logs, license state) and HQbird Monitor data too
sudo sh hqbird2027-fb50-linux-2027.2.33.run --uninstall --remove-data

El comando detiene y elimina las unidades hqbirdfbagent-fb50 y hqbirdmonitor-fb50, los programas fbagent y hqmonitor, y las reglas de sudoers del agente. Cierra el puerto de HQbird Monitor que la instalación abrió en firewalld o ufw.

5.2. Varias instancias en un mismo host

Sin --agent-dir el instalador elimina el único agente en /opt/hqbird. Con varios agentes se detiene con el código de salida 1 y lista sus carpetas. Indique la carpeta:

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

Ejecute el comando una vez por cada agente. El archivo de inicio de sesión compartido de HQbird Monitor permanece hasta que se elimine el último agente.

5.3. Eliminar Firebird (opcional, a mano)

El instalador nunca elimina Firebird en Linux. Hágalo a mano solo después de haber hecho copias de seguridad y movido las bases de datos fuera de la carpeta de Firebird.

Nombres de unidades de Firebird:

Carpeta de Firebird Línea Unidad
/opt/firebird 2.5, 4.0, 5.0 firebird
/opt/firebird 3.0 firebird-superserver
otra carpeta, por ejemplo /opt/fb50-2 4.0, 5.0 firebird.opt_fb50-2
otra carpeta, por ejemplo /opt/fb30 3.0 firebird.opt_fb30-superserver

Ejemplo para 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

Advertencia: rm -rf elimina todo en la carpeta, también las bases de datos y la base de datos de seguridad que están dentro de ella. Compruebe la carpeta primero.

5.4. Comprobar el resultado

Command
systemctl list-unit-files 'hqbird*' 'hqclusternode*' 'firebird*' --no-legend
ls /opt/hqbird /var/lib/hqmonitor 2>/dev/null

Esperado: ninguna unidad hqbirdfbagent-fb50 y hqbirdmonitor-fb50. La unidad de Firebird sigue ahí a menos que haya eliminado Firebird a mano.

5.5. Qué permanece en el disco

Ruta Contenido ¿Eliminar a mano?
/opt/hqbird/fbagent-fb50/ Configuración y registros del agente (sin --remove-data) Sí, si no los necesita
/var/lib/hqmonitor/ Datos de HQbird Monitor (sin --remove-data) Sí, si no los necesita
/opt/hqbirdrcm/ RCM, mientras otros agentes del host lo usen Después de que el clúster desaparezca
/opt/fbagent-update-backup/ Archivos de programa de Firebird que las actualizaciones reemplazaron Sí, cuando las actualizaciones estén confirmadas
/opt/hqbird/fbagent-hqbird-takeover.json Estado de las unidades de HQbird anteriores antes de la actualización Consérvelo si planea volver al HQbird anterior
/opt/firebird (o su carpeta de Firebird) Firebird y sus bases de datos Sección 5.3

5.6. Códigos de salida de --uninstall

Código Significado Qué hacer
0 Eliminado —
1 Rechazado: varios agentes en el host, o una opción incorrecta Agregue --agent-dir con una carpeta de la lista
5 Rechazado: este agente ejecuta el RCM del host y otros agentes lo usan Sección 4

6. Un HQbird anterior después de la desinstalación

Cuando HQbird 2027 reemplazó a un HQbird anterior (2024 y anteriores), la actualización desactivó los servicios del HQbird anterior. La desinstalación de HQbird 2027 no los vuelve a activar. Su estado antes de la actualización se guarda en:

  • Windows: <HQbird folder>\fbagent-hqbird-takeover.json
  • Linux: /opt/hqbird/fbagent-hqbird-takeover.json

Use este archivo para ver qué servicios estaban activos, e inícielos a mano si vuelve al HQbird anterior.

7. Solución de problemas

Problema Qué hacer
Windows: la entrada en Aplicaciones y características permanece después de la desinstalación Una instancia no se eliminó (a menudo la que ejecuta el RCM). Ejecute el desinstalador de nuevo; para el propietario del RCM vea la sección 4
Windows: un error general y un comando de un desinstalador antiguo El agente se actualizó a 3.1.0 o más nuevo y se niega a eliminar el propietario del RCM. Agregue --force al comando mostrado, o ejecute el desinstalador de un instalador más nuevo
Windows: compilaciones de prueba 2027.0.1 y 2027.0.2 Usaban una entrada para todas las líneas. Elimínelas con su propio desinstalador
Linux: --uninstall rechazado, código de salida 1 Varios agentes en el host: agregue --agent-dir (sección 5.2)
Linux: --uninstall rechazado, código de salida 5 El agente ejecuta el RCM del host: sección 4
Linux: run as root (sudo sh ...) Ejecute el instalador con sudo o como root
Linux: el archivo .run se perdió Descargue el instalador de la misma línea de nuevo; una versión más nueva de la misma línea también funciona