These four parameters are tightly interconnected, as they control the
way in which the Apache source is handled.
Typically, when you want mod_perl to be compiled statically with
Apache without adding any extra components, you specify the location
of the Apache source tree using the APACHE_SRC
parameter and use the DO_HTTPD=1 parameter to tell
the installation script to build the httpd
panic% perl Makefile.PL APACHE_SRC=../apache_1.3.xx/src DO_HTTPD=1
If no APACHE_SRC is specified,
Makefile.PL makes an intelligent guess by
looking at the directories at the same level as the mod_perl sources
and suggesting a directory with the highest version of Apache found
By default, the configuration process will ask you to confirm whether
the location of the source tree is correct before continuing. If you
use DO_HTTPD=1 or NO_HTTPD=1,
the first Apache source tree found or the one you specified will be
used for the rest of the build process.
If you don't use DO_HTTPD=1, you
will be prompted by the following question:
Shall I build httpd in ../apache_1.3.xx/src for you?
Note that if you set DO_HTTPD=1 but do not use
APACHE_SRC=../apache_1.3.xx/src, the first Apache
source tree found will be used to configure and build against.
Therefore, you should always use an explicit
APACHE_SRC parameter, to avoid confusion.
If you don't want to build the
httpd in the Apache source tree because you
might need to add extra third-party modules, you should use
NO_HTTPD=1 instead of
DO_HTTPD=1. This option will install all the files
that are needed to build mod_perl in the Apache source tree, but it
will not build httpd itself.
PREP_HTTPD=1 is similar to
NO_HTTPD=1, but if you set this parameter you will
be asked to confirm the location of the Apache source directory even
if you have specified the APACHE_SRC parameter.
If you choose not to build the binary, you will have to do that
manually. Building an httpd binary is covered in
an upcoming section. In any case, you will need to run make
install in the mod_perl source tree so the Perl side of
mod_perl will be installed. Note that mod_perl's
make test won't work until you
have built the server.