This is a binary distribution for Win32 of Perl 5.8.0 and Apache 2.0.45, together with mod_perl-1.99, mod_ssl / OpenSSL (0.9.7b), and php-4.3.2, all built with VC++ 6.0 (SP5). Also included are some popular non-core module packages such libnet, libwww-perl, Tk, and DBI. Perl was built using the sources of build 806 provided by ActiveState. A brief synopsis of the installation, for the most part carried out in tk-config.bat under Perl/bin, is: - Edit Perl\lib\Config.pm and Perl\site\lib\ppm.xml to reflect the installed location of the Perl subdirectory. - Edit Apache2\conf\httpd.conf, Apache2\conf\ssl.conf, and Apache2\conf\perl.conf to reflect the installed location of the Apache2 subdirectory. - add the paths to your installed Perl\bin and Apache2\bin to your PATH environment variable. Also, for certain purposes it is convenient to set the following environment variables: HOME=C:\, TERM=dumb, NAME=your_name_without_spaces, and DOMAIN=whatever. - edit Apache2\conf\httpd.conf to set the desired server directives and then give the command, in C:\Apache2\bin, Apache.exe -n Apache2 -k install Apache.exe -n Apache2 -k start to install the Apache2 service and to start the web server. If you want to enable SSL, add "-D SSL" to these arguments. - in the Perl\bin subdirectory, run make_html.bat to build the Perl html documentation. - if you use CPAN.pm to add 3rd party modules, you can reconfigure this to reflect local details by giving the command C:\> perl -MCPAN -e shell cpan> o conf init - The certificates found in the Apache2\conf subdirectory and as used in the example httpd.conf file are for demonstration purposes only; how to generate real certificates is described in the mod_ssl documentation. There are several example cgi scripts provided under Apache2\cgi-bin (from the CGI.pm distribution), together with the necessary directives to run them under http://localhost/cgi-bin/. If Perl was installed to something other than C:\Perl, then the first line of these scripts (the shebang line) has to be changed to point to the perl binary. There are also some mod_perl related directives given in httpd.conf: - ModPerl::Registry scripts to run under http://localhost/perl/ - a simple custom Apache module, accessed as http://localhost/hello, which prints out a standard "Hello, world" message. The module used to do this is at Perl\site\lib\Apache2\Apache\Hello.pm. - a sample HTML::Mason script at http://localhost/mason/printenv.html - a sample Apache::ASP script at http://localhost/asp/printenv.html - a sample Template::Toolkit script at http://localhost/tt2/printenv.html Information on many of these packages are included, with links available through the Start Menu shortcuts associated with the "Perl Apache2 binary". Information on the web is available at http://perl.apache.org/ mod_perl http://take23.org/ mod_perl http://httpd.apache.org/ Apache http://www.cpan.org/ CPAN http://www.perl.com/ Perl http://www.activestate.com/ Win32 perl http://www.modssl.org/ mod_ssl http://www.openssl.org/ OpenSSL http://www.php.net/ php The mod_perl, mod_ssl, OpenSSL, and ActiveState sites also contain instructions for subscribing to various mailing lists. Various newsgroups, searchable at http://groups.google.com/, are also available. Please note that the Perl, Apache, and openssl packages included here might not be compatible with other binaries of these packages compiled with a different compiler, version, or compile-time options. Randy Kobes April 29, 2003