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

Este guia é para o administrador que instala o HQbird 2027 em um servidor Linux com o instalador offline hqbird2027-fbNN-linux-<version>.run. Ele cobre uma nova instalação, a atualização de um HQbird mais antigo e de um HQbird 2027 anterior, os comandos de manutenção, a conexão com o seu HQCenter, a instalação não assistida (por script) e onde ficam os arquivos após a instalação.

Os exemplos mostram o instalador para Firebird 5.0 no Ubuntu 24.04. Os instaladores para Firebird 2.5, 3.0 e 4.0 funcionam da mesma forma; apenas a versão, a porta padrão e os nomes das pastas diferem. A configuração no Windows é descrita em Instalação no Windows.

Conteúdo

  1. 1. O que o instalador instala
  2. 2. A instalação em resumo
  3. 3. Nova instalação
  4. 4. Após a instalação
  5. 5. Atualização de um HQbird mais antigo (2024 e anteriores)
  6. 6. Atualização do HQbird 2027 para uma nova versão
  7. 7. Comandos de manutenção
  8. 8. Conecte ao seu HQCenter
  9. 9. Instalação autônoma e scripts
  10. 10. Solução de problemas

1. O que o instalador instala

Um arquivo .run = uma linha do Firebird. Escolha o instalador da versão do Firebird que seus bancos de dados usam:

Instalador Firebird que ele instala ou atualiza Primeiro Firebird no host Tamanho
hqbird2027-fb50-linux-<version>.run Firebird 5.0 (build HQbird) /opt/firebird, porta 3050 cerca de 250 MB
hqbird2027-fb40-linux-<version>.run Firebird 4.0 (build HQbird) /opt/firebird, porta 3050 cerca de 220 MB
hqbird2027-fb30-linux-<version>.run Firebird 3.0 (build HQbird) /opt/firebird, porta 3050 cerca de 130 MB
hqbird2027-fb25-linux-<version>.run Firebird 2.5 (build HQbird) /opt/firebird, porta 3050 cerca de 80 MB

Todo instalador contém e instala sem a Internet:

  • Firebird (a build HQbird daquela linha): um novo servidor, ou uma atualização in-place do Firebird daquela linha que já está no host. Seu firebird.conf, databases.conf (aliases.conf para 2.5), o banco de dados de segurança e a senha do SYSDBA são mantidos.
  • Arquivos de depuração do Firebird (símbolos para análise de falhas), instalados na pasta do Firebird. --no-debug os ignora.
  • Agente do HQbird (fbagent): a unit systemd hqbirdfbagent-fb50, executada como o usuário firebird, que faz os backups, o monitoramento, as tarefas de manutenção e as atualizações. O nome termina com a linha do Firebird (-fb25 … -fb50); uma segunda instância da linha tem -fb50-2.
  • HQ Monitor: o console web desta instância do HQbird, unit hqbirdmonitor-fb50, endereço http://<server>:<20000 + Firebird port>/ (para Firebird na porta 3050: http://localhost:23050/).
  • Componentes de cluster: o console de cluster RCM (hqbirdrcm) e o nó de cluster (hqclusternode) são copiados para o cache do agente. Kits com agente (fbagent) 3.1.0 e posteriores não criam cluster por padrão: sem RCM, sem janela de emparelhamento, sem porta de cluster no firewall. Duas perguntas (ou --rcm on, --cluster-pairing on) os ativam (“Próximo: cluster” na seção 3). Com RCM, ele é instalado em /opt/hqbirdrcm e é executado como a unit hqbirdrcm; o resumo imprime seu endereço na linha RCM:. O nó recebe sua unit (por exemplo hqclusternode-master-p3050) quando você vincula o host no RCM. Kits a partir de 2027.2.19 com um agente mais antigo instalam o RCM em cada servidor (--rcm off o deixa no cache) e abrem a janela de emparelhamento. Kits anteriores a 2027.2.19 apenas copiam ambos os componentes para o cache do agente: não há unit hqbirdrcm nem linha RCM:.

Instâncias instaladas antes de 2027.2.9 têm a porta do Firebird nos nomes do agente: pasta /opt/hqbird/fbagent-p3050, units hqbirdfbagent-p3050 e hqbirdmonitor-p3050. Uma atualização não altera esses nomes. Apenas novas instâncias recebem os nomes -fb<NN>, então um host pode ter ambas as formas.

Requisitos: x86_64, kernel 3.2 ou mais recente, systemd; um Linux com apt, dnf/yum ou zypper (Ubuntu, Debian, AlmaLinux, Rocky, RHEL, Oracle Linux, openSUSE, RED OS e outros); root. Cerca de 300 MB livres em /var/tmp durante a instalação (uma pasta onde programas podem ser executados; veja --tmpdir). Algumas bibliotecas do SO (libtommath, ICU) são obtidas do repositório da distribuição; um servidor sem Internet recebe os comandos exatos para prepará-las (seção 9).

Não suportado: um Firebird instalado a partir dos pacotes da distribuição (firebird3.0-server, rpm firebird). O instalador para antes de alterar qualquer coisa (código de saída 7); remova os pacotes primeiro (mantenha um backup gbak dos seus bancos de dados) ou use o instalador online com --import-firebird.

Várias linhas do Firebird em um servidor: cada linha tem seu próprio instalador. O primeiro Firebird no host vai para /opt/firebird; uma segunda linha vai para /opt/fb<NN> (/opt/fb50, /opt/fb40, /opt/fb30) na porta da sua linha: 3053 para 3.0, 3054 para 4.0, 3055 para 5.0. Quando essa porta está em uso, o instalador para e pede --port N. Várias instâncias de uma linha (um segundo Firebird 5.0 em outra porta) são instaladas com --fb-root <new folder> --port <port> (seção 7). O Firebird 2.5 tem apenas uma instância, em /opt/firebird; para um segundo servidor ao lado dele, use outra linha (por exemplo Firebird 5.0 em /opt/fb50).

Um runbook passo a passo para duas instâncias nas portas 3050 e 3051, para todas as linhas, com comandos para copiar e colar, está em hqbird2027-linux-two-instances-runbook.ru.md (russo) e hqbird2027-linux-two-instances-runbook.pt.md (português).

Teste: sem uma licença, o agente executa um teste de 7 dias. O e-mail do teste (--email) o estende para 30 dias. Um arquivo de licença (--license) ou a conexão com o seu HQCenter (seção 8) substitui o teste.

Atualizações: a partir do kit 2027.2.31 (agente 3.3.0), um servidor que não está conectado a nenhum HQCenter verifica o servidor de atualizações do fornecedor. Por padrão, o agente, o HQ Monitor e o fbmcp se atualizam sozinhos, e um novo pacote do Firebird é baixado e aguarda você. --auto-update all|agent|off ou a linha Updates da interface de texto altera isso (“Atualizações sem HQCenter” na seção 4). Um servidor conectado a um HQCenter recebe suas atualizações desse HQCenter.

2. A instalação em resumo

Diagram

A verificação do servidor e a própria instalação são feitas pelo agente do HQbird que o instalador carrega (fbagent --install-plan, fbagent --setup-install). Nada é baixado, exceto os pacotes do SO ausentes. Nada é alterado antes que o plano seja confirmado: os pacotes do SO são instalados após a confirmação. Em um terminal, os kits posteriores a 2027.2.30 abrem a interface de texto (etapa 3 da seção 3); --no-tui executa o instalador simples, que faz suas perguntas como linhas de texto. Sem um terminal e sem --yes, o instalador para na confirmação com o código de saída 4. Se a instalação falhar antes de a unit do agente iniciar, o agente reverte as units para o estado que tinham antes (código de saída 2; código 3 quando a reversão não foi completa, o resumo diz o que verificar).

3. Nova instalação

Etapa 1: Baixe o instalador e verifique-o

Command
KIT=hqbird2027-fb50-linux-2027.2.9.run
curl -fL -O https://ib-aid.com/download/hqbird/v2027/$KIT -O https://ib-aid.com/download/hqbird/v2027/$KIT.sha256
sha256sum -c $KIT.sha256

As outras linhas têm os mesmos nomes com fb40, fb30, fb25. Esperado: hqbird2027-fb50-linux-2027.2.9.run: OK. Um servidor sem Internet: baixe os dois arquivos em um PC com os mesmos links e copie-os para o servidor (scp, um pendrive, um compartilhamento).

O instalador também verifica seu próprio payload antes de descompactar qualquer coisa: um download cortado ou danificado para com o código de saída 5 (“baixe novamente”).

Etapa 2: Verifique o host sem alterá-lo (opcional)

Command
sudo sh hqbird2027-fb50-linux-2027.2.9.run --check

--check executa a verificação do host, relata as bibliotecas do SO ausentes (e os comandos para obtê-las em um servidor sem Internet), mostra o que o agente encontrou e o que ele faria, e sai. Nada é instalado.

Etapa 3: Execute o instalador

Command
sudo sh hqbird2027-fb50-linux-2027.2.9.run

Os kits posteriores a 2027.2.30 abrem a interface de texto quando você os inicia em um terminal: páginas em tela cheia com o plano e as configurações. Os kits até 2027.2.30, e os casos em “O instalador simples” abaixo, fazem suas perguntas como linhas de texto. Ambos fazem a mesma instalação com as mesmas opções.

A interface de texto

O instalador verifica o host, descompacta a si mesmo, lê o plano e mostra a primeira página. Nada no host é alterado até você iniciar a instalação na página Install.

text
 HQbird 2027 setup <version> | Firebird 5.0 (5.0.5.1917)

 Plan M1: New Firebird and HQbird agent
   Firebird: new /opt/firebird (unit firebird, port 3050)
   Agent: new, in /opt/hqbird/fbagent-fb50
   OS packages to install: libtommath1 (see Plan details)

   Language         English (auto)
   Firebird folder  automatic (/opt/firebird)
   Firebird port    automatic (3050)
   Agent id         automatic (srv1261114-fb50)
   SYSDBA password  generated (for a new Firebird)
   HQ Monitor       port automatic, login admin
   License          not now (add it later in HQ Monitor)
   HQCenter         not attached
   Cluster          RCM off, discovery mode off
   Components       debug files: yes, fbmcp: yes
   Updates          HQbird only (recommended)

 > Install
   Plan details
   About plans
   Quit

 Up/Down: move   Enter: change or start   Esc: quit

As linhas do topo são o plano para as configurações atuais: seu código e o que o instalador fará com o Firebird e o agente. Um plano que não é possível fica em vermelho, com o motivo, e o cursor fica na configuração que o corrige. Após cada alteração, o instalador lê o plano novamente.

Tecla O que faz
Cima, Baixo Move o cursor (também k, j)
Enter Abre a configuração sob o cursor, seleciona um item, aceita um valor digitado
Espaço Liga ou desliga um componente (a página Components)
Esc Volta à página anterior; na primeira página: sai do instalador (ele pergunta primeiro)
Ctrl+C Interrompe o instalador imediatamente (código de saída 2). Nada foi alterado antes da página Install

Em uma página onde você digita um valor (uma pasta, uma porta, um endereço), Enter o aceita e um valor vazio significa “automático”. Esc não sai de uma página dessas.

Configuração O que você escolhe O mesmo que a opção
Language Inglês, russo, português do Brasil, alemão; as páginas mudam imediatamente --lang
Firebird folder A pasta de um novo Firebird, ou do Firebird a atualizar. O Firebird 2.5 tem uma pasta, então seu instalador não tem essa linha --fb-root
Firebird port A porta TCP do Firebird --port
Agent id Automático, o nome do host, o nome do host e a instância, ou seu próprio valor. Apenas para um novo agente: um agente instalado mantém seu id, e a linha não é mostrada --agent-id
SYSDBA password Para um novo Firebird: gerada, ou a sua própria --sysdba-pass-file
HQ Monitor A porta e o login do console web --hqmonitor-port, --hqmonitor-login, --hqmonitor-password-file
License Não agora, um teste de 30 dias por e-mail (endereço, aviso de privacidade, zona), ou um arquivo de licença --email --accept-privacy --trial-zone, --license
HQCenter O arquivo attach.json do seu HQCenter --attach
Cluster O gerenciador de cluster RCM (id do cluster, senha de admin), modo de descoberta, a porta de emparelhamento --rcm, --cluster-id, --rcm-password-file, --cluster-pairing, --pairing-port
Components Arquivos de depuração do Firebird; fbmcp e os endereços do seu modo remoto --no-debug, --no-fbmcp, --fbmcp-allow-from

| Atualizações | Somente HQbird (o agente, o HQ Monitor e o fbmcp se atualizam sozinhos, um novo Firebird aguarda você), HQbird e Firebird (o Firebird também se atualiza sozinho, à noite, das 03:30 às 04:00, com uma reinicialização do Firebird), ou Desligado. Kits a partir de 2027.2.31; apenas para um novo agente sem arquivo attach.json: um HQCenter controla as atualizações de um agente anexado | --auto-update |

As opções na linha de comando são os valores com que as páginas iniciam: sudo sh hqbird2027-fb50-linux-<ver>.run --rcm on --port 3055 abre a primeira página com RCM ligado e porta 3055.

As quatro linhas sob as configurações:

  • Install mostra o plano por completo e então pergunta Start the install now? com o cursor em No. As perguntas do plano (um HQbird mais antigo, um Firebird em execução a ser parado) estão na mesma página: Yes responde a todas. Após Yes as páginas se fecham, e a instalação imprime seu log e o resumo na tela normal, como no instalador simples abaixo.
  • Plan details mostra o que o código do plano significa, o que o instalador encontrou no host, os avisos e os pacotes do SO que ele vai instalar.
  • About plans lista todos os códigos (M1 … M17). Enter em um código o explica. Um * marca o código do plano atual.
  • Quit sai do instalador (código de saída 1). Nada foi alterado.

O instalador simples

O instalador simples é executado quando uma destas condições é verdadeira:

  • a opção --no-tui, ou a variável HQBIRD_NO_TUI=1;
  • --yes, --check, --uninstall, --extract, --plan-help, --help;
  • stdin ou stdout não é um terminal: um script, ssh host 'command' sem um terminal, ou um pipe como ... 2>&1 | tee install.log;
  • TERM é dumb ou não está definido;
  • a janela é menor que 80 colunas por 24 linhas (dentro do tmux com sua linha de status, um terminal 80x24 tem 23 linhas: aumente a janela, ou use --no-tui);
  • o bash no host é mais antigo que 4.4 (RHEL 7, CentOS 7);
  • o kit é 2027.2.30 ou mais antigo.

Para a janela e para o bash, a primeira linha da saída diz por que as páginas não abriram.

Uma execução típica do instalador simples em um servidor sem Firebird:

text
[install] HQbird 2027 setup 2027.2.9, Firebird 5.0 (5.0.5.1916)
[install] host: Ubuntu 24.04.5 LTS, kernel 6.8.0-142-generic
[install] checking the payload (sha256) ...
[install] unpacking into /var/tmp/hqbird2027.k3Qf1x ...
[install] OS libraries missing: libtommath.so.1 (packages: libtommath1)
[install] plan M1: Firebird new /opt/firebird (unit firebird, port 3050)
[install]              agent new in /opt/hqbird/fbagent-fb50 (unit hqbirdfbagent-fb50), HQ Monitor hqbirdmonitor-fb50
[install]              OS packages to install: libtommath1
[install] Install as planned? Yes/No y
[install] installing from the package repository: libtommath1
[install] OS libraries: installed
[install] installing (fbagent --setup-install; log /var/log/fbagent/install.log) ...
...
Done: agent hqbirdfbagent-fb50 in /opt/hqbird/fbagent-fb50, Firebird 5.0.5.1916 in /opt/firebird (port 3050).
HQ Monitor: http://localhost:23050/ (login admin; password in /opt/hqbird/conf/access.properties)
[install] done. Uninstall: sudo sh hqbird2027-fb50-linux-2027.2.9.run --uninstall

Este exemplo é do kit 2027.2.9. A partir do kit 2027.2.19 o resumo também tem as linhas RCM: e Pairing: do console de cluster (“Next: cluster” abaixo). Com o agente 3.1.0 e posterior e nenhum cluster escolhido, elas são:

text
RCM:        off; turn it on in HQbird Monitor or with fbagent --cluster-init <id>
Pairing:    off; turn it on in HQbird Monitor or with fbagent --cluster-pairing on (port 7450)

O que as linhas significam:

  • host: a distribuição e o kernel; o instalador recusa um host que não seja x86_64, não tenha systemd, ou execute um kernel mais antigo que 3.2.
  • OS libraries: o que o Firebird desta linha precisa do SO (seção 9). O plano lista os pacotes ausentes (OS packages to install); após a confirmação o instalador os obtém do repositório da distribuição. Sem um repositório ele para com o código de saída 6 e imprime os comandos.
  • plan: o que o agente encontrou (linhas found Firebird ..., HQbird: ...) e o que ele vai fazer: Firebird new (um novo servidor), update (o Firebird desta linha é atualizado no local), ou uma recusa com o motivo (código de saída 1, nada alterado).
  • Install as planned? Yes/No: a última pergunta antes de qualquer coisa ser alterada. Responda y. Quando o plano tem perguntas próprias (um HQbird mais antigo, outra versão), elas vêm em vez disso (seção 5). Sem um terminal, passe --yes; caso contrário o instalador para com o código de saída 4.
  • Perguntas de cluster (agente 3.1.0 e posterior): Install the cluster manager (RCM) on this host and make a new cluster? [y/N] e Turn on discovery mode for 24 hours (an RCM on the network may invite this agent into its cluster; port 7450)? [y/N]. O padrão é No. A primeira é perguntada apenas quando o host não tem RCM e o agente não está em nenhum cluster; a segunda não quando o agente está em um cluster ou executa o RCM. --yes e uma execução sem terminal respondem No (sem código de saída 4).
  • HQ Monitor: o endereço e o login. Uma nova instalação recebe o login admin; sua senha gerada está em /opt/hqbird/conf/access.properties (modo 0600, legível apenas por root e pelo agente). Todas as instâncias HQbird 2027 do host compartilham este arquivo. Altere a senha no HQ Monitor.

A senha SYSDBA de um novo Firebird é gerada e salva em /root/fbagent-install-sysdba.txt (modo 0600): uma linha de comentário, depois a linha SYSDBA_PASS=<password>. Um outro Firebird instalado no mesmo host depois recebe a mesma senha deste arquivo. Para definir a sua própria, passe --sysdba-pass-file <file> (primeira linha do arquivo) ou --sysdba-pass <password>.

Idioma do instalador

Kits após 2027.2.30 falam quatro idiomas: inglês, russo (ru), português brasileiro (pt-BR) e alemão (de). O instalador escolhe o idioma nesta ordem:

  1. a opção --lang en|ru|pt-BR|de;
  2. a variável HQBIRD_LANG;
  3. o locale do console (LC_ALL, depois LC_MESSAGES, depois LANG), quando é um locale UTF-8;
  4. inglês.

A segunda linha da saída diz qual é o idioma e como alterá-lo. Esta linha é sempre em inglês:

text
[install] Language: Русский (auto). Use --lang en to change.

Notas:

  • O PuTTY não envia LANG para o servidor. O locale do próprio servidor conta, então o idioma costuma ser inglês. Use --lang.
  • Com --yes, e sem um terminal, o idioma automático é inglês: scripts leem essa saída. --lang ainda funciona aí.
  • O instalador precisa de um locale UTF-8 no host para os outros idiomas (C.UTF-8 ou en_US.UTF-8). Ele define um para si mesmo. Sem um, ele fala inglês.
  • Na interface de texto a linha Language da primeira página altera o idioma imediatamente. O terminal deve mostrar UTF-8 (PuTTY: Window, Translation, Remote character set UTF-8, que é o padrão dele).
  • O inglês permanece em: as linhas de progresso da própria instalação, o resumo Done:, /var/log/fbagent/install.log, e os avisos da varredura do host.

O código do plano

O plano tem um código: M1, M2, … Ele nomeia o caso que o instalador encontrou no host. O instalador imprime o que o código significa:

text
[install] plan M1: New Firebird and HQbird agent
[install]              This host has no Firebird and no older HQbird. Setup installs a new Firebird and a new HQbird agent.
[install] plan M1: Firebird new /opt/firebird (unit firebird, port 3050)

--plan-help imprime todos os códigos e sai. Não altera nada. Na interface de texto a primeira página mostra o código e seu título, “Plan details” mostra o texto, e “About plans” lista todos os códigos.

Código O que o instalador encontrou Firebird Agente HQbird mais antigo
M1 nada novo novo —
M2 Firebird desta linha, nenhum HQbird mais antigo atualização novo —
M3 Firebird de outra linha, nenhum HQbird mais antigo novo, porta 305N novo —
M4 HQbird mais antigo que serve o Firebird desta linha atualização novo desligado, seus jobs importados como habilitados
M5 HQbird mais antigo de outra linha; há um Firebird desta linha atualização, após uma pergunta novo continua funcionando
M6 HQbird mais antigo de outra linha; nenhum Firebird desta linha novo, após uma pergunta novo continua funcionando
M7 HQbird mais antigo sem um Firebird local de uma versão conhecida atualização ou novo novo continua funcionando, um aviso
M8 um agente HQbird 2027 para outro Firebird atualização ou novo novo, ao lado do primeiro não alterado
M9 como M8, e um HQbird mais antigo serve esta linha atualização novo, ao lado do primeiro desligado, seus jobs importados como habilitados
M10 um agente já serve este Firebird (uma execução repetida) atualização no local desligado quando ele executa
M11 --fb-root é um Firebird desta linha atualização novo ou no local como acima
M13 --fb-root é uma pasta vazia ou nova novo nessa pasta novo como acima

Códigos de uma recusa (código de saída 1, nada alterado): M12 a pasta tem um Firebird que o instalador não consegue atualizar (outra linha, uma versão que ele não consegue ler, um serviço desabilitado); M14 a pasta não está vazia e não tem Firebird; M16 vários servidores Firebird desta linha, forneça --fb-root; M17 o Firebird 2.5 funciona apenas em /opt/firebird. M15 é o kit somente de agente: o Firebird não é instalado e não é atualizado.

O id do agente

O id do agente nomeia o agente no HQCenter, na licença e no cluster. Ele é definido apenas na primeira instalação:

  • Padrão: nome do host + data + instância, por exemplo srv1261114-fb50.
  • --agent-id ID fornece seu próprio id (1-128 letras, dígitos, ., _ ou -; o primeiro uma letra ou dígito).
  • O instalador recusa um id que outro agente do host tenha.
  • Na interface de texto a página Agent id oferece o id automático, o nome do host, o nome do host com a instância, e seu próprio valor, e lista os ids que o host já tem.
  • Um agente instalado mantém seu id. Uma execução repetida o mostra no plano (id srv1 (kept)), a interface de texto não tem linha Agent id então, e --agent-id aí gera apenas um aviso. Um novo agente em uma pasta que uma instalação anterior deixou com sua configuração também mantém o id dessa configuração.

Passo 4: Verifique o resultado

Command
systemctl status firebird hqbirdfbagent-fb50 hqbirdmonitor-fb50 --no-pager
ss -ltnp | grep -E ':3050|:23050'
ISC_PASSWORD="$(sed -n 's/^SYSDBA_PASS=//p' /root/fbagent-install-sysdba.txt)" \
  /opt/firebird/bin/isql -user SYSDBA localhost/3050:/opt/firebird/examples/empbuild/employee.fdb

Use o caminho completo do banco de dados de exemplo: ele funciona para todas as linhas e também após uma atualização, enquanto o databases.conf mantido de uma instalação mais antiga pode não ter o alias employee (uma nova instalação de 2027.2.3 o tem).

Abra http://<server>:23050/ em um navegador e entre como admin com a senha de /opt/hqbird/conf/access.properties. A porta do Firebird e a porta do HQ Monitor são abertas no firewalld (zona public) quando ele está em execução, senão no ufw quando ele está ativo; com outro firewall, abra-as você mesmo. As portas de cluster são abertas apenas para uma opção de cluster: 7443, 7444 e a porta do nó com --rcm on; a porta do nó e a porta de pareamento com --cluster-pairing on. Sem um firewall ativo o instalador imprime uma linha com as portas que ele não abriu. Uma porta que estava aberta antes da instalação é deixada como está.

Próximo: cluster

Para replicar seus bancos de dados de um servidor mestre para um servidor réplica, vincule os dois servidores no console de cluster RCM. Com o agente 3.1.0 e posterior, instale o RCM apenas no mestre (--rcm on, ou responda y) e ative o modo de descoberta na réplica (--cluster-pairing on). O modo de descoberta abre a janela de pareamento por 24 horas: a porta de pareamento do slot do agente (7450 para a primeira instância, 7451 para a segunda, até 7459) é aberta no firewall, e o RCM pode convidar o agente. Um host tem um RCM (portas 7443 e 7444); o agente que o criou o executa e não abre nenhuma janela de pareamento.

Depois, sem o instalador: HQ Monitor → Clusters → Cluster on this server, ou fbagent --cluster-init <id> e fbagent --cluster-pairing on. Kits a partir de 2027.2.19 com um agente mais antigo iniciam o RCM em cada servidor e imprimem seu endereço na linha RCM: do resumo; uma instalação anterior a 2027.2.19 recebe o RCM quando você a atualiza com um kit mais novo (seção 6). O guia do cluster (para o kit 2027.2.33) vai passo a passo de dois servidores novos até uma réplica funcional, com capturas de tela: Guia do cluster Linux (também em russo e português). Os mesmos passos como apenas comandos: hqbird2027-linux-cluster-runbook.md (hqbird2027-linux-cluster-runbook.ru.md, hqbird2027-linux-cluster-runbook.pt.md).

4. Após a instalação

Units

Unit O que é Executa como
firebird (2.5, 4.0, 5.0 em /opt/firebird); firebird-superserver (3.0 em /opt/firebird); para outra pasta, o nome da pasta com / → _: firebird.opt_fb50, firebird.opt_fb40-2 (4.0, 5.0 em /opt/fb50, /opt/fb40-2), firebird.opt_fb30-superserver (3.0 em /opt/fb30) Servidor Firebird firebird
hqbirdfbagent-fb50 (segunda instância hqbirdfbagent-fb50-2; antes de 2027.2.9 hqbirdfbagent-p<porta do Firebird>) Agente HQbird firebird
hqbirdmonitor-fb50 (hqbirdmonitor-fb50-2; antes de 2027.2.9 hqbirdmonitor-p<porta do Firebird>) HQ Monitor firebird

As três estão habilitadas e iniciam na inicialização. journalctl -u hqbirdfbagent-fb50 mostra o log da unit do agente. O Firebird 3.0 também tem as units firebird-classic.socket e [email protected] (firebird.opt_fb30-classic.* em outra pasta), e o Firebird 2.5 tem firebird.socket: elas permanecem inactive, isso é normal. O processo do Firebird 2.5 é fb_smp_server (SuperClassic).

Onde estão os arquivos

O exemplo é a primeira instância do Firebird 5.0 em /opt/firebird na porta 3050. Uma segunda instância da linha tem -2 nos nomes do agente (fbagent-fb50-2, hqbirdfbagent-fb50-2, hqbirdmonitor-fb50-2). Instâncias instaladas antes de 2027.2.9 têm a porta nesses nomes (fbagent-p3050, hqbirdfbagent-p3050, hqbirdmonitor-p3050).

text
/opt/firebird/                         Firebird 5.0 server: bin/, lib/, plugins/, firebird.conf,
                                       databases.conf, security5.fdb, *.debug files (symbols)
/opt/fb50/                             a Firebird 5.0 next to another line (/opt/fb40, /opt/fb30)
/opt/hqbird/                           root of the HQbird agents
  conf/access.properties               HQ Monitor sign-in, shared by all instances of the host (0600)
  fbagent-fb50/                        HQbird agent of this Firebird
    fbagent                            the agent (unit hqbirdfbagent-fb50)
    hqmonitor                          HQ Monitor (unit hqbirdmonitor-fb50)
    agent_config.json                  agent configuration (encrypted secrets: config_secret.key)
    config.properties                  HQ Monitor configuration
    hqbird2027-firebird.json           the Firebird this installer installed
    hqbird2027-hqmonitor-firewall.json the HQ Monitor port this installer opened in firewalld or ufw
    conf/                              trace and job settings
    logs/                              agent log (firebird-agent_<date>.jsonl), license_state.json;
                                       journal.log and server_status.json after the first checks
    bak/                               backups of the configuration
    outcoming/                         status reports for HQCenter
    update/                            update cache: hqmonitor/, hqclusternode/, hqbirdrcm/
    certs/                             certificates after the attach to HQCenter
  fbagent-hqbird-takeover.json         state of the older HQbird units before the takeover (section 5)
/opt/hqbirdrcm/                        the cluster console RCM (unit hqbirdrcm, owner firebird):
                                       with agent 3.1.0 only after --rcm on (or HQ Monitor);
                                       kits 2027.2.19+ with an older agent: unless --rcm off
/opt/hqclusternode/                    the cluster node (owner firebird), empty until the host is
                                       linked in RCM or HQCenter adds it to a cluster
/var/lib/hqmonitor/<server id>/        HQ Monitor data
/var/log/fbagent/install.log           log of the installer's steps (passwords are hidden)
/root/fbagent-install-sysdba.txt       SYSDBA password of a new Firebird (root only, 0600)
/etc/sysctl.d/90-hqbird-firebird.conf  kernel settings for Firebird (vm.max_map_count), only when
                                       the system value is lower (Ubuntu 24.04 needs none)
/etc/sudoers.d/                        the agent's sudoers rules for its root helpers (updates, HQ Monitor)

O instalador não mantém nada em /var/tmp: sua pasta de trabalho /var/tmp/hqbird2027.XXXXXX é removida ao final, também após um erro.

Logs

Log Onde
Instalador o terminal; /var/log/fbagent/install.log
Agente /opt/hqbird/fbagent-fb50/logs/firebird-agent_<date>.jsonl, journal.log; journalctl -u hqbirdfbagent-fb50
HQ Monitor journalctl -u hqbirdmonitor-fb50; log de auditoria /opt/hqbird/fbagent-fb50/hqmonitor_audit.log
Firebird /opt/firebird/firebird.log

Atualizações sem HQCenter

A partir do kit 2027.2.31 (agente 3.3.0), um agente que não está vinculado a nenhum HQCenter obtém novas versões do servidor de atualização do fornecedor. O modo de atualização é a chave update.mode de agent_config.json:

Modo O que se atualiza sozinho
agent (padrão) O agente, o HQ Monitor e o fbmcp. Um novo pacote do Firebird é baixado e aguarda o administrador
all O mesmo, e o Firebird também, em sua janela de aplicação (à noite, das 03:30 às 04:00; a atualização reinicia o Firebird)
off Nada: o agente não faz verificações de atualização. Para atualizar, execute o instalador de uma nova versão (seção 6)
  • Na instalação: a linha Updates da interface de texto, ou --auto-update all|agent|off. Sem elas, o instalador não altera o modo.
  • Depois: a página Updates do HQ Monitor, ou o instalador novamente com --auto-update <mode>.
  • O estado: sudo /opt/hqbird/fbagent-fb50/fbagent --update-status (adicione --json para um script). Ele imprime a origem da versão, a zona e a última resposta do servidor de atualização.

O agente abre conexões HTTPS de saída apenas para estes endereços. Nenhuma porta de entrada é necessária.

Finalidade Endereço
Atualizações, zona EU liceu.ibsurgeon.com:9443
Atualizações, zona BR licbr.ibsurgeon.com:9443
Atualizações, zona RU licru.ibsurgeon.com:20943
Licença de avaliação trialeu.ibsurgeon.com:9443, trialbr.ibsurgeon.com:19443, trialru.ibsurgeon.com:23943

Um servidor vinculado a um HQCenter não usa os endereços de atualização: ele obtém suas atualizações desse HQCenter (seção 8).

Notificações

A partir do kit 2027.2.33 (agente 3.4.0), o agente envia mensagens sobre problemas do servidor para um bot do Telegram seu, um webhook ou e-mail (SMTP). O instalador não define nenhum canal, e nada é enviado até você adicionar um: HQ Monitor → Servers → Notifications. Para testar um canal pela linha de comando: sudo -u firebird /opt/hqbird/fbagent-fb50/fbagent --notify-test <channel>; --notify-history imprime as últimas entregas.

5. Atualização de um HQbird mais antigo (2024 e anteriores)

O instalador encontra um HQbird (FBDataGuard) instalado em /opt/hqbird e suas units, e os servidores Firebird que ele gerencia. Em seguida, segue as mesmas regras dos scripts de instalação do HQbird:

Diagram

O que você vê no terminal:

text
[install]   found Firebird 5.0.5.1878: /opt/firebird, port 3050, unit firebird, no agent
[install] plan M4: Firebird update /opt/firebird (unit firebird, port 3050)
[install]              agent new in /opt/hqbird/fbagent-fb50 (unit hqbirdfbagent-fb50), HQ Monitor hqbirdmonitor-fb50
[install]              HQbird services to turn off: hqbird
[install] Firebird 5.0.5.1878: unit firebird, port 3050, 0 TCP connections
[install] Confirm to stop running Firebird 5.0.5.1878? Yes/No y
  • O plano nomeia o Firebird que é atualizado; --fb-root e --port não podem movê-lo (sua unit é tomada).
  • A pergunta Confirm to stop running Firebird? é feita quando o mecanismo precisa ser parado; a linha anterior mostra as conexões abertas. Another version é perguntado quando o HQbird mais antigo gerencia um Firebird de outra versão (atualize esse, ou um novo ao lado dele). --yes responde a todas as perguntas com Yes; sem um terminal e sem --yes, o instalador para com o código de saída 4 e não altera nada.
  • --disable-hqbird desliga as units do HQbird mais antigo em qualquer caso; --no-hqbird deixa o HQbird mais antigo em paz (ele continua rodando ao lado do HQbird 2027).
  • A senha do SYSDBA não é solicitada: o agente a obtém do HQbird mais antigo.
  • O HQ Monitor usa o login do HQbird mais antigo: seu arquivo /opt/hqbird/conf/access.properties é mantido, então entre com o login e a senha que você usava antes. O instalador entrega o arquivo ao firebird com modo 0600 (o HQbird mais antigo o deixava legível por todos os usuários). O login de convidado do HQbird mais antigo (access.guest-login) não é usado pelo HQ Monitor.

O que é mantido: firebird.conf, databases.conf / aliases.conf, o banco de dados de segurança, a senha do SYSDBA, os bancos de dados, os backups e os arquivos do HQbird mais antigo. A atualização substitui os arquivos de programa do Firebird no local; os arquivos substituídos são mantidos em /opt/fbagent-update-backup/<folder name>-<id>/<time>_<old version>_to_<new version>/ (as duas atualizações mais recentes permanecem). As tarefas do HQbird (backups, sweeps, monitoramento) são importadas para o novo agente. A licença do HQbird mais antigo não é transferida: o novo agente executa a avaliação até que uma licença seja instalada ou o servidor seja vinculado ao seu HQCenter.

A partir do kit 2027.2.33 (agente 3.4.0), a importação da configuração do HQbird mais antigo faz mais duas coisas:

  • Registra os bancos de dados do HQbird mais antigo no arquivo de aliases do Firebird (databases.conf, ou aliases.conf para 2.5) como linhas name = path. O arquivo antigo é copiado primeiro. Um banco de dados é omitido quando seu caminho já está no arquivo, ou quando seu arquivo não existe. Um arquivo com uma diretiva include não é alterado.
  • Remove os logs de monitoramento antigos do HQbird mais antigo: o conteúdo das pastas mon/outcoming e mon/outtrace de sua pasta de saída (as pastas permanecem). Nada é removido enquanto um serviço do HQbird mais antigo estiver em execução. A remoção não pode ser desfeita: se você precisar desses logs, copie-os antes da instalação.

Ambos estão ativados por padrão. As chaves hqbird_import.register_databases e hqbird_import.clean_mon_logs de agent_config.json (ambas estão no editor de configuração do HQ Monitor) os desativam para uma importação posterior; o instalador não tem opção para elas.

O estado das units do HQbird mais antigo antes da tomada é salvo em /opt/hqbird/fbagent-hqbird-takeover.json. --uninstall não as reativa.

Forma não assistida:

Command
sudo sh hqbird2027-fb50-linux-2027.2.9.run --yes --disable-hqbird

6. Atualização do HQbird 2027 para uma nova versão

Um instalador mais novo da mesma linha, executado em um host com HQbird 2027, atualiza a instância instalada no local: Firebird, os arquivos de depuração, o agente e o HQ Monitor. A configuração, os bancos de dados, o estado de avaliação ou licença, a porta do HQ Monitor e o login são mantidos.

Command
sudo sh hqbird2027-fb50-linux-2027.2.9.run

Na interface de texto, a primeira página mostra Plan M10: Update of an installed HQbird 2027, o agente com seu id (kept), e nenhuma linha Agent id; Install inicia a atualização. O instalador simples imprime:

text
[install] HQbird 2027 setup 2027.2.9, Firebird 5.0 (5.0.5.1916)
[install]   found Firebird 5.0.5.1880: /opt/firebird, port 3050, unit firebird, agent hqbirdfbagent-p3050
[install] plan M10: Firebird update /opt/firebird (unit firebird, port 3050)
[install]              agent in_place in /opt/hqbird/fbagent-p3050 (unit hqbirdfbagent-p3050), HQ Monitor hqbirdmonitor-p3050
[install] Firebird 5.0.5.1880: unit firebird, port 3050, 2 TCP connections
[install] Confirm to stop running Firebird 5.0.5.1880? Yes/No y
...
Firebird updated: 5.0.5.1880 -> 5.0.5.1916
HQ Monitor updated 1.31.0 -> 1.33.0 (...)
Done: agent hqbirdfbagent-p3050 in /opt/hqbird/fbagent-p3050, Firebird 5.0.5.1916 in /opt/firebird (port 3050).

Uma atualização não altera os nomes da pasta do agent e das units: a instância deste exemplo foi instalada antes de 2027.2.9 e mantém fbagent-p3050.

Quando a build do Firebird do instalador é a que já está instalada (por exemplo Firebird 2.5.9.27194 em todo HQbird 2027 para 2.5), apenas o agent e o HQ Monitor são atualizados: o Firebird não é parado e não há a pergunta Confirm to stop.

O databases.conf mantido de uma instância instalada por um HQbird 2027 mais antigo pode não ter o alias employee; conecte-se ao banco de dados de exemplo pelo caminho completo (seção 3, passo 4). No Firebird 3.0 uma atualização a partir de 2027.2.0 deixa /opt/firebird/examples/empbuild/employee.fdb com modo 0444, e o Firebird não consegue abri-lo (no permission for read-write access); se você precisar do banco de dados de exemplo: sudo chmod 660 /opt/firebird/examples/empbuild/employee.fdb. Seus próprios bancos de dados não são tocados.

  • Com várias instâncias da linha, nomeie a que será atualizada: --fb-root /opt/fb50-2 --port 3056.
  • Executar o mesmo instalador novamente sobre a versão instalada é um reparo: os arquivos de programa e as units são gravados novamente, os dados permanecem.
  • Após a conexão a um HQCenter (seção 8), o agent, o HQ Monitor, o Firebird e os componentes do cluster são atualizados a partir do catálogo do HQCenter; um novo instalador então não é necessário.
  • Um servidor sem conexão a nenhum HQCenter com agent 3.3.0 ou posterior (kits a partir de 2027.2.31) atualiza o agent, o HQ Monitor e o fbmcp por conta própria, a menos que o modo de atualização seja off (“Atualizações sem HQCenter” na seção 4). Uma instalação feita antes de 2027.2.31 obtém isso após uma atualização com um instalador mais novo. Uma atualização com o instalador mantém o modo de atualização; --auto-update <mode> o altera.

7. Comandos de manutenção

Toda ação de manutenção é uma execução do instalador com opções, ou um comando do agent na pasta do agent. Em um terminal, uma execução sem --yes abre a interface de texto com essas opções já definidas (kits após 2027.2.30): verifique o plano na primeira página e então escolha Install.

Ação Comando
Outra instância desta linha sudo sh hqbird2027-fb50-linux-<ver>.run --fb-root /opt/fb50-2 --port 3056
Reparo / atualização sudo sh hqbird2027-fb50-linux-<ver>.run (com várias instâncias: --fb-root <folder> --port <port>)
Conectar ao HQCenter sudo sh hqbird2027-fb50-linux-<ver>.run --attach attach.json durante a instalação, ou depois cd /opt/hqbird/fbagent-fb50 && sudo ./fbagent --attach --file /path/attach.json
Enviar o e-mail de avaliação cd /opt/hqbird/fbagent-fb50 && sudo -u firebird ./fbagent --trial-email [email protected] --accept-privacy
Confirmar o código de avaliação do e-mail cd /opt/hqbird/fbagent-fb50 && sudo -u firebird ./fbagent --trial-confirm <code> (ou no HQ Monitor)
Instalar um arquivo de licença --license <file> durante a instalação, ou cd /opt/hqbird/fbagent-fb50 && sudo -u firebird ./fbagent --license-install /path/license.json
Estado da instalação sudo /opt/hqbird/fbagent-fb50/fbagent --install-state --json
Estado das atualizações (sem HQCenter) sudo /opt/hqbird/fbagent-fb50/fbagent --update-status
Alterar o modo de atualização (sem HQCenter) HQ Monitor, a página Updates; ou sudo sh hqbird2027-fb50-linux-<ver>.run --auto-update all|agent|off
Remover sudo sh hqbird2027-fb50-linux-<ver>.run --uninstall [--remove-data] [--force] [--agent-dir /opt/hqbird/fbagent-fb50]

Outra instância

Command
sudo sh hqbird2027-fb50-linux-2027.2.9.run --fb-root /opt/fb50-2 --port 3056

O novo Firebird vai para /opt/fb50-2 (uma pasta nova ou vazia), unit firebird.opt_fb50-2, com seu próprio agent (/opt/hqbird/fbagent-fb50-2, unit hqbirdfbagent-fb50-2) e seu próprio HQ Monitor (http://localhost:23056/, unit hqbirdmonitor-fb50-2). O agent recebe o menor número livre da linha: fb50-2 para a segunda instância, também ao lado de um agent instalado antes de 2027.2.9 (fbagent-p3050). O arquivo de login do HQ Monitor /opt/hqbird/conf/access.properties é compartilhado pelas instâncias do host: uma nova instância sem --hqmonitor-login mantém o login existente, e --hqmonitor-login/--hqmonitor-password-file em qualquer instância alteram o login de todas elas (o arquivo antigo é mantido como access.properties.bak-<time>). O Firebird 2.5 não suporta uma segunda instância: o instalador para com refused (M17): Firebird 2.5 works only in /opt/firebird, not in <folder> (código de saída 1, nada alterado). Instale um Firebird de outra linha ao lado dele, por exemplo sudo sh hqbird2027-fb50-linux-<ver>.run --fb-root /opt/fb50 --port 3051.

Remover

A remoção no Windows e no Linux, servidores em um cluster e o que permanece no disco são descritos por completo no guia de remoção. Em resumo:

Command
# the agent and HQ Monitor of this instance; Firebird, the databases, configs and logs stay
sudo sh hqbird2027-fb50-linux-2027.2.9.run --uninstall
# the same, and the agent's configuration, logs, license state and HQ Monitor data too
sudo sh hqbird2027-fb50-linux-2027.2.9.run --uninstall --remove-data

Sem --agent-dir o instalador remove o único agent em /opt/hqbird. Com vários agents no host ele para (código de saída 1), lista suas pastas e pede --agent-dir:

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

--uninstall para e remove as units do agent e de seu HQ Monitor (hqbirdfbagent-fb50, hqbirdmonitor-fb50), as regras de sudoers do agent e de seus programas (fbagent, hqmonitor), e fecha a porta do HQ Monitor que a instalação abriu no firewalld ou no ufw. A pasta do agent permanece com a configuração e os logs; --remove-data remove a pasta e também os dados do HQ Monitor em /var/lib/hqmonitor/. O Firebird permanece instalado (unit, pasta de programas, bancos de dados); as units mais antigas do HQbird que foram desativadas permanecem desativadas. Com vários agents no host, o arquivo de login compartilhado do HQ Monitor permanece até que o último agent seja removido.

Se o agent executa o RCM do host e outros agents usam esse RCM, --uninstall recusa com código de saída 5 e não altera nada: this agent runs the RCM of the host, and other agents use it: remove the cluster in the RCM console, or run again with --force. --force remove o agent de qualquer forma; o cluster então perde sua CA (nenhum novo certificado, nenhum novo membro). A unit do RCM permanece enquanto outros agents do host a usarem. Para tornar outro agent o proprietário de um novo RCM quando o antigo proprietário não existe mais: fbagent --cluster-init <id> --rcm-takeover (uma nova CA: vincule os membros novamente).

A dica ao final de uma instalação (Uninstall: sudo sh ... --uninstall) não tem --agent-dir: com várias instâncias adicione-o como mostrado acima.

Para remover também o Firebird de uma instância (o instalador não faz isso; faça backups gbak de seus bancos de dados primeiro), por exemplo 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*"             # 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

8. Conecte ao seu HQCenter

O HQCenter é o servidor central da sua empresa que gerencia os agents do HQbird: licenças, configuração, atualizações, visão geral dos backups. Sem um HQCenter o agent trabalha por conta própria com as versões do instalador e o arquivo de avaliação ou de licença.

Diagram
  1. No painel de administração do HQCenter abra Tokens (https://<hqcenter>:8443/admin/tokens). No formulário Install script escolha a licença (ou nenhuma), o modo, o número de servidores e a validade (1 a 365 dias); os campos de plataforma e Firebird não são usados. Clique em Download connection file e salve attach.json. O arquivo contém um token secreto: mantenha-o seguro (chmod 600), exclua-o após o uso e revogue o token na lista na mesma página. O formulário é mostrado apenas quando admin_panel.install_script_url está definido.
  2. Copie attach.json para o servidor.
  3. Conecte de uma de duas maneiras:
Command
# during the installation
sudo sh hqbird2027-fb50-linux-2027.2.9.run --yes --attach /root/attach.json
# later, for an installed agent
cd /opt/hqbird/fbagent-fb50 && sudo ./fbagent --attach --file /root/attach.json

Com um token comum o comando aguarda até que o administrador do HQCenter aprove a solicitação (até 30 minutos). Com um token de licença o agent é conectado imediatamente e recebe a licença. Após a conexão, a avaliação termina quando o HQCenter fornece uma licença ao agent; o agent, o HQ Monitor, o Firebird e os componentes do cluster são então atualizados a partir do catálogo do HQCenter. Uma conexão malsucedida durante a instalação não desfaz a instalação: o resumo informa isso, e o comando acima a repete.

Requisitos: HQCenter (goafts) 1.15.0 ou mais novo (versões mais antigas não têm o botão de arquivo de conexão); o servidor alcança a porta de bootstrap do HQCenter uma vez para a conexão e depois a porta dos agents (443 por padrão). O HQCenter pode estar sem Internet. Uma segunda conexão do mesmo servidor ao mesmo HQCenter exige a aprovação do administrador mesmo com um token de licença.

9. Instalação autônoma e scripts

Toda opção funciona também no terminal. Uma execução autônoma precisa de --yes (responde às perguntas do plano; sem um terminal e sem --yes o instalador para com código de saída 4). --yes nunca abre a interface de texto. Um script que inicia o instalador em um terminal e responde às suas perguntas por conta própria (por exemplo com expect) deve adicionar --no-tui ou definir HQBIRD_NO_TUI=1: kits após 2027.2.30 abrem as páginas ali. O código de saída informa o resultado; os detalhes estão no terminal e em /var/log/fbagent/install.log.

Opções

Opção Significado Padrão
--fb-root DIR Pasta do novo Firebird (nova ou vazia); ou a pasta do Firebird a atualizar /opt/firebird, depois /opt/fb<NN>
--port N Porta do Firebird 3050 para o primeiro Firebird; para outra linha a porta da linha (3053 para 3.0, 3054 para 4.0, 3055 para 5.0)
--sysdba-pass-file F, --sysdba-pass P Senha SYSDBA de um novo Firebird (primeira linha de F; P é gravada em um arquivo 0600) gerada, salva em /root/fbagent-install-sysdba.txt; um outro Firebird no host usa a senha desse arquivo
--agent-id ID agent.id do novo agent; apenas na primeira instalação, um agent instalado mantém seu id (“O id do agent” na seção 3) nome do host + data + instância
--hqmonitor-port N Porta do HQ Monitor 20000 + porta do Firebird
--hqmonitor-login L --hqmonitor-password-file F Login do HQ Monitor, compartilhado por todas as instâncias do host: informado em uma instância, ele altera o login de todas admin + senha gerada; uma atualização ou uma outra instância mantém o login existente
--email ADDR --accept-privacy [--trial-zone RU|EU|BR] E-mail de avaliação (30 dias); o endereço é enviado ao servidor de avaliação do fornecedor nenhum
--auto-update all|agent|off Atualizações de um servidor sem conexão a nenhum HQCenter (kits a partir de 2027.2.31): agent = o agent, o HQ Monitor e o fbmcp se atualizam por conta própria, um pacote do Firebird aguarda você; all = o Firebird também, em sua janela; off = nenhuma verificação de atualização (“Atualizações sem HQCenter” na seção 4) o modo não é alterado; um novo agent tem agent

| --license F | Arquivo de licença a instalar | nenhum | | --attach F | Anexar ao seu HQCenter (attach.json) | nenhum | | --no-hqbird, --disable-hqbird | Deixar o HQbird mais antigo em paz / desligar todas as suas unidades | automático | | --no-debug | Não instalar os arquivos de depuração do Firebird | instalados | | --no-fbmcp | Não instalar o fbmcp (o servidor MCP para clientes de IA) e não alterar o fbmcp deste host | instalado | | --fbmcp-allow-from A,B | Ativar o modo remoto do fbmcp para estes endereços de administração (IP ou CIDR) | somente local | | --fbmcp-port N, --fbmcp-dns NAME,..., --fbmcp-ip ADDR | A porta remota do fbmcp; nomes extras para o seu certificado; o endereço para o certificado e o listener | porta 8650 | | --rcm on\|off | Instalar o console de cluster RCM neste host e criar um novo cluster (agent 3.1.0 e posteriores) | perguntado; Não | | --rcm-password-file F | Senha de administrador do RCM com --rcm on (primeira linha de F) | gerada, exibida no final | | --cluster-id ID | Id do cluster com --rcm on | o nome do host | | --cluster-pairing on\|off | Modo de descoberta: a janela de emparelhamento por 24 horas, um RCM pode convidar este agent | perguntado; Não | | --rcm-allow A,B,... | Somente estes RCMs podem convidar este host no modo de descoberta (IP, CIDR ou nome do host) | qualquer RCM | | --pairing-port N | Porta de emparelhamento 7450–7459 de um novo agent; ele escolhe o slot (portas de nó 7051+k, 7061+k). Uma configuração posterior mantém o slot | o primeiro slot livre | | --cluster-node on\|off | Colocar o serviço de nó de cluster no cache do agent | on | | --yes | Responder Sim às perguntas do plano (Não às perguntas do cluster) | perguntar | | --check | Somente as verificações, as bibliotecas e o plano; nada é alterado | — | | --plan-help | Imprimir o que significam os códigos do plano (M1, M2, …) e sair | — | | --no-tui | O instalador simples, sem a interface de texto; também a variável HQBIRD_NO_TUI=1 (“The plain installer” na seção 3) | a interface de texto em um terminal | | --lang en\|ru\|pt-BR\|de | Idioma do instalador; também a variável HQBIRD_LANG (“Language of the installer” na seção 3) | o locale UTF-8 do console, senão inglês | | --tmpdir DIR | Descompactar aqui (uma pasta onde programas podem ser executados) | /var/tmp | | --extract DIR | Apenas descompactar o payload em DIR/payload e sair | — | | --uninstall [--remove-data] [--force] [--agent-dir DIR] | Remover o agent e o HQ Monitor (o Firebird permanece); --force também remove o agent que executa o RCM do host enquanto outros agents o utilizam | — |

As opções podem ser escritas como --port 3055 ou --port=3055. Caminhos relativos contam a partir da pasta atual.

Exemplos

Nova instalação com os padrões:

Command
sudo sh hqbird2027-fb50-linux-2027.2.9.run --yes
echo "exit code $?"

Nova instalação em uma pasta e porta escolhidas, com uma senha SYSDBA de um arquivo e um login do HQ Monitor:

Command
umask 077
printf '%s\n' 'S3cret-Sysdba' > /root/sysdba.txt
printf '%s\n' 'S3cret-Monitor' > /root/hqm.txt
sudo sh hqbird2027-fb50-linux-2027.2.9.run --yes \
  --fb-root /opt/firebird --port 3050 \
  --sysdba-pass-file /root/sysdba.txt \
  --hqmonitor-port 24000 --hqmonitor-login ops --hqmonitor-password-file /root/hqm.txt
rm -f /root/sysdba.txt /root/hqm.txt

Nova instalação com o e-mail de avaliação, um arquivo de licença e o arquivo de anexo:

Command
sudo sh hqbird2027-fb50-linux-2027.2.9.run --yes \
  --email [email protected] --accept-privacy --trial-zone EU \
  --license /root/hqbird-license.json \
  --attach /root/attach.json

Atualização de um HQbird mais antigo, todas as unidades do HQbird mais antigo desligadas:

Command
sudo sh hqbird2027-fb50-linux-2027.2.9.run --yes --disable-hqbird

Atualização do HQbird 2027 para uma nova versão (uma instância; com várias, adicione --fb-root e --port):

Command
sudo sh hqbird2027-fb50-linux-2027.2.9.run --yes

Uma segunda instância do Firebird 5.0 na porta 3056:

Command
sudo sh hqbird2027-fb50-linux-2027.2.9.run --yes --fb-root /opt/fb50-2 --port 3056

Remoção:

Command
sudo sh hqbird2027-fb50-linux-2027.2.9.run --uninstall
sudo sh hqbird2027-fb50-linux-2027.2.9.run --uninstall --remove-data

Um script que para em uma instalação com falha:

Command
#!/bin/sh
set -e
sh hqbird2027-fb50-linux-2027.2.9.run --yes || {
  rc=$?
  echo "HQbird setup failed with code $rc, see /var/log/fbagent/install.log" >&2
  exit $rc
}
echo "HQbird 2027 installed"

Servidor sem Internet: bibliotecas do SO

O Firebird de uma linha precisa destas bibliotecas do SO (além da glibc):

Linha Pacotes (Debian/Ubuntu) Pacotes (família RHEL)
5.0 libtommath1, libicu<NN>, libgssapi-krb5-2 libtommath (EPEL), libicu, krb5-libs
4.0 libtommath1, libicu<NN> libtommath (EPEL), libicu
3.0 libtommath1, libicu<NN> libtommath (EPEL), libicu
2.5 geralmente nada (libstdc++6 está no sistema base) geralmente nada

Os kits após 2027.2.30 das linhas 3.0, 4.0 e 5.0 também precisam do programa colrm, que o script de instalação do Firebird usa: pacote bsdextrautils (bsdmainutils em Debian e Ubuntu mais antigos). Um Debian mínimo não tem nenhum; a família RHEL tem no util-linux, que está sempre presente.

Quando um pacote está faltando e o repositório não está acessível, o instalador para com código de saída 6 e nada é alterado:

text
[install] ERROR: no access to the package repository, or a package is not there; nothing was changed.
[install] Missing: libtommath1
[install] Install them, then run this file again:
[install]   apt-get install -y libtommath1
[install] On a server without internet: on a PC with the same Ubuntu 24.04.5 LTS
[install]   apt-get download libtommath1
[install] copy the .deb files here and run:  apt-get install -y ./*.deb

Na família RHEL o libtommath está no EPEL: com um repositório acessível o instalador adiciona o epel-release por conta própria. Sem um, os comandos são dnf install -y epel-release, dnf download --resolve <packages> e dnf install -y ./*.rpm. --check imprime a mesma lista antecipadamente, para que os pacotes possam ser preparados antes da janela de instalação.

Códigos de saída

Código Significado Alterações no host
0 Concluído (avisos sobre o e-mail de avaliação, o anexo ou a licença estão no resumo) sim
1 Recusado: o host, uma opção, um arquivo ou o plano (o motivo é impresso). Também: Sair na interface de texto nenhuma
2 A instalação falhou e foi revertida. Também: o instalador foi interrompido por um sinal (Ctrl+C) revertida; nenhuma quando interrompido antes da instalação
3 A instalação falhou e a reversão não foi completa (o resumo diz o que verificar) parcialmente
4 Uma pergunta do plano não foi confirmada (sem terminal, sem --yes). nenhuma
5 O payload não passou na verificação (sha256, assinaturas): baixe o arquivo novamente. Com --uninstall: recusado, o agent executa o RCM do host e outros agents o utilizam (seção 7) nenhuma
6 Bibliotecas do SO estão faltando e o repositório de pacotes não está acessível nenhuma
7 Um Firebird dos pacotes da distribuição está instalado nenhuma

10. Solução de problemas

Problema O que fazer
run as root (sudo sh ...) Execute o instalador com sudo ou como root
As páginas da interface de texto não abrem A primeira linha diz por quê: needs a window of 80x24 or larger (aumente a janela; tmux com uma linha de status ocupa uma linha) ou needs bash 4.4 or newer. O instalador simples que executa então faz a mesma instalação
Caracteres errados ou linhas quebradas nas páginas Configure o terminal para UTF-8, ou execute com --lang en; --no-tui executa o instalador simples
/var/tmp is mounted noexec Execute novamente com --tmpdir /root (qualquer pasta onde programas podem ser executados)
is damaged or cut (código de saída 5) Copie o arquivo .run novamente e compare seu sha256sum com o valor publicado
Código de saída 6, bibliotecas faltando Prepare os pacotes conforme impresso (seção 9), depois execute o instalador novamente
Código de saída 7, Firebird dos pacotes da distro Remova os pacotes (apt-get remove firebird3.0-server, mantenha um backup gbak) ou use o instalador online com --import-firebird
refused (M17): Firebird 2.5 works only in /opt/firebird Um segundo Firebird 2.5 não é possível; instale outra linha ao lado dele (seção 7)
--uninstall recusado (código de saída 1) com vários agents Adicione --agent-dir com uma pasta da lista, por exemplo --agent-dir /opt/hqbird/fbagent-fb50-2
--uninstall recusado (código de saída 5): this agent runs the RCM of the host Remova o cluster no console do RCM primeiro, ou execute novamente com --force (seção 7)
no permission for read-write access para employee.fdb após uma atualização (3.0) sudo chmod 660 /opt/firebird/examples/empbuild/employee.fdb (seção 6)
refused (M14): the folder is not empty Escolha uma pasta vazia ou nova com --fb-root, ou nomeie o Firebird a atualizar
Código de saída 2 ou 3 Leia /var/log/fbagent/install.log; as unidades voltaram ao seu estado antes da execução (código 2) ou precisam de uma verificação (código 3)
O HQ Monitor não abre systemctl status hqbirdmonitor-fb50 (hqbirdmonitor-p<port> antes de 2027.2.9); verifique se nada mais escuta na porta; abra a porta no firewall; --hqmonitor-port para outra porta
Perdeu a senha do HQ Monitor Execute o instalador novamente (reparo) com --hqmonitor-login admin --hqmonitor-password-file <file>; o antigo /opt/hqbird/conf/access.properties é mantido como access.properties.bak-<time>. O novo login vale para todas as instâncias do host
O e-mail de avaliação não foi enviado (sem rede) Envie-o depois: cd /opt/hqbird/fbagent-fb50 && sudo -u firebird ./fbagent --trial-email <address> --accept-privacy
SELinux (AlmaLinux, RHEL) Suportado no modo enforcing: o instalador restaura os contextos dos arquivos que grava; nada a fazer