Instalação de serviços

Para tentar simplificar o processo de instalação de serviços esta é a nossa nova abordagem

Configuração

Para uma melhor experiência com serviços que recebem conexões externas , recomendamos que o mesmo seja executado no servidor da empresa e que a configuração de IP esteja fixa.

Crie uma pasta para o serviço, caso seja algum serviço em que seja necessário o sistema recomendamos que seja feita a instalação na pasta do sistema. nos demais casos recomendamos que seja utilizado os locais abaixo para melhor manutenibilidade:

Linux: /opt/merito/{nome do serviço}
Windows: C:/merito/{nome do serviço}

Coloque o arquivo de configuração XML nesta pasta, caso não tenha o arquivo de configuração entre em contato com a Mérito ou faça o download do mesmo no FTP do servidor 2 pasta "Instalação de serviços 2025"

Altere dentro do arquivo de configuração os seguintes parâmetros:

executable: Adicione o caminho do jar necessário para a execução do mesmo(o java pode ser uma distribuição portable sem problemas)
ENV: Configure as variáveis necessárias para a aplicação
- OBS: Em caso de APP_PROFILE, ou PROFILE manter "prod" para ambiente de produção e "homolog" para ambiente de homologação
arguments: Verificar o caminho do jar
- Caso o arquivo config esteja na mesma pasta do jar pode ser utilizado o %base%/nome do jar
- caso estejam em pastas diferentes mudar a pasta para a correta

Etapa inicial da instalação finalizada, vamos para a etapa 2 que é a parte relacionada a Sistema operacional

Instalação no sistema operacional

Windows

Nota: O gerenciador de serviço padrão é o WinSW. Os arquivos .exe não serão enviados para evitar bloqueios durante a atualização. Eles devem ser baixados do WinSW

Faça o download da ultima versão do arquivo WinSW para a versão do seu sistema seja x86(32) ou x64.
Execute um prompt de comando como administrador.
Navegue até a pasta do arquivo.
Execute o comando: WinSW-{x64|x86}.exe install {caminho para o arquivo de configuração} O caminho para o arquivo de configuração. Se um arquivo não for especificado, o WinSW procura no diretório executável por um arquivo .xml com o mesmo nome de arquivo sem a extensão.

Linux

Faça download do script de instalação Linux, se for somente arquivo de texto pode se usar nano
mova-o para a mesma pasta do arquivo configuração xml e do arquivo executável Jar
Conceda permissão de execução para o script: chmod +x InstaladorServicoVX.X.X.sh
Execute o script: InstaladorServicoVX.X.X.sh {nome do xml}

3. Configurações Adicionais e Troubleshooting (Linux)

Arquivo loginbasico.cfg e Geração de Senhas

Se o serviço requer conexão com o banco de dados e retorna Status: 1/FAILURE com erro de arquivo não localizado nos logs, é necessário criar o arquivo loginbasico.cfg na pasta do executável.

Arquivo padrao para alteração esta no servidor 1 /temp/loginbasico.cfg

Para ofuscar a senha no Linux: Utilize o script da Mérito para criptografar as senhas do banco antes de inseri-las no .cfg:

./launcher.sh --ofuscar-senha sua_senha_aqui

(Copie o código retornado na linha Resultado: ).

Exemplo de loginbasico.cfg:

local.ip_bd=localhost
local.porta_bd=5432
local.nome_bd=NomeDoBanco
local.usuario_bd=postgres
local.senha_bd=SENHA_OFUSCADA_DO_BANCO
empresa=1
unidade=50
usuario=1
senha=SENHA_OFUSCADA_DO_SISTEMA

Comandos Úteis para Validação

Após concluir a instalação ou ajustar configurações, recarregue e verifique a saúde do serviço:

Reiniciar o serviço:

systemctl daemon-reload
systemctl restart {id_do_servico_no_xml}

Verificar o status: (O resultado esperado é active (running))

systemctl status {id_do_servico_no_xml}

Acompanhar logs do sistema em tempo real:

journalctl -u {id_do_servico_no_xml} -f