Este documento lista as mudanças do HQbird 2027, as mais novas primeiro. Cada parte começa com o número da versão e a data dela. Uma versão nova acrescenta a parte dela no topo; as partes abaixo ficam como estavam.

  • 2027.2.34 e posteriores: uma parte para cada versão.
  • 2027.2.33: o HQbird 2027 inteiro naquela versão, comparado com o HQbird 2024.
  • As notas de cada kit, de 2027.2.8 a 2027.2.33, estão em hqbird2027-whats-new-2027.2.8-2027.2.33.md no site de download.

Instaladores: Download do HQbird 2027.

Downloads: https://ib-aid.com/download/hqbird/v2027/ (setup .exe do Windows e .run do Linux para o Firebird 2.5, 3.0, 4.0 e 5.0; SHA256SUMS traz as somas de verificação). Imagens Docker: ghcr.io/ibsurgeon/hqbird2027-fb25, -fb30, -fb40, -fb50.


2027.2.35 (2026-11-18)

Versões

Componente Versão Alterado
Agente do HQbird (fbagent, enroll) 3.6.0 sim
HQbird Monitor 1.59.0 sim
Editor de configuração (no HQbird Monitor) 1.63.0 sim
HQbird RCM 2027.5.13 sim
Nó do HQCluster 2027.5.13 sim
fbmcp (servidor MCP para o Firebird) 2027.2.24 não
Firebird 2.5.9.27194, 3.0.15.33893, 4.0.8.3332, 5.0.5.1917 não

Cluster: reinicialização depois de um backup e restore de um banco de dados master

  • Um backup e restore (gbak) de um banco de dados master dá a ele um GUID novo, e as réplicas não conseguem mais aplicar o journal dele. O nó vê isso em alguns segundos, pausa o envio para cada réplica (motivo master_db_replaced) e coloca o master em NEEDS_REINIT, como antes.
  • Novo: o RCM decide o que fazer em seguida, pela configuração auto_reinit.on_master_restore em rcm.json (também na página Configurações):
    • auto: o RCM reinicializa cada réplica do banco de dados sozinho, depois de uma espera de 300 segundos (auto_reinit.master_restore_settle_sec);
    • window: o RCM as reinicializa na janela de reinicialização automática dele;
    • propose: o RCM não inicia nada e espera um operador.
  • Sem essa configuração, nada muda: window quando a reinicialização automática está ligada, propose quando está desligada.
  • A linha do banco de dados master na página Bancos de dados diz o que aconteceu e o que o RCM faz. O botão novo Reinicializar todas as réplicas agora inicia a reinicialização de todas as réplicas, uma depois da outra. Adiar a segura.
  • O nó reage a qualquer substituição do arquivo do banco de dados: um restore feito à mão, ou o ciclo backup-restore do agente. Verificado no Firebird 2.5, 3.0 e 5.0. O alerta master_db_replaced vai para os canais de alerta do RCM.

Cluster: a replicação do HQbird 2024 (FBDataGuard) passa para o RCM

  • Em um servidor atualizado a partir do HQbird 2024, o agente lê as configurações de replicação do FBDataGuard (papéis, pastas de journal e de archive, destinos das réplicas) e as entrega ao RCM.
  • O RCM vincula os hosts de réplica sozinho. Um host que ele não consegue vincular aparece como candidato na página Vincular hosts.
  • O RCM então assume a replicação dos bancos de dados como ela está. Ele não reinicializa uma réplica, não reinicia o Firebird e não apaga arquivos. Ele espera enquanto o FBDataGuard ainda roda.
  • A página Configurações → Importar do FBDataGuard mostra o estado da importação e a repete. A linha de comando tem hqbirdrcm dg-import status e hqbirdrcm dg-import retry.
  • O nó lê os blocos que o FBDataGuard gravou em replication.conf e os segmentos de journal que ele renomeou para .uploaded.
  • A importação foi testada em servidores Linux.

RCM: a página Bancos de dados

  • A linha de um banco de dados master com a publicação ligada mostra quantas tabelas estão na publicação e quantas o operador retirou, por exemplo publication on · tables: 118 · taken out: 2.

Instaladores: a primeira senha do RCM

  • Depois de uma instalação com o RCM, o instalador Linux mostra a senha gerada de rcmadmin no terminal, com o caminho do arquivo dela. O setup do Windows a mostra na página de resultado.
  • A senha é mostrada só em um terminal. Ela não é gravada em um log, em um pipe nem no arquivo de resultado da instalação.

HQbird Monitor: a hora do intervalo de tempo

  • Os campos de hora do intervalo de tempo (dashboard, páginas de banco de dados, Logs, Errors) são dois campos para digitar, horas e minutos, no lugar das listas. As setas para cima e para baixo mudam um valor em 1, : passa das horas para os minutos, e uma lista curta oferece passos de 15 minutos.

Editor de configuração no HQbird Monitor

  • Um carimbo de tempo é a hora exata. A idade dele (“há 23 min”) fica na dica.
  • O painel de resultado de um job de backup tem uma linha Tamanho: o arquivo de backup da execução, e o banco de dados que o restore de teste dele gerou.
  • As páginas de configuração do agente cabem em um telefone e em uma tela de 1280 px: a linha de abas quebra, Configurações mostra as entradas dela como uma linha que rola, e as tabelas Tarefas e Backups não rolam mais para o lado em 1280 px.

Correções

  • O HQbird 3.0 em um servidor atualizado a partir do HQbird 2024 não iniciava depois da configuração do cluster (“Incorrect version of replication config file”): o Firebird carregava a cópia antiga do plugin de replicação da pasta plugins. A cópia agora fica fora dessa pasta.
  • O nó aplica uma alteração de limits.rescan_interval_sec sem reinício.

Atualização

  • Instale ou atualize com o setup 2027.2.35 do Windows ou com o .run do Linux. Um servidor com atualizações automáticas pega o agente 3.6.0 e o HQbird Monitor 1.59.0 por conta própria.
  • Em um cluster, atualize o RCM antes dos nós, ou ao mesmo tempo. O RCM 2027.5.13 funciona com nós mais antigos; a importação do FBDataGuard precisa de nós 2027.5.13.
  • Um ciclo backup-restore agendado em um banco de dados master de um cluster: defina auto_reinit.on_master_restore como auto. Caso contrário, as réplicas não recebem alterações depois do ciclo até um operador iniciar a reinicialização.
  • Docker: faça o pull da imagem 2027.2.35 e inicie um contêiner novo nos mesmos volumes.

2027.2.34 (2026-11-17)

Versões

Componente Versão Alterado
Agente do HQbird (fbagent, enroll) 3.5.0 sim
HQbird Monitor 1.58.0 sim
Editor de configuração (no HQbird Monitor) 1.62.0 sim
fbmcp (servidor MCP para o Firebird) 2027.2.24 não
HQbird RCM 2027.5.12 não
Nó do HQCluster 2027.5.12 não
Firebird 2.5.9.27194, 3.0.15.33893, 4.0.8.3332, 5.0.5.1917 não

O log de um job do gbak fica inteiro

  • Antes, o agente cortava o meio de um log do gbak maior que 16 MiB. Agora o log de cada fase de um job de backup ou de restore é um arquivo .log.zip com tudo o que o gbak imprimiu.
  • Ao lado do arquivo, o agente guarda um arquivo de texto pequeno com as últimas 100 linhas da saída e dos erros.
  • No editor de configuração, Baixar log salva o arquivo. O botão novo Últimas linhas, na linha de log de um job e no histórico de restore, mostra o fim do log sem um download.
  • Um arquivo maior que 30 MB não é enviado ao HQCenter. A linha dele diz mantido só no servidor, e Baixar log mostra o caminho do arquivo no servidor. As últimas linhas ainda são enviadas.
  • Logs gravados por versões anteriores (.log.gz) são mantidos e o download funciona como antes.

HQbird Monitor no telefone

  • Em uma tela de 768 px de largura ou menos, o cabeçalho é uma linha: a seta de voltar, o nome do servidor e um botão de menu. O botão abre o menu do servidor, Configurações, o idioma e Log out como um painel. Antes, o cabeçalho ocupava três linhas e mostrava quatro dos sete itens do menu.
  • O intervalo de tempo é um botão. Ele abre a data, o intervalo e as predefinições como um painel. Os filtros Include e Exclude de Logs, Errors e Conflicts se recolhem sob um botão Filtros.
  • Em uma tela de 600 px de largura ou menos, os servidores, os bancos de dados do dashboard, os erros e os registros de log são cartões. Nada rola para o lado.
  • Botões e campos têm pelo menos 44 px de altura, e o texto de um campo tem 16 px, para o Safari no iPhone não ampliar a página quando você toca em um campo.

Páginas de banco de dados no HQbird Monitor

  • Uma página de banco de dados mantém o menu do servidor: Logs, Configs, Errors, Conflicts, Perf Report, Jobs e Backups ficam a um clique. Antes, os itens do banco de dados tomavam o lugar do menu do servidor.
  • Os itens do banco de dados (Database, Metrics, Clients Versions, Statistics, Performance report) ficam em uma linha sob o cabeçalho. A linha começa com o rótulo DB e o nome do banco de dados, e permanece no lugar quando você rola.
  • Clique no nome do banco de dados para ver os bancos de dados do servidor: o nome, o caminho e o tamanho de cada um. Outro banco de dados abre na mesma página, no mesmo dia e no mesmo intervalo de tempo. A partir de 8 bancos de dados, a lista tem um campo de busca.
  • Perf Report mostra a linha de um banco de dados enquanto esse banco de dados está escolhido na lista Database.
  • O logotipo em uma página de banco de dados não é mais um link para o dashboard; o nome do servidor é.
  • O Guia do usuário (inglês e português do Brasil) está atualizado, com imagens novas.

Instalador Linux

  • ALT Linux. Em um ALT 11 limpo, os kits do Firebird 3.0, 4.0 e 5.0 paravam com o código 6, porque o instalador pedia nomes de pacotes do Debian. O instalador agora conhece o ALT Linux e instala os pacotes certos.
  • sudo só para um grupo. Em um sistema em que só um grupo pode executar sudo (ALT Linux: o grupo wheel), a instalação fazia rollback. O instalador agora adiciona a conta do agente a esse grupo e avisa. Ele para, com o motivo, quando esse grupo pode executar todos os comandos sem senha ou quando só o root pode executar sudo.
  • Uma instalação que falha não deixa nada para trás. O rollback agora para um serviço do Firebird que rodava a partir da pasta removida e segurava a porta, e remove a pasta do agente e o arquivo sudoers dela. A tentativa seguinte começa limpa.
  • SELinux. No AlmaLinux 8 o HQbird Monitor não era instalado: o arquivo unit dele tinha um rótulo SELinux errado. O instalador agora define o rótulo.

Imagens Docker

  • Um roteador de cluster (HAProxy) agora inicia no contêiner. Antes, o serviço do roteador não iniciava na imagem.
  • Um contêiner novo nos volumes de um antigo, com um roteador neles, não fica mais preso em um loop de reinício.

Correções

  • HQbird Monitor no telefone: os itens Jobs e Backups apareciam para um servidor cujo agente não tem editor de configuração.

Atualização

  • Instale ou atualize com o setup 2027.2.34 do Windows ou com o .run do Linux. Um servidor com atualizações automáticas pega o agente 3.5.0 e o HQbird Monitor 1.58.0 por conta própria.
  • Um HQCenter precisa do HQbird Monitor 1.58.0 para baixar os logs novos .log.zip dos agentes dele. Atualize o HQCenter antes dos agentes, ou ao mesmo tempo.
  • Um proxy na frente do HQbird Monitor que filtra os tipos de conteúdo da resposta precisa permitir application/zip em api/joblog.
  • Docker: faça o pull da imagem 2027.2.34 e inicie um contêiner novo nos mesmos volumes.

2027.2.33 (2026-11-16): HQbird 2027 comparado com o HQbird 2024

Estado do código-fonte em 2026-11-16. O kit lançado foi 2027.2.33 (2026-11-16). Esta parte dá o panorama completo em relação ao HQbird 2024.

1. Resumo

  • A ferramenta Java FBDataGuard foi substituída. O trabalho dela agora é feito por um serviço, fbagent, e por um console web, HQbird Monitor.
  • Novo: HQbird Cluster. Um gerenciador de cluster (RCM) e um nó em cada servidor permitem configurar a réplica a partir de uma página web, switchover, failover e rejoin.
  • Novo: HQCenter. O seu servidor central para muitos servidores HQbird: um console, entrega de configuração, atualizações, licenças, acompanhamento de problemas.
  • Novo: fbmcp. Um servidor MCP que permite a um assistente de IA trabalhar como DBA do Firebird. Alterações críticas precisam da aprovação de uma pessoa fora do cliente de IA.
  • Instaladores novos. Um setup offline por versão principal do Firebird, para Windows (.exe) e Linux (.run), com várias versões principais do Firebird e várias instâncias em um servidor. Imagens Docker para cada versão principal.
  • Licenciamento novo. Arquivos de licença assinados, uma avaliação sem cadastro por 7 dias, zonas de licença EU / RU / BR.
  • Atualizações automáticas do agente, do HQbird Monitor, do fbmcp, dos programas do cluster e do Firebird, com verificação de assinatura e rollback.
  • Engine. Índice NGRAM, views materializadas, CREATE INDEX CONCURRENTLY, CREATE TABLE AS SELECT, opções avançadas de trace, um limite de conexões por banco de dados, login do Active Directory no Linux.

2. Componentes: 2024 e 2027

HQbird 2024 HQbird 2027
FBDataGuard (Java, console web na porta 8082) fbagent (serviço) + HQbird Monitor (console web) + editor de configuração dentro do Monitor
Advanced Monitoring Viewer (AMV), ferramentas de desktop Páginas do HQbird Monitor: dashboard, relatório de performance, erros, conflitos, estatísticas
Replicação definida à mão ou no FBDataGuard, failover manual HQbird Cluster: RCM + nó, switchover, failover, roteadores
Sem servidor central HQCenter (Linux) para uma frota de servidores
Sem ferramentas de IA fbmcp, um servidor MCP com cerca de 120 ferramentas
Um setup do Windows com componentes, um script de Linux Um setup offline por versão principal do Firebird, .exe e .run, imagens Docker
Ativação por e-mail e senha Arquivo de licença assinado, avaliação, zonas de licença
Alertas por e-mail do FBDataGuard E-mail do acompanhamento de status do HQCenter; Telegram, webhooks e e-mail do agente

3. Versões

Componente Versão no kit 2027.2.33
Firebird (builds HQbird) 2.5.9.27194, 3.0.15.33893, 4.0.8.3332, 5.0.5.1917
fbagent 3.4.0
HQbird Monitor 1.57.0
Editor de configuração (no Monitor) 1.61.0
HQbird RCM / nó de cluster 2027.5.12
fbmcp 2027.2.24
HQCenter (goafts, site stack) 1.22.0
fblogspacker (dentro do fbagent) 1.5.12

4. Engine do Firebird (builds HQbird)

Os builds HQbird do Firebird têm recursos de nível de servidor (plugins e alterações no núcleo) que o vanilla Firebird da mesma versão não tem. A tabela mostra cada recurso e as versões principais do Firebird que o têm. A fonte é a página Melhorias de nível de servidor do HQbird 2027.

Recurso O que oferece Parâmetro Versões principais
Índice NGRAM Busca indexada de substring (LIKE '%search%') para VARCHAR e BLOBs de texto - 5.0
Views materializadas CREATE MATERIALIZED VIEW, para BI e consultas complexas. Usa inserção em massa - 5.0
Tabela como resultado de consulta CREATE TABLE AS SELECT. Usa inserção em massa - 5.0
Criação de índice sob carga CREATE INDEX ... CONCURRENTLY: a tabela continua disponível - 5.0
Tabelas MON$ mais rápidas Desliga a coleta dos dados que não são necessários FillMonCompiledStatements, FillMonStatements, FillMonCallStack 5.0
Migração fácil para o 5.0 Literais no estilo antigo são reconhecidos; COUNT(*) é descrito como INT para aplicações antigas LegacyTimeLiterals, LegacyIntForCount 5.0
Autenticação GSSAPI/SSPI Plugin gssauth para Active Directory; servidores e clientes Windows e Linux - 5.0
Sem registro de erros INET Erros de rede não são gravados em firebird.log DisableLogNetIOErrors 5.0
Monitoramento leve Acompanhamento do estado do servidor sem carga MonitoringPlugin 2.5, 3.0, 4.0, 5.0
Limite de conexões a um banco de dados Proteção contra picos de conexão WarnCountAttachments, MaxCountAttachments 3.0, 4.0, 5.0
Opções avançadas de trace Rastreamento de conflitos (deadlocks) e de alterações (por exemplo, uma auditoria de alterações) - 3.0, 4.0, 5.0
Substituição de consulta em tempo real O servidor substitui o texto da consulta. O texto novo fica visível no trace e em MON$ SqlSubstDirectory 2.5, 3.0, 4.0, 5.0
Cache de BLOB em espaço temporário BLOBs ficam 15-200% mais rápidos BlobTempSpace 2.5, 3.0, 4.0, 5.0
Log de consultas com ordenação grande O texto da consulta é gravado em firebird.log TempSpaceLogThreshold 2.5, 3.0, 4.0, 5.0
Fontes de dados externas: MySQL e ODBC EXECUTE STATEMENT ... ON EXTERNAL para MySQL e ODBC - 3.0, 4.0, 5.0
Streaming / CDC (Kafka, RabbitMQ, JSON, Mongo) Envia INSERT/UPDATE/DELETE das tabelas escolhidas, com base na replicação. Sob demanda - 4.0, 5.0
Busca de texto completo (Lucene) UDR de código aberto e um plugin baseado em streaming - 3.0, 4.0, 5.0
Autocorreção de parâmetros de cache Corrige valores errados de DefaultDbCachePages em firebird.conf / databases.conf DefaultDbCachePages, MinDbCachePages, MaxDbCachePages 4.0, 5.0
Mascaramento da versão do HQbird Define se a API do Firebird devolve a string de versão do HQbird HQbirdVersionString 2.5, 3.0, 4.0, 5.0
Criptografia de banco de dados (plugin) AES-256, sobrecarga de 4-20%. Sob demanda - 3.0, 4.0, 5.0
Otimizador de JOIN Joins internos implícitos passam a ser explícitos LeftJoinConversion 3.0, 4.0
Cache de consultas preparadas Consultas preparadas ficam na memória da conexão DSQLCacheSize 3.0, 4.0
Backup, restore, sweep e criação de índice em várias threads Backup e sweep até 4-6x mais rápidos, restore 2-4x mais rápido (8 núcleos, SSD) - 2.5, 3.0, 4.0
Replicação nativa Plugin; registros sem PK/UK podem ser excluídos - 2.5, 3.0
Otimizador de ordenações grandes Refetch plan SortDataStorageThreshold 2.5, 3.0
Leitura paralela de dados make_dbkey() e um snapshot compartilhado - 2.5, 3.0
Pool de conexões externas Consultas externas paralelas ao Firebird ExtConnPoolSize, ExtConnPoolLifeTime 2.5, 3.0
Backups para o Amazon S3 (plugin) Sob demanda - não informado

5. fbagent: o agente que substitui o FBDataGuard

Um agente atende uma instância do Firebird. Vários agentes podem rodar em um host. O agente funciona com Firebird 2.5, 3.0, 4.0 e 5.0 no Windows e no Linux.

5.1 Backups

  • Backup verificado (gbak) para um banco de dados ou um grupo de bancos de dados em pastas, com um restore de teste opcional.
  • nbackup incremental, níveis 0 a 4, no modo simples, avançado ou de grupo.
  • Modo de plano do nbackup: as regras definem o nível, os dias e a hora. O editor mostra um calendário e uma previsão de armazenamento. A retenção mantém um nível 0 com os incrementos dele.
  • Ciclo backup-restore: backup, restore e troca do banco de dados em produção, com rollback depois de uma queda.
  • Jobs de restore a partir de .fbk ou .nbk, locais ou do S3.
  • Compressão: deflate, zip, gz, zstd.
  • Criptografia: arquivos zip AES-256 com custódia de chaves.
  • Nuvem: backup em streaming para o S3 sem arquivo local; cópia para o S3 e para FTP/FTPS.
  • Inventário de backups: um registro de cada arquivo de backup e de cada restore, com tamanho, hora e o resultado da verificação.
  • Histórico de comandos: até 50 execuções por job, com logs do gbak.

5.2 Manutenção

  • Sweep, estatísticas de índice, validação com gfix, scripts SQL com uma janela de execução, rastreamento de metadados.
  • Um agendamento cron e uma janela de execução para cada job.
  • Executar agora para jobs importantes: localmente, ou à distância pelo HQCenter, com progresso e cancelamento.
  • Um teste de velocidade de disco em uma janela noturna.

5.3 Verificações de saúde

  • Status do servidor cerca de cada 10 minutos. Cada achado tem um nível, uma linha de evidência e uma dica. O status mostra tendências (por exemplo, o tempo até um disco encher) e nomeia a transação ou o programa por trás de um problema.
  • Métricas do host: CPU e memória por programa, latência de disco e IOPS por disco, qual serviço usa o disco, bancos de dados no cache do SO.
  • Limites do Linux: TasksMax, NPROC, NOFILE, OOM kills.
  • Espaço em disco: mínimos de espaço livre e detecção de enchimento rápido.
  • Logs: firebird.log e replication.log são classificados por assinatura, por exemplo corrupção provável.
  • Estado do banco de dados a partir da página de cabeçalho: shutdown, lock do nbackup, réplica, somente leitura.
  • Modo do Firebird: SuperServer, SuperClassic ou Classic, com um achado quando uma mudança de modo espera um reinício.
  • Prometheus, endpoint /metrics com um token.
  • Um limitador de recursos limita a CPU e a memória do próprio agente. Ele nunca pausa um backup.

5.4 Performance

  • Trace contínuo com um watchdog.
  • Relatório de performance por janela de tempo: rankings por duração, frequência, tempo total, fetches, leituras e gravações; planos, procedures e triggers; quem executou um statement, quando e de onde; execuções que falharam.
  • Relatório de performance sob demanda para um intervalo e um banco de dados escolhidos.
  • Conflitos de lock e deadlocks com o SQL dos dois lados.
  • Erros de trace por classe, com a aplicação cliente e o endereço.
  • Monitoramento leve pelo plugin fblwmon.

5.5 Configuração

  • O agente recarrega a configuração sem reinício: validação, backup e rollback em caso de erro.
  • Editor de databases.conf (aliases.conf no 2.5): verificações por versão da engine, uma cópia de backup antes de salvar, os comentários são mantidos.
  • Usuários: a lista de usuários de um banco de dados de segurança, e Criar usuário.
  • Entrega de configuração a partir do HQCenter, com um estado para cada alteração: enviada, aplicada, rejeitada, drift.

5.6 Entrega de logs (fblogspacker)

  • O agente envia só dados novos ao HQCenter: o trecho novo no fim de firebird.log e de replication.log, arquivos de trace e de monitoramento por minuto, métricas, o status do servidor.
  • Os arquivos têm um limite de tamanho (120 MiB por padrão). Arquivos grandes vão em partes.
  • Backups e bancos de dados nunca são enviados.

6. HQbird Monitor: o novo console web

Um console por instância do Firebird (porta 20000 + a porta do Firebird, por exemplo 23050), ou um console central para todos os servidores de um HQCenter.

  • Servers: todos os servidores com status, versão e modo do Firebird, versão do agente, licença e gráficos pequenos.
  • Dashboard: CPU, memória, conexões; CPU por programa; quem usa o disco e a memória; arquivos temporários; espaço em disco, latência e velocidade; uma tabela de bancos de dados com indicadores de estado. Um clique em um minuto mostra aquele minuto.
  • Relatório de saúde do servidor: uma matriz de 18 sistemas por 24 horas, 7 dias ou 14 dias; uma cronologia de problemas; achados por área; tabelas de discos, transações, replicação, erros, consultas e backups. Botões de ação abrem a correção no editor.
  • Página do banco de dados: gráficos de monitoramento, de I/O e de transações; as principais consultas e conexões de um minuto escolhido.
  • Perf Report: 10 rankings, execuções por hora, uma comparação de duas janelas, um histórico de 30 dias de um statement, um relatório sob demanda.
  • Errors e Conflicts: erros de trace com exportação CSV; conflitos de lock e deadlocks por minuto.
  • Estatísticas: análise do gstat com recomendações, tendências e previsões, exportação para Excel e JSON.
  • Logs e Configs: firebird.log e replication.log por dia, com filtros; o histórico de alterações dos arquivos .conf.
  • Jobs, Backups, Activity: o editor de configuração embutido e o inventário de backups.
  • Licenças, Atualizações, Usuários, Clusters, Configurações.
  • Página de notificações (o botão fica na página Servers): quem envia (o agente, o HQCenter, os dois ou ninguém), canais, mensagens de teste, o chat ID de um bot do Telegram, as últimas 50 entregas. A página nunca mostra um token, uma URL ou uma senha armazenados.
  • Idiomas: inglês, russo, alemão, português do Brasil, espanhol.
  • Acesso: um login ou vários usuários com uma lista de servidores e um papel de admin; um log de auditoria; temas claro, escuro e de alto contraste; modo demo que mascara nomes e literais SQL. Funciona sem internet.

7. HQbird Cluster: RCM e nó

O HQbird 2024 tinha replicação, mas não tinha gerenciador de cluster. O HQbird 2027 acrescenta um.

  • Partes. Um nó ao lado de cada instância do Firebird, e um RCM por cluster, com um console web (HTTPS, porta 7444), uma linha de comando e uma API.
  • Replicação é assíncrona. O Firebird 4.0 e o 5.0 usam replicação nativa. O HQbird 2.5 e o 3.0 usam o plugin de replicação.
  • Um cluster sem HQCenter. fbagent --cluster-init cria o RCM e o primeiro admin. A página Link hosts junta outros servidores com um token de uso único. O cluster fica desligado por padrão; você o liga na instalação ou pelo HQbird Monitor.
  • Configuração da réplica pelo console: registre um banco de dados, defina a publicação, inicialize. A cópia é feita com nbackup. Reinicialização suave espera as transações de escrita longas. O nó nunca sobrescreve um banco de dados em funcionamento.
  • Takeover de bancos de dados que já replicam a partir de uma configuração feita à mão.
  • Várias réplicas de um mesmo master.
  • Estados e atraso de cada banco de dados (em sincronia, atrasado, precisa de reinit e outros), cada um com um motivo.
  • Verificação: uma comparação da contagem de linhas entre master e réplica, sob demanda ou em uma agenda.
  • Serviços: um banco de dados lógico em vários hosts.
    • Switchover sem perda de dados; em seguida o master antigo volta como réplica.
    • Failover manual quando o host do master se perde, com um relatório de perda de dados.
    • Failover automático por serviço, desligado por padrão. Precisa de roteadores.
    • Roteadores (HAProxy, Linux) dão aos clientes um endereço estável.
  • Console: 6 idiomas, um papel de visualizador somente leitura, um log de auditoria, alertas com um runbook para cada código.
  • Canais de alerta (Telegram, webhooks, e-mail) para problemas de severidade warn ou maior. A página Alerts tem um botão Teste para cada canal.
  • Segurança: TLS mútuo sob uma autoridade certificadora do cluster, renovação automática de certificados, releases assinados.

Limites: sem replicação síncrona pelo cluster; só tabelas com chave primária ou única são publicadas; no máximo 3 hosts por cluster pela licença; um RCM por cluster; roteadores só no Linux. O switchover foi testado em laboratório no Firebird 5.0 no Linux.

Guias: guia do cluster, runbook do cluster.

8. HQCenter: um servidor central para muitos servidores HQbird

  • O que é. Um servidor Linux na sua rede. Os agentes se registram nele e enviam os dados deles. Ele tem um HQbird Monitor central e um painel de administração.
  • Instalação com um comando no Ubuntu 22.04 / 24.04 / 26.04 ou no AlmaLinux 9 / 10. Uma rede fechada é suportada: instale a partir de um pacote levado até o local.
  • Registro: o agente cria a própria chave. Um operador a aprova, ou um token de licença a aprova enquanto há assentos livres. Todo o tráfego do agente usa TLS mútuo.
  • Tabela da frota: versões do agente e do Firebird, último contato, canal de release.
  • Entrega de configuração aos agentes, com histórico e restauração. Execute jobs importantes agora em qualquer servidor.
  • Atualizações para a frota: o agente, o HQbird Monitor, os programas do cluster e o Firebird vêm do catálogo do HQCenter. As assinaturas do fornecedor são verificadas.
  • O HQCenter se atualiza sozinho a partir de uma stack assinada, com verificações e rollback automático. O dono pode desligar isso.
  • Acompanhamento de status: problemas novos, escalados e encerrados de todos os servidores, com e-mail e um relatório semanal. Canais de Telegram, webhook e SMTP, horários de silêncio e eventos de “servidor silencioso”.
  • Licenças: envio, atribuição aos agentes, contagem de assentos.
  • Auditoria de pedidos: quem mudou o quê em um servidor.
  • API com tokens com escopo; métricas do Prometheus e um dashboard do Grafana para o próprio HQCenter.
  • Painel de administração em 4 idiomas: inglês, português do Brasil, russo, alemão.

Guia: site-install.md.

9. fbmcp: ferramentas do Firebird para assistentes de IA

  • Um servidor MCP no host do banco de dados. Um cliente de IA (por exemplo, Claude Desktop ou Claude Code) o usa para inspecionar e administrar o Firebird 2.5 ao 5.0.
  • Cerca de 120 ferramentas: consultas com plano e estatísticas, esquema, sessões, sugestão de índice, gstat, tendências; backup, restore de teste, validação, sweep; DDL e migrações; usuários e permissões; trace; firebird.conf; um agendador; cerca de 30 ferramentas para o fbagent (status, relatórios, jobs, licença, atualizações); o cluster (link, enroll, reinit, verify, switchover, failover).
  • Segurança por níveis:
    • A leitura não precisa de aprovação. Ela roda em uma transação somente leitura.
    • Uma alteração comum é confirmada no cliente de IA com um token de uso único.
    • Uma alteração de alto impacto só é aprovada fora do cliente de IA (uma janela na bandeja do Windows ou um comando no servidor). Ela também precisa de uma janela de manutenção aberta e de um backup verificado com menos de 24 horas.
    • Excluir um banco de dados está desligado.
  • Toda decisão vai para um log de auditoria.
  • Os setups do HQbird instalam o fbmcp por padrão, só para uso local. O uso remoto precisa de HTTPS e de uma chave de API.

10. Instaladores

Windows

  • Quatro setups, um por versão principal do Firebird (fb25, fb30, fb40, fb50). Cada um é offline: todos os arquivos estão dentro.
  • Cada setup instala o Firebird, o fbagent, o HQbird Monitor e o fbmcp. Os programas do cluster são copiados e ficam desligados até você ligá-los.
  • Várias versões principais do Firebird em um servidor, e várias instâncias de uma mesma versão principal.
  • Páginas do assistente para a avaliação, um arquivo de licença, a conexão com o HQCenter e as atualizações automáticas.
  • Instalação silenciosa com um switch para cada página.
  • 8 idiomas do assistente: inglês, português do Brasil, alemão, russo, espanhol, polonês, turco, chinês simplificado.
  • O setup e o desinstalador têm uma assinatura Authenticode.
  • A desinstalação remove uma instância ou todas. Os bancos de dados são sempre mantidos.

Guia: Guia de instalação do HQbird no Windows.

Linux

  • Um arquivo .run offline por versão principal do Firebird. Só os pacotes do sistema operacional que faltam são baixados.
  • Hosts: x86_64 com systemd e apt, dnf/yum ou zypper (Ubuntu, Debian, AlmaLinux, Rocky, RHEL, Oracle Linux, openSUSE, RED OS). O SELinux no modo enforcing funciona.
  • Interface de texto em tela cheia por padrão, em inglês, russo, português do Brasil e alemão. --no-tui dá o modo de texto simples.
  • Várias instâncias em um host (Firebird 2.5: uma instância).
  • Instalação desassistida com --yes e opções.

Guia: Guia de instalação do HQbird no Linux.

Docker

  • Imagens públicas ghcr.io/ibsurgeon/hqbird2027-fb25, -fb30, -fb40, -fb50. Um contêiner contém uma instância com todos os componentes.
  • As imagens são assinadas com cosign.
  • Papel no cluster HQBIRD_CLUSTER_ROLE=master|replica com arquivos compose.
  • As pastas da imagem ficam fechadas para os outros usuários, e um contêiner novo mantém a conta do RCM.

Guia: guia do Docker.

11. Licenciamento e avaliação

  • Arquivos de licença assinados. O agente verifica a assinatura do fornecedor. O licenciamento nunca para um banco de dados.
  • Avaliação: 7 dias sem etapa de rede. Um e-mail de trabalho e um código de 6 dígitos a estendem para 30 dias.
  • Zonas de licença EU, RU e BR, cada uma com as próprias chaves.
  • Offline: um arquivo de licença na instalação; o setup do Windows pode criar um arquivo de pedido de licença.
  • Com o HQCenter: as licenças são enviadas uma vez e atribuídas aos agentes.
  • Uma licença nova chega sozinha. Um agente que recebeu a licença com um pedido de avaliação consulta o servidor de licenças do fornecedor uma vez por hora. Ele instala a licença que o servidor tem para ele: uma avaliação mais longa, uma licença paga feita a partir da avaliação, ou o período seguinte de uma assinatura. Nada é feito no servidor. Os servidores de licença do fornecedor passam a atender essas licenças passo a passo.
  • Um pedido de avaliação também pode ser enviado depois dos 30 dias da avaliação: o endereço de e-mail pode ser de um cliente que tem uma licença.

12. Atualizações automáticas

  • O agente se atualiza sozinho. Ele verifica a assinatura do fornecedor, recusa um downgrade e pode fazer rollback.
  • O agente atualiza o HQbird Monitor, o fbmcp, os programas do cluster e o Firebird. Uma atualização do Firebird tem um backup, uma janela de aplicação, uma verificação de saúde e uma reversão.
  • Com o HQCenter: as atualizações vêm do catálogo do HQCenter pelo canal de release.
  • Sem o HQCenter: as atualizações vêm da zona do fornecedor. Modos: all, agent (o Firebird espera o administrador), off. A página Updates no HQbird Monitor mostra o estado.

13. Alertas e notificações

  • O acompanhamento de status do HQCenter envia e-mail sobre os problemas da frota. O console do cluster mostra alertas.
  • O agente envia as próprias mensagens sobre problemas do servidor: quando um problema é novo, quando ele piora e quando ele some. Todas as mudanças de uma verificação de status vão em uma mensagem só.
  • Os canais são um bot do Telegram seu, webhooks (Slack, Teams, Discord, Mattermost, Rocket.Chat, ntfy) e e-mail (SMTP), com um filtro de severidade e horários de silêncio. Você pode ter vários canais. Nada é enviado até você adicionar um canal.
  • Resumo diário: uma mensagem por dia com os problemas abertos (notify.daily_summary, desligado por padrão).
  • Com vários agentes em uma máquina, só um deles envia os problemas da própria máquina (disco, memória).
  • Dois comandos do agente: --notify-history [N] imprime as últimas entregas, --notify-test <channel> envia uma mensagem de teste.
  • O agente não envia enquanto a licença dele não permite.
  • Bot do Telegram do HQbird: um servidor ou um HQCenter com uma licença válida vincula um chat com um código de uso único. Não é preciso um bot próprio. Os servidores do fornecedor ainda não oferecem este serviço; até oferecerem, use o seu bot do Telegram, um webhook ou e-mail.
  • O RCM envia alertas do cluster para os mesmos tipos de canal (notify.channels em rcm.json).

14. Segurança

  • TLS mútuo para os agentes, o HQCenter e o cluster.
  • Releases assinados: o agente recusa uma atualização sem uma assinatura válida do fornecedor.
  • Authenticode nos setups e nos programas do Windows; cosign nas imagens Docker.
  • Criptografia AES-256 dos arquivos de backup.
  • Os segredos ficam fora das linhas de comando e dos snapshots de configuração.
  • Um log de auditoria de pedidos no agente; logs de auditoria no HQbird Monitor, no HQCenter, no RCM e no fbmcp.
  • Comandos remotos podem ser desligados em um servidor (--remote-commands off).

15. Atualização a partir do HQbird 2024

  • O setup do 2027 encontra o HQbird 2024, atualiza o Firebird no local e guarda a pasta antiga como uma cópia.
  • Os jobs do FBDataGuard são importados uma vez, na primeira inicialização: gbak, nbackup (níveis 0 a 4), backup de grupo, sweep e estatísticas de índice. O agente continua os conjuntos de backup que já existem.
  • Não importados: replicação, trace, transferência de arquivos, backup na nuvem, restore, validação. Defina-os de novo no editor.
  • A licença de 2024 não é transferida. O agente novo começa em modo de avaliação. Instale uma licença de 2027.
  • Removidos: o console do FBDataGuard na porta 8082, o AMV, o backup VSS, o servidor FTP, o envio por SFTP.
  • Scripts do setup de 2024: switches que têm um equivalente em 2027 são aceitos. Os outros switches são recusados com uma mensagem que diz o substituto.
  • A importação registra os bancos de dados do FBDataGuard no arquivo de aliases do Firebird (databases.conf, ou aliases.conf no Firebird 2.5). O arquivo antigo é copiado primeiro. Um banco de dados fica de fora quando o caminho dele já está no arquivo ou quando o arquivo dele não existe. Um arquivo com uma diretiva include não é alterado.
  • A importação remove os logs de monitoramento antigos do FBDataGuard (as pastas mon\outcoming e mon\outtrace). Nada é removido enquanto um serviço do HQbird antigo está em execução. A remoção não pode ser desfeita.
  • Os dois ficam ligados por padrão. Para desligá-los, defina hqbird_import.register_databases ou hqbird_import.clean_mon_logs como false, ou use --no-register-databases e --no-clean-mon-logs com --import-hqbird-config.