Capítulo 4. Configurando o JBoss EAP para Ser Executado como um Serviço

Configurando o JBoss EAP como um Serviço no Red Hat Enterprise Linux

1. Personalize as opções de inicialização no arquivo jboss-eap.conf.

   O script de inicialização e o arquivo de configuração associado a ele estão localizados no diretório EAP_HOME/bin/init.d/. Abra jboss-eap.conf em um editor de texto e defina as opções para a sua instalação do JBoss EAP.

   Há várias opções no arquivo jboss-eap.conf e você deve fornecer pelo menos os valores corretos para o JBOSS_HOME e o JBOSS_USER.

   You can customize the other options provided in the configuration file by uncommenting and editing the respective lines. If you do not, the service will default to starting a standalone JBoss EAP server using the default configuration file, standalone.xml.

   Nota

   If you want the service to start JBoss EAP as a managed domain, add JBOSS_MODE=domain to jboss-eap.conf.

   To specify custom domain configuration files, add JBOSS_DOMAIN_CONFIG=DOMAIN_CONFIG_FILE.xml and JBOSS_HOST_CONFIG=HOST_CONFIG_FILE.xml. By default, JBoss EAP uses domain.xml and host.xml as the domain configuration files.

2. Copie os arquivos de serviço nos diretórios do sistema.

   1. Copie o arquivo de configuração do serviço modificado ao diretório /etc/default.

      sudo cp EAP_HOME/bin/init.d/jboss-eap.conf /etc/default

   2. Copie o script de inicialização do serviço no diretório /etc/init.d e dê a ele permissões para execução:

      sudo cp EAP_HOME/bin/init.d/jboss-eap-rhel.sh /etc/init.d
      sudo chmod +x /etc/init.d/jboss-eap-rhel.sh

3. Adicione o novo serviço jboss-eap-rhel.sh à lista dos serviços iniciados automaticamente, usando o comando de gerenciamento do serviço chkconfig.

   sudo chkconfig --add jboss-eap-rhel.sh

4. Verifique se o serviço foi instalado corretamente usando um dos seguintes comandos:

   1. Para o Red Hat Enterprise Linux 6:

      sudo service jboss-eap-rhel.sh start

   2. Para o Red Hat Enterprise Linux 7:

      sudo service jboss-eap-rhel start

   O serviço será iniciado. Caso você obtenha um erro, verifique os logs de erro e certifique-se de que as opções no arquivo de configuração estejam definidas corretamente.

5. Para que o serviço seja iniciado automaticamente ao iniciar o servidor do Red Hat Enterprise Linux, execute o seguinte comando:

   sudo chkconfig jboss-eap-rhel.sh on

Removendo o Serviço do JBoss EAP no Red Hat Enterprise Linux

1. Caso o serviço esteja em execução, abra um terminal e interrompa o serviço com um dos seguintes comandos:

   1. Para o Red Hat Enterprise Linux 6:

      sudo service jboss-eap-rhel.sh stop

   2. Para o Red Hat Enterprise Linux 7:

      sudo service jboss-eap-rhel stop

2. Remova o JBoss EAP da lista de serviços:

   sudo chkconfig --del jboss-eap-rhel.sh

3. Exclua o arquivo de configuração do serviço e o script de inicialização:

   sudo rm /etc/init.d/jboss-eap-rhel.sh
   sudo rm /etc/default/jboss-eap.conf

Configurando o JBoss EAP como um Serviço no Microsoft Windows Server

1. Crie duas variáveis de ambiente do sistema:

   • JBOSS_HOME apontando para o diretório de instalação do JBoss EAP.
   • NOPAUSE=1

2. Instale o Pacote Jsvc no JBoss Core Services

   Caso não esteja configurado ainda, baixe e extraia o pacote Jsvc do JBoss Core Services.

   1. Open a browser and log in to the Red Hat Customer Portal JBoss Software Downloads page.
   2. Select Apache Jsvc in the Product drop-down menu.
   3. Selecione a versão mais recente no menu suspenso Versão.
   4. Find Red Hat JBoss Core Services Apache Jsvc in the list, ensuring that you select the correct platform and architecture for your system, and click the Download link.

   5. Extraia o arquivo ZIP baixado no diretório contendo o seu diretório de instalação do JBoss EAP.

      Isto resultará em um diretório jbcs-jsvc-<VERSION> com a mesma profundidade que o seu diretório de instalação do JBoss EAP. Por exemplo:

      C:\Program Files
      ├── jboss-eap-7.0
      │   ├── bin
      │   └── ...
      └── jbcs-jsvc-<VERSION>

3. Instale o Serviço

   Abra um terminal e mude os diretórios para EAP_HOME\bin.

   Seguem abaixo exemplos de um comando básico service.bat install para a criação de um novo serviço tanto para um servidor autônomo como para um servidor em um domínio gerenciado. Para uma lista de todas as opções possíveis, execute service.bat, sem argumento algum.

   Execute o comando a seguir, ajustando o nível de log para o serviço como necessário:

   1. Para um servidor autônomo:

      service.bat install /loglevel INFO

   2. Para um servidor em domínio gerenciado:

      Use the /host parameter to specify the name of the JBoss EAP host controller being controlled by the service. You can see valid values for the name by executing ls /host in the management CLI.

      Replace EAP_HOST_NAME in the command below with your JBoss EAP host controller name. If you specify the /host parameter without providing a JBoss EAP host controller name, the name defaults to master.

      service.bat install /host EAP_HOST_NAME /loglevel INFO

   Um novo serviço do Windows será criado com o nome JBossEAP7.

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

   Abra o console do Windows Services (services.msc) e verifique se o serviço foi criado.

   Caso o nome do serviço padrão tenha sido usado, o novo serviço terá o nome de exibição na lista de serviços do Windows como: JBossEAP7. A partir do console de Serviços, é possível iniciar e interromper o serviço, assim como alterar as suas configurações de como e quando ele deve ser iniciado.

5. Iniciando e Interrompendo o Serviço do JBoss EAP 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 JBossEAP7

   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 JBossEAP7

Removendo o Serviço do JBoss EAP no Microsoft Windows Server

1. Caso o serviço esteja em execução, primeiro abra um terminal e interrompa o serviço executando o comando net stop com o nome do serviço:

   net stop JBossEAP7

2. Em um terminal, mude os diretórios para EAP_HOME\bin e execute o seguinte comando:

   service.bat uninstall

1. Open a browser and log in to the Red Hat Customer Portal JBoss Software Downloads page.
2. Select Apache Jsvc in the Product drop-down menu.
3. Selecione a versão mais recente no menu suspenso Versão.
4. Find Red Hat JBoss Core Services Apache Jsvc in the list, ensuring that you select the correct platform and architecture for your system, and click the Download link.

5. Extraia o arquivo ZIP baixado no diretório contendo o seu diretório de instalação do JBoss EAP.

   Isto resultará em um diretório jbcs-jsvc-<VERSION> com a mesma profundidade que o seu diretório de instalação do JBoss EAP. Por exemplo:

   /var/opt/
   ├── jboss-eap-7.0
   │   ├── bin
   │   └── ...
   └── jbcs-jsvc-<VERSION>

6. The command examples for using Jsvc to start JBoss EAP assume that a jboss user has been created. If you have not already created a user for JBoss EAP, run the following commands to create the jboss user and group:

   # groupadd -f -g 185 -r jboss
   # useradd -r -u 185 -g jboss -d EAP_HOME -s /sbin/nologin -c "JBoss" jboss

1. Faça o login no Red Hat Subscription Manager.
2. Clique em Sistemas no Inventário do Assinante.

3. Subscreva-se para os repositórios CDN do JBoss Core Services para a arquitetura e versão do seu sistema operacional:

   1. Para o Red Hat Enterprise Linux 6:

      • jb-coreservices-1-for-rhel-6-server-rpms

   2. Para o Red Hat Enterprise Linux 7:

      • jb-coreservices-1-for-rhel-7-server-rpms

4. Execute o seguinte comando, como usuário root, para instalar o Jsvc:

   # yum groupinstall jbcs-jsvc