Recompiling Stronghold on Cross-Platform Systems

This chapter describes how to recompile Stronghold on systems other than Red Hat Linux. Recompiling Stronghold on Red Hat Linux Advanced Server systems is not required. If you want to change a module, you need only to edit the httpd.conf file. If you want to compile a third-party module, compile it according to the instructions in its documentation.

The Configuration file (ServerRoot/src/apace-1.3/Configuration) already contains the code you need to install any module that comes with Stronghold, including the optional modules described later in this chapter. The precompiled modules are compiled into Stronghold when you first install it. Optional modules are commented out of the Configuration file. By uncommenting a line of module code, you can recompile the server to include that module. Commenting out a line of module code and recompiling the server excludes the module.

The order of the module list in the Configuration file affects how the modules are compiled. In general, use these guidelines for dealing with the module list:

Do not change the order of the module list unless you are sure you know what you are doing.
If you add third-party modules to the list, place them at the bottom of the list, but above mod_ssl.
Always remove a module by commenting it out rather than deleting it, so that you do not lose its place in the list. Many third-party modules have not been thoroughly tested for use with Stronghold 4.0 and Apache 1.3.22.
If you have an existing server with third-party modules that you wish to compile into Stronghold 4.0, do so with caution.

To Edit, Configure, and Recompile Stronghold

Switch to the ServerRoot/src/apache-1.3 directory:
```
   # cd ServerRoot/src
```
Edit the Configuration file to reflect which modules or patches you want:
- To add an existing module, uncomment the module code line by removing the opening hash mark (#).
- To add a new module, place it at the end of the module list using the following syntax:
```
   AddModule modules/directory/object.o
```
  Always use a path relative to: ServerRoot/src/apache-1.3
- To remove a module, comment it out by adding a hash mark to the beginning of the module code line.
Save the modified Configuration file.
To add a patch, use the patch utility to specify the patch you want to install:
```
   # patch -s < patchfile
```
Run Configure:
```
   # ./Configure
```
Rebuild httpd:
```
   # make
```
Stop the server:
```
   # ../bin/stop-server
```
Install the new binaries:
```
   # make install
```
Start the server:
```
   # ../bin/start-server
```

Creating an httpd Binary Without mod_perl

On cross-platform systems you can use bin/httpd or bin/httpd-without-perl to get an httpd binary with or without mod_perl statically linked in. To do this, edit the file bin/start-server, and change the line that says:

   | if bin/httpd -d ServerRoot -f conf/httpd.conf ; then

to read as follows:

   | if bin/httpd-without-perl -d ServerRoot -f conf/httpd.conf ; then