====== Migrar do Firebird 2.1 para 2.5 ======
O objetivo desse manual é auxiliar na migração das bases de dados do Firebird 2.1 para o 2.5.
<note>A partir da versão **__3.0.137__** o **__Intellicash__** não funcionara mais com a versão 2.1 do Firebird e para instalar o **Easy Cash** é obrigatório utilizar o Firebird 2.5.</note>

=== 1º Passo: Verificar a base de dados. ===
  * Rodar script de campos NULL;
  * Compilar todas as procedures. Para fazer isso acesse o ibexpert na barra que mostra a base de dados na parte esquerda clique com botão direito sobre as procedures, vá até a opção **“Recompile all stored procedures”**, conforme imagem abaixo;
{{ :intellicash:manuais_auxiliares:recompilarallprocedures.jpg?nolink |}}
  * Compilar todas as Triggers. Para fazer isso basta fazer o mesmo procedimento acima, clicando em **“Recompile all Triggers”**;
{{ :intellicash:manuais_auxiliares:recompilaralltriggers.jpg?nolink |}}
<note important>Esses procedimentos não podem apresentar nenhum erro, caso tenha erro entrar em contato com a Intelliware.</note>

=== 2º Passo: Realizar o Backup. ===
Após realizar o passo 1 com sucesso, fazer o backup da base de dados. Para isso basta executar o comando abaixo no Prompt de Comando: **“gbak  –user  nome_usuario  –pass  senha caminho_do_banco    caminho_do_backup”**. 
<note important>Esse procedimento não pode apresentar nenhum erro, caso tenha erro entrar em contato com a Intelliware.</note>
<note>Obs: Para realizar o backup por linha de comando conforme descrito acima tem que copiar o gbak.exe que está dentro da pasta bin da instalação do Firebird para a pasta system32 do Windows.</note>

=== 3º Passo: Desinstalar o Firebird 2.1. ===
Para desinstalar o Firebird basta acessar o painel de controle ir até o menu **“Programas e Recursos”** isso no Windows 7, se for XP se chama **“Adicionar ou Remover Programas”**. Localizar o registro do Firebird, e clicar em Desinstalar.
{{ :intellicash:manuais_auxiliares:desisntalarfirebird2.1.jpg?nolink |}}

=== 4º Passo: Instalar o Firebird 2.5. ===
A instalação do Firebird 2.5 é bem parecida com a do 2.1, porem o 2.5 tem uma nova opção, o Firebird **“SuperClassic”**.  
Algumas vantagens sobre cada tipo de instalação: \\
**SuperServer**
  * Bases de dados pequenas ou pouco acessadas;
  * Servidores pequenos;
  * Ambiente onde o cache compartilhado é mais vantajoso que a escabilidade do SuperClassic.
**ClassicServer**
  * Ambientes onde a estabilidade é a maior preocupação;
  * Servidores multi-processados;
  * Grandes bases de dados com centenas de usuários.
**SuperClassic**
  * Servidores multi-processados;
  * Grandes bases de dados com centenas de usuários;
  * Ambiente onde o cache dedicado é mais vantajoso que o cache compartilhado do SuperServer;
  * Ambiente onde o ClassicServer já não consegue escalar.
<note tip>Para bases com 3 ou mais usuários simultâneos indicamos a instalação do **SuperClassic**</note>
<note important>Para o bom desempenho do **SuperClassic** o servidor deve ser multi-processador(ou com um único processador com vários nucleos), caso contrário deve ser instalado o **SuperServer**</note>

A instalação do Firebird pode ser baixada em [[http://www.firebirdsql.org/en/firebird-2-5-2-upd1/|http://www.firebirdsql.org/en/firebird-2-5-2-upd1/]]
<note important>Baixar a versão 32 bits</note>
Após executar o instalador e chegar na tela de escolha do tipo de serviço que será instalado, o sistema listará os serviços **__Binários ClassicServer__** e **__Binários Super Server__**. Para instalar a opção **__SuperClassic__** basta escolher a opção “Binários Classic Server”, conforme imagem abaixo:
{{ :intellicash:manuais_auxiliares:installclassicserver.jpg?nolink |}}

Na interface seguinte ira aparecer a opção de selecionar as opções adicionais. É nessa tela que pode ser marcada a opção para utilizar o Super Classic **“Usar Super Classic”**. 
<note important>Caso tenha escolhido a opção Super Server nessa interface não aparecerá à opção de **“Usar Super Classic”**.</note>
Nessa interface devem ser marcadas as opções de executar o Firebird como serviço e copiar a biblioteca cliente do Firebird para pasta system do Windows.
{{ :intellicash:manuais_auxiliares:instalfbservico.jpg?nolink |}}
Após instalar o Firebird copiar a DLL **“iw_UDF.dll”** para pasta UDF que está na raiz onde foi instalado o Firebird. Copiar os arquivos **“gbak.exe”** e **“gfix.exe”** que se encontram na pasta BIN da raiz do Firebird para o system32 da maquina.

=== 5ºPasso: Restaurar a Base de Dados ===
Com o Firebird 2.5 instalado vamos restaurar a base de dados, para isso executaremos o seguinte comando no Prompt de comando: **“gbak   –r   –user   nome_usuario   –pass senha caminho_do_backup    caminho_do_banco   -FIX_FSS_D win1252”**
Executado o comando sem erros o banco de dados está pronto para ser usado.
<note tip>Para ter certeza que está usando o GBAK correto, no prompt de comando digite **gbak -z**, deverá aparecer uma mensagem indicando que está sendo usado o Firebird 2.5 {{ :intellicash:manuais_auxiliares:versao_firebird.jpg?nolink |}}</note>

=== 6ºPasso: Copiar arquivos para pasta de sistema ===
Após a instalação do firebird 2.5 é importante copiar os arquivos abaixo para a pasta de sistema do windows:
  * GSTAT.exe
  * GFIX.exe
  * GBAK.exe
  * GSEC.exe
  * GDS32.dll
Esses arquivos se encontram na pasta Bin do diretório onde foi instalado o Firebird 2.5.\\
<note important>Caso o Windows seja x64 é importante que os arquivos sejam copiados para as pastas **\Windows\System32\** e **\Windows\SysWOW64\** </note>