Esse documento tem por objetivo orientar na instalação e migração do Firebird 2.X para o Firebird 3.0
Antes de realizar a migração atualize a versão do cliente para a versão 9.1.19.0 ou superior
- REALIZANDO O BACKUP DA BASE
O backup da base pode ser feito de duas formas: pelo Presence Domain/Store ou CMD (Prompt de
Comando) do Windows.
Presence Domain/Store
1. Utilitários > Utilitários > Processos > Backup / Restore
2. Preencha as informações e clique em ok, aguarda a finalização do processo.
Prompt de Comando (CMD)
1. Pressione a tecla Windows + R, digite CMD e dê um Enter.
2. Insira o comando abaixo para entrar na pasta do Firebird 2.X, no caso foi utilizado o 2.1: cd "c:\Program Files\Firebird\Firebird_2_1\bin"
3. Em seguida, insira o comando para realizar o Backup: gbak -b -t -v -g -ig -user SYSDBA -password masterkey <CAMINHO DA BASE> <CAMINHO DO BACKUP + NOME DO BANCO.ibk>
Exemplo: gbak -b -t -v -g -ig -user SYSDBA -password masterkey C:\scl\dados\BDE\ELBRUS.IB C:\scl\dados\BDE\elbrus.ibk
4. Dê um Enter e aguarde o final do processo.
- Desinstalando o Firebird anterior
1. Para instalar a versão 3.0 do Firebird, é necessário desinstalar suas versões anteriores e renomear a pasta da Unidade C: da
máquina.
2. Feito isso, efetue o download dos arquivos de instalação do Firebird 3.0, esse caminho contém duas pastas, cada pasta com um arquivo de instalação para arquitetura x86 ou x64, use a versão compatível com a máquina.
3. Execute como administrador clicando com o botão direito sobre o arquivo Firebird-3.0.3.32900_0_x64.exe ou Firebird-3.0.3.32900_0_X32.exe e selecionando a opção Executar como administrador.
4. Escolha a linguagem, leia os termos, marque a opção I accept the agreement e clique em Next.
5. Clique em Next novamente.
6. Deixe as duas opções marcadas e clique em Next.
7. Deixe as opções marcadas conforme imagem abaixo e clique em next;
8. Informe a senha do SYSBDA (por padrão é masterkey) e clique em Next.
9. Clique em Install e aguarde o término da instalação.
O ícone do programa do Firebird não estará mais visível no Painel de Controle. Caso seja necessário Iniciar ou Reiniciar o mesmo, será possível apenas pelo services.msc.
- CONFIGURANDO O FIREBIRD 3.0
Antes de iniciar o Restore do banco para utilização do Firebird 3.0, será necessário realizar algumas configurações.
1. Baixe o arquivo UDF de acordo com a arquitetura da sua maquina;
2. Cole o arquivo na pasta UDF: C:\Program Files\Firebird\Firebird_3_0\UDF , O arquivo deve ter o nome desta forma "PresenceUDF.dll" caso esteja diferente disso precisa renomeá-lo.
3. Baixe as ICUs e cole na pasta C:\Program Files\Firebird\Firebird_3_0
4. Reinicie o Firebird 3.0
- Restaurando o Banco
1. Na pasta em que se encontra o Backup do banco, pressione o botão Shift + Botão direito do mouse e vá na opção
Abrir janela de comando aqui, que abrirá a janela do CMD (Prompt de Comando).
2. Nesta janela execute o comando abaixo:
"C:\Program Files\Firebird\Firebird_3_0\gbak" -user SYSDBA -pass masterkey -c -v -fix_fss_metadata win1252 -se service_mgr <Nome_do_BANCO.ibk> <Novo_nome.ib>
Exemplo:
C:\Program Files\Firebird\Firebird_3_0\gbak" -user SYSDBA -pass masterkey -c -v -fix_fss_metadata win1252 -se service_mgr ELBRUSMASTER.ibk ELBRUSMASTER.ib
3. Aguarde até o final do processamento. Caso as alterações tenha sido feitas corretamente e o Restore concluído sem erros, a versão ODS do banco (no IBExpert) estará 12.0.
- Rodando o Script de atualização no banco
1. Para realizar a migração do Firebird, é necessário atualizar o script para ajustar algumas funções da PresenceUDF.dll, pois algumas mudam do Firebird 2.x para o 3.0.
2. Acesse o IBExpert e conecte-se ao banco:
3. Após confirmar a versão da ODS, o script Update_Funcoes_PresenceUDF.sql deverá ser executado na base conectada. Vá em Script Executive:
4. Faça o download do Script Update_Funcoes_PresenceUDF.sql;
5. Execute usando a tecla F9.
6. Execute o instalador do PresenceUDF mais recente para importar as DLLs atualizadas ao sistema.
Finalizado, base migrada para Firebird 3.0