Editing Non-root proxy (section)

===Now we can start installing software.===
====Apache====
Install a base Apache (previously downloaded into ~/distributions):
<pre>

%> cd ~/distributions/
%> tar xvf httpd-2.2.x.tar
%> cd httpd_2.2.x

</pre>
If you are returning to an existing source-tree, rather than a brand new untar'd bundle, clear any previous setup:
<pre>

%> make distclean

</pre>
Now configure and install an initial Apache server:</p>
<pre>

%> ./configure --prefix=/home/MyUser/www --disable-userdir --disable-status
%> make
%> make install

</pre>

Edit http.conf (essentially, the port the server is listening on) and start the web server.  Check the error log:

<pre>

%> cat ~/www/logs/error_log
[...] Apache/2.2.x (Unix) Configured -- resuming normal operations

</pre>

====Mod-Perl====
Stop web server and install the Mod-Perl extensions (previously downloaded into ~/distributions):
<pre>

%> cd ~/distributions/
%> tar xvf mod_perl-2.0-current.tar
%> cd mod_perl-2.0.x

</pre>

If you are returning to an existing source-tree, rather than a brand new untar'd bundle, clear any previous setup:
<pre>

%> make clean 

</pre>
Now configure and install mod-perl into the Apache tree, and (re)install Apache. In this example, I am specifying a version of Perl to use:
<pre>

%> /path/to/specific/perl Makefile.PL PREFIX="/home/MyUser/perl5" MP_USE_DSO=1 \
   MP_APXS="/home/MyUser/www/bin/apxs" \
   MP_AP_CONFIGURE="--prefix=/home/MyUser/www --disable-userdir \
   --disable-status --enable-module=mod_perl"
%> make
%> make install

</pre>
NOTE: To install under Debian/Ubuntu, you will need the <code>libperl-dev</code> package installed

NOTE: Notice that there is a PREFIX defined, which matches the prefix in the CPAN configuration; that we are stating we want mod-perl as a DSO; the full path to the previously installed Apache "apxs" command; and that the configure parameters to be passed to the apache rebuild include enabling mod-perl

=====Editing the new apache config file=====
We need to enable the mod-perl module, which I do using one of the Includes:
*  In ~/www/conf/httpd.conf, add:
<pre>

# Mod-Perl
Include conf/extra/httpd-perl.conf

</pre>

* Create ~/www/conf/extra/httpd-perl.conf:
<pre>

#
# Load the Mod_perl DSO.
#
LoadModule perl_module modules/mod_perl.so
PerlSwitches -I/home/MyUser/perl5/lib/perl5/site_perl/5.x.y/sun4-solaris/ \
             -I/home/MyUser/perl5/lib/perl5/5.x.y/sun4-solaris \
             -I/home/MyUser/perl5/lib/perl5/5.x.y \
             -I/home/MyUser/perl5/lib/perl5/site_perl/5.x.y/sun4-solaris \
             -I/home/MyUser/perl5/lib/perl5/site_perl/5.x.y \
             -I/home/MyUser/perl5/lib/perl5/site_perl

</pre>

* NOTE: the "PerlSwitches" line tells the Apache server where to look for extra libraries, and matches the PERL5LIB environment variable set earlier.</dd>

Start the web server.  Check the error log:

<pre>

%> cat ~/www/logs/error_log
[...] Apache/2.2.x (Unix) Configured -- resuming normal operations
[...] caught SIGTERM, shutting down
[...] Apache/2.2.x (Unix) mod_perl/2.0.x Perl/v5.x.y configured -- resuming normal operations

</pre>

Stop the web server again.
----