Chapter 4. Configuring JBoss EAP to Run as a Service

Configuring JBoss EAP as a Service in Red Hat Enterprise Linux

1. Customize the start-up options in the jboss-eap.conf file.

   The startup script and an associated configuration file are located in the EAP_HOME/bin/init.d/ directory. Open jboss-eap.conf in a text editor and set the options for your JBoss EAP installation.

   There are several options in jboss-eap.conf file, but at the minimum you must provide the correct values for JBOSS_HOME and the 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.

   Note

   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. Copy the service files into the system directories.

   1. Copy the modified service configuration file to the /etc/default directory.

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

   2. Copy the service startup script to the /etc/init.d directory, and give it execute permissions:

      $ 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. Add the new jboss-eap-rhel.sh service to list of automatically started services using the chkconfig service management command:

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

4. Test that the service has been installed correctly by using one of the following commands.

   1. For Red Hat Enterprise Linux 6:

      $ sudo service jboss-eap-rhel.sh start

   2. For Red Hat Enterprise Linux 7 and later:

      $ sudo service jboss-eap-rhel start

   The service will start. If you get an error, check the error logs and make sure that the options in the configuration file are set correctly.

5. To make the service start automatically when the Red Hat Enterprise Linux server starts, run the following command:

   $ sudo chkconfig jboss-eap-rhel.sh on

Removing the JBoss EAP Service in Red Hat Enterprise Linux

1. If the service is running, open a terminal and stop the service with one of the following commands.

   1. For Red Hat Enterprise Linux 6:

      $ sudo service jboss-eap-rhel.sh stop

   2. For Red Hat Enterprise Linux 7 and later:

      $ sudo service jboss-eap-rhel stop

2. Remove JBoss EAP from the list of services:

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

3. Delete the service configuration file and startup script:

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

Configuring JBoss EAP as a Service in Microsoft Windows Server

1. Create two system environment variables:

   • JBOSS_HOME pointing to the JBoss EAP installation directory.
   • NOPAUSE=1

2. Install the JBoss Core Services Jsvc Package

   If not already configured, download and extract the JBoss Core Services Jsvc package.

   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. Select the latest version from the Version drop-down menu.
   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. Extract the downloaded ZIP file into the directory containing your JBoss EAP installation directory.

      This will result in a jbcs-jsvc-<VERSION> directory at the same depth as your JBoss EAP installation directory. For example:

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

3. Install the Service

   Open a terminal, and change directories to EAP_HOME\bin.

   Below are examples of a basic service.bat install command to create a new service for either a standalone server, or a server in a managed domain. For a list of all possible options, run service.bat without any arguments.

   Important

   If you specify the /jbossuser and /jbosspass parameters, you must ensure that your JBoss EAP user’s password does not contain a hash (#) or a semicolon (;).

   Execute the following command, adjusting the log level for the service as required:

   1. For a standalone server:

      service.bat install /loglevel INFO

   2. For a server in a managed domain:

      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

   A new Windows service will be created with name JBossEAP7.

4. Verify the New Service in the Services console

   Open the Windows Services console (services.msc) and verify that the service was created.

   If the default service name was used, in the list of Windows services the new service will have the display name: JBossEAP7. From the Services console you can start and stop the service, as well change its settings of how and when it starts.

5. Starting and Stopping the JBoss EAP Service from a Terminal

   To start the service from a terminal, use the following command, changing the service name if necessary:

   net start JBossEAP7

   To stop the service from a terminal, use the following command, changing the service name if necessary:

   net stop JBossEAP7

Removing the JBoss EAP Service in Microsoft Windows Server

1. If the service is running, first open a terminal and stop the service by executing the net stop command with the name of the service:

   net stop JBossEAP7

2. In a terminal, change directories to EAP_HOME\bin and execute the following command:

   service.bat uninstall