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.
You can install the archive file with non-root privileges, provided that you have write access to the intended installation folder.
Prerequisites
- Open a browser and log in to the Software Downloads page on the Red Hat Customer Portal.
- From the Product drop-down menu, select Apache HTTP Server.
- From the Version drop-down menu, select the correct JBoss Core Services version.
- 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.
Extract the downloaded archive file to your installation directory.
NoteOn 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 thejbcs-httpd24-2.4
directory asHTTPD_HOME
.To install the latest service pack release, perform the following steps:
- On the Software Downloads page, click the Security Advisories tab.
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.
NoteService 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
- Open the Command Prompt as an administrative user.
-
Go to the
HTTPD_HOME\etc
directory. 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.
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 theStartup Type
toManual
. - 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.
Prerequisites
Procedure
- Open the Command Prompt as an administrative user.
-
Go to the
HTTPD_HOME\bin
directory. To install the Apache HTTP Server service, enter the following command:
httpd -k install
NoteA 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.
Prerequisites
- You have installed the Apache HTTP Server service.
Procedure
-
Right-click the
HTTPD_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.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.
Prerequisites
Procedure
-
Go to the
HTTPD_HOME\conf.d\
directory. To enable or disable SSL, perform either of the following steps:
-
If you want to disable SSL, rename
ssl.conf
tossl.conf.disabled
. -
If you want to re-enable SSL, rename
ssl.conf.disabled
tossl.conf
.
-
If you want to disable SSL, rename
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
- You have configured the Apache HTTP Server.
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
- You have started the Apache HTTP Server.
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.