Chapter 4. Installing the JBCS Apache HTTP Server on Windows Server
You can install the JBCS Apache HTTP Server on Windows Server 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 Windows Server
You can download the Apache HTTP Server archive files from the Software Downloads page on the Red Hat Customer portal. You can download the archive file for the base JBCS Apache HTTP Server 2.4.57 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.
If you have write access to the intended installation folder, you can install the archive file with non-administrator privileges.
Procedure
- 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 JBCS version.
-
On the Releases tab, click Download next to the
Red Hat JBoss Core Services Apache HTTP Server 2.4.57 for Windows Server x86_64
file. Extract the downloaded archive file to your installation directory.
NoteOn Windows Server systems, install the Apache HTTP Server in the
C:\Program Files
directory.The extraction of the archive file automatically creates the top-level
jbcs-httpd24-2.4
folder for the Apache HTTP Server. This document refers to thejbcs-httpd24-2.4
folder asHTTPD_HOME
.To install the latest service pack release, if any, 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 2.4.57 Patch X 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 Windows Server
When you install JBCS Apache HTTP Server on Windows Server, 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 Windows Server, you must perform the following series of configuration tasks:
4.2.1. Running the Apache HTTP Server post-installation script on Windows Server
Before you run the Apache HTTP Server for the first time on Windows Server, 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 Windows Server, 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 Windows Server, 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 Windows Server
When you install JBCS Apache HTTP Server on Windows Server, 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 Windows Server
When you install JBCS Apache HTTP Server on Windows Server, 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.