Remoção do HQbird 2027
Este guia é para o administrador que remove o HQbird 2027 de um servidor.
Ele cobre o instalador do Windows hqbird2027-fbNN-setup-<version>.exe e o
instalador do Linux hqbird2027-fbNN-linux-<version>.run.
Os exemplos mostram o Firebird 5.0 (fb50). Para Firebird 2.5, 3.0 e 4.0 use
fb25, fb30, fb40 nos nomes de arquivos, pastas e serviços. A
instalação é descrita em
Instalação no Windows e
Configuração no Linux.
O HQbird 2024 é removido com as instruções anteriores.
1. Antes de começar
- Faça um backup de cada banco de dados (
gbakounbackup) e copie-o para outro disco ou servidor. A remoção não exclui os arquivos de banco de dados, mas um backup protege você de um erro. - Pare as aplicações que usam os bancos de dados. No Windows a remoção para o Firebird que o instalador instalou.
- Servidores em cluster: se este servidor executa o console de cluster RCM, exclua o cluster no RCM e desvincule seus agentes primeiro (seção 4).
- HQCenter: a remoção não exclui o registro do servidor no seu HQCenter. Remova o agente lá após a remoção, se você não planeja instalar o HQbird novamente.
- Licença: a remoção com os dados exclui o estado da licença do agente. Guarde seu arquivo de licença se você planeja instalar o HQbird novamente.
2. O que é removido e o que permanece
| Item | Windows | Linux |
|---|---|---|
| Agente HQbird (serviço ou unit, programas) | removido | removido |
| HQbird Monitor (serviço ou unit, regra de firewall) | removido | removido |
| Firebird que o HQbird 2027 instalou do zero | removido (serviço, arquivos de programa, regra de firewall) | permanece |
| Firebird que já existia e foi apenas atualizado | permanece | permanece |
Arquivos de banco de dados (*.fdb, *.gdb, *.fbk, *.nbk) |
sempre permanecem | sempre permanecem |
| Configuração do agente, logs, estado da licença, dados do HQbird Monitor | permanecem; removidos com a opção de dados | permanecem; removidos com --remove-data |
Banco de dados de segurança e arquivos *.conf do Firebird |
permanecem; removidos com a opção de dados | permanecem |
| Serviços de um HQbird mais antigo (2024 e anteriores) que a atualização desativou | permanecem desativados | permanecem desativados |
A opção de dados no Windows remove apenas o que um instalador do HQbird 2027 criou. Os dados de um agente que já existia antes da primeira instalação do HQbird 2027 permanecem.
3. Windows
Uma entrada em Apps e recursos = uma linha do Firebird. O desinstalador de uma linha remove todas as instâncias dessa linha. Execute-o como administrador.
3.1. Remover uma linha inteira
- Abra Configurações → Aplicativos → Aplicativos e recursos (ou Programas e Recursos).
- Selecione HQbird 2027 (Firebird 5.0) e clique em Desinstalar.
- Confirme a remoção.
- Responda à pergunta sobre os dados: Não mantém a configuração e o banco de dados de segurança, Sim os remove também.
- Aguarde a mensagem de que o HQbird foi removido.
Repita estes passos para cada linha do Firebird no servidor (uma entrada por linha).
3.2. Remover uma instância
Use isto quando uma linha tem várias instâncias e você remove apenas uma.
- Abra Iniciar → Manutenção do HQbird 2027 (Firebird 5.0).
- Selecione Remover uma instância e selecione a instância.
- Confirme, depois responda à pergunta sobre os dados.
Quando você remove a última instância, o HQbird 2027 desta linha é removido.
3.3. Remoção silenciosa
# programas e serviços; bancos de dados, configurações e o banco de dados de segurança permanecem
& 'C:\HQbird\setup\fb50\unins000.exe' /VERYSILENT
# o mesmo, e também os dados do agente, os dados do HQbird Monitor, o banco de dados de segurança e os *.conf
& 'C:\HQbird\setup\fb50\unins000.exe' /VERYSILENT /REMOVEDATA
# remove também uma instância que executa o RCM de um cluster (seção 4)
& 'C:\HQbird\setup\fb50\unins000.exe' /VERYSILENT /FORCEA pasta do desinstalador é <HQbird folder>\setup\fb50. As linhas instaladas por
instaladores anteriores a 2027.2.8 a têm em
C:\Program Files\IBSurgeon\HQbird 2027\fb50. A pasta exata é o
valor InstallLocation da entrada em Apps:
Get-ItemProperty 'HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\*' | Where-Object DisplayName -like 'HQbird 2027*' | Select-Object DisplayName, InstallLocation, UninstallString3.4. Verificar o 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: nenhum serviço do HQbird desta linha, e False para a chave do registro.
O desinstalador exclui a chave do registro somente após uma remoção completa. Se
a chave ainda estiver lá, execute o desinstalador novamente.
3.5. O que permanece no disco
| Pasta | Conteúdo | Excluir manualmente? |
|---|---|---|
C:\HQbird\Firebird50\ |
Arquivos de banco de dados e, sem a opção de dados, o banco de dados de segurança e os *.conf |
Depois de mover os bancos de dados |
C:\HQbird\fbagent-fb50\ |
Configuração e logs do agente, quando você manteve os dados | Sim, se você não precisar deles |
C:\HQbirdData\ |
Dados de trabalho do agente, dados do HQbird Monitor e arquivo de login, quando você manteve os dados | Sim, se você não precisar deles |
C:\HQbird\hqbirdrcm\ |
Dados do RCM (vão apenas com a opção de dados) | Sim, depois que o cluster não existir mais |
C:\ProgramData\fbagent\ |
install.log, resultado da última execução do instalador |
Sim |
C:\ProgramData\HQbird\fbagent\ |
Arquivo de senha do SYSDBA de uma instalação silenciosa | Sim |
<Firebird folder>.old_<time> |
Cópia da pasta de programas antiga do Firebird de uma atualização | Sim, quando a atualização estiver confirmada |
O serviço fbmcp é compartilhado por todas as linhas do servidor. Ele permanece enquanto outra linha o usar, e é removido com a última linha.
4. Servidores em um cluster
O agente que executa o RCM detém a CA do cluster. Quando outros agentes usam esse RCM, a remoção é recusada e nada é alterado.
Ordem recomendada:
- Exclua o cluster no console do RCM e desvincule seus agentes.
- Remova o HQbird dos servidores membros.
- Remova o HQbird do servidor que executa o RCM.
Para remover o proprietário do RCM de qualquer forma:
- Windows, diálogo: o desinstalador pergunta “Remover esta instância de qualquer forma? O cluster perde sua CA do RCM.” Responda Sim.
- Windows, silencioso: adicione
/FORCE. Sem ele, a instância que executa o RCM permanece, e o log informa o motivo. - Linux: o instalador para com o código de saída 5. Execute-o novamente com
--force.
Após uma remoção forçada o cluster não tem CA: nenhum certificado novo e nenhum
novo membro. Para tornar outro agente o proprietário de um novo RCM, execute
fbagent --cluster-init <id> --rcm-takeover nele e vincule os membros
novamente.
5. Linux
Execute o mesmo arquivo .run que instalou o HQbird (ou um mais novo da mesma
linha) como root. Os exemplos usam a versão 2027.2.33.
5.1. Remover o agente e o HQbird Monitor
# o agente e o HQbird Monitor; Firebird, bancos de dados, configuração e logs permanecem
sudo sh hqbird2027-fb50-linux-2027.2.33.run --uninstall# o mesmo, e também a pasta do agente (configuração, logs, estado da licença) e os dados do HQbird Monitor
sudo sh hqbird2027-fb50-linux-2027.2.33.run --uninstall --remove-dataO comando para e remove as units hqbirdfbagent-fb50 e
hqbirdmonitor-fb50, os programas fbagent e hqmonitor, e as
regras do sudoers do agente. Ele fecha a porta do HQbird Monitor que a
instalação abriu no firewalld ou ufw.
5.2. Várias instâncias em um único host
Sem --agent-dir o instalador remove o único agente em
/opt/hqbird. Com vários agentes ele para com o código de saída 1 e lista
suas pastas. Informe a pasta:
sudo sh hqbird2027-fb50-linux-2027.2.33.run --uninstall --agent-dir /opt/hqbird/fbagent-fb50-2Execute o comando uma vez para cada agente. O arquivo de login compartilhado do HQbird Monitor permanece até que o último agente seja removido.
5.3. Remover o Firebird (opcional, manualmente)
O instalador nunca remove o Firebird no Linux. Faça isso manualmente somente depois de ter feito backups e movido os bancos de dados para fora da pasta do Firebird.
Nomes das units do Firebird:
| Pasta do Firebird | Linha | Unit |
|---|---|---|
/opt/firebird |
2.5, 4.0, 5.0 | firebird |
/opt/firebird |
3.0 | firebird-superserver |
outra pasta, por exemplo /opt/fb50-2 |
4.0, 5.0 | firebird.opt_fb50-2 |
outra pasta, por exemplo /opt/fb30 |
3.0 | firebird.opt_fb30-superserver |
Exemplo para o Firebird em /opt/fb50-2:
B=/opt/fb50-2
U=firebird.$(echo ${B#/} | tr / _) # /opt/fb50-2 -> firebird.opt_fb50-2
systemctl list-unit-files "$U*" # as units que serão removidas
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 $BAviso: rm -rf exclui tudo na pasta, também os bancos de dados
e o banco de dados de segurança que estão dentro dela. Verifique a pasta primeiro.
5.4. Verificar o resultado
systemctl list-unit-files 'hqbird*' 'hqclusternode*' 'firebird*' --no-legend
ls /opt/hqbird /var/lib/hqmonitor 2>/dev/nullEsperado: nenhuma unit hqbirdfbagent-fb50 e hqbirdmonitor-fb50. A
unit do Firebird ainda está lá, a menos que você tenha removido o Firebird manualmente.
5.5. O que permanece no disco
| Caminho | Conteúdo | Excluir manualmente? |
|---|---|---|
/opt/hqbird/fbagent-fb50/ |
Configuração e logs do agente (sem --remove-data) |
Sim, se você não precisar deles |
/var/lib/hqmonitor/ |
Dados do HQbird Monitor (sem --remove-data) |
Sim, se você não precisar deles |
/opt/hqbirdrcm/ |
RCM, enquanto outros agentes do host o usarem | Depois que o cluster não existir mais |
/opt/fbagent-update-backup/ |
Arquivos de programa do Firebird que as atualizações substituíram | Sim, quando as atualizações estiverem confirmadas |
/opt/hqbird/fbagent-hqbird-takeover.json |
Estado das units do HQbird mais antigo antes da atualização | Mantenha-o se você planeja voltar ao HQbird mais antigo |
/opt/firebird (ou sua pasta do Firebird) |
Firebird e seus bancos de dados | Seção 5.3 |
5.6. Códigos de saída de --uninstall
| Código | Significado | O que fazer |
|---|---|---|
| 0 | Removido | — |
| 1 | Recusado: vários agentes no host, ou uma opção incorreta | Adicione --agent-dir com uma pasta da lista |
| 5 | Recusado: este agente executa o RCM do host e outros agentes o usam | Seção 4 |
6. Um HQbird mais antigo após a remoção
Quando o HQbird 2027 substituiu um HQbird mais antigo (2024 e anteriores), a atualização desativou os serviços do HQbird mais antigo. A remoção do HQbird 2027 não os reativa. O estado deles antes da atualização é salvo em:
- Windows:
<HQbird folder>\fbagent-hqbird-takeover.json - Linux:
/opt/hqbird/fbagent-hqbird-takeover.json
Use este arquivo para ver quais serviços estavam ativos, e inicie-os manualmente se você voltar ao HQbird mais antigo.
7. Solução de problemas
| Problema | O que fazer |
|---|---|
| Windows: a entrada em Apps e recursos permanece após a remoção | Uma instância não foi removida (frequentemente a que executa o RCM). Execute o desinstalador novamente; para o proprietário do RCM veja a seção 4 |
| Windows: um erro geral e um comando de um desinstalador antigo | O agente se atualizou para 3.1.0 ou mais novo e se recusa a remover o proprietário do RCM. Adicione --force ao comando mostrado, ou execute o desinstalador de um instalador mais novo |
| Windows: builds de teste 2027.0.1 e 2027.0.2 | Eles usavam uma entrada para todas as linhas. Remova-os com o próprio desinstalador deles |
Linux: --uninstall recusado, código de saída 1 |
Vários agentes no host: adicione --agent-dir (seção 5.2) |
Linux: --uninstall recusado, código de saída 5 |
O agente executa o RCM do host: seção 4 |
Linux: run as root (sudo sh ...) |
Execute o instalador com sudo ou como root |
Linux: o arquivo .run foi perdido |
Baixe o instalador da mesma linha novamente; uma versão mais nova da mesma linha também funciona |