Esta página foi traduzida por máquina. Leia o original em inglês. English

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

  1. Faça um backup de cada banco de dados (gbak ou nbackup) 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.
  2. Pare as aplicações que usam os bancos de dados. No Windows a remoção para o Firebird que o instalador instalou.
  3. 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).
  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.
  5. 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

  1. Abra Configurações → Aplicativos → Aplicativos e recursos (ou Programas e Recursos).
  2. Selecione HQbird 2027 (Firebird 5.0) e clique em Desinstalar.
  3. Confirme a remoção.
  4. 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.
  5. 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.

  1. Abra Iniciar → Manutenção do HQbird 2027 (Firebird 5.0).
  2. Selecione Remover uma instância e selecione a instância.
  3. 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

Command
# 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 /FORCE

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

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

3.4. Verificar o 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: 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:

  1. Exclua o cluster no console do RCM e desvincule seus agentes.
  2. Remova o HQbird dos servidores membros.
  3. 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

Command
# 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
Command
# 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-data

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

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

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

Command
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 $B

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

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

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