| =head1 NAME |
| |
| INSTALL.win32 - Apache mod_perl installation instructions for Win32 |
| |
| =head1 DESCRIPTION |
| |
| How to build, test, configure and install mod_perl under Win32 |
| |
| =head1 PREREQUSITES |
| |
| =over 3 |
| |
| patience - mod_perl is considered alpha under NT and Windows95. |
| |
| MSVC++ 5.0+, Apache version 1.3-dev or higher and Perl 5.004_02 or higher. |
| |
| mod_perl will _not_ work with ActiveState's port, only with the "official" |
| Perl, available from: http://www.perl.com/CPAN/src/5.0/latest.tar.gz |
| |
| =back |
| |
| =head1 BUILDING |
| |
| =over 3 |
| |
| =item Binaries |
| |
| Jeffey Baker maintains the binary distribution of mod_perl available |
| from: |
| |
| http://www.perl.com/CPAN/authors/Jeffrey_Baker/ |
| |
| =item Setup the Perl side |
| |
| run 'perl Makefile.PL' |
| run 'nmake install' |
| |
| This will install the Perl side of mod_perl and setup files for the library build. |
| |
| =item Build ApacheModulePerl.dll |
| |
| Using MS developer studio, |
| select "File -> Open Workspace ...", |
| select "Files of type [Projects (*.dsp)]" |
| browse and open mod_perl-x.xx/src/modules/ApacheModulePerl/ApacheModulePerl.dsp |
| |
| =item Settings |
| |
| select "Tools -> Options -> [Directories]" |
| |
| select "Show directories for: [Include files]" |
| |
| You'll need to add the following paths: |
| C:\apache_x.xx\src\include |
| . (should be expanded to C:\...\mod_perl-x.xx\src\modules\perl for you) |
| C:\perl\lib\Core |
| |
| select "Project -> Add to Project -> Files" adding: |
| perl.lib (e.g. C:\perl\lib\Core\perl.lib) |
| ApacheCore.lib (e.g. C:\Apache\ApacheCore.lib) |
| |
| select "Build -> Set Active Configuration... -> [ApacheModulePerl - Win32 Release]" |
| |
| select "Build -> Build ApacheModulePerl.dll" |
| |
| You may see some harmless warnings, which can be reduced (along with |
| the size of the DLL), by setting: |
| |
| "Project -> Settings -> [C/C++] -> Category: [Code Generation] -> |
| Use runtime library: [Multithreaded DLL] |
| |
| =item Testing |
| |
| Once ApacheModulePerl.dll is built and apache.exe in installed you may |
| test mod_perl with: |
| |
| nmake test |
| |
| =item Apache setup |
| |
| You do not need to rebuild apache, just copy ApacheModulePerl.dll to |
| $SERVER_ROOT/modules |
| |
| =back |
| |
| =head1 CONFIGURATION |
| |
| Add this line to httpd.conf: |
| |
| LoadModule perl_module modules/ApacheModulePerl |
| |
| Be sure that 'C:\perl\bin' is in your path so apache can find perl.dll |
| |
| See the cgi_to_mod_perl.pod and mod_perl.pod documents for general |
| configuration. |
| |
| =head1 NOTES |
| |
| mod_perl-win32 is considered alpha, at the time of this writing, so is |
| Apache-NT (1.3a1) |
| |
| CGI::Switch does not work with apache_1.3a1 because basic_http_header() |
| is not exported by the ApacheCore.dll For now, just change: |
| |
| use CGI::Switch (); |
| my $q = CGI::Switch->new; |
| |
| - to - |
| |
| use CGI (); |
| my $q = CGI->new; |
| |