Chapter 4. Installing the JBoss Core Services Apache HTTP Server on Microsoft Windows

You can install the JBoss Core Services Apache HTTP Server on Microsoft Windows from a set of archive files that you can download from the Software Downloads page on the Red Hat Customer portal.

4.1. Downloading and extracting the Apache HTTP Server archive file on Microsoft Windows

You can download the Apache HTTP Server archive files from the Software Downloads page on the Red Hat Customer Portal. You must download the archive file for the original JBoss Core Services Apache HTTP Server 2.4.37 release from the Releases tab on the Software Downloads page. You can also download the latest service pack release, if any, from the Security Advisories tab on the Software Downloads page.

Note

You can install the archive file with non-root privileges, provided that you have write access to the intended installation folder.

Prerequisites

  1. Open a browser and log in to the Software Downloads page on the Red Hat Customer Portal.
  2. From the Product drop-down menu, select Apache HTTP Server.
  3. From the Version drop-down menu, select the correct JBoss Core Services version.
  4. On the Releases tab, click Download next to the Red Hat JBoss Core Services Apache HTTP Server archive file that matches the platform and architecture for your system.
  5. Extract the downloaded archive file to your installation directory.

    Note

    On Microsoft Windows systems, install the Apache HTTP Server in the C:\Program Files directory.

    The jbcs-httpd24-2.4 directory is created when you extract the archive. This directory is the top-level directory for the Apache HTTP Server. This document refers to the jbcs-httpd24-2.4 directory as HTTPD_HOME.

  6. To install the latest service pack release, perform the following steps:

    1. On the Software Downloads page, click the Security Advisories tab.
    2. On the Security Advisories tab, click Download next to the latest Red Hat JBoss Core Services Apache HTTP Server Patch archive file that matches the platform and architecture for your system.

      For example, if you want to install the Service Pack 10 release of the Apache HTTP Server 2.4.37 on Microsoft Windows, click Download next to the Red Hat JBoss Core Services Apache HTTP Server 2.4.37 Patch 10 for Windows Server x86_64 file.

      Note

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

4.2. Apache HTTP Server configuration on Microsoft Windows

When you install JBoss Core Services Apache HTTP Server on Microsoft Windows, you can manage the Apache HTTP Server from a command prompt or by using the Computer Management tool. Before you can run the Apache HTTP Server on Microsoft Windows, you must perform the following series of configuration tasks:

4.2.1. Running the Apache HTTP Server post-installation script on Microsoft Windows

Before you run the Apache HTTP Server for the first time on Microsoft Windows, you must run the Apache HTTP Server post-installation script.

Procedure

  1. Open the Command Prompt as an administrative user.
  2. Go to the HTTPD_HOME\etc directory.
  3. Enter the following command:

    call postinstall.httpd.bat

4.2.2. Installing the Apache HTTP Server service

Before you run the Apache HTTP Server for the first time on Microsoft Windows, you must install the Apache HTTP Server as a Windows service.

Note

By default, the Apache HTTP Server is configured to use port 80. If you have Microsoft Internet Information Services (IIS) installed, you must disable or reconfigure Microsoft IIS to avoid port conflicts:

  • Stop the World Wide Web service, and change the Startup Type to Manual.
  • Configure IIS to use different ports.

Alternatively, you can edit httpd.conf before installing the Apache HTTP Server service and change Listen to a port that does not conflict with the Microsoft IIS ports.

Procedure

  1. Open the Command Prompt as an administrative user.
  2. Go to the HTTPD_HOME\bin directory.
  3. To install the Apache HTTP Server service, enter the following command:

    httpd -k install
    Note

    A firewall security dialog might be displayed to request networking access for the Apache HTTP Server. Click Allow to access this service from the network.

4.2.3. Configuring folder permissions for the Apache HTTP Server service

Before you run the Apache HTTP Server for the first time on Microsoft Windows, you must ensure that the account used to run the service has full control over the HTTPD_HOME folder and all of its subfolders.

Procedure

  1. Right-click the HTTPD_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 Edit.
  10. Select the check box next to the Replace all existing inheritable permissions on all descendants with inheritable permissions from this object option.
  11. Click OK through all the open folder property windows to apply the settings.

4.2.4. Disabling or enabling SSL support

Before you run the Apache HTTP Server, you can choose to disable or enable SSL support by renaming the SSL configuration file. The Apache HTTP Server supports SSL by default.

Procedure

  1. Go to the HTTPD_HOME\conf.d\ directory.
  2. To enable or disable SSL, perform either of the following steps:

    • If you want to disable SSL, rename ssl.conf to ssl.conf.disabled.
    • If you want to re-enable SSL, rename ssl.conf.disabled to ssl.conf.

4.3. Starting the Apache HTTP Server on Microsoft Windows

When you install JBoss Core Services Apache HTTP Server on Microsoft Windows, you can start the Apache HTTP Server 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 Apache2.4
    • Click Start > Administrative Tools > Services, right-click the httpd service, and click Start.

4.4. Stopping the Apache HTTP Server on Microsoft Windows

When you install JBoss Core Services Apache HTTP Server on Microsoft Windows, you can stop the Apache HTTP Server 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 Apache2.4
    • Click Start > Administrative Tools > Services, right-click the httpd service, and click Stop.