HQbird 2027 para Linux: guia de instalação
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. O que o instalador instala
- 2. A instalação em resumo
- 3. Nova instalação
- 4. Após a instalação
- 5. Atualização de um HQbird mais antigo (2024 e anteriores)
- 6. Atualização do HQbird 2027 para uma nova versão
- 7. Comandos de manutenção
- 8. Conecte ao seu HQCenter
- 9. Instalação autônoma e scripts
- 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.confpara 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-debugos ignora. - Agente do HQbird (
fbagent): a unit systemdhqbirdfbagent-fb50, executada como o usuáriofirebird, 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çohttp://<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/hqbirdrcme é executado como a unithqbirdrcm; o resumo imprime seu endereço na linhaRCM:. O nó recebe sua unit (por exemplohqclusternode-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 offo 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á unithqbirdrcmnem linhaRCM:.
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
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
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.sha256As 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)
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
sudo sh hqbird2027-fb50-linux-2027.2.9.runOs 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.
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: quitAs 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ávelHQBIRD_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édumbou não está definido;- a janela é menor que 80 colunas por 24 linhas (dentro do
tmuxcom 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:
[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 --uninstallEste 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:
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]eTurn 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.--yese 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 porroote 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:
- a opção
--lang en|ru|pt-BR|de; - a variável
HQBIRD_LANG; - o locale do console (
LC_ALL, depoisLC_MESSAGES, depoisLANG), quando é um locale UTF-8; - inglês.
A segunda linha da saída diz qual é o idioma e como alterá-lo. Esta linha é sempre em inglês:
[install] Language: Русский (auto). Use --lang en to change.Notas:
- O PuTTY não envia
LANGpara 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.--langainda funciona aí. - O instalador precisa de um locale UTF-8 no host para os outros idiomas
(
C.UTF-8ouen_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:
[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 IDfornece 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-idaí 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
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.fdbUse 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).
/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--jsonpara 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:
O que você vê no terminal:
[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-roote--portnã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).--yesresponde 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-hqbirddesliga as units do HQbird mais antigo em qualquer caso;--no-hqbirddeixa 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 aofirebirdcom 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, oualiases.confpara 2.5) como linhasname = 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 diretivaincludenão é alterado. - Remove os logs de monitoramento antigos do HQbird mais antigo: o conteúdo
das pastas
mon/outcomingemon/outtracede 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:
sudo sh hqbird2027-fb50-linux-2027.2.9.run --yes --disable-hqbird6. 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.
sudo sh hqbird2027-fb50-linux-2027.2.9.runNa 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:
[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
sudo sh hqbird2027-fb50-linux-2027.2.9.run --fb-root /opt/fb50-2 --port 3056O 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:
# 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-dataSem --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:
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:
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 $B8. 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.
- 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 salveattach.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 quandoadmin_panel.install_script_urlestá definido. - Copie
attach.jsonpara o servidor. - Conecte de uma de duas maneiras:
# 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.jsonCom 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:
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:
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.txtNova instalação com o e-mail de avaliação, um arquivo de licença e o arquivo de anexo:
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.jsonAtualização de um HQbird mais antigo, todas as unidades do HQbird mais antigo desligadas:
sudo sh hqbird2027-fb50-linux-2027.2.9.run --yes --disable-hqbirdAtualização do HQbird 2027 para uma nova versão (uma instância; com várias, adicione
--fb-root e --port):
sudo sh hqbird2027-fb50-linux-2027.2.9.run --yesUma segunda instância do Firebird 5.0 na porta 3056:
sudo sh hqbird2027-fb50-linux-2027.2.9.run --yes --fb-root /opt/fb50-2 --port 3056Remoção:
sudo sh hqbird2027-fb50-linux-2027.2.9.run --uninstall
sudo sh hqbird2027-fb50-linux-2027.2.9.run --uninstall --remove-dataUm script que para em uma instalação com falha:
#!/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:
[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 ./*.debNa 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 |