O Guarani Agent é um programa atualizador, por meio dele podemos realizar atualizações de versões e “FIX” no “Guarani ERP, Guarani PDV e Guarani Loja (Market)”.
A atualização é realizada de forma automática, sendo necessário seguir os passos abaixo.
Para abrir o aplicativo utilize o executável Guarani Agent que se encontra na área de trabalho do servidor ou no diretório C:\Program Files (x86)\Ferraz automação\Guarani ERP\Server (diretório padrão).
Utilizar o usuário administrador para realizar a abertura do programa, afim 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 folha (símbolo da Guarani) ao lado do relógio na barra de tarefas.
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:
Salvar: Esta opção permite que as informações alteradas na parte de configuração sejam gravadas, 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 agente, 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 a folhinha do Guarani próxima 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 e 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). Somente é possível manter uma aba como ativo por vez.
Estatísticas: É informado 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 que o usuário define o diretório onde 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).
Execução do Guarani Agent:
Testar Ambiente
Ao clicar nesta opção serão validadas as configurações realizadas acima.
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.
Testar Interrupção de BD
A funcionalidade de testar interrupção demonstrará se existem usuários conectados no sistema, se houver apresentará a mensagem abaixo:
Caso não exista nenhum usuário conectado, será demonstrada a mensagem abaixo, demonstrando se a atualização pode ser realizada, com a seguinte mensagem:
“Local: INTERRUPÇÃO > :: Concluído”
Atualizar Licenças
Ao clicar na opção “Atualizar Licenças” com o “Status = Ativo” na aba ERP, o sistema demonstrará a quantidade de licenças liberadas para a utilização no “ERP” e também do “WMS” (para aqueles que utilizam esta funcionalidade).
Caso a empresa não utilizar a funcionalidade “WMS”, após demonstrar a quantidade de licenças do “ERP” será apresentada a mensagem: “Cliente não autorizado – Guarani WMS!”.
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)”, a 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 pode 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 é “Iniciando Rotina de Manutenção no banco de dados”, e posteriormente “Shutdown 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 é “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 (corrompimentos), 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 do banco, diminuindo o tamanho do banco.
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...”
