Dúvida

Como configurar o Domínio do WildFly para iniciar como um Serviço no Windows?

Solução

Importante

Os passos descritos nesse artigo foram repassados pelo Consultor de TI Thiago Martins para equipe do Suporte ERP. Este artigo está sendo definido inicialmente como Interno, pois os passos foram validados apenas internamente em um ambiente do Suporte ERP. Posteriormente, caso o processo seja verificado que é adequado para utilização em diversos ambientes, o artigo poderá ser editado e publicado externamente.

Abaixo seguem os passos para realizar a instalação do domínio do Wildfly como Serviço no Windows:

1. Pare toda e qualquer execução do Wildfly como aplicativo no computador onde você efetuará a instalação do Serviço;

2. Acesse a pasta bin do diretório de instalação do Wildfly. Exemplo: D:\Senior5104\wildfly-30.0.1.Final\bin;

2.1. Dentro desta pasta, selecione o arquivo domain.conf.bat com botão direito do mouse e selecione a opção Editar, para que o arquivo seja aberto no Bloco de Notas do Windows e permita edição;

2.1.1. Dentro do arquivo domain.conf.bat, localize a linha que se inicia com o texto rem set "JAVA_HOME=. Edite essa linha, removendo o prefixo rem e substituindo o caminho do JAVA_HOME pelo caminho da instalação do Java 17 na máquina onde o serviço do Wildfly será executado.

Exemplo de como ficará a linha:

set "JAVA_HOME=C:\Program Files\Java\jdk-17"

Agora uma imagem de exemplo:

Observação

Essa alteração definirá o JAVA_HOME na execução do Serviço, não havendo necessidade de definir o JAVA_HOME nas Configurações Avançadas do Windows.

2.1.2. Salve as alterações no arquivo domain.conf.bat;

3. Acesse a pasta docs\contrib\scripts do diretório de instalação do Wildfly. Exemplo: D:\Senior5104\wildfly-30.0.1.Final\docs\contrib\scripts

3.1. Copie toda a pasta service para a pasta bin do diretório de integração do Wildfly:

Exemplo da pasta que deve ser copiada: D:\Senior5104\wildfly-30.0.1.Final\docs\contrib\scripts\service

Exemplo de para onde a pasta deverá ser copiada: D:\Senior5104\wildfly-30.0.1.Final\bin

Exemplo de como ficará a estrutura depois da cópia: D:\Senior5104\wildfly-30.0.1.Final\bin\service

3.2. Dentro desta pasta, selecione o arquivo service.bat com botão direito do mouse e selecione a opção Editar, para que o arquivo seja aberto no Bloco de Notas do Windows e permita edição;

3.2.1. Dentro do arquivo service.bat, localize a linha com o texto set IS_DOMAIN=false. Edite essa linha, alterando o valor para true.

Exemplo de como ficará a linha:

set IS_DOMAIN=true

Agora uma imagem de exemplo:

4. Acesse o CMD (Command) do Windows;

4.1. Dentro do CMD, acesse o diretório onde o arquivo service.bat foi copiado e editado. Exemplo: D:\Senior5104\wildfly-30.0.1.Final\bin\service.

4.1.1. Execute o aplicativo service.bat com o parâmetro install.

Exemplo: service.bat install

Abaixo segue exemplo de como ficará a execução do comando no CMD e a resposta do comando.

Por padrão, após a execução do comando, terá sido criado um Serviço no Windows com o nome Wildfly, conforme mensagem de retorno do processo de instalação do Serviço.

Abaixo segue exemplo de como ficará o serviço dentro do Console de Serviços do Windows (services.msc):

Importante

O serviço é instalado com o tipo de inicialização Manual, podendo ser alterado conforme necessidade.