Este manual auxilia na utilização do Guarani Agent.

Atualização – Guarani Agent

O Guarani Agent é um programa atualizador e por meio dele podemos realizar atualizações de versões e FIX no Guarani ERP, Guarani PDV e Guarani Loja (Market).

• Para abrir o aplicativo utilize o executável “Guarani Agent” (Imagem 1) que se encontra na área de trabalho do servidor ou no diretório padrão C:\Program Files (x86)\Ferraz automação\Guarani ERP\Server.

Open

Imagem 1 - Ícone executável

• Utilizar o usuário administrador para realizar a abertura do programa, a fim de que possua permissão de realizar os procedimentos de atualização.

• Ao acessar esse aplicativo, será demonstrado o ícone de uma flecha (símbolo da Guarani), ao lado do relógio na barra de tarefas (Imagem 2).

Open

Imagem 2 - Tela Guarani Agent :: Módulo de configuração

Conhecendo o Guarani Agent:

Esta tela é composta por duas abas: “Principal e Guarani Sistemas”.

• A aba “Guarani Sistemas” é de uso exclusivo para os desenvolvedores da Guarani.

• A aba “Principal” é dividida em “Cabeçalho e Configurações”.

No cabeçalho, podemos visualizar as seguintes opções (Imagem 3).

Salvar: Esta opção permite que as informações alteradas na parte de configuração sejam gravadas, que deve ser utilizada somente pela Guarani.

Testar Ambiente: Permite que as informações existentes na parte de configuração sejam validadas, verificando se os caminhos dos diretórios informados estão corretos para realizar a atualização de versão ou FIX.

Testar Interrupção de BD: Serve para visualizarmos os usuários logados no sistema, para que possa solicitar que saiam deste antes do início da atualização.

Atualizar Licenças: Permite que sejam atualizadas as licenças de uso contratadas junto à Guarani.

Manutenção de Banco de Dados: Esta opção permite que sejam realizadas manutenções no banco de dados de forma que sejam verificados corrompimentos, realizando os ajustes automaticamente quando necessário

E-mail: Permite a configuração de e-mail do usuário-chave, para que receba as ocorrências dos procedimentos realizados pelo Guarani Agent.

Atualizar Homologação: Esta opção permite atualizar a base de homologação, criando uma base de testes do Guarani ERP, com a versão topo disponibilizada no Agent para que possa ser testado e tenha suas alterações validadas mediante melhorias e ajustes realizados na nova versão, antes de atualizar a base de produção.

Configurar Homologação: Esta opção permite que seja criado uma base de dados em homologação, definindo os diretórios no local em que o usuário desejar que a base de homologação seja criada.

Atualizar Produção: Esta opção permite que seja atualizada a base de dados em produção, ou seja, ao clicar nesse ícone a base de dados que está em uso na empresa será atualizada para a versão topo disponibilizada no Guarani Agent. Possui a mesma funcionalidade que a opção “Atualizar agora” ao clicar com botão direito sobre o ícone do Guarani próximo ao relógio. 

Notas da Última Versão: Possui a documentação com as alterações disponibilizadas na última versão disponível para o sistema em questão (ERP, PDV, Loja). Antes de qualquer atualização (base de homologação e produção) é de extrema importância que sejam lidas as Notas de Versão.

Configurações: É definido o código do cliente e o status (ativo/inativo) e somente será possível manter uma aba como ativo por vez.

Estatísticas: É informada a data da última atualização, a versão do EXE (sistema) e do banco de dados. Estas informações serão demonstradas somente após a primeira atualização de versão pelo Guarani Agent.

Configurações Locais: São informados os caminhos dos diretórios onde se encontram o arquivo “Guarani.ini” e também a pasta do repositório.

Backup: É informado o caminho onde o Guarani Agent deve salvar os backups realizados.

Exclusão de Log (exclusivo das abas PDV e LOJA): Define quantos dias os logs devem ser mantidos a salvo na pasta backup. Após isto, serão apagados.

Manutenção de Banco de Dados: Demonstra a quantidade de dias que o Guarani Agent analisa para realizar a manutenção do banco de dados. Esta validação é realizada a partir da data de última execução definida nas “estatísticas” mais a quantidade de dias configurados neste campo, obrigando a manutenção antes da atualização caso tenha excedido os 30 dias.

Pasta guarani Homologação: Caminho onde o usuário define o diretório que serão gravados os arquivos de atualização para a base de homologação. Durante a atualização da base de dados homologação, será criado dentro deste diretório, todos os arquivos da nova atualização (tudo da pasta repositório).

Pasta dados Guarani Homologação: É o caminho que o usuário definirá para ser criado o banco de dados em homologação, criando dentro do diretório escolhido os bancos de dados: “ERP_Homologação.FDB”, “ERP_Homologação_Imagem.FDB” e “ERP_Homologação_XML.FDB” (caso a base de testes for do sistema ERP) (Imagem 4).

Execução do Guarani Agent:

Testar Ambiente

Ao clicar na opção “Testar Ambiente”, serão validadas as configurações realizadas anteriormente (Imagem 5).

Testar Interrupção de BD

A funcionalidade de testar interrupção, demonstrará se existem usuários conectados no sistema e caso haja, apresentará uma mensagem de alerta (Imagem 7).

Atualizar Licenças

Ao clicar na opção “Atualizar Licenças” com o “Status = Ativo”, na aba ERP o sistema apresentará a quantidade de licenças liberadas, para a utilização no ERP e também do WMS “para aqueles que utilizam este módulo” (Imagens 9 e 10).

• Caso a empresa não utilize o módulo “WMS”, após demonstrar a quantidade de licenças do ERP será apresentada a mensagem: Cliente não autorizado – Guarani WMS! (Imagem 11).

Manutenção de Banco de Dados 

Iniciando a manutenção do bando de dados, o sistema contará os dias configurados no campo “Tempo para manutenção do Banco de Dados (em dias)”, à partir da data da última execução para identificar a necessidade de executar a manutenção, ou seja, não será possível atualizar a base de produção enquanto não for realizado o procedimento de  manutenção do banco de  dados. Isso não será regra para a base de homologação, onde poderá ser realizada sua atualização sem necessidade de efetuar a manutenção no banco de dados.

Durante a “Manutenção do Banco de Dados”, serão apresentadas mensagens como: “Iniciando Rotina de Manutenção no banco de dados!” e “Shutdown no banco de dados!”, onde será verificado se durante a manutenção existirá algum usuário conectado, identificando que não existe nenhum usuário conectado, a próxima mensagem a ser apresentada será “Shutdown foi realizado com sucesso!”

A mensagem “Iniciando Validação no banco de dados!” será apresentada quando o processo de validação do banco for iniciada, onde será verificado se o banco possui algum erro (corrompimento), devendo aguardar até sua finalização. Já a mensagem: “Iniciando processo de correção para possíveis erros” é a correção de erros encontrados na validação, este processo também refaz os index, organizando a estrutura e diminuindoo tamanho do banco (Imagem 14).

E-mail

Para a configuração do e-mail, poderá ser cadastrado um ou mais e-mails configurados para serem enviadas as mensagens de erros, que ocorrerem durante a atualização da base de dados em produção. O mais adequado é que o e-mail cadastrado seja do usuário chave, responsável pela execução da atualização do sistema pelo Guarani Agent (Imagem 16).

Configurar homologação

Antes de ser realizada a atualização do banco em homologação, será obrigatória a criação da pasta “Homologação” para criar a base de testes. O caminho da pasta deverá ser verificado e cadastrado pelo usuário chave junto ao TI da empresa (Imagem 17).

• O diretório criado deverá ser indicado no Guarani Agent,no botão “Configurar Homologação” (Imagem 18).

Configuração base de homologação – ERP

Deverá ser informado nos botões “Caminho dos executáveis da base de homologação e Caminho do banco de dados da base de homologação”.

• Em “Caminho dos executáveis da base de homologação”, deverá informar qual o diretório onde estarão os executáveis da base de homologação, este caminho será definido pela empresa onde for criada a pasta repositório de homologação.

• No “Caminho do banco de dados da base de homologação”, deverá informar o caminho definido pela empresa onde será criado o banco de dados de homologação.

Atualizar homologação

Após ter configurado os caminhos das pastas “Guarani Homologação e Dados Guarani Homologação”, poderá efetuar a atualização do banco de dados em homologação (Imagem 20).

O processo de atualizar homologação:

1. Criando ambiente de homologação: operação iniciada;

2. Iniciando criação da base de homologação: nesta etapa o sistema estará criando uma cópia do banco de dados atual de sua base de produção com os nomes ERP_HOMOLOGAÇÃO.FDB, ERP_HOMOLOGAÇÃO_IMAGENS.FDB, ERP_HOMOLOGAÇÃO_XML.FDB nos caminhos definidos na pasta dados Guarani Homologação configurados (Imagem 21).

Na imagem abaixo segue demonstração de como ficarão os bancos de dados no caminho configurado (Imagem 22).

Após atualização da base de homologação, no diretório onde foi configurado a pasta “Guarani Homologação” será realizada uma cópia de todos os arquivos da nova versão “assim como existente na pasta Cliente da base de dados em produção” (Imagem 23).

Ao concluir a “Atualização do Banco em Homologação”, será apresentada a seguinte mensagem “Processo Finalizado com Sucesso” (Imagem 24).

• Importante salientar que não é possível atualizar a base de produção, se a base de homologação não estiver atualizada.

Se for realizada a tentativa de atualizar a base de produção sem ter atualizado a base de homologação, o Agent gerará a seguinte mensagem: “Banco de homologação desatualizado, por favor atualize o banco de homologação e faça os testes antes de atualizar o ambiente de produção” (Imagem 25).

Atualizar a base de produção

Após ter atualizado o ambiente de homologação e ter efetuado os testes da nova versão, poderão efetuar a atualização do ambiente de produção. Seguindo o log do sistema quando terminar a atualização do ambiente de produção a mensagem ao término da atualização vem a ser “Atualização finalizada” (Imagem 26).

Caso seja apresentada alguma mensagem de erro durante o processo, tirar um print da mensagem e contatar o suporte da Guarani Sistemas pelo Chat Online, abrindo um ticket ou por telefone para que sejam realizados análises e ajustes (caso necessário).

Nova implemantação

Foi implementada uma função para desconectar os usuários conectados no banco de dados via Guarani Agent, independente da forma que estiver conectado, como por exemplo: “Ibexpert, Integrador AFV, Guarani ERP”, etc. Esta função poderá ser utilizada através do botão “Testar Interrupção de BD” ou ao clicar no botão “Atualizar Produção”, caso tenha um usuário conectado, aparecerá a tela para desconectá-lo.

Quando não houver usuários conectados, mas ao atualizar for exibido que existe o usuário “SYSDBA” fantasma, que não contém identificação, ou “SWEEPER” conectados, o usuário responsável pela atualização poderá utilizar a nova funcionalidade para alterar de “Inativo” para “Ativo” no Guarani Agent, pelos campos.