Gestão de Armazenagem WMS - 8.12.6.30

Para realizar a instalação no Windows utilize o Java Service Wrapper chamado Windows Service Wrapper, que é uma ferramenta que facilitará a criação do serviço do Windows que inicia o processo Java.

Após realizar o download do agente e configurar devidamente o arquivo application.properties, crie o serviço para iniciar o Agente de Impressões.

Para este passo de criação realize o download da ferramenta no link (WinSW Versão 2.12.0), que foi a última liberada até o momento da criação deste documento, e que também foi disponibilizada no nosso FTP em ftp://ftp2.senior.com.br/ferramentas/WMS-Print-Agent/WinSW, que já contém o arquivo de configuração para adequação e uso já com a nomenclatura correta.

Faça o download do arquivo que condiz com o sistema operacional para configurar o serviço:
- WinSW-x64.exe para sistemas de 64 bits
- WinSW-x86.exe para sistemas de 32 bits.

Insira o arquivo executável na mesma pasta do Agente de impressões remoto e o renomeie para wms-print-agent-service.exe, como mostrado na imagem abaixo:

Após copiar o arquivo executável do WinSW para a pasta do agente. Crie o arquivo XML de configuração conforme exemplo abaixo, e salve com o mesmo nome do executável do serviço, wms-print-agent-service.exe:

<service>

<!-- Identificador único do Serviço no Sistema de serviços do Windows-->
<id>Wms-Print-Agent</id>
<!-- Nome como será apresentado o serviço no Windows-->
<name>Wms Print Agent (powered by WinSW)</name>
<!-- Descrição do Serviço -->
<description>Agente de Impressões remota</description>
<!-- Comando executado para serviço ser executado -->
<executable>java</executable>
<!-- Argumentos adicionados ao comando para executar o agente -->
<arguments>-jar C:\wms-print-agent\wms-print-agent-2.0.3.jar</arguments>
<!-- Ação tomada ao falhar a inicialização -->
<onfailure action="restart" delay="20 sec"/>
<!-- Diretório onde o agente reside e será executado -->
<workingdirectory>C:\wms-print-agent</workingdirectory>

</service>

Após realizar o salvamento do XML na pasta do agente, serão listados os arquivos, conforme demonstrado na próxima imagem:

Execute o comando de instalação do serviço, a partir do Prompt de Comando ou PowerShell:

wms-print-agent-service.exe install

Após executar a instalação deverá exibir a seguinte saída:

wms-print-agent-service.exe install
2023-02-17 19:44:45,485 INFO - Installing service 'Wms Print Agent
(powered by WinSW) (Wms-Print-Agent)'...
2023-02-17 19:44:45,536 INFO - Service 'Wms Print Agent (powered by WinSW) (Wms-Print-Agent)' was installed successfully

E então será possível verificar o serviço instalado no Gerenciador de Serviços do Windows (services.msc):

Caso seja necessário, configure um usuário que tenha acesso às impressoras disponíveis:

Serviço no Linux baseado no Systemd

O Systemd é um gerenciador de serviços presente na maioria das distribuições Linux modernas, caso precise de mais informações sobre este gerenciador poderá usar o link (https://linuxhandbook.com/create-systemd-services) para consultar o uso e funcionamento.

Após fazer o download do agente de impressões remotas, e a correta configuração do arquivo application.properties. Será possível criar um serviço para execução do agente, para isso crie um script localizado em /usr/local/bin que será utilizado para realizar a execução do serviço, como exemplo:

sudo vi /usr/local/bin/Wms-Print-Agent

No conteúdo deste arquivo adicione o comando para executar através do java o jar do agente de impressões.

#!/bin/bash
java -jar /<Caminho até o Agente>/wms-print-agent-2.0.3.jar

Após a criação do script, crie o arquivo descritor do serviço para a execução do mesmo no caminho apresentado:

sudo vi /etc/systemd/system/wms-print-agent.service

[Unit]
Description=WMS-Print-Agent Service

[Service]
Type=simple
User=<Usuário>
Group=<Grupo do Usuário>

WorkingDirectory=<Pasta onde reside o agente>

ExecStart=/usr/local/bin/Wms-Print-Agent

SuccessExitStatus=0
TimeoutStopSec=60
Restart=on-failure
RestartSec=30

[Install]
WantedBy=wms-print-agent.target
RequiredBy=network.target

Valide se o usuário definido na execução do serviço tem acesso ao "WorkingDirectory", permissão para executar o script apontado em "ExecStart", permissão de visualização e impressão nas impressoras disponíveis para uso.

Após a criação do descritor, faz-se necessário recarregar os serviços disponíveis para execução através do comando:

sudo systemctl daemon-reload

Para habilitar o serviço após a inicialização do sistema utilize o seguinte comando:

sudo systemctl enable wms-print-agent

Com todos os passos devidamente executados, é possível iniciar o serviço através do comando:

sudo service wms-print-agent start

Execute o comando para verificar o status:

sudo service wms-print-agent status

Será retornado o status marcando como "Active (running)" conforme escrito no exemplo abaixo:

   wms-print-agent.service - WMS-Print-Agent Service

     Loaded: loaded (/etc/systemd/system/wms-print-agent.service; disabled; vendor preset: enabled)

     Active: active (running) since Fri 2023-02-17 17:47:56 -03; 2s ago

   Main PID: 23697 (Wms-Print-Agent)

      Tasks: 26 (limit: 18858)

     Memory: 311.1M

        CPU: 9.022s

     CGroup: /system.slice/wms-print-agent.service

             +-23697 /bin/bash /usr/local/bin/Wms-Print-Agent

             +-23700 java -jar /home/server/downloads/WMS-Print-Agent/2.0.3/wms-print-agent-2.0.3.jar