FAQ - Falha ao atualizar PDV

1. Por que o PDV entra em loop ao tentar atualizar?
R: Esse comportamento pode ocorrer ocasionalmente ao tentar atualizar um PDV que está com uma versão muito antiga. O salto entre versões pode causar incompatibilidades ou inconsistências nos componentes utilizados pelo PDV durante a atualização.

Nesses casos, quando o PDV não consegue concluir o processo de atualização, a orientação é realizar a reinstalação do caixa utilizando a versão do instalador mais recente, garantindo que o ambiente seja reconstruído de forma íntegra.
 

2. O uso do Monitor Legado (AcruxMonitor) pode impactar as atualizações?
R: Sim. O Monitor Legado foi descontinuado em 2024 e pode causar problemas durante o processo de atualização, inclusive situações em que versões superiores à versão suportada pelo Servidor de PDVs são disponibilizadas para os caixas.

O novo Monitor deve ser utilizado como ferramenta oficial para gerenciamento das atualizações, não sendo recomendada a utilização de mecanismos do Monitor Legado.
 

3. O que causa o status "Pendente" na atualização dentro do Monitor?
R: O status "Pendente" indica que o PDV ainda não conseguiu concluir o recebimento dos pacotes necessários para a atualização.

Os arquivos são enviados gradativamente para o diretório local do PDV:

C5Client\AcruxPDV\cache\deploy

Caso os arquivos não estejam chegando ao diretório, deve-se verificar possíveis travamentos do serviço do servidor de PDV's ou problemas de comunicação entre o Servidor de PDVs e o caixa.
 

4. Como saber se a falha no download de pacotes no Linux é problema de rede?
R: Em PDVs Linux, problemas na configuração da placa de rede podem causar degradação na transmissão dos pacotes e impactar o processo de atualização.

Verifique se a opção "Permitir negociação automática" (AutoNegotiation) está habilitada e se a conexão está operando corretamente em Full Duplex.

Mais detalhes na documentação: Varejo Supermercados - Atualização - Envio de atualizações para PDV - Pacotes de atualização do PDV pendente no Monitor
 

5. Como testar a comunicação entre o Servidor de PDVs e o Caixa?
R: A comunicação entre o Servidor de PDVs e o caixa deve ser validada nos dois sentidos, utilizando as portas correspondentes a cada direção.

No terminal do Windows (CMD), realize os seguintes testes:

• Do Servidor de PDVs para o PDV: telnet IP_DO_PDV 8011
• Do PDV para o Servidor de PDVs: telnet IP_DO_SERVIDOR 7011

A resposta esperada é:

200 CONECTADO

Caso o teste apresente resultado diferente, deve-se verificar possíveis bloqueios de porta, Firewall ou outras restrições de comunicação junto à equipe de infraestrutura.
 

6. Apenas alguns PDVs apresentam falha na atualização. O que isso indica?
R: Quando apenas alguns PDVs apresentam falha, enquanto outros caixas da mesma loja conseguem realizar a atualização normalmente, o problema tende a estar relacionado ao ambiente dos PDVs afetados.

Nesse cenário, priorize a validação de:

• Comunicação entre o Servidor de PDVs e os caixas afetados;
• Configuração de rede;
• Recebimento dos arquivos no diretório de atualização;
• Status do processo de atualização;
• Integridade dos arquivos e componentes do PDV.

Caso os procedimentos de validação não resolvam o problema e existam indícios de inconsistência no ambiente, avalie a reinstalação do PDV.
 

7. Quando devo reinstalar o PDV em vez de tentar corrigir a atualização?
R: A reinstalação é recomendada quando existem indícios de corrupção ou inconsistência nos arquivos, banco de dados ou estruturas utilizadas pelo PDV, principalmente quando:

• O PDV está em uma versão muito antiga e não consegue concluir o salto de versão;
• A atualização foi interrompida durante o processo;
• O PDV apresenta erros relacionados à ausência ou inconsistência de estruturas (Colunas ou Tabelas);
• O processo de atualização permanece travado mesmo após a validação da comunicação e do ambiente.

Nesses cenários, a reinstalação limpa do PDV é a alternativa mais segura, pois garante a reconstrução do ambiente a partir de uma instalação íntegra, evitando a manutenção de inconsistências que podem gerar novos problemas.
 

8. A reinstalação deve ser realizada sempre que houver falha na atualização?
R: Não. A reinstalação não deve ser o primeiro procedimento em todos os casos.

Antes, devem ser validados a versão do ambiente, a compatibilidade entre as versões, a comunicação entre Servidor e PDV, o recebimento dos arquivos e o status do processo de atualização.

A reinstalação deve ser priorizada quando houver indícios de inconsistência no ambiente do PDV, quando uma atualização tiver sido interrompida durante alterações estruturais ou quando o caixa estiver em uma versão muito antiga e não conseguir concluir a atualização.
 

9. O processo de atualização foi interrompido e gerou inconsistência. Como proceder?
R: A atualização pode realizar alterações estruturais em banco de dados e arquivos do sistema. Caso o processo seja interrompido por oscilação de rede, travamento do PDV ou queda de energia, algumas estruturas podem não ser criadas ou atualizadas corretamente.

Quando houver indícios de que a interrupção comprometeu a integridade do ambiente, a solução mais segura é realizar a reinstalação limpa do PDV, evitando a tentativa de corrigir individualmente estruturas que possam estar inconsistentes.
 

10. O que fazer após instalar ou atualizar um PDV Linux manualmente caso ele não inicie?
R: Verifique se o binário do PDV possui permissão de execução.

Acesse a pasta /c5client/AcruxPDV pelo Konsole e execute:

• chmod +x AcruxPDV

Em seguida, tente iniciar o PDV pelo terminal:

• ./AcruxPDV

Caso o PDV não seja iniciado, o terminal poderá apresentar informações sobre dependências, permissões ou outros erros que auxiliam na identificação da causa.
 

11. Qual a forma correta de planejar a atualização na loja sem impactar a operação?
R: Evite enviar a atualização simultaneamente para todos os PDVs de todas as lojas.

Como boa prática:

1. Atualize inicialmente apenas 2 PDVs por loja.
2. Mantenha esses caixas em operação por um período para validar o funcionamento das principais operações e a compatibilidade da nova versão com o ambiente.
3. Após confirmar a estabilidade, libere a atualização gradativamente para os demais PDVs.

Essa estratégia permite identificar eventuais problemas de compatibilidade ou atualização antes que afetem todos os caixas da loja.
 

12. Quais informações devo anexar ao ticket caso precise de suporte técnico para atualização?
R: Para agilizar a análise da equipe de suporte, anexe o máximo possível de evidências do cenário, principalmente:

• Versão atual do Servidor de PDVs;
• Versão que está sendo enviada para atualização;
• Identificação dos PDVs afetados, incluindo Loja e Número do PDV;
• Print da tela do Monitor apresentando o status da atualização;
• Evidências do conteúdo do diretório de atualização, quando aplicável;
• Resultado dos testes de comunicação entre Servidor e PDV;
• Resultado dos testes de porta (telnet);
• Mensagens de erro apresentadas pelo PDV ou pelo Monitor;
• Informações sobre eventuais quedas de energia, oscilações de rede ou interrupções ocorridas durante a atualização.

Essas informações permitem identificar se o problema está relacionado à versão, comunicação, ambiente do PDV ou integridade da instalação, evitando procedimentos desnecessários.