Mudanças entre as edições de "Firebird 5"

De Office System
Ir para navegação Ir para pesquisar
(Criou página com 'Teste')
 
Linha 1: Linha 1:
−
Teste
+
==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.
 +
 
 +
{| class="wikitable"
 +
!'''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:''' <code>ServerMode = Super</code>
 +
 
 +
===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:''' <code>ServerMode = Classic</code>
 +
 
 +
===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:''' <code>ServerMode = SuperClassic</code>
 +
 
 +
{| class="wikitable"
 +
!'''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|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 '''[https://files.officesystem.com.br/atualizacoes/migracao-fb5/MigrarParaFB5.bat 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: [https://files.officesystem.com.br/atualizacoes/migracao-fb5/fbclient50.dll files.officesystem.com.br/atualizacoes/migracao-fb5/fbclient50.dll]
 +
*Após baixar, '''renomeie o arquivo''' de <code>fbclient50.dll</code> para <code>fbclient.dll</code>
 +
*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 <code>fbclient.dll</code> 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''' (<code>services.msc</code>)
 +
 
 +
{| class="wikitable"
 +
!
 +
!'''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==
 +
 
 +
===<big>DBX Error: Driver could not be properly initialized</big>===
 +
 
 +
'''Mensagem completa:'''
 +
 
 +
<code>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.</code>
 +
 
 +
'''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:
 +
 
 +
*[https://aka.ms/vc14/vc_redist.x64.exe vc_redist.x64.exe] — Visual C++ Redistributable 64 bits
 +
*[https://aka.ms/vc14/vc_redist.x86.exe 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.
 +
 
 +
===<big>Erros genéricos de acesso ao sistema</big>===
 +
 
 +
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 <code>services.msc</code>
 +
#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:''' [https://files.officesystem.com.br/atualizacoes/migracao-fb5 files.officesystem.com.br/atualizacoes/migracao-fb5]
 +
 
 +
Arquivos disponíveis:
 +
 
 +
*[https://files.officesystem.com.br/atualizacoes/migracao-fb5/fbclient50.dll fbclient50.dll] — fbclient 32 bits para FB5 (renomear para fbclient.dll)
 +
*[https://files.officesystem.com.br/atualizacoes/migracao-fb5/MigrarParaFB5.bat MigrarParaFB5.bat] — BAT para conversão manual dos bancos

Edição das 19h52min de 21 de maio de 2026

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:

  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 BAT — 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:

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:

  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:

Arquivos disponíveis:

Disponível em “https://wiki.officesystem.com.br/index.php?title=Firebird_5&oldid=2365”