This is a binary distribution for Win32 of Perl 5.8.4 and Apache 2.0.50, together with mod_perl-1.99, mod_ssl / OpenSSL (0.9.7d), and php-4.3.7, 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 for build 810 provided by ActiveState. A brief synopsis of the installation, for the most part carried out by 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 Apache subdirectory. - add the paths to your installed Perl\bin and Apache2 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 conf\httpd.conf in Apache2 to set the desired server directives and then give the command, in the Apache subdirectory, 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 conf subdirectory of Apache2 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 D:\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/template/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 http://www.apache-asp.org/ Apache::ASP http://perl.apache.org/embperl/ Embperl http://www.masonhq.com/ HTML::Mason http://www.template-toolkit.org/ Template::Toolkit http://www.mysql.com/ MySQL 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. In order to use the Perl module Image::Magick the Win32 ImageMagick binary package from http://www.imagemagick.net/ must be installed. Similarly, the Win32 MySQL binary package from http://www.mysql.com/ must be installed in order to use DBD::mysql. 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 July 13, 2004