Instalação/Atualização do PDV Berlin/Rest

Owned by Gabriela Milena Coletti (Unlicensed)
Last updated: Jul 26, 2024
7 min read

Pré- Requisitos

  • Instalação do Servidor Concluída

  • Executável do atualizador “AtualizaPetroshow_PDV_Client” correspondente à versão desejada.

Siga as orientações abaixo:

A instalação e/ou atualização do Petroshow PDV Berlin é composta pela atualização da versão dos executáveis.

Esse processo será executado de forma automática pelo serviço do Viasoft Update, mas é necessário que na primeira vez seja feita a instalação manual.

É importante que o serviço do Viasoft Update sempre esteja em execução para que possa ficar monitorando novas atualizações.

Passo a Passo de Instalação

1. Iniciando a Instalação

  1. Execute o atualizador.

    image-20240725-181052.png

     

  2. Na tela de boas-vindas, clique em Próximo.

    image-20240725-180933.png

     

  3. Leia as informações importantes e clique em Próximo.

  1. Selecionando o Local da Instalação

  • Na tela de seleção do local da instalação, verifique se a pasta de destino é "Viasoft".

  • Clique em Próximo
    Neste momento será apresentada uma tela para selecionar o local da instalação. Caso seja uma atualização de sistemas, será carreado o diretório utilizado na última execução.

IMPORTANTE: A pasta de destino sempre deve se chamar “Viasoft“, para que o Viasoft Update consiga baixar os arquivos e enviá-los para o local correto.


A próxima etapa é uma das mais importantes do processo, onde será definido o tipo de instalação/atualização.

3. Definindo o Tipo de Instalação/Atualização

  1. Selecione uma das opções:

    • Servidor de Aplicação Instalado em Servidor Próprio

    • Servidor de Aplicação Instalado no Ambiente Viasoft Cloud

    • Servidor de Aplicação Instalado no Ambiente Viasoft Cloud Multi-Client

      • Identifique o tipo de atualização que deverá ser feito e clique em Próximo.

  • Servidor de Aplicação Instalado em Servidor Próprio: Como o próprio nome diz, deve ser usada quando o servidor de aplicação tenha sido instalado em um ambiente que não seja o ambiente Cloud Viasoft. Com isso, o atualizador mudará algumas configurações facilitando o processo.

  • Servidor de Aplicação Instalado no Ambiente Viasoft Cloud: Atualizador preparado para conexão com servidores instalados no ambiente Cloud Viasoft, onde trás algumas configurações pré-definidas.

  • Servidor de Aplicação Instalado no Ambiente Viasoft Cloud Multi-Client: Essa opção se assemelha com a anterior, mas é preparada para conexão com servidores instalados no ambiente Cloud da Viasoft onde clientes compartilham recursos entre si. Essa opção deve ser utilizada com cautela.

IMPORTANTE: Essa opção deve ser selecionada em combinação com que foi instalado no servidor, ou seja, sempre que o servidor for instalado no formato Multi-Client, será selecionado o Multi-Client aqui também. Se o servidor foi instalado com a opção Servidor Próprio, aqui deverá ser definido Servidor Próprio também.

Neste momento, serão apresentados campos para comunicação com o Viasoft Update Server.
É a única configuração solicitada, pois ao realizar essa configuração, o Viasoft Update fará o download dos arquivos configurados na instalação do servidor, deixando o sistema pronto para uso.

 

  1. Informações para Atualização Automática

  • Servidor Próprio

    • Protocolo: Por padrão será http. Caso sua estrutura exija o https, pode ser alterado também.

    • Servidor: Avaliar qual é o IP Público do servidor. Provavelmente será o mesmo utilizado para comunicação do PDV com a Retaguarda, definido no PSConfigurador.

    • Porta: Porta definida na instalação/atualização do servidor. Se nada foi alterado, a porta default é a 2001.

4.2 Conf. Arquivos de Conexão Estação PDV (Server Integração)

  • Servidor Próprio

    • Protocolo: http

    • Servidor: Avaliar qual é o IP Público do servidor. Provavelmente será o mesmo utilizado para comunicação do PDV com a Retaguarda, definido no PSConfigurador.

    • Porta: Porta definida na instalação/atualização do servidor. Se nada foi alterado, a porta default é a 2920.

 

4.3 Conf. Arquivos de Conexão Estação PDV (Server DFE)

  • Servidor Próprio

    • Servidor: http

    • Porta: Porta definida na instalação/atualização do servidor. Se nada foi alterado, a porta default é a 2910.

 

  1. Informações para Atualização Automática

  • Viasoft Cloud ou Viasoft Cloud Multi-Client

    • ID Cloud: Para obter seu ID Cloud entre em contato com a Viasoft.

    • Protocolo: https

    • Servidor: tec-update.viasoft.com.br

    • Porta: 443

5.2 Conf. Arquivos de Conexão Estação PDV (Server Integração) -

 

5.3 Conf. Arquivos de Conexão Estação PDV (Server DFE)

 

Na etapa seguinte é onde deve ser definido qual o tipo de atualização que será realizada no PDV.

Atualmente existem 2 formatos:

  • Atualização Completa - Serviço de Leitura de Abastecimento e Petroshow PDV: Esse tipo de atualização é para o PDV que é o servidor de abastecimento. Seria a máquina onde ficam centralizadas todas as informações do posto.

  • Atualização Cliente - Apenas o Petroshow PDV - Sem serviço de abastecimento: Esse tipo de atualização é para o PDV que não é servidor de abastecimento. Ou seja, é a máquina apenas  utilizada para realizar as operações do PDV.

Depois de escolhida a opção desejada, clique em Próximo.

Por fim, será apresentada a tela de resumo da atualização.

Clique em Atualizar para executar o processo.

Para que a atualização seja realizada é necessário que o módulo PDV esteja fechado, assim como os serviços de abastecimento e integração estejam parados.

Diante disso, caso o atualizador identifique que as aplicações estão abertas, marque a opção Automatically close the applications. E em seguida clique em Próximo.

Durante a atualização, pode ser que algumas aplicações não sejam fechadas automaticamente na primeira tentativa, sendo assim, será apresentada a mensagem a seguir. Neste caso, clique em Try Again para que o processo de fechar as aplicações seja realizado novamente.

O processo de atualização irá atualizar os executáveis necessários e também instalar o Viasoft Update caso ainda não tenha sido instalado.

As configurações do Viasoft Update serão as informadas no momento da instalação, como visto anteriormente.

Com isso, logo após instalar o serviço, o Viasoft Update será iniciado e começará a fazer o processo de monitoramento de novas atualizações, ou seja, cada vez que for feita uma atualização no servidor, o Viasoft Update irá baixar automaticamente a atualização para os PDV’s. Esse processo de consulta é feito a cada 5 minutos. O PDV vai verificar se houve a baixa de um novo atualizador a cada 15 minutos.

Resumindo, o Viasoft Update monitora e faz a baixa de novas atualizações a cada 5 minutos, e o PDV verifica se existe uma nova versão já baixada a cada 15 minutos.

Quando identificado que existe uma atualização disponível, o PDV terá o seguinte comportamento:

Se o PDV já estiver aberto, será apresentada a seguinte mensagem no canto da tela para o usuário:

Quando o PDV for iniciado, caso o PDV identifique que o processo de baixa do atualizador ainda está em andamento, será apresentada uma tela de progresso como essa:

Depois de concluir o download, ou ao iniciar o PDV com o download concluído, será apresentada essa mensagem:

Ao clicar em OK, o processo de atualização será então realizado automaticamente, e após concluir o PDV será iniciado, sem precisar executá-lo novamente. Com isso, o PDV estará atualizado e disponível para utilização.