Rimozione di HQbird 2027
Questa guida è per l’amministratore che rimuove HQbird 2027 da un server.
Copre il setup Windows hqbird2027-fbNN-setup-<version>.exe e
l’installer Linux hqbird2027-fbNN-linux-<version>.run.
Gli esempi mostrano Firebird 5.0 (fb50). Per Firebird 2.5, 3.0 e 4.0 usare
fb25, fb30, fb40 nei nomi di file, cartelle e servizi. L’installazione
è descritta in
Windows installation e
Linux setup.
HQbird 2024 viene rimosso con le istruzioni precedenti.
1. Prima di iniziare
- Eseguire un backup di ogni database (
gbakonbackup) e copiarlo su un altro disco o server. La rimozione non elimina i file dei database, ma un backup ti protegge da un errore. - Fermare le applicazioni che usano i database. Su Windows la rimozione ferma il Firebird installato dal setup.
- Server in cluster: se questo server esegue la console cluster RCM, eliminare il cluster in RCM e scollegare prima i suoi agenti (sezione 4).
- HQCenter: la rimozione non elimina il record del server nel tuo HQCenter. Rimuovere l’agente lì dopo la rimozione, se non prevedi di installare di nuovo HQbird.
- Licenza: la rimozione con i dati elimina lo stato della licenza dell’agente. Conserva il file di licenza se prevedi di installare di nuovo HQbird.
2. Cosa viene rimosso e cosa resta
| Voce | Windows | Linux |
|---|---|---|
| Agente HQbird (servizio o unit, programmi) | rimosso | rimosso |
| HQbird Monitor (servizio o unit, regola firewall) | rimosso | rimosso |
| Firebird installato ex novo da HQbird 2027 | rimosso (servizio, file di programma, regola firewall) | resta |
| Firebird preesistente e solo aggiornato | resta | resta |
File dei database (*.fdb, *.gdb, *.fbk, *.nbk) |
restano sempre | restano sempre |
| Configurazione dell’agente, log, stato della licenza, dati di HQbird Monitor | restano; rimossi con l’opzione dati | restano; rimossi con --remove-data |
Database di sicurezza e file *.conf di Firebird |
restano; rimossi con l’opzione dati | restano |
| Servizi di un HQbird precedente (2024 e anteriori) disattivati dall’aggiornamento | restano disattivati | restano disattivati |
L’opzione dati su Windows rimuove solo ciò che ha creato un setup di HQbird 2027. I dati di un agente presenti prima del primo setup di HQbird 2027 restano.
3. Windows
Una voce in App e funzionalità = una linea Firebird. Il disinstallatore di una linea rimuove tutte le istanze di quella linea. Eseguirlo come amministratore.
3.1. Rimuovere un’intera linea
- Aprire Impostazioni → App → App e funzionalità (o Programmi e funzionalità).
- Selezionare HQbird 2027 (Firebird 5.0) e fare clic su Disinstalla.
- Confermare la rimozione.
- Rispondere alla domanda sui dati: No conserva la configurazione e il database di sicurezza, Sì li rimuove anch’essi.
- Attendere il messaggio che HQbird è stato rimosso.
Ripetere questi passaggi per ogni linea Firebird sul server (una voce per linea).
3.2. Rimuovere una singola istanza
Usare questa procedura quando una linea ha più istanze e se ne rimuove solo una.
- Aprire Start → HQbird 2027 (Firebird 5.0) maintenance.
- Selezionare Remove an instance e selezionare l’istanza.
- Confermare, poi rispondere alla domanda sui dati.
Quando si rimuove l’ultima istanza, HQbird 2027 di questa linea viene rimosso.
3.3. Rimozione silenziosa
# 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 cartella del disinstallatore è <HQbird folder>\setup\fb50. Le linee installate da
setup precedenti alla 2027.2.8 la hanno in
C:\Program Files\IBSurgeon\HQbird 2027\fb50. La cartella esatta è il
valore InstallLocation della voce in App:
Get-ItemProperty 'HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\*' | Where-Object DisplayName -like 'HQbird 2027*' | Select-Object DisplayName, InstallLocation, UninstallString3.4. Verificare il risultato
Get-Service | Where-Object Name -match 'HQbird|Firebird|hqbirdrcm|hqclusternode'
Test-Path 'HKLM:\SOFTWARE\IBSurgeon\HQbird2027\fb50'
Get-NetFirewallRule -DisplayName 'HQbird Monitor*', 'Firebird *' -ErrorAction SilentlyContinueAtteso: nessun servizio HQbird di questa linea e False per la chiave di registro.
Il disinstallatore elimina la chiave di registro solo dopo una rimozione completa. Se
la chiave è ancora presente, eseguire di nuovo il disinstallatore.
3.5. Cosa resta sul disco
| Cartella | Contenuto | Eliminare manualmente? |
|---|---|---|
C:\HQbird\Firebird50\ |
File dei database e, senza l’opzione dati, il database di sicurezza e *.conf |
Dopo aver spostato i database |
C:\HQbird\fbagent-fb50\ |
Configurazione e log dell’agente, se hai conservato i dati | Sì, se non ti servono |
C:\HQbirdData\ |
Dati di lavoro dell’agente, dati di HQbird Monitor e file di accesso, se hai conservato i dati | Sì, se non ti servono |
C:\HQbird\hqbirdrcm\ |
Dati RCM (vanno solo con l’opzione dati) | Sì, dopo che il cluster è stato eliminato |
C:\ProgramData\fbagent\ |
install.log, risultato dell’ultima esecuzione del setup |
Sì |
C:\ProgramData\HQbird\fbagent\ |
File della password SYSDBA di un’installazione silenziosa | Sì |
<Firebird folder>.old_<time> |
Copia della vecchia cartella dei programmi Firebird da un aggiornamento | Sì, quando l’aggiornamento è confermato |
Il servizio fbmcp è condiviso da tutte le linee del server. Resta finché un’altra linea lo usa, e viene rimosso con l’ultima linea.
4. Server in un cluster
L’agente che esegue il RCM detiene la CA del cluster. Quando altri agenti usano quel RCM, la rimozione viene rifiutata e nulla viene modificato.
Ordine consigliato:
- Eliminare il cluster nella console RCM e scollegare i suoi agenti.
- Rimuovere HQbird dai server membri.
- Rimuovere HQbird dal server che esegue il RCM.
Per rimuovere comunque il proprietario del RCM:
- Windows, finestra di dialogo: il disinstallatore chiede “Remove this instance anyway? The cluster loses its RCM CA.” Rispondere Sì.
- Windows, silenzioso: aggiungere
/FORCE. Senza di esso l’istanza che esegue il RCM resta, e il log ne indica il motivo. - Linux: l’installer si ferma con codice di uscita 5. Eseguirlo di nuovo con
--force.
Dopo una rimozione forzata il cluster non ha CA: nessun nuovo certificato e nessun
nuovo membro. Per rendere un altro agente il proprietario di un nuovo RCM, eseguire
fbagent --cluster-init <id> --rcm-takeover lì e collegare di nuovo i membri.
5. Linux
Eseguire lo stesso file .run che ha installato HQbird (o uno più recente della stessa
linea) come root. Gli esempi usano la versione 2027.2.33.
5.1. Rimuovere l’agente e 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-dataIl comando ferma e rimuove le unit hqbirdfbagent-fb50 e
hqbirdmonitor-fb50, i programmi fbagent e hqmonitor, e le
regole sudoers dell’agente. Chiude la porta di HQbird Monitor che
l’installazione ha aperto in firewalld o ufw.
5.2. Più istanze su un solo host
Senza --agent-dir l’installer rimuove l’unico agente in
/opt/hqbird. Con più agenti si ferma con codice di uscita 1 e elenca
le loro cartelle. Indicare la cartella:
sudo sh hqbird2027-fb50-linux-2027.2.33.run --uninstall --agent-dir /opt/hqbird/fbagent-fb50-2Eseguire il comando una volta per ogni agente. Il file di accesso condiviso di HQbird Monitor resta fino alla rimozione dell’ultimo agente.
5.3. Rimuovere Firebird (opzionale, manualmente)
L’installer non rimuove mai Firebird su Linux. Farlo manualmente solo dopo aver eseguito i backup e spostato i database fuori dalla cartella Firebird.
Nomi delle unit Firebird:
| Cartella Firebird | Linea | Unit |
|---|---|---|
/opt/firebird |
2.5, 4.0, 5.0 | firebird |
/opt/firebird |
3.0 | firebird-superserver |
un’altra cartella, per esempio /opt/fb50-2 |
4.0, 5.0 | firebird.opt_fb50-2 |
un’altra cartella, per esempio /opt/fb30 |
3.0 | firebird.opt_fb30-superserver |
Esempio per il Firebird in /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 $BAttenzione: rm -rf elimina tutto nella cartella, anche i database
e il database di sicurezza che vi si trovano. Controllare prima la cartella.
5.4. Verificare il risultato
systemctl list-unit-files 'hqbird*' 'hqclusternode*' 'firebird*' --no-legend
ls /opt/hqbird /var/lib/hqmonitor 2>/dev/nullAtteso: nessuna unit hqbirdfbagent-fb50 e hqbirdmonitor-fb50. La
unit Firebird è ancora presente a meno che tu non abbia rimosso Firebird manualmente.
5.5. Cosa resta sul disco
| Percorso | Contenuto | Eliminare manualmente? |
|---|---|---|
/opt/hqbird/fbagent-fb50/ |
Configurazione e log dell’agente (senza --remove-data) |
Sì, se non ti servono |
/var/lib/hqmonitor/ |
Dati di HQbird Monitor (senza --remove-data) |
Sì, se non ti servono |
/opt/hqbirdrcm/ |
RCM, finché altri agenti dell’host lo usano | Dopo che il cluster è stato eliminato |
/opt/fbagent-update-backup/ |
File di programma Firebird sostituiti dagli aggiornamenti | Sì, quando gli aggiornamenti sono confermati |
/opt/hqbird/fbagent-hqbird-takeover.json |
Stato delle unit HQbird precedenti prima dell’aggiornamento | Conservarlo se prevedi di tornare al vecchio HQbird |
/opt/firebird (o la tua cartella Firebird) |
Firebird e i suoi database | Sezione 5.3 |
5.6. Codici di uscita di --uninstall
| Codice | Significato | Cosa fare |
|---|---|---|
| 0 | Rimosso | — |
| 1 | Rifiutato: più agenti sull’host, o un’opzione errata | Aggiungere --agent-dir con una cartella dall’elenco |
| 5 | Rifiutato: questo agente esegue il RCM dell’host e altri agenti lo usano | Sezione 4 |
6. Un HQbird precedente dopo la rimozione
Quando HQbird 2027 ha sostituito un HQbird precedente (2024 e anteriori), l’aggiornamento ha disattivato i servizi del vecchio HQbird. La rimozione di HQbird 2027 non li riattiva. Il loro stato prima dell’aggiornamento è salvato in:
- Windows:
<HQbird folder>\fbagent-hqbird-takeover.json - Linux:
/opt/hqbird/fbagent-hqbird-takeover.json
Usare questo file per vedere quali servizi erano attivi, e avviarli manualmente se si torna al vecchio HQbird.
7. Risoluzione dei problemi
| Problema | Cosa fare |
|---|---|
| Windows: la voce in App e funzionalità resta dopo la rimozione | Un’istanza non è stata rimossa (spesso quella che esegue il RCM). Eseguire di nuovo il disinstallatore; per il proprietario del RCM vedere la sezione 4 |
| Windows: un errore generico e un comando da un vecchio disinstallatore | L’agente si è aggiornato alla 3.1.0 o successiva e rifiuta di rimuovere il proprietario del RCM. Aggiungere --force al comando mostrato, o eseguire il disinstallatore di un setup più recente |
| Windows: build di test 2027.0.1 e 2027.0.2 | Usavano una sola voce per tutte le linee. Rimuoverle con il loro disinstallatore |
Linux: --uninstall rifiutato, codice di uscita 1 |
Più agenti sull’host: aggiungere --agent-dir (sezione 5.2) |
Linux: --uninstall rifiutato, codice di uscita 5 |
L’agente esegue il RCM dell’host: sezione 4 |
Linux: run as root (sudo sh ...) |
Eseguire l’installer con sudo o come root |
Linux: il file .run è perduto |
Scaricare di nuovo l’installer della stessa linea; funziona anche una versione più recente della stessa linea |