Como fazer a migração para o 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 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

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 com a opção Desinstalação do Firebird 2.5 desmarcada, caso o Firebird instalado esteja na versão 2.5, será exibida a seguinte mensagem de validação:

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

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.

Cenário

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.

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

Utilizando o Eagle Gestão e PDVExpresso na mesma maquina, 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 é iniciado automaticamente, convertendo todos os bancos elegíveis do Firebird 2.5 para o Firebird 5.0. Ao término da atualização, 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.

<NomeDoBanco>_OLDFB25

Como resultado, a atualização é concluída com sucesso, o Migrador é 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, deve ser validado os seguintes itens:

• Existência 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.

Cenário

Preparar o ambiente conforme abaixo:

Máquina 01

Deve possuir 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

Deve possuir 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.

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.

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 e migração do Firebird.

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. Dessa forma a atualização e migração do banco de dados será realizada de forma local sem que ocorra a atualização e migração do banco de dados remoto.

Cenário

• 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.
• Realizar backup completo de ambas as bases.

Atualização na Máquina 01 (Selecionando "Sim")

Nesse cenário apenas o banco local da maquina 01 é atualizado o migrador será iniciado automaticamente, somente o banco local será listado para a migração e ao fim do processo de migração será exibida uma mensagem informando que os bancos remotos não foram atualizados..

Atualização na Máquina 02

Nesse cenário apenas o banco local da maquina 02 é atualizado o migrador será iniciado automaticamente, somente o banco local será listado para a migração e ao fim do processo de migração será exibida uma mensagem informando que os bancos remotos não foram atualizados..

Acesso aos bancos

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.

Cenário

Máquina 01

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

Máquina 02

• Apenas Firebird 2.5 instalado.
• Disponibilizar dois bancos do Eagle Gestão.
• Configurar Alias para um dos bancos.

Migração dos bancos

Nesse cenário será feita a alocação dos bancos de dados de forma manual, verificando a atualização e migração de ambos os bancos de dados. Ao final do processo ambos passam a utilizar o Firebird 5.0. Ao final do processo os bancos deve ser retornado para sua respectiva maquina e o Firebird deve ser atualizado de forma isolada sem que o Eagle Gestão seja atualizado ou migrado

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.

Cenário

Máquina 01

• 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

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

Atualização na Máquina 02

Nesse cenario a atualização é realizada sem impedimentos a migração é realizada com sucesso e o sistema funciona normalmente.

Atualização do Eagle Gestão na Máquina 01

Nesse cenario ao executar o atualizador será exibida mensagem informando que existem bancos remotos ao clicar em Sim na mensagem a aplicação é atualizada sem impedimentos o banco remoto não sofre alterações e o banco de dados do PDVExpresso é migrado corretamente.

Atualização do PDVExpresso

Ao executar o atualizador isolado do PDVExpresso após a atualização do Eagle Gestão. A aplicação será atualizada normalmente e o processo será concluído sem executar migração do Firebird.

Acesso aos sistemas

Ao fim do processo ambos os sistemas iniciam normalmente, cada sistema acessa seu respectivo banco sem impedimentos e nenhuma inconsistência de comunicação é apresentada.