randyk 2002/12/31 11:24:26 Modified: src/docs/1.0/guide getwet.pod install.pod src/docs/1.0/os/win32 install.pod multithread.pod src/docs/2.0/os/win32 install.pod Log: - avoid duplicating cvs info in win32 pages - use perl.apache.org links to source distributions - make links in guide to win32 binary distributions Revision Changes Path 1.9 +29 -79 modperl-docs/src/docs/1.0/guide/getwet.pod Index: getwet.pod =================================================================== RCS file: /home/cvs/modperl-docs/src/docs/1.0/guide/getwet.pod,v retrieving revision 1.8 retrieving revision 1.9 diff -u -r1.8 -r1.9 --- getwet.pod 17 Sep 2002 17:13:23 -0000 1.8 +++ getwet.pod 31 Dec 2002 19:24:25 -0000 1.9 @@ -369,18 +369,25 @@ =head1 Installing mod_perl for Windows Apache runs on many flavors of Unix and Unix-like operating systems. -Version 1.3 introduced a port to the Windows familiy of operating +Version 1.3 introduced a port to the Windows family of operating systems, often named C<Win32> after the name of the common API. Because of many deep differences between Unix and Windows, the Win32 port of Apache is still branded as beta quality, because it hasn't yet reached the stability and performance of the native Unix counterpart. -Another hindrance to using mod_perl on Windows is that current +Another hindrance to using mod_perl 1.0 on Windows is that current versions of Perl are not thread-safe on Win32. As a consequence, mod_perl calls to the embedded Perl interpreter must be serialized, -i.e. executed one at a time. For these reasons, we recommend that -mod_perl on Windows be used only for testing purposes, not in -production. +i.e. executed one at a time. See the discussion on +L<multithreading on Win32 +mod_perl 1.xx|docs::1.0::os::win32::multithread> +for details. This situation changes with Apache/mod_perl 2.0, +which is based on a +multi-process/multi-thread approach using a native Win32 threads +implementation - see the L<mod_perl 2 +overview|docs::2.0::user::intro::overview> for more details, +and the discussion of L<modperl 2.0 in Win32|docs::2.0::os::win32::install> +on getting modperl-2 for Win32 in particular. Building mod_perl from source on Windows is a bit of a challenge. Development tools such as a C compiler are not bundled with the @@ -388,80 +395,23 @@ as with most Windows software. Additionally, all software packages need to be built with the same compiler and compile options. This means building Perl, Apache, and mod_perl from source, quite a -daunting task. - -Fortunately, Randy Kobes maintains a Windows distribution of mod_perl -which includes all the necessary tools, including Perl, Apache, and a -host of useful CPAN modules. Using this distribution provides an -out-of-the-box Apache+mod_perl combo in minutes. - -The distribution comes with extensive documentation. Take the time to -read it, particularly if you wish to install the software in a -location different from the default. In the following installation -we'll use the default locations and options. - -=head2 Download the Windows distribution - -Download C<perl-win32-bin-x.x.exe> from the L<binary distributions -page|download::binaries>. This is a self-extracting archive, yielding -four directories: - - Apache - Perl - openssl - readmes - - -=head2 Install the software - -Move the C<Apache> and C<Perl> directories to C<C:\>. Edit -C<C:\AUTOEXEC.BAT> to install the Perl executable directories in your -system's search path: - - SET PATH=C:\Perl\5.6.1\bin;C:\Perl\5.6.1\bin\MSWin32-x86;"%PATH%" - -Then restart Windows for this change to take effect. - - -=head2 Test the Perl installation - -Open a DOS prompt window and verify that Perl is installed correctly -and learn the version number: - - C:\> perl -v - - This is perl, v5.6.1 built for MSWin32-x86 - - Copyright 1987-2000, Larry Wall - - -=head2 Start Apache - -The distribution comes with a ready-made configuration file for -mod_perl which we'll use to start Apache. From the C<C:\Apache> -directory, start Apache: - - C:\Apache> apache.exe - -Now issuing a request for I<http://localhost/> displays the usual -Apache C<It Worked> page. - -=head2 Test mod_perl - -The distribution comes with a pre-configured mod_perl handler and -C<Apache::Registry> directory. We can test our mod_perl enabled server -by issuing the following requests: - - http://localhost/hello - http://localhost/mod_perl/printenv - -We now have a fully-functional mod_perl server. The example scripts -described in the rest of this chapter can be used with minor -modifications to file paths and URIs. In particular, change all -instances of I</home/stas> with C<C:\Apache\>, and change all -instances of I<http://localhost/perl> with -I<http://localhost/mod_perl>. - +daunting task. For details on building mod_perl on Windows, +see the documentation +for L<modperl 1.0 in Win32|docs::1.0::os::win32::install> +or L<modperl 2.0 in Win32|docs::2.0::os::win32::install>. + +For those who prefer binary distributions, there are a +number of alternatives. For mod_perl 1.0, one can obtain either +L<mod_perl 1.0 PPM packages|docs::1.0::os::win32::install/PPM_Packages>, +suitable for use with ActivePerl's C<ppm> utility, +or else L<mod_perl 1.0 all-in-one +packages|docs::1.0::os::win32::install/All_in_one_packages> +containing binaries of Perl and Apache, including mod_perl. +For mod_perl 2.0, similar +L<mod_perl 2.0 PPM packages|docs::2.0::os::win32::install/PPM_Packages> +and L<mod_perl 2.0 all-in-one +packages|docs::2.0::os::win32::install/All_in_one_packages> +are available. =head1 Preparing the Scripts Directory 1.18 +3 -1 modperl-docs/src/docs/1.0/guide/install.pod Index: install.pod =================================================================== RCS file: /home/cvs/modperl-docs/src/docs/1.0/guide/install.pod,v retrieving revision 1.17 retrieving revision 1.18 diff -u -r1.17 -r1.18 --- install.pod 31 Jul 2002 09:30:07 -0000 1.17 +++ install.pod 31 Dec 2002 19:24:25 -0000 1.18 @@ -64,7 +64,9 @@ In this chapter we will talk extensively about the prepackaged versions, and ways to prepare your own packages for reuse on many -machines. +machines. Win32 users should consult the +L<Win32 documentation|docs::1.0::os::win32::install> for details on +that platform. =head1 The Gory Details 1.17 +18 -18 modperl-docs/src/docs/1.0/os/win32/install.pod Index: install.pod =================================================================== RCS file: /home/cvs/modperl-docs/src/docs/1.0/os/win32/install.pod,v retrieving revision 1.16 retrieving revision 1.17 diff -u -r1.16 -r1.17 --- install.pod 28 Dec 2002 20:35:27 -0000 1.16 +++ install.pod 31 Dec 2002 19:24:25 -0000 1.17 @@ -73,9 +73,10 @@ =back -Obtain the mod_perl sources (F<mod_perl-1.xx.tar.gz>) from CPAN -under L<http://www.cpan.org/authors/id/D/DO/DOUGM/>. -When unpacked, using Winzip or similar tools, a subdirectory +First obtain the +L<mod_perl 1.0 sources|download::source/Stable_Source_Distribution> +as a C<tar.gz> file - +when unpacked, using Winzip or similar tools, a subdirectory F<mod_perl-1.xx> will be created. There are two ways to build mod_perl - with MS Developer Studio, @@ -204,15 +205,11 @@ through the Apache::src module. If this build fails, you may want to try the sources obtained -from cvs (you may also want to use the Apache cvs sources). -To do this, first obtain a Win32 cvs client from, for example, -L<http://www.cvshome.org/>. The cvs sources may be obtained as - - C:\src> cvs -d :pserver:[EMAIL PROTECTED]:/home/cvspublic login - C:\src> cvs -d :pserver:[EMAIL PROTECTED]:/home/cvspublic co apache-1.3 - C:\src> cvs -d :pserver:[EMAIL PROTECTED]:/home/cvspublic co modperl - -The build then proceeds as above. Be aware, though, +from cvs you may want to try the sources obtained +from cvs - see the discussion on the +L<Development Source Distribution|download::source/Development_Source_Distribution> +for details. +Be aware, though, that as well as providing bug fixes, there may be new features being added and tested in the cvs versions, so at any given time there are no guarantees that these packages will build and test successfully. @@ -238,19 +235,22 @@ these also include an ActiveState-compatible C<ppm> (Perl Package Manager) utility for adding and upgrading modules. -For the adventuresome who want a taste of things to come, a -mod_perl-2.0/Apache-2.0 binary distribution based on cvs -sources is available - see the discussion of +For the adventuresome who want a taste of things to come, +or for those who want to avoid the +L<multithreading limitations of mod_perl +1.0|docs::1.0::os::win32::multithread>, a +mod_perl-2.0/Apache-2.0 binary distribution +is available - see the discussion of L<modperl-2 on Win32|docs::2.0::os::win32::install> -for details. Be aware though that, being a pre-release version, -bugs are most likely present. +for details. Be aware though that mod_perl 2.0 is +still in a development phase. =head2 PPM Packages For users of ActivePerl builds 6xx I<only>, obtainable from L<http://www.activestate.com/>, there are also C<PPM> mod_perl packages available (as discussed -in the introduction, no C<ppm> mod_perl-1 ppm packages for +in the introduction, no C<ppm> mod_perl 1.0 ppm packages for ActivePerl builds 8xx are presently available). For this, if you don't already have it, get and install the latest Win32 Apache binary from L<http://httpd.apache.org/>. 1.5 +2 -2 modperl-docs/src/docs/1.0/os/win32/multithread.pod Index: multithread.pod =================================================================== RCS file: /home/cvs/modperl-docs/src/docs/1.0/os/win32/multithread.pod,v retrieving revision 1.4 retrieving revision 1.5 diff -u -r1.4 -r1.5 --- multithread.pod 28 Dec 2002 20:35:27 -0000 1.4 +++ multithread.pod 31 Dec 2002 19:24:25 -0000 1.5 @@ -1,6 +1,6 @@ =head1 NAME -Discussion of multithreading on Win32 mod_perl-1.xx +Discussion of multithreading on Win32 mod_perl 1.xx =head1 Description @@ -20,7 +20,7 @@ This situation changes with Apache/mod_perl 2.0, which is based on a multi-process/multi-thread approach using a native Win32 threads -implementation See the L<mod_perl 2 +implementation. See the L<mod_perl 2 overview|docs::2.0::user::intro::overview> for more details, and the discussion of L<modperl-2 in Win32|docs::2.0::os::win32::install> on getting modperl-2 for Win32 in particular. 1.15 +20 -32 modperl-docs/src/docs/2.0/os/win32/install.pod Index: install.pod =================================================================== RCS file: /home/cvs/modperl-docs/src/docs/2.0/os/win32/install.pod,v retrieving revision 1.14 retrieving revision 1.15 diff -u -r1.14 -r1.15 --- install.pod 28 Dec 2002 20:35:28 -0000 1.14 +++ install.pod 31 Dec 2002 19:24:25 -0000 1.15 @@ -18,9 +18,9 @@ Note that there are some threading issues in perl-5.6 (upon which ActivePerl builds 6xx are based) which may cause -problems with mod_perl-2. Because of this, it is (I<strongly>) +problems with mod_perl 2.0. Because of this, it is (I<strongly>) recommended -that perl-5.8 (ActivePerl builds 8xx) be used with mod_perl-2 +that perl-5.8 (ActivePerl builds 8xx) be used with mod_perl 2.0 on Win32. =head1 Installing @@ -40,11 +40,11 @@ The Apache sources and binaries are available at L<http://httpd.apache.org/>. -As of this writing, mod_perl-2 is known to compile and work +As of this writing, mod_perl 2.0 is known to compile and work with an ActivePerl-compatible Perl, both for builds 6xx, based on perl-5.6.1, and builds 8xx, based on perl-5.8.0. However, because of improved threading support, perl-5.8 is recommended -for Win32 mod_perl-2. See the section on Apache/mod_perl binaries +for Win32 mod_perl 2.0. See the section on Apache/mod_perl binaries below for details on a suitable repository containing mod_perl ppm packages, and also how to obtain other Win32 binary packages. @@ -53,7 +53,7 @@ have to specify F<C:\Program Files\> by the DOS 8.3 path name F<C:\Progra~1\> in certain Apache directives. If you want to avoid this, install, if possible, these packages to locations without spaces -in their names (eg, F<C:\Perl> for Perl and F<C:\Apache2> for Apache2). +in their names (eg, F<C:\Perl> for Perl and F<C:\Apache2> for Apache 2.0). In the following, it may be necessary to invoke certain commands through a DOS prompt. A DOS window may be opened either through @@ -69,15 +69,17 @@ C<InstallBin - Win32 Release> target to build and install Apache 2.0, which by default will be placed in F</Apache2>. -Having built and installed Apache 2.0, next obtain the mod_perl 2.0 -sources (F<mod_perl-1.99_xx>) -from L<http://www.cpan.org/authors/id/D/DO/DOUGM/>. After -unpacking, run the command +Having built and installed Apache 2.0, +next obtain the mod_perl 2.0 +First obtain the +L<mod_perl 2.0 sources|download::source/2_0_Development_Source_Distribution> +as a C<tar.gz> file - +when unpacked, using Winzip or similar tools, a subdirectory +F<mod_perl-x.xx> will be created. Next, run the command C:\modperl_src> perl Makefile.PL MP_AP_PREFIX=\Path\to\Apache2 -where F<\Path\to\Apache2> is the path to the Apache 2.0 package you -earlier built. Then +Then C:\modperl_src> nmake C:\modperl_src> nmake test @@ -90,8 +92,8 @@ C:\modperl_src> nmake install will install the necessary mod_perl 2.0 files into your Perl directory -tree (you will also need to copy F<src/modules/perl/mod_perl.so> into -your F</Path/to/Apache2/modules/> directory). If you are installing +tree, and also copy F<src/modules/perl/mod_perl.so> into +your F</Path/to/Apache2/modules/> directory. If you are installing mod_perl 2.0 on a system that also contains mod_perl 1.0, then some mod_perl 1.0 files will be overwritten by this procedure. This can be avoided by preparing the build as @@ -105,26 +107,14 @@ If this build fails, or you want features not present in the official releases, you may want to try the sources obtained -from cvs (it is a good idea to also use the cvs httpd-2.0 sources). -To do this, first obtain a Win32 cvs client from, for example, -L<http://www.cvshome.org/>. The cvs sources may be obtained as - - C:\src> cvs -d :pserver:[EMAIL PROTECTED]:/home/cvspublic login - C:\src> cvs -d :pserver:[EMAIL PROTECTED]:/home/cvspublic co httpd-2.0 - C:\src> cvs -d :pserver:[EMAIL PROTECTED]:/home/cvspublic co modperl-2.0 - -The build then proceeds as above. Be aware, though, +from cvs - see the discussion on the +L<2.0 Development Source Distribution|download::source/2_0_Development_Source_Distribution> +for details. Be aware, though, that as well as providing bug fixes, there may be new features being added and tested in the cvs versions, so at any given time there are no guarantees that these packages will build and test successfully. -=head2 Binary packages - -There are two ways of obtaining a binary mod_perl 2.0 package. - -=over 3 - -=item PPM +=head2 PPM Packages The first, for ActivePerl users, is through C<PPM> - this assumes you already have ActivePerl (build 8xx is recommended) from @@ -220,15 +210,13 @@ before loading F<mod_perl.so>. If all else fails, a reboot may help. -=item Apache/mod_perl binary +=head2 All in one packages At L<ftp://theoryx5.uwinnipeg.ca/pub/other/> there is a self-extracting archive F<Perl-5.8-win32-bin.exe> containing a binary version of perl-5.8 (compatible with ActivePerl 8xx), together with Apache 2.0 and mod_perl 2.0. See the file F<Perl-5.8-win32-bin.readme> for a description. - -=back =head1 See Also
--------------------------------------------------------------------- To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]