Firebird 5
Índice
Firebird 5 — Informações e Migração
Esta página reúne todas as informações relevantes sobre o Firebird 5 e o processo de migração dos sistemas Office System, destinada ao time de suporte.
Visão Geral
O Firebird é o banco de dados utilizado por todos os sistemas Office System. A versão 5.0 traz melhorias significativas de desempenho, segurança e compatibilidade em relação à versão 2.5 anteriormente utilizada.
| Informação | Detalhe |
|---|---|
| Versão | 5.0.3 |
| Arquitetura do servidor | 64 bits |
| Arquitetura da DLL (fbclient) | 32 bits (aplicações Office System são 32 bits) |
| Porta de conexão | 44680 |
| Banco de segurança | security5.fdb |
| Serviço Windows | FB50Office |
Tipos de Servidor
O Firebird 5 pode ser instalado em três modos de operação. O modo é definido no momento da instalação e pode ser verificado no arquivo firebird.conf na pasta de instalação do Firebird.
Super Server (Recomendado)
- Um único processo para o servidor inteiro
- Cache de páginas compartilhado entre todas as conexões — menor consumo de memória
- Usa threads para atender cada conexão simultaneamente
- Melhor opção para ambientes com muitas conexões simultâneas
- Se o processo travar, todas as conexões são encerradas
- Configuração:
ServerMode = Super
Classic
- Um processo separado para cada conexão ativa
- Cada conexão tem seu próprio cache — maior consumo de memória
- Mais indicado para poucas conexões com consultas pesadas
- Se uma conexão travar, as demais continuam normalmente
- Permite acesso local (embedded) ao mesmo banco
- Configuração:
ServerMode = Classic
Super Classic
- Um único processo, assim como o Super Server
- Cada conexão tem seu próprio cache, assim como o Classic
- Consumo de memória intermediário entre os dois modos acima
- Permite acesso local (embedded) ao mesmo banco
- Configuração:
ServerMode = SuperClassic
| Característica | Super Server | Classic | Super Classic |
|---|---|---|---|
| Processos | 1 | 1 por conexão | 1 |
| Cache de páginas | Compartilhado | Por conexão | Por conexão |
| Uso de memória | Baixo | Alto | Médio |
| Isolamento de falha por conexão | Não | Sim | Parcial |
| Acesso embedded (local) | Não | Sim | Sim |
Processo de Migração
A migração consiste em converter os bancos de dados do formato ODS (On-Disk Structure) do Firebird 2.5 para o formato do Firebird 5. Esse processo é obrigatório — bancos no formato antigo não funcionam no Firebird 5. Existem duas formas de realizar a migração:
Forma 1: Via Updater (Automática)
O Updater dos sistemas Office System realiza todo o processo automaticamente:
- Atualiza os sistemas para a versão mais recente
- Cria automaticamente um ZIP de backup dos bancos de dados originais de cada sistema antes de converter
- Converte os bancos para o formato do Firebird 5
- Instala e configura o Firebird 5
Importante: O Updater sempre tentará migrar para o FB5 ao ser executado. Caso o cliente precise permanecer no FB2.5, consulte a seção Manter cliente no Firebird 2.5.
Forma 2: Via BAT Manual
Indicada para casos em que os sistemas já foram atualizados, mas a migração dos bancos ainda não foi feita.
- Baixe o arquivo MigrarParaFB5.bat
- Crie uma pasta em qualquer local da máquina
- Coloque todos os bancos de dados que o cliente utiliza dentro dessa pasta
- Coloque o MigrarParaFB5.bat junto com os bancos na mesma pasta
- Execute o BAT — ele irá processar todos os bancos automaticamente
- Os bancos convertidos serão gerados na subpasta Convertidos_FB5
- Substitua os bancos originais pelos bancos da pasta Convertidos_FB5
⚠ Atenção: Sempre salve uma cópia separada dos bancos originais antes de realizar a conversão. O Updater já faz isso automaticamente, mas na migração manual essa responsabilidade é do técnico.
fbclient.dll — Biblioteca do Cliente
A fbclient.dll é a biblioteca responsável pela comunicação entre as aplicações e o servidor Firebird. Como o servidor instalado é 64 bits, mas as aplicações Office System são 32 bits, é obrigatório utilizar a versão 32 bits da fbclient.
- A fbclient correta normalmente já vem incluída no pacote de atualização dos sistemas
- Caso não tenha vindo no pacote, faça o download em: files.officesystem.com.br/atualizacoes/migracao-fb5/fbclient50.dll
- Após baixar, renomeie o arquivo de
fbclient50.dllparafbclient.dll - Coloque o arquivo dentro da pasta do sistema (onde fica o executável da aplicação)
Como verificar se a fbclient instalada está correta:
Passe o cursor do mouse sobre o arquivo fbclient.dll na pasta do sistema e verifique:
- A versão deve ser 5.0.3
- Deve ser 32 bits
Em caso de qualquer erro de acesso aos sistemas, sempre verifique a fbclient primeiro.
Firebird 2.5 e Firebird 5 Simultâneos
O Firebird 2.5 e o Firebird 5 utilizam a mesma porta de conexão (44680), portanto não é possível manter os dois serviços rodando ao mesmo tempo.
- É possível ter os dois instalados na mesma máquina sem problemas
- Porém apenas um serviço deve estar ativo por vez
- Para alternar entre eles, pare o serviço ativo e inicie o desejado pelo Gerenciador de Serviços do Windows (
services.msc)
| Firebird 2.5 | Firebird 5.0 | |
|---|---|---|
| Nome do serviço | FB25Office | FB50Office |
| Porta | 44680 | 44680 |
| Banco de segurança | security2.fdb | security5.fdb |
Manter Cliente no Firebird 2.5
As versões atuais dos sistemas Office System ainda são compatíveis com o Firebird 2.5. Em breve será implementada uma trava que exigirá o Firebird 5.0 obrigatoriamente.
Caso seja necessário manter um cliente no Firebird 2.5 por ora:
- Não utilize o Updater para atualizar os sistemas, pois ele tentará migrar para o FB5 automaticamente
- Realize as atualizações dos sistemas manualmente
- Fique atento às comunicações sobre a data de entrada em vigor da trava obrigatória do FB5
Erros Comuns e Soluções
DBX Error: Driver could not be properly initialized
Mensagem completa:
DBX Error: Driver could not be properly initialized. Client library may be missing, not installed properly, of the wrong version, or the driver may be missing from the system path.
Causa: Pacotes redistribuíveis do Visual C++ ausentes ou desatualizados no Windows.
Solução: Baixe e instale os dois arquivos abaixo na máquina do cliente:
- vc_redist.x64.exe — Visual C++ Redistributable 64 bits
- vc_redist.x86.exe — Visual C++ Redistributable 32 bits
Após instalar os dois, reinicie a máquina e teste novamente.
Obs.: O Updater já instala esses pacotes automaticamente durante a migração.
Erros genéricos de acesso ao sistema
Em qualquer erro de acesso ou conexão aos sistemas após a migração, siga este checklist antes de escalar:
- Verifique se o serviço FB50Office está em execução no
services.msc - Confirme que o serviço FB25Office está parado (conflito de porta)
- Verifique a fbclient.dll na pasta do sistema — deve ser versão 5.0.3, 32 bits
- Confirme que os bancos de dados foram convertidos para o FB5 (se estiverem no formato antigo, não abrirão)
- Verifique se os pacotes vc_redist.x64 e vc_redist.x86 estão instalados
Downloads
Todos os arquivos relacionados à migração estão disponíveis em:
- Página de downloads: files.officesystem.com.br/atualizacoes/migracao-fb5
Arquivos disponíveis:
- fbclient50.dll — fbclient 32 bits para FB5 (renomear para fbclient.dll)
- MigrarParaFB5.bat — BAT para conversão manual dos bancos
