Instalar o agente
Um comando no servidor da loja. O que ele faz, e o que fazer quando não dá certo.
A instalação acontece em duas máquinas e quase sempre duas pessoas: quem gera o código de instalação é a equipe Plenus; quem roda o comando está na loja. Por isso o código chega até você dentro de um texto pronto, com o SQL, o comando e o código já no lugar certo — é só copiar.
Leva poucos minutos. O que leva horas é a carga do histórico, depois, e ela não exige ninguém acompanhando.
Antes de começar
Peça o código de instalação
Solicite à equipe Plenus o código de instalação da sua fonte.
Rode o comando
Duas variáveis antes do comando: o código, e a conexão com o banco do ERP com a senha do usuário de leitura.
Windows Server
No PowerShell, como administrador:
$env:ERP_CODIGO='SEU-CODIGO'
$env:ERP_ORIGEM='postgres://dashboard_leitura:SENHA@localhost:5432/vr'
irm https://api.assessoriaplenus.com/agente/instalar.ps1 | iex
Linux
Como root:
export ERP_CODIGO=SEU-CODIGO
export ERP_ORIGEM='postgres://dashboard_leitura:SENHA@localhost:5432/vr'
bash <(curl -fsSL https://api.assessoriaplenus.com/agente/instalar.sh)
O comando baixa o agente, confere que o arquivo chegou íntegro, testa a conexão com o ERP, liga esta instalação à sua fonte e registra o serviço do sistema.
Onde as coisas ficam
O agente não entra no PATH. Todo comando é pelo caminho completo.
Windows Server
| Executável | C:\Program Files\ErpAgente\plenus-agente.exe |
| Serviço | ErpAgente (início automático) |
Linux
| Executável | /opt/plenus-agente/plenus-agente |
| Serviço | plenus-agente.service (systemd) |
Confira
Windows Server
& 'C:\Program Files\ErpAgente\plenus-agente.exe' estado
Linux
/opt/plenus-agente/plenus-agente estado
servidor: https://api.assessoriaplenus.com
origem: postgres://dashboard_leitura:***@localhost:5432/vr
token: presente
janela: 0h às 24h
ERP: alcançável e somente leitura
As duas linhas que interessam são a última — o ERP está acessível e
comprovadamente somente leitura — e token: presente, que confirma o vínculo
com a sua fonte.
token: AUSENTE — pareie significa que o vínculo não foi gravado: o código pode
ter vencido ou já ter sido usado. Peça outro.
A carga inicial leva horas
Isso é esperado. O histórico vem em etapas para não pesar no banco durante o
expediente, e a tela mostra o progresso em meses (6 de 76 meses · histórico de 02/2026 em diante).
Assim que o primeiro dado chega, a fonte sai de aguardando agente para carga inicial. Os meses já carregados já respondem.
Quando dá errado
“a conexão não é somente leitura”
O agente testou escrever no seu ERP — e conseguiu. Ele para aqui de propósito: seguir significaria rodar com mais permissão do que o combinado.
Volte ao usuário de leitura e confirme a linha
ALTER ROLE ... SET default_transaction_read_only = on.
Não consegui conectar no banco
Quase sempre é ERP_ORIGEM: senha ausente, nome de banco diferente de vr,
ou Postgres em outra máquina. Rode estado para ver com que conexão ele está
tentando — a senha sai mascarada, o resto não.
“código inválido ou vencido”
O código vale 30 minutos e é de uso único. Peça outro à equipe Plenus.
O arquivo baixado não confere
O instalador apaga o download e para, em vez de instalar um executável possivelmente corrompido. Rode de novo; se repetir, avise a equipe Plenus — aí não é a rede da loja.
A fonte ficou em “aguardando agente”
O que define uma fonte como ligada é haver dado chegando, não haver agente
instalado. Rode estado: se o token está presente e o ERP está alcançável,
mas nada subiu, o problema está na saída para a internet — firewall ou proxy
bloqueando a conexão HTTPS de saída.