Firebird 5

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.

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.

Classic (Recomendado)

• 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 Server

• 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

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:

1. Atualiza os sistemas para a versão mais recente
2. Cria automaticamente um ZIP de backup dos bancos de dados originais de cada sistema antes de converter
3. Converte os bancos para o formato do Firebird 5
4. 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.

1. Baixe o arquivo MigrarParaFB5.bat
2. Crie uma pasta em qualquer local da máquina
3. Coloque todos os bancos de dados que o cliente utiliza dentro dessa pasta
4. Coloque o MigrarParaFB5.bat junto com os bancos na mesma pasta
5. Execute o BA. Ele irá processar todos os bancos automaticamente
6. Os bancos convertidos serão gerados na subpasta Convertidos_FB5
7. 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.dll para fbclient.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 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:

1. Verifique se o serviço FB50Office está em execução no services.msc
2. Confirme que o serviço FB25Office está parado (conflito de porta)
3. Verifique a fbclient.dll na pasta do sistema — deve ser versão 5.0.3, 32 bits
4. Confirme que os bancos de dados foram convertidos para o FB5 (se estiverem no formato antigo, não abrirão)
5. 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