[Manual] Guarani Agent
- Luciana Barboza
- Damián Muñoz
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).
A atualização será realizada seguindo os passos abaixo:
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.
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.
OBS: Sempre que for realizar a atualização, escolher um horário que não existam usuários no sistema e reinicie o servidor, para ter certeza que todos os processos foram encerrados.
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).
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.
Nas Configurações da aba “Principal”, existem 3 outras abas: ERP, PDV e LOJA, dentro de cada uma delas é possível realizar a configuração para atualização de cada um destes sistemas. Em cada uma das abas, são configuradas pela Guarani as seguintes informações:
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).
Se apresentadas as mensagens: “Teste Concluído com Sucesso!” e em seguida: “Local: SUCESSO > :: Teste realizado com sucesso, nenhum problema detectado”, significa que a validação foi realizada com sucesso, estando os diretórios todos corretos (Imagem 6).
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).
Caso não exista nenhum usuário conectado, será apresentada uma mensagem indicando que a atualização poderá ser realizada: Local: INTERRUPÇÃO > :: Concluído (Imagem 8).
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.
Ao clicar em “Manutenção de Banco de Dados”, o log apresentado será “Iniciando Rotina de manutenção no banco de dados…”, e posteriormente “Shutdown no banco de dados!“ (Imagem 12).
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).
Ao término do processo, será demonstrada a mensagem no log: “Processo de validação do banco de dados realizado com Sucesso”!, sendo necessário aguardar até a mensagem: “Processo Finalizado com Sucesso...” (Imagem 15).
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).
Ao clicar no botão “Atualizar Homologação”, o sistema traz a mensagem: “Para realizar o processo de criação de base de homologação é necessário que não haja usuários conectados a base de dados. Este processo pode ser demorado Deseja continuar?”
Clicando em “SIM”, o sistema iniciará a criação da base de homologação e posteriormente a sua atualização. |
O processo de atualizar homologação:
Criando ambiente de homologação: operação iniciada;
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).
Necessário aguardar esta mensagem para somente então fechar o Guarani Agent e iniciar a utilização do sistema.
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.
Clicar no botão “Fechar Dependências” na tela “Conexões” e clicar em “SIM” na pergunta que aparecerá na tela de “Aviso” (Imagens 27 e 28).
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.
|
|---|
Alteração de “Inativo” para “Ativo”, dos campos citados e iniciação da atualização do sistema efetuada com sucesso (Imagem 30).
