5 - Instalação/Atualização do PDV

Pré- Requisitos

  • Instalação do Servidor Concluída

Siga as orientações abaixo:

A instalação e/ou atualização do Petroshow PDV é 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.

Instalando o Petroshow nas Máquinas estações.

Para iniciar o processo, tenha em mãos o atualizador “AtualizaPetroshow_PDV_Client” correspondente a versão desejada. O atualizador será assim:

image-20240208-141013.png

Ao executá-lo, será apresentada uma tela de boas vindas.

image-20240118-175250.png

Clique em Próximo.


Será apresentada uma tela com algumas informações importantes sobre a atualização. Execute a leitura.

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.

Clique em Próximo.


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

Atualmente existem 3 formatos:

  • 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.

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


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.

Quando o tipo de instalação for Viasoft Cloud ou Viasoft Cloud Multi-Client, será solicitado o ID Cloud. Para obter seu ID Cloud entre em contato com a Viasoft.

Deverá ser informado o mesmo ID Cloud utilizado na instalação do servidor. Para o tipo Servidor Próprio não será necessário.

Quanto aos demais campos, podem ser informados os seguintes dados:

  • Viasoft Cloud ou Viasoft Cloud Multi-Client

  • 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.

Abaixo exemplos das telas apresentadas com suas configurações default:

Depois de informados esses dados, clique em Próximo.


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.

ATENÇÃO: Ao informar que dois PDV’s no mesmo posto utilizam o serviço de abastecimentos, pode haver falhas no serviço de leitura de abastecimentos. Apenas um PDV por posto/estabelecimento deve ser o servidor de abastecimentos.

OBS: Tais configurações serão salvas, e nas próximas atualizações o usuário não precisará informar mais nada, o atualizador se encarregará de todo o processo.

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.

Nas próximas vezes que o servidor for atualizado, a atualização será baixada automaticamente para os PDV’s, sendo que quando o usuário reiniciá-lo a atualização já será aplicada.