Questa pagina è stata tradotta automaticamente. Leggi l'originale in inglese. English

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

  1. Eseguire un backup di ogni database (gbak o nbackup) e copiarlo su un altro disco o server. La rimozione non elimina i file dei database, ma un backup ti protegge da un errore.
  2. Fermare le applicazioni che usano i database. Su Windows la rimozione ferma il Firebird installato dal setup.
  3. Server in cluster: se questo server esegue la console cluster RCM, eliminare il cluster in RCM e scollegare prima i suoi agenti (sezione 4).
  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.
  5. 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

  1. Aprire Impostazioni → App → App e funzionalità (o Programmi e funzionalità).
  2. Selezionare HQbird 2027 (Firebird 5.0) e fare clic su Disinstalla.
  3. Confermare la rimozione.
  4. Rispondere alla domanda sui dati: No conserva la configurazione e il database di sicurezza, Sì li rimuove anch’essi.
  5. 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.

  1. Aprire Start → HQbird 2027 (Firebird 5.0) maintenance.
  2. Selezionare Remove an instance e selezionare l’istanza.
  3. Confermare, poi rispondere alla domanda sui dati.

Quando si rimuove l’ultima istanza, HQbird 2027 di questa linea viene rimosso.

3.3. Rimozione silenziosa

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 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:

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

3.4. Verificare il risultato

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

Atteso: 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:

  1. Eliminare il cluster nella console RCM e scollegare i suoi agenti.
  2. Rimuovere HQbird dai server membri.
  3. 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

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

Il 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:

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

Eseguire 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:

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

Attenzione: 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

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

Atteso: 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