O que há de novo no HQbird 2027
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 emNEEDS_REINIT, como antes. - Novo: o RCM decide o que fazer em seguida, pela configuração
auto_reinit.on_master_restoreemrcm.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:
windowquando a reinicialização automática está ligada,proposequando 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_replacedvai 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 statusehqbirdrcm dg-import retry. - O nó lê os blocos que o FBDataGuard gravou em
replication.confe 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
rcmadminno 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_secsem reinício.
Atualização
- Instale ou atualize com o setup 2027.2.35 do Windows ou com o
.rundo 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_restorecomoauto. 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.zipcom 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.
sudosó para um grupo. Em um sistema em que só um grupo pode executarsudo(ALT Linux: o grupowheel), 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 executarsudo.- 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
.rundo 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.zipdos 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/zipemapi/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
.fbkou.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.logereplication.logsã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
/metricscom 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.confno 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.loge dereplication.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.logereplication.logpor 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-initcria 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
warnou 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
.runoffline 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-tuidá o modo de texto simples. - Várias instâncias em um host (Firebird 2.5: uma instância).
- Instalação desassistida com
--yese 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|replicacom 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.channelsemrcm.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, oualiases.confno 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 diretivaincludenão é alterado. - A importação remove os logs de monitoramento antigos do FBDataGuard
(as pastas
mon\outcomingemon\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_databasesouhqbird_import.clean_mon_logscomofalse, ou use--no-register-databasese--no-clean-mon-logscom--import-hqbird-config.