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 link:http://access.redhat.com{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.
This procedure describes how to install the Oracle JDK.
Procedure
To access the Oracle website, open a browser window and enter the following URL:
http://www.oracle.com/technetwork/java/javase/downloads/index.html
- Download the Oracle JDK for your operating system and architecture.
- Double-click the downloaded file to start the installation.
- Proceed as instructed in the installation window.
Additional resources
- For information about installing the IBM JDK, see the IBM developer kits web page.
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.
Prerequisites
Procedure
- Open a browser and log in to the Red Hat Product Downloads page.
- In the Product Downloads list, click Red Hat JBoss Web Server.
- In the Software Downloads page, select the correct JBoss Web Server version from the Version drop-down menu.
In the Download File table, click Download next to each of the following files:
-
The Red Hat JBoss Web Server 5.6 Application Server (
jws-5.6.0-application-server.zip
). The Red Hat JBoss Web Server 5.6 Native Components for Windows Server (
jws-5.6.0-application-server-<platform>-<architecture>.zip
).NoteEnsure that you select the correct file that matches the platform and architecture in your system.
-
The Red Hat JBoss Web Server 5.6 Application Server (
- 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
- You have installed JBoss Web Server.
Procedure
- Log in to an account with local administrator permissions.
- Click Control Panel > System.
- Click the Advanced tab.
- Click the Environment Variables button.
- Click the New button for System Variables.
-
For
JAVA_HOME
,TMP
, andTEMP
, enter the appropriate name-value pairs for your system. To enable the SSL Connector to work successfully, add
JWS_HOME\bin
to thePATH
environment variable of the user that the services will run under.NoteThe 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.
Prerequisites
Procedure
Open a command prompt with administrator privileges and go to the
bin
folder for your Tomcat version:cd /D "JWS_HOME\tomcat\bin"
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.
Prerequisites
Procedure
-
Right-click the
JWS_HOME
folder and click Properties. - Select the Security tab.
- Click the Edit button.
- Click the Add button.
-
In the text box, enter
LOCAL SERVICE
. -
Select the Full Control check box for the
LOCAL SERVICE
account. - Click OK.
- Click the Advanced button.
-
Inside the Advanced Security Settings dialog, select
LOCAL SERVICE
and click Edit. - Select the check box next to the Replace all existing inheritable permissions on all descendants with inheritable permissions from this object option.
- 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
- You have configured JBoss Web Server.
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.
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 otherPATH
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
, andlibssl32.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.
Prerequisites
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.