Chapter 8. Running and removing JBoss EAP as a service on Microsoft Windows Server

Procedure

1. 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 archive file into the directory containing your JBoss EAP installation directory.

   6. This results in a jbcs-jsvc-<VERSION>` directory at the same level as your JBoss EAP installation directory. For example:

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

2. Install the service.

   1. 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 (;).

3. Adjust 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 that is managed by the service. To list 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 JBossEAP8.

4. Verify the new Service in the Services console.

   1. 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: JBossEAP8. 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.

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

      net start JBossEAP8

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

      net stop JBossEAP8

Procedure

1. Use the setx command to configure the two environment variables:

   1. Set the path for the JBOSS_HOME variable to the JBoss EAP installation directory.
   2. The jboss-cli.bat script contains the "x%NOPAUSE%" == "x" pause line of code. This code creates a status message when you issue the pause command. To disable these messages, you must specify a value for the NOPAUSE variable. For example, setting the NOPAUSE variable to NOPAUSE=true disables status messages from appearing when a script completes.
2. Use the setx command to create two system environment variables: JBOSS_HOME and NOPAUSE.

Procedure

1. When the service is running, open the command prompt and stop the service by entering the net stop command with the name of the service:

   net stop JBossEAP8

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

   service.bat uninstall