Pular para o conteúdo
ALPHA ERP Central de Ajuda

Atualizar o sistema para uma versão nova

Rode o instalador do servidor por cima da instalação atual; os caixas e a Gestão de Estoque se atualizam sozinhos ao abrir e o Gerencial pede só um Ctrl+F5.

Atualizado na versão 1.0.0.19.18

Para atualizar o ALPHA ERP, só o servidor recebe o instalador. Os caixas (PDV) e a Gestão de Estoque baixam a versão nova do próprio servidor na próxima vez que abrirem.

Antes de começar#

  • Escolha um horário sem movimento (antes de abrir a loja ou depois de fechar). Durante a atualização os caixas ficam alguns minutos sem servidor.
  • Tenha a senha do banco de dados (a mesma usada na instalação do servidor).
  • Leia a nota da versão (seção "Como atualizar"): ela avisa se há migração de banco, se todos precisam entrar de novo ou se algo muda para os operadores.

Passo a passo#

  1. Nos caixas: finalize, cancele ou coloque em espera (CtrlE) as vendas abertas, e finalize ou cancele as trocas em andamento. Feche o PDV.
  2. No servidor: rode o AlphaERP-Servidor-<versão>.exe por cima da instalação atual, na mesma pasta que o instalador mostra (C:\AlphaERP, ou C:\Nascente nas instalações feitas antes da versão 1.0.0.19.18). Não troque a pasta: a atualização não move o banco de dados, os backups nem o certificado.
    • O instalador já vem preenchido com o tipo, as portas e a senha guardada; confira e avance.
    • Ele para o servidor, troca os arquivos e liga de novo sozinho.
  3. Banco de dados: se a versão trouxer mudanças no banco, o servidor faz sozinho um backup antes de mudar o banco (aparece como "Antes da atualização (V…)" na tela de backup). Não é preciso fazer backup manual.
  4. Espere a mensagem "Servidor instalado e a API respondendo…". Em versões com migração de banco, a primeira subida pode levar alguns minutos.
  5. Abra cada caixa. O PDV percebe que o servidor está em outra versão, mostra "Atualizando o PDV da versão X para a Y…", baixa, instala e abre sozinho de novo. O mesmo vale para a Gestão de Estoque.
  6. Gerencial: no navegador, aperte CtrlF5 para carregar a versão nova da tela. No app do Windows, feche e abra.
  7. Confira a versão no canto da tela de cada caixa (veja Conferir a versão de cada programa).
  8. No Gerencial, em Administração → Backup, confira se o backup de antes da atualização apareceu (quando a versão tinha migração).

O que acontece#

  • Dados: nada se perde. O banco, os backups, o certificado digital e os XML das notas ficam como estavam.
  • Configuração dos caixas: a atualização automática nunca sobrescreve o config.ini (servidor, caixa, impressoras), o dispositivo.json (ativação) nem as logos da loja.
  • Logins: algumas versões pedem que todos entrem de novo (a nota da versão avisa).
  • Mais de uma base: todas as bases usam o mesmo sistema; a atualização vale para todas, e cada base atualiza o próprio banco quando sobe.

Problemas comuns#

MensagemO que fazer
"PDV na versão X, o servidor está na Y. Atualize o PDV."O PDV vai se atualizar sozinho; se não atualizar, feche e abra o PDV.
"Não foi possível atualizar o PDV para a versão Y: …"Feche e abra o PDV de novo. Se continuar, confira o espaço em disco do caixa e chame o suporte. O PDV só funciona na mesma versão do servidor.
"O servidor exige outra versão do PDV, mas não foi possível consultar a atualização."Problema de conexão no meio da atualização. Abra o PDV de novo.
"o pacote baixado está corrompido (SHA-256 não confere)."O download falhou. Abra o PDV de novo para baixar outra vez.
A janela do Windows pede permissão de administrador ao atualizarA pasta do PDV não está liberada para escrita. Aceite, ou reinstale a estação com o instalador para corrigir as permissões.
O Gerencial no navegador mostra telas antigasAperte CtrlF5.

Veja também#

Artigos relacionados