Solução de Problemas — Integrador Usina Concreto

Guia de manutenção quando o serviço falha ao iniciar.

Cenário de Aplicação

Este procedimento deve ser executado quando o serviço Integrador Usina Concreto falha ao iniciar e os seguintes erros aparecem no arquivo de log usinaconcreto.wrapper.log:

ERROR - Failed to start service. System.ComponentModel.Win32Exception: O sistema não pode encontrar o arquivo especificado.

Diagnóstico do Problema

A análise indica duas causas raiz possíveis:

1. Corrupção de dados: os arquivos físicos do banco de dados embarcado podem estar corrompidos, impedindo a inicialização da aplicação.
2. Configuração de ambiente: o executável java.exe não é encontrado pelo contexto de execução do serviço Windows.

A solução consiste em corrigir a configuração do serviço e limpar os dados da aplicação para garantir uma reinicialização limpa.

Visão Geral da Solução

1. Configuração do serviço: editar usinaconcreto.xml para incluir o caminho absoluto do executável java.exe.
2. Reset da aplicação: utilizar o script reinstalar_servico.bat para desinstalar, limpar dados e reinstalar o serviço.

Procedimento Operacional

Etapa 1: Identificação e Configuração do Ambiente Java

Este procedimento é executado apenas uma vez.

a) Abrir o Windows PowerShell

Pressione a tecla Windows, digite PowerShell e selecione “Windows PowerShell”.

b) Identificar o caminho do executável Java

Get-Command java.exe | Select-Object -ExpandProperty Source

O comando retorna o caminho completo do arquivo java.exe.

Java 17: certifique-se de que o Java na versão 17 esteja instalado na máquina. Download em Adoptium Temurin Releases.

c) Copiar o caminho

Selecione a linha de texto do caminho retornado e copie-a (Ctrl + C).

d) Acessar o arquivo de configuração

Navegue até o diretório da aplicação e abra usinaconcreto.xml com um editor de texto.

e) Atualizar o arquivo de configuração

Substitua todo o conteúdo do arquivo pelo modelo abaixo:

<service>
  <id>crtiintegradorusina</id>
  <name>CRTI Integrador Usina Concreto</name>
  <description>Este servico integra a usina de concreto.</description>

  <executable>SEU_CAMINHO_DO_JAVA_AQUI</executable>

  <arguments>-jar "integradorusinaconcreto.jar"</arguments>
  <logmode>rotate</logmode>
</service>

Cole o caminho do Java copiado no passo anterior, substituindo SEU_CAMINHO_DO_JAVA_AQUI. Exemplo de configuração final:

<executable>C:\Program Files\Java\jdk-17\bin\java.exe</executable>

Salve e feche o arquivo.

Etapa 2: Execução do Script de Reinstalação de Serviço

1. Navegue até o diretório da aplicação.
2. Localize o arquivo reinstalar_servico.bat.
3. Clique com o botão direito e selecione “Executar como administrador”.
4. No prompt de comando, confirme digitando S e pressione Enter.
5. Aguarde a finalização do script, que exibirá a mensagem de sucesso ao final.

Após a conclusão, o serviço estará reinstalado e operacional.