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

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

Execute o atualizador.
Na tela de boas-vindas, clique em Próximo.
Leia as informações importantes e clique em Próximo.

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

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.

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.

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.

Observação: Para instalações locais, o sistema irá carregar as configurações já existentes para o PSPDV. No caso de uma instalação nova, ele aplicará as portas padrão: 2920 para o servidor de integração e 2910 para o servidor DFe.

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) -

Viasoft Cloud ou Viasoft Cloud Multi-Client
- Protocolo: https
- Servidor: app-petroshow.viasoftcloud.com.br
- Porta: 443

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

Viasoft Cloud ou Viasoft Cloud Multi-Client
- Servidor: app-petroshow.viasoftcloud.com.br
- Porta: 443

Observação: Na primeira atualização para o Berlin, quando a configuração for Cloud ou Multi-Client, a porta padrão será 443 e o endereço será app-petroshow. Nas atualizações subsequentes, as configurações existentes do PDV serão mantidas.

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.