Migração Firebird 5.0

| 13 minutos

Migração Firebird 2.5 → Firebird 5.0

Este faq tem como objetivo orientar e padronizar o processo de validação da migração do ambiente Firebird 2.5 para o Firebird 5.0, contemplando os diferentes cenários de instalação e atualização do Eagle Gestão e do PDVExpresso.

Ao longo desta documentação são descritos os pré-requisitos, configurações necessárias, procedimentos de atualização, execução do processo de migração e validações esperadas para cada cenário. Também são abordados aspectos importantes relacionados à instalação do Firebird 5.0, substituição do IBExpert pelo DBeaver para administração dos bancos de dados, bem como a verificação da integridade dos arquivos gerados após a migração.

O objetivo é garantir que todos os cenários homologados sejam executados de forma padronizada, assegurando a correta atualização das aplicações, a migração dos bancos de dados, a preservação das informações existentes e o funcionamento adequado dos sistemas em ambientes com bancos locais, remotos e distribuídos entre diferentes máquinas.

Antes de iniciar os testes, recomenda-se realizar um backup completo de todos os bancos de dados envolvidos e confirmar que o ambiente está configurado conforme os pré-requisitos descritos para cada cenário.

Instalação do Firebird 5.0

Foi criada a opção Desinstalação do Firebird 2.5 Ao executar o instalador do EagleGestão, a opção "Desinstalação do Firebird 2.5" será exibida como opção de marcação pelo usuário; por padrão, aparece marcada e caso precise ser executado o instalador uma segunda vez, o usuário deverá desmarcar a opção (pois ele já terá sido desinstalado).

42aa6b62-4a95-4cf6-a864-31f596d467d2%20%281%29

Selecionar Tarefas Adicionais

Caso o instalador seja executado e a opção Desinstalação do Firebird 2.5 seja desmarcada com o Firebird instalador na versão 2.5 será exibida a seguinte mensagem de validação:

"An existing Firebird v2.1 or later Server is running. You must close the application or stop the service before continuing."

Todo o processo de instalação do Firebird 5.0 está descrito no faq e pode ser consultado caso exista alguma dúvida durante o procedimento:

FAQ - Instalação Firebird 5.0

Diferentes situações de Migração do Firebird 2.5 para o Firebird 5.0

  • Situação 1 - Atualizando banco de dados em apenas uma máquina
  • Situação 2 - Banco do Eagle Gestão e do PDVExpresso em máquinas diferentes
  • Situação 3 - Dois bancos de dados em máquinas diferentes com Firebird em ambas
  • Situação 4 - Banco do Eagle Gestão e Firebird em máquinas diferentes
  • Situação 5 - Banco do Eagle Gestão remoto e banco do PDVExpresso local

Situação 01 - Atualizando banco de dados em apenas uma máquina

Nesta situação, tanto o Eagle Gestão quanto o PDVExpresso estão instalados na mesma máquina e utilizam bancos de dados Firebird 2.5. O objetivo é validar todo o fluxo de atualização das aplicações e da migração dos bancos de dados para o Firebird 5.0, garantindo que o processo ocorra conforme esperado.

Pré-condições

Antes de iniciar as validações, o ambiente deve atender aos seguintes requisitos:

  • Instalar o Eagle Gestão na última versão homologada anterior à migração.
  • Instalar o PDVExpresso na última versão homologada anterior à migração.
  • Configurar o banco de dados do Eagle Gestão utilizando Firebird 2.5.
  • Configurar o banco de dados do PDVExpresso utilizando Firebird 2.5.
  • Validar que ambos os sistemas iniciam normalmente.
  • Realizar uma cópia (backup) de todos os bancos de dados antes de iniciar os testes.

Cenário 1 - Atualização do banco de dados do PDVExpresso

Validar que a atualização do PDVExpresso realiza apenas a atualização da estrutura do banco de dados, sem iniciar o processo de migração para o Firebird 5.0.

Isso ocorre porque a migração do banco é responsabilidade do processo executado durante a atualização do Eagle Gestão.

Validação

  1. Executar o atualizador do PDVExpresso.
  2. Acompanhar todas as etapas do processo de atualização.
  3. Confirmar que não é exibida nenhuma tela do Migrador de Banco de Dados.
  4. Após a conclusão da atualização, acessar o sistema normalmente.
  5. Validar que o banco de dados foi atualizado para a nova estrutura da versão instalada.
  6. Confirmar que o banco permanece utilizando o Firebird 2.5.

Resultado esperado

  • A atualização da aplicação é concluída com sucesso.
  • O banco de dados recebe apenas as alterações estruturais necessárias para a nova versão.
  • Nenhum processo de migração é iniciado.
  • O sistema permanece funcionando normalmente utilizando Firebird 2.5.

Cenário 2 - Atualização do Eagle Gestão e migração dos bancos

Objetivo

Validar que, após a atualização do Eagle Gestão, o processo de migração dos bancos de dados seja iniciado automaticamente, convertendo todos os bancos elegíveis do Firebird 2.5 para Firebird 5.0.

Validação

  1. Executar o atualizador do Eagle Gestão.
  2. Aguardar a conclusão da atualização dos arquivos da aplicação.
  3. Confirmar que o Migrador é iniciado automaticamente ao término da atualização.
  4. Verificar a lista de bancos apresentada pelo migrador.

Deve ocorrer o seguinte:

  • Todos os bancos configurados no LocalConf do Eagle Gestão devem ser listados.
  • Todos os bancos configurados no LocalConf do PDVExpresso também devem ser listados.
  • Bancos não configurados no LocalConf não devem aparecer na relação.
  1. Iniciar o processo de migração.
  2. Acompanhar toda a execução verificando se nenhuma inconsistência é apresentada.
  3. Confirmar a exibição da mensagem de migração concluída com sucesso.
  4. Verificar as pastas Data do Eagle Gestão e do PDVExpresso.

Durante essa validação deve ser observado que:

  • O banco migrado passa a utilizar o nome original.
  • Uma cópia do banco Firebird 2.5 é preservada.
  • A migração cria automaticamente um backup de segurança antes da substituição do banco.

Também deve ser validada a existência e utilização da pasta BackupMigrador, responsável por armazenar os arquivos utilizados durante o processo de migração.

Resultado esperado

  • Atualização concluída.
  • Migrador iniciado automaticamente.
  • Todos os bancos configurados são identificados.
  • Migração realizada sem erros.
  • Mensagem de sucesso apresentada.
  • Bancos convertidos para Firebird 5.0.
  • Backup do banco Firebird 2.5 preservado.

Cenário 3 - Atualização do Eagle Gestão sem atualizar o PDVExpresso

Objetivo

Validar que existe uma dependência obrigatória entre as versões do Eagle Gestão e do PDVExpresso, impedindo que o Eagle Gestão seja atualizado quando o PDVExpresso permanecer em versão incompatível.

Essa validação garante que os dois sistemas permaneçam sincronizados e evita incompatibilidades entre banco de dados e aplicação.

Validação

  1. Restaurar o ambiente para a versão anterior.
  2. Atualizar somente o Eagle Gestão.
  3. Não executar o atualizador do PDVExpresso.
  4. Durante a atualização do Eagle Gestão, observar a validação realizada pelo instalador.

Resultado esperado

  • O instalador identifica que o PDVExpresso está desatualizado.
  • Uma mensagem informando a incompatibilidade entre versões é apresentada.
  • A atualização do Eagle Gestão é interrompida automaticamente.
  • Nenhuma migração de banco é iniciada.
  • O ambiente permanece exatamente como estava antes da tentativa de atualização.

Cenário 4 - Validação dos arquivos do Eagle Gestão após a migração

Objetivo

Garantir que todos os arquivos gerados pelo processo de migração foram criados corretamente e que nenhuma informação do banco original foi perdida.

Validação

Acessar a pasta Data da instalação do Eagle Gestão.

Para cada banco configurado no LocalConf, validar os seguintes itens:

  • Existe um banco utilizando o nome original da base.
  • Esse banco corresponde ao banco já migrado para Firebird 5.0.
  • Existe uma cópia do banco original Firebird 2.5 utilizando o padrão:
<NomeDoBanco>_OLDFB25

Esse arquivo representa uma cópia de segurança da base original antes da migração.

Também validar:

  • A pasta BackupMigrador não deve mais existir na pasta de instalação após a conclusão da migração.
  • Todos os arquivos temporários utilizados pelo migrador devem ter sido removidos automaticamente.
  • O Eagle Gestão deve iniciar normalmente utilizando o banco migrado.

Resultado esperado

  • Banco migrado presente.
  • Banco original preservado com o sufixo _OLDFB25.
  • Nenhum arquivo temporário restante.
  • Pasta BackupMigrador removida.
  • Sistema funcionando normalmente utilizando o banco migrado.

Situação 02 - Banco do Eagle Gestão e do PDVExpresso em máquinas diferentes

Nesta situação, o Eagle Gestão e o PDVExpresso estão instalados em máquinas distintas, cada um utilizando seu próprio banco de dados Firebird 2.5. O objetivo é validar que o processo de atualização e migração ocorre de forma independente em cada equipamento, respeitando apenas os bancos configurados localmente e garantindo a comunicação correta entre as aplicações.

Pré-condições

Antes de iniciar os testes, preparar o ambiente conforme abaixo:

Máquina 01

  • Instalar o Eagle Gestão na última versão homologada anterior à migração.
  • Configurar o banco de dados do Eagle Gestão utilizando Firebird 2.5.

Máquina 02

  • Instalar o PDVExpresso na última versão homologada anterior à migração.
  • Configurar o banco de dados do PDVExpresso utilizando Firebird 2.5.

Além disso:

  • Validar que ambos os sistemas iniciam normalmente.
  • Confirmar que os bancos estão acessíveis.
  • Realizar backup completo dos dois bancos de dados.

Cenário 1 - Atualização do PDVExpresso

Validar que a atualização do PDVExpresso, quando instalado em uma máquina independente do Eagle Gestão, realiza automaticamente a migração apenas do seu banco de dados, sem considerar bancos pertencentes ao Eagle Gestão.

Validação

  1. Executar o atualizador do PDVExpresso.
  2. Aguardar a conclusão da atualização da aplicação.
  3. Confirmar que o Migrador é iniciado automaticamente.
  4. Verificar os bancos apresentados pelo migrador.

Durante essa validação deve ser observado que:

  • Apenas o banco configurado no LocalConf do PDVExpresso deve ser listado.
  • Bancos pertencentes ao Eagle Gestão não devem aparecer.
  • Bancos que possuam Alias, mas não estejam configurados no LocalConf, também não devem ser exibidos.
  1. Executar a migração.
  2. Confirmar a mensagem de conclusão com sucesso.

Resultado esperado

  • Aplicação atualizada corretamente.
  • Migrador iniciado automaticamente.
  • Apenas o banco do PDVExpresso é listado.
  • Migração concluída sem erros.
  • Banco convertido para Firebird 5.0.

Cenário 2 - Atualização do Eagle Gestão

Validar que, após a migração do banco do PDVExpresso, o Eagle Gestão pode ser atualizado normalmente em sua própria máquina, realizando a atualização do banco correspondente.

Validação

  1. Executar o atualizador do Eagle Gestão.
  2. Acompanhar o processo de atualização.
  3. Confirmar que o banco do Eagle Gestão é atualizado.
  4. Caso aplicável, acompanhar o processo de migração do banco para Firebird 5.0.
  5. Validar que nenhuma inconsistência é apresentada durante a execução.

Resultado esperado

  • Eagle Gestão atualizado com sucesso.
  • Banco atualizado corretamente.
  • Migração realizada sem erros.
  • Sistema inicia normalmente após a atualização.

Situação 03 - Dois bancos do Eagle Gestão em máquinas diferentes com Firebird instalado em ambas

Nesta situação existem duas instalações do Eagle Gestão, cada uma com seu próprio banco de dados local. Entretanto, ambas possuem acesso aos dois bancos através do LocalConf. O objetivo é validar que apenas os bancos locais sejam atualizados e migrados, preservando os bancos remotos e informando corretamente o usuário sobre essa condição.

Pré-condições

  • Configurar um banco do Eagle Gestão na Máquina 01.
  • Configurar outro banco do Eagle Gestão na Máquina 02.
  • Configurar o LocalConf das duas máquinas permitindo acesso aos dois bancos.
  • Validar o acesso aos dois bancos.
  • Realizar backup completo de ambas as bases.

Cenário 1 - Atualização na Máquina 01 (Selecionando "Sim")

Objetivo

Validar o comportamento do atualizador quando existem bancos locais e bancos remotos configurados.

Validação

  1. Executar o atualizador do Eagle Gestão na Máquina 01.
  2. Confirmar que é exibida a mensagem informando a existência de bancos remotos que não poderão ser atualizados.
  3. Selecionar Sim para continuar.
  4. Aguardar a conclusão da atualização.
  5. Confirmar o início automático do Migrador.
  6. Verificar quais bancos são apresentados.

Resultado esperado

  • Apenas o banco local da Máquina 01 é atualizado.
  • O Migrador é iniciado automaticamente.
  • Somente o banco local é listado para migração.
  • A migração é concluída com sucesso.
  • Ao final é apresentada mensagem informando que os bancos remotos não foram atualizados.

Cenário 2 - Atualização na Máquina 01 (Selecionando "Não")

Validar o cancelamento da atualização quando o usuário opta por não prosseguir diante da existência de bancos remotos.

Validação

  1. Executar novamente o atualizador.
  2. Quando a mensagem for apresentada, selecionar Não.

Resultado esperado

  • Processo cancelado imediatamente.
  • Nenhum banco atualizado.
  • Nenhuma migração iniciada.
  • Ambiente permanece inalterado.

Cenário 3 - Atualização na Máquina 02

Validar que o comportamento observado na Máquina 01 também ocorre na Máquina 02.

Validação

  1. Executar o atualizador na Máquina 02.
  2. Aguardar a atualização.
  3. Iniciar o processo de migração.

Resultado esperado

  • Apenas o banco local da Máquina 02 é atualizado.
  • O Migrador inicia automaticamente.
  • A migração é concluída com sucesso.
  • Nenhuma mensagem sobre bancos remotos é apresentada ao final.

Cenário 4 - Acesso aos bancos

Garantir que todos os bancos permaneçam acessíveis após a conclusão das migrações.

Validação

Na Máquina 01:

  • Acessar o banco local.
  • Acessar o banco remoto.

Na Máquina 02:

  • Acessar o banco local.

Resultado esperado

  • Todos os bancos podem ser acessados normalmente.
  • Nenhuma inconsistência de conexão é apresentada.
  • As aplicações funcionam corretamente utilizando os bancos migrados.

Situação 04 - Banco do Eagle Gestão e Firebird em máquinas diferentes

Nesta situação o Firebird e os bancos de dados encontram-se em uma máquina diferente daquela onde o Eagle Gestão será executado. O objetivo é validar todo o fluxo de migração utilizando bancos remotos e posteriormente restaurando o ambiente.

Pré-condições

Máquina 01

  • Desinstalar o Firebird 5.0.
  • Instalar o Eagle Gestão com Firebird 2.5.
  • Configurar o LocalConf apontando para os bancos hospedados na Máquina 02.

Máquina 02

  • Desinstalar o Eagle Gestão.
  • Desinstalar o Firebird 5.0.
  • Manter apenas Firebird 2.5.
  • Disponibilizar dois bancos do Eagle Gestão.
  • Configurar Alias para um dos bancos.

Cenário 1 - Migração dos bancos

Validar que bancos originalmente hospedados em outra máquina podem ser migrados corretamente.

Validação

  1. Copiar os bancos da Máquina 02 para a Máquina 01.
  2. Ajustar os caminhos do LocalConf.
  3. Executar o atualizador.
  4. Executar a migração dos dois bancos.

Resultado esperado

  • Ambos os bancos são migrados com sucesso.
  • Nenhuma inconsistência é apresentada.
  • Os bancos passam a utilizar Firebird 5.0.

Cenário 2 - Retorno dos bancos para a Máquina 02

Validar o retorno dos bancos migrados ao ambiente original.

Validação

  1. Copiar os bancos migrados para a Máquina 02.
  2. Substituir os bancos antigos.
  3. Ajustar novamente o LocalConf da Máquina 01.

Resultado esperado

  • Configuração concluída corretamente.
  • Bancos acessíveis normalmente.

Cenário 3 - Instalação do Firebird 5.0

Validar que o Firebird 5.0 pode ser instalado isoladamente.

Validação

  1. Executar o instalador do Eagle Gestão.
  2. Selecionar apenas a instalação do Firebird 5.0.

Resultado esperado

  • Firebird 5.0 instalado com sucesso.
  • Nenhuma instalação adicional do Eagle Gestão realizada.

Cenário 4 - Acesso aos bancos

Garantir que os bancos permaneçam acessíveis após a reinstalação do Firebird.

Validação

  • Acessar o Eagle Gestão utilizando ambos os bancos.

Resultado esperado

  • Ambos os bancos são acessados normalmente.
  • Nenhuma inconsistência de conexão é apresentada.

Cenário 5 - Nova atualização da Máquina 01

Validar o comportamento do atualizador quando apenas bancos remotos permanecem configurados.

Validação

  1. Executar novamente o atualizador.

Resultado esperado

  • É apresentada mensagem informando que existem apenas bancos remotos.
  • O usuário cancela o processo.
  • Nenhuma atualização ou migração é realizada.

Situação 05 - Banco do Eagle Gestão remoto e banco do PDVExpresso local

Nesta situação o Eagle Gestão utiliza um banco remoto enquanto o PDVExpresso permanece utilizando um banco local. O objetivo é validar o comportamento da atualização considerando essa configuração híbrida.

Pré-condições

Máquina 01

  • Desinstalar Firebird 5.0.
  • Instalar Eagle Gestão e PDVExpresso utilizando Firebird 2.5.
  • Configurar o LocalConf do Eagle Gestão apontando para a Máquina 02.
  • Configurar o LocalConf do PDVExpresso apontando para seu banco local.
  • Configurar Alias para o banco do PDVExpresso.
  • Validar o acesso aos dois sistemas.

Máquina 02

  • Desinstalar Firebird 5.0.
  • Instalar Eagle Gestão utilizando Firebird 2.5.
  • Disponibilizar um banco.
  • Configurar Alias.

Cenário 1 - Atualização na Máquina 02

Validar a atualização do banco remoto antes da atualização da aplicação cliente.

Validação

  1. Executar o atualizador do Eagle Gestão.
  2. Aguardar a conclusão da atualização e migração.

Resultado esperado

  • Banco atualizado.
  • Migração realizada com sucesso.
  • Sistema funcionando normalmente.

Cenário 2 - Atualização do Eagle Gestão na Máquina 01

Validar a atualização da aplicação quando o banco do Eagle Gestão é remoto e o banco do PDVExpresso é local.

Validação

  1. Executar o atualizador do Eagle Gestão.
  2. Confirmar a mensagem informando que existem apenas bancos remotos.
  3. Selecionar Sim para continuar.

Resultado esperado

  • Aplicação atualizada.
  • Banco remoto não sofre alteração.
  • Banco do PDVExpresso é migrado corretamente.

Cenário 3 - Dependência entre Eagle Gestão e PDVExpresso

Validar a verificação de compatibilidade entre as versões das aplicações.

Validação

  1. Executar o atualizador do Eagle Gestão sem atualizar previamente o PDVExpresso.

Resultado esperado

  • Mensagem informando que o PDVExpresso está desatualizado.
  • Atualização interrompida.
  • Nenhuma migração executada.

Cenário 4 - Atualização do PDVExpresso

Validar a atualização isolada do PDVExpresso após a atualização do Eagle Gestão.

Validação

  1. Executar o atualizador do PDVExpresso.

Resultado esperado

  • Aplicação atualizada normalmente.
  • Processo concluído sem executar migração.

Cenário 5 - Acesso aos sistemas

Validar o funcionamento dos sistemas após todas as atualizações.

Validação

  • Acessar o Eagle Gestão.
  • Acessar o PDVExpresso.

Resultado esperado

  • Ambos os sistemas iniciam normalmente.
  • Cada sistema acessa seu respectivo banco sem impedimentos.
  • Nenhuma inconsistência de comunicação é apresentada.
Este artigo ajudou você?
 0
 0

Seja uma Revenda de Software da Eagle Tecnologia

Temos a melhor Parceria de Software para sua revenda crescer e se destacar na sua região com os nossos sistemas, oferecendo mais qualidade na Gestão Empresarial dos seus clientes.
Conheça nossa Revenda de Software