Comandos do agente

O que você pode rodar no servidor da loja, e quando precisa disso.

No dia a dia não se roda nada: o agente é um serviço do sistema, sobe com a máquina e trabalha sozinho. Os comandos abaixo existem para dois momentos — a instalação e a conferência.

O agente não entra no PATH. Nos exemplos, plenus-agente é o caminho completo do executável:

Windows Server

& 'C:\Program Files\ErpAgente\plenus-agente.exe' estado

Linux

/opt/plenus-agente/plenus-agente estado

Os comandos

estadoo que você mais vai usar

Mostra para onde o agente fala, com que conexão lê o ERP (senha mascarada), se o vínculo com a sua fonte está gravado, a janela de leitura e se o ERP está alcançável e comprovadamente somente leitura.

É o primeiro comando a rodar quando a tela não bate com o que se espera. O que cada linha significa

sincronizarsob demanda

Faz uma leitura agora e sai, sem esperar a janela. Serve para forçar uma atualização imediata, ou para ver um erro na tela em vez de no log do serviço.

" type="uma vez por instalação"> Liga esta instalação à sua fonte, usando o código de instalação. O instalador faz isso para você — você só roda à mão se precisar religar um agente.

Antes de ligar, ele testa a conexão com o ERP e para se conseguir escrever. Um agente que se ligasse com uma conexão de escrita passaria a valer mais permissão do que o combinado, e ninguém saberia.

instalar / remover

Registra e remove o serviço do sistema. O instalador chama instalar para você; remover é o que desinstala o agente da máquina.

servico

O laço contínuo que respeita a janela. É o que o serviço do sistema executa — você não roda isto à mão.

Parar, iniciar, reiniciar

Windows Server

Restart-Service ErpAgente
Stop-Service ErpAgente
Start-Service ErpAgente

Linux

systemctl restart plenus-agente
systemctl stop plenus-agente
systemctl start plenus-agente

Parar o agente não perde dado: a leitura seguinte retoma de onde parou.

Variáveis de ambiente

Elas são lidas na instalação e guardadas na máquina. Depois disso o serviço não depende mais delas.

ERP_ORIGEMURL de conexão

O banco do ERP, com o usuário de leitura e a senha dele. Defina sempre — o padrão do instalador não tem senha e presume localhost:5432.

ERP_SERVIDORURL

Para onde o agente fala. O instalador já preenche.

ERP_LOGnível

info por padrão. debug detalha cada passo — útil ao investigar um problema com a equipe Plenus. warn e error reduzem a saída.