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 as verificações desse faq, 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).

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

---

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.
• Realizar uma cópia (backup) de todos os bancos de dados antes de iniciar os.

Atualização do banco de dados do PDVExpresso e posteriormente atualização do Eagle Gestão e migração dos bancos

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. A atualização da aplicação deve ser 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 durante a atualização do PDVExpresso

Após a atualização do Eagle Gestão, o processo de migração dos bancos de dados deve ser iniciado automaticamente, convertendo todos os bancos elegíveis do Firebird 2.5 para o Firebird 5.0. Ao término da atualização, deve ser validado que o Migrador é executado automaticamente, identificando todos os bancos configurados no LocalConf do Eagle Gestão e do PDVExpresso, sem listar bancos não configurados. Em seguida, deve-se executar a migração, acompanhando toda a sua execução para garantir que não ocorram inconsistências e que seja apresentada a mensagem de conclusão com sucesso. Após a migração, deve ser verificado que os bancos convertidos passam a utilizar o nome original, que uma cópia do banco em Firebird 2.5 foi preservada, que um backup de segurança foi criado automaticamente antes da substituição e que a pasta BackupMigrador foi utilizada para armazenar os arquivos do processo. Como resultado esperado, a atualização deve ser concluída com sucesso, o Migrador deve ser iniciado automaticamente, todos os bancos configurados devem ser identificados e migrados sem erros para o Firebird 5.0, mantendo o backup do banco original em Firebird 2.5.

Atualização do Eagle Gestão sem atualizar o PDVExpresso

O Eagle Gestão somente é atualizado quando o PDVExpresso estiver em uma versão compatível. Dessa forma a migração de banco de dados não é iniciada e o ambiente permanece inalterado após a tentativa de atualização.

Validação dos arquivos do Eagle Gestão após a migração

Após a atualização e migração dos bancos de dados, deve ser verificado se todos os arquivos gerados pelo processo de migração foram criados corretamente e que nenhuma informação do banco original foi perdida.

Na pasta Data da instalação do Eagle Gestão. Para cada banco configurado no LocalConf, validar os seguintes itens:

• Existencia de 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

Também deve ser validado:

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

---

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, respeitando apenas os bancos configurados localmente e garantindo a comunicação correta entre as aplicações.

Pré-condições

Preparar o ambiente conforme abaixo:

Máquina 01

Possui o Eagle Gestão na última versão homologada anterior à migração. O mesmo deve ser configurado no banco de dados do Eagle Gestão utilizando Firebird 2.5.

Máquina 02

Possui o PDVExpresso na última versão homologada anterior à migração. O mesmo deve ser configurado no banco de dados do PDVExpresso utilizando Firebird 2.5.

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 será listado.
• Bancos pertencentes ao Eagle Gestão não vão aparecer.
• Bancos que possuam Alias, mas não estejam configurados no LocalConf, também não serão exibidos.

5. Executar a migração.
6. 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.

---

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.

---

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.

---

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.

---

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.

---

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.

---

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.

---

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.

---

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.

---

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.

---

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.

---

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.

---

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.

---

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.

---

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.

---

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.