Chapter 4. Installing JBoss Web Server on Microsoft Windows

You can install JBoss Web Server on Microsoft Windows from a set of archive files that you can download from the Red Hat Customer Portal.

4.1. Installing a JDK on Microsoft Windows

Before you install JBoss Web Server on Microsoft Windows, you must first install a Java Development Kit (JDK).

You can download and install the JDK from a supported vendor website, such as Oracle or IBM. For a list of supported JDKs, see Supported operating systems and configurations.

Note

This procedure describes how to install the Oracle JDK.

Procedure

  1. To access the Oracle website, open a browser window and enter the following URL:

    http://www.oracle.com/technetwork/java/javase/downloads/index.html

  2. Download the Oracle JDK for your operating system and architecture.
  3. Double-click the downloaded file to start the installation.
  4. Proceed as instructed in the installation window.

Additional resources

4.2. Downloading and extracting JBoss Web Server on Microsoft Windows

You can download the JBoss Web Server archive files from the Product Downloads page on the Red Hat Customer Portal.

Procedure

  1. Open a browser and log in to the Red Hat Product Downloads page.
  2. In the Product Downloads list, click Red Hat JBoss Web Server.
  3. In the Software Downloads page, select the correct JBoss Web Server version from the Version drop-down menu.
  4. In the Download File table, click Download next to each of the following files:

    • The Red Hat JBoss Web Server 5.7 Application Server (jws-5.7.0-application-server.zip).
    • The Red Hat JBoss Web Server 5.7 Native Components for Windows Server (jws-5.7.0-application-server-<platform>-<architecture>.zip).

      Note

      Ensure that you select the correct file that matches the platform and architecture in your system.

  5. Unzip the downloaded archive files to your installation directory.

The top-level directory for JBoss Web Server is created when you extract the archive. This documentation refers to the top-level directory for JBoss Web Server as JWS_HOME.

4.3. JBoss Web Server configuration on Microsoft Windows

When you install JBoss Web Server on Microsoft Windows, you can manage JBoss Web Server from a command prompt or by using the Computer Management tool.

Before you can run JBoss Web Server on Microsoft Windows, you must perform the following series of configuration tasks:

4.3.1. Setting environment variables for JBoss Web Server on Microsoft Windows

Before you run JBoss Web Server for the first time on Microsoft Windows, you must set the JAVA_HOME, TMP, and TEMP environment variables. You must also update the PATH environment variable.

Prerequisites

Procedure

  1. Log in to an account with local administrator permissions.
  2. Click Control Panel > System.
  3. Click the Advanced tab.
  4. Click the Environment Variables button.
  5. Click the New button for System Variables.
  6. For JAVA_HOME, TMP, and TEMP, enter the appropriate name-value pairs for your system.
  7. To enable the SSL Connector to work successfully, add JWS_HOME\bin to the PATH environment variable of the user that the services will run under.

    Note

    The services run under the SYSTEM user by default.

4.3.2. Installing the Tomcat service on Microsoft Windows

Before you run JBoss Web Server for the first time on Microsoft Windows, you must install the Tomcat service.

Procedure

  1. Open a command prompt with administrator privileges and go to the bin folder for your Tomcat version:

    cd /D "JWS_HOME\tomcat\bin"
  2. Install the Tomcat service:

    call service.bat install

4.3.3. Configuring folder permissions for JBoss Web Server services on Microsoft Windows

Before you run JBoss Web Server for the first time on Microsoft Windows, you must configure folder permissions for JBoss Web Server services. Configuring folder permissions ensures that the account that is used to run the JBoss Web Server services has full control over the JWS_HOME folder and all of its subfolders.

Procedure

  1. Right-click the JWS_HOME folder and click Properties.
  2. Select the Security tab.
  3. Click the Edit button.
  4. Click the Add button.
  5. In the text box, enter LOCAL SERVICE.
  6. Select the Full Control check box for the LOCAL SERVICE account.
  7. Click OK.
  8. Click the Advanced button.
  9. Inside the Advanced Security Settings dialog, select LOCAL SERVICE and click Change permissions.
  10. Select the check box next to the Replace all child object permission entries with inheritable permission entries from this object option.
  11. Click OK through all the open folder property windows to apply the settings.

4.4. Starting JBoss Web Server on Microsoft Windows

When you install JBoss Web Server on Microsoft Windows, you can start the Tomcat service by using the Command Prompt or the Computer Management tool.

Prerequisites

Procedure

  • Perform either of the following steps:

    • Open the Command Prompt as an administrator and enter the following command:

      net start tomcat9
    • Click Start > Administrative Tools > Services, right-click the Tomcat9 service, and click Start.
Note

Some third-party applications add libraries to the system directory in Windows. These third-party libraries take precedence over Tomcat libraries during lookups. If the third-party libraries have the same name as the Tomcat native libraries, the system loads the third-party libraries rather than the libraries that are distributed with JBoss Web Server. In this situation, Tomcat might not start successfully, and Tomcat does not log any error messages in the Windows Event Log or the Tomcat log files.

If this behavior occurs, you can take the following steps:

  • To see errors, run the catalina.bat run command.
  • Inspect the contents of the C:\windows\System32\ directory and the other PATH directories.
  • Ensure that dynamic link libraries (DLLs) do not conflict with the JBoss Web Server libraries. In particular, look for the libeay32.dll, ssleay32.dll, and libssl32.dll libraries.

4.5. Stopping JBoss Web Server on Microsoft Windows

When you install JBoss Web Server on Microsoft Windows, you can stop the Tomcat service by using the Command Prompt or the Computer Management tool.

Procedure

  • Perform either of the following steps:

    • Open the Command Prompt as an administrator and enter the following command:

      net stop tomcat9
    • Go to Start > Administrative Tools > Services, right-click the Tomcat9 service, and click Stop.