이 콘텐츠는 선택한 언어로 제공되지 않습니다.

Chapter 4. Installing JBoss Web Server on Windows Server


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

4.1. Installing a JDK on Windows Server

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

You can download and install the JDK from a supported vendor website, such as Oracle. 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.

4.2. Downloading and extracting archive files for a base release of JBoss Web Server

A base release is the initial release of a specific product version (for example, 6.1.0 is the base release of version 6.1). You can download the JBoss Web Server archive files from the Software Downloads page on the Red Hat Customer Portal.

Procedure

  1. Open a browser and log in to the Red Hat Customer Portal.
  2. Click the Downloads tab.
  3. From the Product Downloads list, select Red Hat JBoss Web Server.
  4. On the Software Downloads page, from the Version drop-down list, select the appropriate JBoss Web Server version.
  5. Click Download next to the Red Hat JBoss Web Server 6.1.0 Application Server file.

    The downloaded file is named jws-6.1.0-application-server.zip on your local host.

  6. If you also want to download the native JBoss Web Server components for your operating system, click Download next to the Red Hat JBoss Web Server 6.1.0 Optional Native Components for Windows x86_64 file.

    The downloaded file is named jws-6.1.0-optional-native-components-win6-x86_64.zip.

  7. Extract the downloaded archive files to your installation folder.

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

4.3. Downloading and extracting archive files for JBoss Web Server patch updates

If product patch updates are available for the appropriate JBoss Web Server version, you can install the archive files for the latest cumulative patches. You can download the JBoss Web Server archive files from the Software Downloads page on the Red Hat Customer Portal.

Important

You cannot use cumulative patch updates to install the base (X.X.0) release of a product version. For example, the installation of a 6.1.2 patch would install the 6.1.1 and 6.1.2 releases but cannot install the base 6.1.0 release.

Service pack releases are cumulative. By downloading the latest service pack release, you also install any previous service pack releases automatically.

Procedure

  1. Open a browser and log in to the Red Hat Customer Portal.
  2. Click the Downloads tab.
  3. From the Product Downloads list, select Red Hat JBoss Web Server.
  4. On the Software Downloads page, from the Version drop-down list, select the appropriate JBoss Web Server version.
  5. Click the Patches tab.
  6. Click Download next to the latest Red Hat JBoss Web Server 6.1 Update XX Application Server file.

    The downloaded file is named jws-6.1.x-application-server.zip on your local host.

  7. If you also want to download the native JBoss Web Server components for your operating system, click Download next to the latest Red Hat JBoss Web Server 6.1 Update XX Optional Native Components for Windows x86_64 file.

    The downloaded file is named jws-6.1.x-optional-native-components-win6-x86_64.zip.

  8. Extract the downloaded archive files to your installation folder.

4.4. JBoss Web Server configuration on Windows Server

When you install JBoss Web Server on Windows Server, 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 Windows Server, you must perform the following series of configuration tasks:

4.4.1. Setting environment variables for JBoss Web Server on Windows Server

Before you run JBoss Web Server for the first time on Windows Server, 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.4.2. Installing the Tomcat service on Windows Server

Before you run JBoss Web Server for the first time on Windows Server, 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:

    Copy to Clipboard Toggle word wrap
    cd /D "JWS_HOME\tomcat\bin"
  2. Install the Tomcat service:

    Copy to Clipboard Toggle word wrap
    call service.bat install

4.4.3. Configuring folder permissions for JBoss Web Server services on Windows Server

Before you run JBoss Web Server for the first time on Windows Server, 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.5. Starting JBoss Web Server on Windows Server

When you install JBoss Web Server on Windows Server, 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:

      Copy to Clipboard Toggle word wrap
      net start tomcat10
    • Click Start > Administrative Tools > Services, right-click the Tomcat10 service, and click Start.
Note

Some third-party applications add libraries to the system directory in Windows Server. 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 Server 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.6. Stopping JBoss Web Server on Windows Server

When you install JBoss Web Server on Windows Server, 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:

      Copy to Clipboard Toggle word wrap
      net stop tomcat10
    • Go to Start > Administrative Tools > Services, right-click the Tomcat10 service, and click Stop.
맨 위로 이동
Red Hat logoGithubredditYoutubeTwitter

자세한 정보

평가판, 구매 및 판매

커뮤니티

Red Hat 문서 정보

Red Hat을 사용하는 고객은 신뢰할 수 있는 콘텐츠가 포함된 제품과 서비스를 통해 혁신하고 목표를 달성할 수 있습니다. 최신 업데이트를 확인하세요.

보다 포괄적 수용을 위한 오픈 소스 용어 교체

Red Hat은 코드, 문서, 웹 속성에서 문제가 있는 언어를 교체하기 위해 최선을 다하고 있습니다. 자세한 내용은 다음을 참조하세요.Red Hat 블로그.

Red Hat 소개

Red Hat은 기업이 핵심 데이터 센터에서 네트워크 에지에 이르기까지 플랫폼과 환경 전반에서 더 쉽게 작업할 수 있도록 강화된 솔루션을 제공합니다.

Theme

© 2025 Red Hat, Inc.