Red Hat Training

A Red Hat training course is available for Red Hat JBoss Core Services

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

3.1. Download and Extract Apache HTTP Server

To install Apache HTTP Server, download and extract the installation ZIP files. Installation can be performed by non-root users if the user account has write access to the intended installation directory.

  1. Open a browser and log in to the Red Hat Customer Portal JBoss Software Downloads page.
  2. Select Apache HTTP Server in the Product drop-down menu.
  3. Select the correct JBoss Core Services version from the Version drop-down menu.
  4. Find Red Hat JBoss Core Services Apache HTTP Server in the list, ensuring that you select the correct platform and architecture for your system, and click the Download link.
  5. Extract the downloaded ZIP file to your installation directory.

    Note

    We recommend that you install Apache HTTP Server in the C:\Program Files directory.

The jbcs-httpd24-2.4 directory created by extracting the ZIP archive is the top-level directory for Apache HTTP Server. This is referred to in this documentation as HTTPD_HOME.

3.2. Configuring the Apache HTTP Server Installation

Some configuration is required before running JBoss Core Services Apache HTTP Server. This section includes the following configuration procedures:

Running the Apache HTTP Server Post-Installation Script

  1. At the Command Prompt as an administrative user, change to the HTTPD_HOME\etc directory.
  2. Run the following command:

    call postinstall.httpd.bat

Installing the Apache HTTP Server Service

Note

By default, Apache HTTP Server is configured to use port 80. If you have Microsoft IIS installed, ensure that you disable or reconfigure it 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 IIS ports.

  1. At the Command Prompt as an administrative user, change to the HTTPD_HOME\bin directory.
  2. Install the Apache HTTP Server service with the following command:

    httpd -k install

    A Firewall security dialog prompt may appear asking for networking access for Apache HTTP Server. Click Allow to access this service from the network.

Configuring Folder Permissions for the Apache HTTP Server Service

Follow this procedure to ensure that the account used to run the service has full control over the HTTPD_HOME folder and all of its subfolders:

  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.

Disabling/Enabling SSL Support

Apache HTTP Server supports SSL by default, but it can be disabled. Follow this procedure to disable or re-enable SSL support.

  1. Go to the HTTPD_HOME\conf.d\ directory and rename the SSL configuration file:

    1. To disable SSL, rename ssl.conf to ssl.conf.disabled.
    2. To re-enable SSL, rename ssl.conf.disabled to ssl.conf.

3.3. Starting Apache HTTP Server

You can start the Apache HTTP Server service from the Command Prompt, or with the Computer Management tool.

Starting Apache HTTP Server Using the Command Prompt

  1. At the Command Prompt as an administrative user, start the Apache HTTP Server service with the following command:

    net start Apache2.4

Starting Apache HTTP Server Using the Computer Management Tool

  1. Go to StartAdministrative ToolsServices.
  2. In the Services list, right-click the httpd service and click Start.

3.4. Stopping Apache HTTP Server

You can stop the Apache HTTP Server service from the Command Prompt, or with the Computer Management tool.

Stopping Apache HTTP Server Using the Command Prompt

  1. At the Command Prompt as an administrative user, stop the Apache HTTP Server service with the following command:

    net stop Apache2.4

Stopping Apache HTTP Server Using the Computer Management Tool

  1. Go to StartAdministrative ToolsServices.
  2. In the Services list, right-click the httpd service and click Stop.