Red Hat Training

A Red Hat training course is available for Red Hat JBoss Enterprise Application Platform

3.9.3. Configure o JBoss EAP 6 como um Serviço no Microsoft Windows Server (Zip, Installer)

Pré-requisitos

Importante

Quando determinando as variáveis do ambiente do sistema, o uso do comando set do aviso do comando do Windows Server não determinará permanentemente o ambiente da variável. Você deve tanto usar o comando setx ou a interface Sistema no Painel de Controle.
Sumário

Use os seguintes procedimentos para configurar o JBoss EAP 6 no Microsoft Windows Server.

Procedimento 3.19. Configure um Serviço para o JBoss EAP 6 no Microsoft Windows Server.

  1. Crie variáveis do ambiente do sistema

    Crie duas variáveis do ambiente do sistema:
    • O JBOSS_HOME apontando ao diretório de instalação do JBoss EAP 6.
    • NOPAUSE=1

  2. Caso ainda não configurado, realize o download e extraia o pacote Native Utilities para sua arquitetura

    Caso o Native Utilities para o pacote do Windows Server não tenha sido instalado como parte da instalação JBoss EAP 6, realize o download do pacote relevante de 32-bytes ou 64-bytes a partir do Portal do Cliente Red Hat no https://access.redhat.com. Extraia o arquivo zip do Native Utilities na instalação do JBoss EAP 6.
    Isto resultará num diretório native na seguinte localização da instalação do JBoss EAP 6: EAP_HOME\modules\system\layers\base\

  3. Instalação do serviço

    Abra um terminal e altere os diretórios para EAP_HOME\modules\system\layers\base\native\sbin
    Um novo serviço pode ser criado com o comando service install, sem opções disponíveis apresentadas na seguinte tabela.

    Tabela 3.3. Opções service install

    Argumento ou Interruptor Descrição
    /startup
    Indica os serviços para iniciação automatizada. Caso não seja especificado, o serviço é definido para ser iniciado manualmente.
    /controller HOST:PORT
    O host e a porta da interface de gerenciamento. Caso omitido, o default é localhost:9999.
    /host [DOMAIN_HOST]
    Indica que o modo domain será usado especificando opcionalmente o nome do domain controller. Caso o domain controller for omitido, o nome default será master.
    /loglevel LEVEL
    O nível de log para o serviço, tanto: ERROR, INFO, WARN ou DEBUG. Caso omitido, o default será INFO.
    /name SERVICE_NAME
    O nome do serviço a ser criado não deve conter espaços. Caso omitido, o default será JBossEAP6.
    /desc "DESCRIPTION"
    A descrição do serviço. Caso omitido, o default será "JBoss Enterprise Application Platform 6".
    /serviceuser DOMAIN\USERNAME
    Especifica o nome da conta pela qual o serviço será executado. Use o nome da conta no formato DOMAIN\USERNAME. Caso omitido, o serviço executa como uma conta do Sistema Local.
    /servicepass PASSWORD
    Senha para a conta /serviceuser.
    /jbossuser USERNAME
    Opcional, o nome do usuário JBoss EAP 6 a ser usado para o comando de encerramento.
    /jbosspass PASSWORD
    Senha para a conta /jbossuser, requerida se o /jbossuser for especificado.
    /config XML_FILE
    Especifica o server-config para uso. O default é standalone.xml ou domain.xml.
    /hostconfig XML_FILE
    Especifica a configuração de host para uso no modo Domain apenas. O default é host.xml.
    /base directory
    Especifica o diretório base para o conteúdo do servidor/domain como um caminho inteiramente qualificado. O default é %JBOSS_HOME%\standalone ou %JBOSS_HOME%\domain.
    /logpath path
    Especifica o caminho dos arquivos de log. O /base é aplicado quando o /logpath não é definido. O default depende no modo domain ou autônomo, %JBOSS_HOME%\domain\log ou %JBOSS_HOME%\standalone\log.
    /debug
    Execução da instalação do serviço no modo de depuração.
    Seguem abaixo amostras básicas de um comando install para criar um novo serviço tanto no modo domain ou autônomo. Execute o seguinte comando, ajustando o nível do log para o serviço conforme requerido:
    • Modo autônomo: 
      service.bat install /loglevel INFO
    • Modo domain:
      Caso você não esteja usando o mestre default para o seu domain controller do JBoss EAP 6, substitua o master pelo nome de host correto ou alias do domain controller do JBoss EAP 6. 
      service.bat install /host master /loglevel INFO
    Um novo serviço Windows será criado com o nome JBossEAP6.

  4. Verifique o novo serviço no console de Serviços

    Execute o seguinte comando num terminal para abrir o console dos Serviços do Windows: 
    services.msc
    Caso o nome do serviço default for usado, na lista dos serviços do Windows, o novo serviço terá o nome de exibição: JBossEAP6. A partir do console de Serviços, é possível iniciar e interromper o serviço, assim como alterar suas configurações sobre como e onde ele deve iniciar.

  5. Iniciação e Interrupção do serviço do JBoss EAP 6 a partir de um terminal

    Para iniciar o serviço a partir de um terminal, use o seguinte comando, alterando o nome do serviço caso necessário: 
    net start JBossEAP6
    Para interromper o serviço a partir de um terminal, use o seguinte comando, alterando o nome do serviço caso seja necessário: 
    net stop JBossEAP6
Resultado

O serviço do JBoss EAP 6 é configurado no Microsoft Windows Server.

Procedimento 3.20. Desinstalação do serviço do JBoss EAP 6 a partir do Servidor Microsoft Windows

  • Caso o servidor estiver executando, abra primeiro um terminal e interrompa o serviço pela execução do comando netstop pelo nome do serviço: 
    net stop JBossEAP6
    Num terminal, altere os diretórios para EAP_HOME\modules\system\layers\base\native\sbin e execute o seguinte comando: 
    service uninstall
Resultado

O serviço do JBoss EAP 6 foi removido do Servidor Microsoft Windows.

Reportar um erro