...
| Painel | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||
|
| Índice |
|---|
Orientações Gerais
...
Este documento tem por objetivo detalhar as etapas necessárias para a utilização do Application Updater. Isso possibilitará o cliente gerenciar e agendar atualizações automáticas de pacotes/versões nos PDVs Storex Home.
Premissas
...
Certifique que as condições abaixo estão devidamente cumpridas:
- O cliente deve disponibilizar um servidor com o Wildfly 10.1.0 conectado ao banco de dados Corporativo (da Retaguarda/Retaguarda - (Manual de Instalação do Portal Application Updater → https://share.linx.com.br/x/B-f7Dg).
Se preferir, ao invés do Wildfly, o cliente, pode disponibilizar um servidor com Docker e o Docker-compose se for Linux ou o Docker desktop se for Windows. - O(s) PDV(s) devem deve(m) estar com o client AppUpdater devidamente configuradoAppUpdater devidamente configurado(s) - (Manual de Configuração do Client no PDV → https://share.linx.com.br/x/OYsEDw).
- O departamento de P&D Linx deve encaminhar o pacote Compose_app_updater ao cliente caso a o servidor seja com Docker.
- O departamento de P&D Linx deve encaminhar o arquivo linx-application-updater-web.war ao cliente para realizar o deploy caso a o servidor seja com Wildfly.
- O departamento de P&D Linx deve viabilizar os pacotes das versões no padrão que o client do AppUpdater no PDV processe. Exemplo: 001.002.002.189.000.
Acesso ao Web-Gui (Application Updater)
...
Uma vez instalado e configurado o wildfly pela infra do cliente (Manual de Instalação do Portal Application Updater→https://share.linx.com.br/x/B-f7Dg) e aplicado o client AppUpdater no(s) PDV(s) → https://share.linx.com.br/x/OYsEDw:
Abra o navegador e digite a url do servidor onde é realizado o deploy: "IP+Porta Servidor/linx-application-updater-web/#/dashboard".
Exemplo:
Não é necessário usuário e senha para acessar:
Dashboard
Através da opção Dashbord no menu, é possível filtrar a versão que deseja analisar o status (de cada PDV agendado):
...
| Informações |
|---|
Novos: Aguardando Atualizaçãoatualização Com Erro: Algo impediu a atualização Com sucesso: Atualização realizada com êxito Cancelados: Desistência do agendamento |
Parametrização dos PDVs
...
Para que o Application Updater se comunique com os PDVs das Lojas, o cliente precisa realizar o cadastro de todos os pdvs no Web Gui.
...
Apresentará um modal de sucesso e listará a(s) loja(s) e PDV(s) cadastrado(s):
Subida dos Pacotes de Versão
...
O departamento de P&D disponibilizará o pacote no formato pré estabelecido para que o cliente faça o upload (arquivo.PKG) no web-gui e agende a atualização nas filiais.
...
3. Clique no botão "Adicionar"
*Obs.: Caso o pacote seja grande, apresentará uma barra de progresso mostrando como está sendo o upload até concluir e apresentará ao final um modal de sucesso listando a versão no "Pacotes de Atualização".
Agendamento para atualização do pacote nos PDVs
...
Para vincular um pacote que já subiu, para os pdvs das lojas:
...
Clique no botão "SALVAR"
*Obs.: Será agendado e listado os PDVs com o status NOVO.
*Obs2.: Caso desista de algum agendamento que ainda não foi atualizado, basta clicar no "cancelar" na linha que deseja e confirmar o cancelamento do agendamento.
Atualização da versão no PDV
...
Para facilitar o entendimento, simularemos dois cenários, um em que o PDV atualiza com sucesso e outro que apresenta erro durante a atualização do pacote.
*Obs.: O(s) PDV(s) deve(m) estar com o client AppUpdater devidamente configurados.
Atualização com sucesso
Foi agendada uma atualização de pacote para o PDV teste.
Ao subir o PDV, foi verificado se havia atualizações. Ao identificar que sim, foi feita a chamada do linx-applicartion-updater-1.5.1-jar, que baixou o pacote 001.002.003.010.000 e iniciou o processo de atualização:
O PDV atualizou com sucesso.
No Web-Gui será possivel identificar facilmente que houve sucesso na atualização para o PDV teste:
Atualização com erro
Foi agendada uma atualização de pacote para o PDV teste.
...
No Web-Gui será possivel identificar facilmente que houve erro na atualização para o PDV teste:
Área do Log da Atualização Automática no PDV
O cliente deverá encaminhar os logs (c:/logAppUpdater) da atualização com erro para [email protected] (quando a atualização for relacionada a correções de erros em produção) ou para [email protected] (quando a atualização for relacionada a projetos).
...