randyk 2002/12/14 10:23:47
Modified: src/docs/2.0/os/win32 install.pod
Log:
recommend perl-5.8 for Win32 and mod_perl-2.
Revision Changes Path
1.12 +49 -60 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.11
retrieving revision 1.12
diff -u -r1.11 -r1.12
--- install.pod 28 Nov 2002 17:08:21 -0000 1.11
+++ install.pod 14 Dec 2002 18:23:47 -0000 1.12
@@ -41,15 +41,12 @@
http://httpd.apache.org/
As of this writing, mod_perl-2 is known to compile and work
-with an ActivePerl-compatable Perl (builds 6xx), based on
-perl-5.6.1. It also works with perl-5.8 compiled with the default
compile-time
-flags in the Win32 F<Makefile>. Because of improved threading support,
-it is expected sometime in the future that perl-5.8 will be the
-recommended Perl for Win32 mod_perl-2. ActiveState currently has
-a beta perl-5.8 Win32 binary ready for testing; see the section
-on Apache/mod_perl binaries below for details on a suitable
-repository containing mod_perl, and also how to obtain another perl-5.8
-Win32 binary package.
+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
+below for details on a suitable repository containing mod_perl
+ppm packages, and also how to obtain other Win32 binary packages.
When installing Perl or other related binaries, subtleties may arise
in using path names that have spaces in them - you may, for example,
@@ -129,10 +126,10 @@
=item PPM
The first, for ActivePerl users, is through C<PPM> - this assumes you
-already have ActivePerl (build 6xx) from http://www.activestate.com/
-and a Win32 Apache 2.0 binary from http://httpd.apache.org/. In
-installing this, you may find it convenient when transcribing any
-Unix-oriented documentation to choose installation directories that do
+already have ActivePerl (build 8xx is recommended) from
+http://www.activestate.com/ and a Win32 Apache 2.0 binary from
+http://httpd.apache.org/. In installing this, you might avoid
+some future problems by choosing installation directories that do
not have spaces in their names (eg, F<C:/Apache2>).
After installing Perl and Apache 2.0, you can then install mod_perl
@@ -144,21 +141,40 @@
C:\> ppm install
http://theoryx5.uwinnipeg.ca/ppmpackages/mod_perl-2.ppd
-Another way, which will be useful if you plan on installing additional
-Apache modules, is to set the repository within the C<ppm> shell
-utility as (broken over 2 lines for readability)
+for ActivePerl 6xx builds, and
- PPM> set repository theoryx5
- http://theoryx5.uwinnipeg.ca/cgi-bin/ppmserver?urn:/PPMServer
+ C:\> ppm install
+ http://theoryx5.uwinnipeg.ca/ppms/mod_perl.ppd
+
+for ActivePerl 8xx builds (at present, this latter repository does not
+contain a mod_perl-1 package). Another way, which will be useful if you
+plan on installing additional Apache modules, is to set the repository
+within the C<ppm> shell utility to
+
+ http://theoryx5.uwinnipeg.ca/cgi-bin/ppmserver?urn:/PPMServer
+
+for ActivePerl 6xx builds, and to
+
+ http://theoryx5.uwinnipeg.ca/cgi-bin/ppmserver?urn:/PPMServer58
+
+for ActivePerl 8xx builds. The repository may be set using
+
+ ppm> set repository NAME LOCATION
+
+for C<ppm2> and by
-or, for C<ppm3>,
+ ppm> rep add NAME LOCATION
- PPM> rep add theoryx5
- http://theoryx5.uwinnipeg.ca/cgi-bin/ppmserver?urn:/PPMServer
+for C<ppm3> - see the help utility within the C<ppm> shell for
+details. mod_perl 2.0 can then be installed as
-mod_perl 2.0 can then be installed as
+ ppm> install mod_perl-2
- PPM> install mod_perl-2
+for builds 6xx and as
+
+ ppm> install mod_perl
+
+for builds 8xx.
This will install the necessary modules under an F<Apache2>
subdirectory in your Perl tree, so as not to disturb an existing
@@ -169,11 +185,19 @@
The mod_perl PPM package also includes the necessary Apache DLL
F<mod_perl.so>; a post-installation script should be run which will
offer to copy this file to your Apache2 modules directory (eg,
-F<C:/Apache2/modules/>). If this is not done, you can get the file
+F<C:/Apache2/modules/>). If this is not done, get either
F<mod_perl-2.tar.gz> from
-http://theoryx5.uwinnipeg.ca/ppmpackages/x86/ which, when unpacked,
+http://theoryx5.uwinnipeg.ca/ppmpackages/x86/, for builds 6xx, or
+F<mod_perl.tar.gz> from
+http://theoryx5.uwinnipeg.ca/ppms/x86/, for builds 8xx;
+when unpacked, this file
contains F<mod_perl.so> in the top-level directory.
+Note that, because of binary incompatibilities, one should
+I<not> install packages for ActivePerl 8xx from a repository
+containing packages for ActivePerl 6xx, and vice-versa, particularly
+if these packages contain XS-based modules.
+
Note that the mod_perl package available from this site will always
use the latest mod_perl sources compiled against the latest official
Apache release; depending on changes made in Apache, you may or may
@@ -187,41 +211,6 @@
LoadFile "C:/Path/to/your/Perl/bin/perlxx.dll"
before loading F<mod_perl.so>. If all else fails, a reboot may help.
-
-For users of ActivePerl beta 8xx, based on perl-5.8, a
-similar repository is available. At present this contains
-mod_perl-2, which can be installed as
-
- C:\> ppm install
- http://theoryx5.uwinnipeg.ca/ppms/mod_perl.ppd
-
-You can also set the repository within the C<ppm> shell
-utility as (broken over 2 lines for readability)
-
- PPM> rep add theoryx5
- http://theoryx5.uwinnipeg.ca/cgi-bin/ppmserver?urn:/PPMServer58
-
-or, for C<ppm2>,
-
- PPM> set repository theoryx5
- http://theoryx5.uwinnipeg.ca/cgi-bin/ppmserver?urn:/PPMServer58
-
-mod_perl 2.0 can then be installed as
-
- PPM> install mod_perl
-
-This procedure should run a post-install script to copy
-F<mod_perl.so> to your Apache2 modules directory (eg,
-F<C:/Apache2/modules/>). If this is not done, you can get the file
-F<mod_perl.tar.gz> from
-http://theoryx5.uwinnipeg.ca/ppms/x86/ which, when unpacked,
-contains F<mod_perl.so> in the top-level directory.
-
-Currently this repository does not contain a mod_perl-1 package.
-Note that, because of binary incompatibilities, one should
-I<not> install packages for ActivePerl 8xx from a repository
-containing packages for ActivePerl 6xx, and vice-versa, particularly
-if these packages contain XS-based modules.
=item Apache/mod_perl binary
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
