Eliminación de HQbird 2027
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
- Haga una copia de seguridad de cada base de datos (
gbakonbackup) 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. - Detenga las aplicaciones que usan las bases de datos. En Windows la desinstalación detiene el Firebird que instaló el instalador.
- 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).
- 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.
- 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
- Abra Configuración → Aplicaciones → Aplicaciones y características (o Programas y características).
- Seleccione HQbird 2027 (Firebird 5.0) y haga clic en Desinstalar.
- Confirme la desinstalación.
- Responda a la pregunta sobre los datos: No conserva la configuración y la base de datos de seguridad, Sí las elimina también.
- 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.
- Abra Inicio → HQbird 2027 (Firebird 5.0) maintenance.
- Seleccione Remove an instance y seleccione la instancia.
- 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
# 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 /FORCELa 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:
Get-ItemProperty 'HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\*' | Where-Object DisplayName -like 'HQbird 2027*' | Select-Object DisplayName, InstallLocation, UninstallString3.4. Comprobar el resultado
Get-Service | Where-Object Name -match 'HQbird|Firebird|hqbirdrcm|hqclusternode'
Test-Path 'HKLM:\SOFTWARE\IBSurgeon\HQbird2027\fb50'
Get-NetFirewallRule -DisplayName 'HQbird Monitor*', 'Firebird *' -ErrorAction SilentlyContinueEsperado: 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:
- Elimine el clúster en la consola RCM y desvincule sus agentes.
- Elimine HQbird de los servidores miembros.
- 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
# the agent and HQbird Monitor; Firebird, databases, configuration and logs stay
sudo sh hqbird2027-fb50-linux-2027.2.33.run --uninstall# 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-dataEl 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:
sudo sh hqbird2027-fb50-linux-2027.2.33.run --uninstall --agent-dir /opt/hqbird/fbagent-fb50-2Ejecute 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:
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 $BAdvertencia: 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
systemctl list-unit-files 'hqbird*' 'hqclusternode*' 'firebird*' --no-legend
ls /opt/hqbird /var/lib/hqmonitor 2>/dev/nullEsperado: 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 |