📊 Migração do Firebird para a Versão 4.0 no FórmulaCerta
⏱️ Tempo estimado: conforme o tamanho dos bancos de dados | Nível: Avançado | Atualizado em: 23 de Julho de 2026
🎯 Objetivo
Este artigo orienta como realizar a migração do banco de dados utilizado pelo FórmulaCerta para o Firebird 4.0, apresentando os pré-requisitos, a ordem de execução, o funcionamento do migrador e as principais validações necessárias antes, durante e após o processo.
A migração deve ser realizada somente após a confirmação de que o servidor e as estações atendem aos requisitos atuais de sistemas operacionais, rede e infraestrutura homologados para o FórmulaCerta.
Sumário
📌 Visão geral da migração
✅ Pré-requisitos
🔢 Ordem obrigatória da migração
🖥️Migração do Firebird 4.0 - Servidor
🔄 Etapas do migrador
🖥️ Migração do servidor de Aplicação e/ou das estações
⚙️ Configuração do Firebird.conf
🚨 Report de erros
⚠️ Erros conhecidos
🧾 Termos usados resumidos
❓ FAQ
✅ Considerações Finais
O Firebird 4.0 oferece melhorias de desempenho, redução de ocorrências de deadlock, novos tipos de dados e melhorias relacionadas à criptografia e ao funcionamento do banco de dados.
A migração é realizada pelo executável FBWizardMigra.exe, disponibilizado na pasta do FórmulaCerta após a atualização dos módulos pelo menu Ajuda, opção Sobre. O migrador realiza as validações do ambiente, prepara os bancos, executa o backup na versão atual, restaura os dados no Firebird 4.0 e instala a nova versão do gerenciador.
⚠️Importante!
O Firebird 4.0 não é homologado para ambientes que utilizam o FórmulaCerta PAF-ECF ou o banco de fidelidade ALTERFDL.IB
O ambiente não deve utilizar FórmulaCerta PAF-ECF, pois essa configuração não está homologada para o Firebird 4.0;
O FórmulaCerta deve estar na versão 6.0, com os módulos mais recentes atualizados;
O servidor e as estações devem utilizar sistemas operacionais atualmente homologados para o FórmulaCerta;
O uso do FórmulaCerta deve ser interrompido durante a migração.
Os serviços externos que acessam os bancos ALTERDB.IB, ALTERIM.IB e COCKPIT_FATE.FDB também devem ser interrompidos.
Caso o procedimento de backup e restauração não seja realizado há vários dias, recomenda-se executá-lo antes da migração.
O disco deve possuir espaço livre equivalente a, no mínimo, três vezes a soma do tamanho dos bancos de dados.
O executável FBWizardMigra.exe deve ser executado como administrador.
Quando existirem módulos locais nas estações, eles também devem ser atualizados.
Para ambientes que utilizam o LogiPrix, é obrigatória a atualização dos módulos para versões compatíveis com o Firebird 4.0. Essa atualização deve ser realizada por meio do executável disponibilizado em anexo a este artigo.
🔢 Ordem obrigatória da migração
O processo de migração deverá ser feito na seguinte ordem:
Atualização dos módulos conforme o procedimento: Atualização do Sistema (e em todas as máquinas que possuem módulos locais);
Migração do Firebird 4.0 no Servidor de Banco de dados;
Migração do Firebird 4.0 no Servidor de Aplicação (Módulos) quando o mesmo existir e for diferente do Servidor de Banco de dados;
Migração do Firebird 4.0 nas estações de trabalho.
🛠️ Passo a Passo
🖥️Migração do Firebird 4.0 - Servidor
Primeiramente deverá ser efetuada a migração no Servidor. Após a atualização de módulos, conforme orientado nos Pré-requisitos, haverá na pasta do FórmulaCerta o executável "FBWizardMigra.exe", que guiará todo o processo de migração:
Acesse a pasta do Fórmula Certa;
Execute o FBWizardMigra.exe como Administrador;
Informe o diretório do Fórmula Certa e clique em OK;
Após clicar na opção OK, o sistema apresenta a interface do migrador.
O migrador será dividido em 4 etapas, sendo elas Início, Preparação, Migração e Instalação. Abaixo veremos com mais detalhes cada uma das etapas.
Início
Na etapa Início, o sistema apresenta e valida informações relacionadas ao ambiente:
Versão e tipo de instalação do Firebird;
Identificação da máquina;
Versão do Windows;
Arquitetura de 32 ou 64 bits;
Espaço disponível em disco;
Memória livre e total;
Bancos presentes na pasta DB;
Tempo estimado para conclusão;
Versões dos módulos do FórmulaCerta.
⚠️Importante!
Caso a versão dos módulos ou o espaço em disco não atendam aos requisitos, o migrador impedirá o avanço até que a inconsistência seja corrigida.
______________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________
Preparação
Na etapa Preparação, o migrador:
Identifica os bancos que serão migrados;
Isola e renomeia os arquivos necessários;
Realiza cópias de segurança;
Compatibiliza as tabelas;
Exporta os arquivos para a pasta de migração;
Valida a estrutura dos bancos.
Caso não sejam encontradas falhas, o botão Próximo será habilitado.
Migração
Na etapa Migração, os dados são transferidos para a nova versão do Firebird.
O migrador realiza o backup dos bancos na versão 2.5 ou 3.0 e restaura as informações no Firebird 4.0. Nessa etapa, o usuário deve aguardar a conclusão sem interromper o processamento.
Instalação
Na etapa Instalação, o migrador remove a versão atual do Firebird e instala o Firebird 4.0.
Após a conclusão:
Clique em Próximo;
Se não houver impedimento operacional, selecione Reiniciar para reiniciar o Windows;
Após reiniciar, valide o acesso ao FórmulaCerta.
🖥️ Migração do servidor de Aplicação e/ou das estações
Após concluir a migração do servidor de banco de dados:
Acesse a pasta do FórmulaCerta pela rede;
Localize o arquivo FBWizardMigra.exe;
Execute o arquivo como administrador;
Informe o caminho de rede da pasta do FórmulaCerta, como \\Servidor\FCerta;
Avance pelo processo apresentado;
Nessa modalidade, o migrador não executará novamente as etapas de preparação dos bancos de dados, pois elas já foram concluídas no servidor. O processo realizará apenas a troca da versão do Firebird para 4.0.
Repita o procedimento no servidor de aplicação (módulos), quando houver, e depois em todas as estações de trabalho.
⚙️ Configuração do Firebird.conf
AuthServer = Srp256,Srp,Legacy_Auth
DataTypeCompatibility = 3.0
Caso o migrador encontre uma inconsistência, o botão Próximo será substituído pela opção Reportar Erro.
Ao selecionar essa opção, o sistema apresentará os detalhes do problema e disponibilizará o botão Enviar Log, permitindo encaminhar o registro da falha ao ambiente de suporte da Fagron Tech.
Após enviar o log, entre em contato com o suporte para análise e orientação.
Falha na atualização da GDS32.DLL
Mensagem: “A atualização da biblioteca compartilhada GDS32.DLL falhou. Faça a atualização manual.”
Solução:
Localize o arquivo fbclient.dll em C:\Program Files\Firebird\Firebird_4_0\WOW64;
Copie o arquivo para C:\Windows\SysWOW64;
Renomeie a cópia para GDS32.DLL.
Módulos abaixo da versão mínima
Mensagem: “Os módulos atuais não estão com a versão mínima necessária para a migração.”
Solução: Aplique a atualização de módulos e execute novamente o migrador.
Pasta raiz inválida
Mensagem: “Pasta informada é inválida! Informe o caminho da pasta raiz do FórmulaCerta.”
Solução: Informe o diretório da pasta raiz do FórmulaCerta no servidor de banco de dados.
Diretório não encontrado
Mensagem: “Cannot create file. O sistema não pode encontrar o caminho especificado.”
Solução: Execute o FBWizardMigra.exe como administrador e verifique se o executável está salvo em uma pasta diferente da pasta FCerta, conforme a orientação apresentada para essa ocorrência.
Firebird 4.0: versão do gerenciador de banco de dados homologada para ambientes compatíveis do FórmulaCerta.
FBWizardMigra.exe: aplicativo responsável por verificar, preparar, migrar e instalar o Firebird 4.0 no ambiente.
Servidor de banco de dados: computador onde ficam armazenados os arquivos principais do banco do FórmulaCerta.
Servidor de Aplicação: computador que disponibiliza os executáveis do FórmulaCerta, quando diferente do servidor de banco de dados.
Estação de trabalho: computador utilizado pelo usuário para acessar o sistema.
Firebird.conf: arquivo que armazena configurações do serviço Firebird.
Backup/Restore: processo de cópia e restauração utilizado para manutenção e validação da estrutura dos bancos.
Reportar Erro: opção apresentada quando o migrador identifica uma inconsistência que impede o avanço.
Enviar Log: função utilizada para encaminhar ao suporte o registro técnico da falha identificada pelo migrador.
Quais sistemas operacionais podem ser utilizados no servidor?
São homologados Windows Server 2022 Standard, Windows Server 2019 Standard, Windows Server 2016 Standard, Windows 11 Pro e Windows 10 Pro.
Quais sistemas operacionais podem ser utilizados nas estações?
São homologados Windows 11 Pro e Windows 10 Pro.
Posso migrar um ambiente FórmulaCerta PAF-ECF?
Não. O Firebird 4.0 não está homologado para FórmulaCerta PAF-ECF.
Qual equipamento deve ser migrado primeiro?
O servidor de banco de dados deve ser migrado primeiro. Depois, migre o servidor de aplicação (módulos), quando houver, e por último as estações.
Qual espaço livre é necessário?
O ambiente deve possuir espaço livre equivalente a três vezes a soma do tamanho dos bancos que serão migrados.
Preciso atualizar o FórmulaCerta antes da migração?
Sim. O FórmulaCerta deve estar na versão 6.0, com os módulos atualizados
O Firebird.conf precisa ser alterado manualmente?
Não, quando a migração é realizada pelo FBWizardMigra.exe, pois o migrador instala automaticamente o arquivo compatível. A intervenção manual é necessária somente em instalações feitas fora do assistente.
O que fazer se o migrador apresentar erro?
Clique em Reportar Erro, consulte os detalhes, utilize Enviar Log e entre em contato com o suporte Fagron Tech.
Verifique os requisitos atuais de sistemas operacionais e rede antes de agendar a migração.
Não realize a migração em ambientes FórmulaCerta PAF-ECF.
Atualize os módulos no servidor e nas máquinas que possuam módulos locais.
Interrompa o uso do sistema e dos serviços que acessam os bancos durante todo o processo.
Garanta espaço livre equivalente a três vezes o tamanho total dos bancos.
Execute primeiro a migração no servidor de banco, depois no servidor de módulos e, por último, nas estações.
Execute o FBWizardMigra.exe como administrador.
Não interrompa as etapas de preparação, migração ou instalação.
Após a reinicialização, valide o acesso ao FórmulaCerta e às rotinas que utilizam os bancos migrados.