randyk 2003/01/01 23:56:04
Modified: src/docs/1.0/os/win32 config.pod install.pod
src/docs/2.0/os/win32 config.cfg config.pod install.pod
Added: src/docs/2.0/os/win32 faq.pod
Log:
added win32 faq
Revision Changes Path
1.6 +3 -1 modperl-docs/src/docs/1.0/os/win32/config.pod
Index: config.pod
===================================================================
RCS file: /home/cvs/modperl-docs/src/docs/1.0/os/win32/config.pod,v
retrieving revision 1.5
retrieving revision 1.6
diff -u -r1.5 -r1.6
--- config.pod 28 Dec 2002 20:35:27 -0000 1.5
+++ config.pod 2 Jan 2003 07:56:04 -0000 1.6
@@ -126,7 +126,9 @@
The directions for L<installing mod_perl 1.0 on
Win32|docs::1.0::os::win32::install>, the L<mod_perl
-documentation|docs::index>, L<http://take23.org/>.
+documentation|docs::index>, L<http://take23.org/>,
+and the
+L<FAQs for mod_perl on Win32|docs::2.0::os::win32::faq>.
Help is also available through the archives of and subscribing to
the L<mod_perl mailing list|maillist::modperl>.
1.18 +3 -1 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.17
retrieving revision 1.18
diff -u -r1.17 -r1.18
--- install.pod 31 Dec 2002 19:24:25 -0000 1.17
+++ install.pod 2 Jan 2003 07:56:04 -0000 1.18
@@ -334,7 +334,9 @@
The directions for L<configuring mod_perl 1.0 on
Win32|docs::1.0::os::win32::config>, the L<mod_perl
-documentation|docs::index>, L<http://take23.org/>.
+documentation|docs::index>, L<http://take23.org/>,
+and the
+L<FAQs for mod_perl on Win32|docs::2.0::os::win32::faq>.
Help is also available through the archives of and subscribing to
the L<mod_perl mailing list|maillist::modperl>.
1.8 +1 -0 modperl-docs/src/docs/2.0/os/win32/config.cfg
Index: config.cfg
===================================================================
RCS file: /home/cvs/modperl-docs/src/docs/2.0/os/win32/config.cfg,v
retrieving revision 1.7
retrieving revision 1.8
diff -u -r1.7 -r1.8
--- config.cfg 21 Dec 2002 07:26:16 -0000 1.7
+++ config.cfg 2 Jan 2003 07:56:04 -0000 1.8
@@ -12,6 +12,7 @@
chapters => [qw(
install.pod
config.pod
+ faq.pod
)],
copy_glob => [qw(
1.9 +4 -2 modperl-docs/src/docs/2.0/os/win32/config.pod
Index: config.pod
===================================================================
RCS file: /home/cvs/modperl-docs/src/docs/2.0/os/win32/config.pod,v
retrieving revision 1.8
retrieving revision 1.9
diff -u -r1.8 -r1.9
--- config.pod 28 Dec 2002 20:35:28 -0000 1.8
+++ config.pod 2 Jan 2003 07:56:04 -0000 1.9
@@ -187,8 +187,10 @@
The directions for L<installing mod_perl 2.0 on
Win32|docs::2.0::os::win32::install>, the L<mod_perl
documentation|docs::index>, L<http://perl.apache.org/>,
-L<http://take23.org/>, L<http://httpd.apache.org/>, and
-L<http://www.activestate.com/>.
+L<http://take23.org/>, L<http://httpd.apache.org/>,
+L<http://www.activestate.com/>,
+and the
+L<FAQs for mod_perl on Win32|docs::2.0::os::win32::faq>.
Help is also available through the archives of and subscribing to
the L<mod_perl mailing list|maillist::modperl>.
1.16 +3 -1 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.15
retrieving revision 1.16
diff -u -r1.15 -r1.16
--- install.pod 31 Dec 2002 19:24:25 -0000 1.15
+++ install.pod 2 Jan 2003 07:56:04 -0000 1.16
@@ -223,7 +223,9 @@
The directions for L<configuring mod_perl 2.0 on
Win32|docs::2.0::os::win32::config>, the L<mod_perl
documentation|docs::index>, L<http://take23.org/>,
-L<http://httpd.apache.org/>, and L<http://www.activestate.com/>.
+L<http://httpd.apache.org/>, L<http://www.activestate.com/>,
+and the
+L<FAQs for mod_perl on Win32|docs::2.0::os::win32::faq>.
Help is also available through the archives of and subscribing to
the L<mod_perl mailing list|maillist::modperl>.
1.1 modperl-docs/src/docs/2.0/os/win32/faq.pod
Index: faq.pod
===================================================================
=head1 NAME
Frequently asked questions for mod_perl on Win32
=head1 Description
This document discusses some questions that arise often
with mod_perl on Win32.
=head1 Obtaining mod_perl
=head2 Do I need Perl to use mod_perl?
Yes, Perl is required. You can obtain a Win32 Perl
binary from L<http://www.activestate.com/>. See also
the all-in-one binary packages for both
L<mod_perl 1.0|docs::1.0::os::win32::install/All_in_one_packages>
and
L<mod_perl 2.0|docs::2.0::os::win32::install/All_in_one_packages>
which include Perl, Apache, and mod_perl.
=head2 Are mod_perl ppm packages available?
PPM packages for both
L<mod_perl 1.0|docs::1.0::os::win32::install/PPM_Packages>
and
L<mod_perl 2.0|docs::2.0::os::win32::install/PPM_Packages>
are available.
=head2 Should I use mod_perl 1.0 or mod_perl 2.0?
L<mod_perl 1.0|docs::1.0::guide::intro>, for use with Apache 1.0,
is stable and well tested, while
L<mod_perl 2.0|docs::2.0::user::intro::overview>, for use with
Apache 2.0, is in a development stage. Normally, therefore, one
would recommend mod_perl 2.0 only in a testing and development
environment. However, on Win32 mod_perl 1.0 is subject to some serious
L<threading limitations|docs::1.0::os::win32::multithread>
which are overcome with mod_perl 2.0; this, coupled
with the improved performance of Apache 2.0 on Win32, may
make mod_perl 2.0 a better choice.
=head1 Installing mod_perl
=head2 I get an "unable to load mod_perl.so" error when starting
Apache.
This can be due to a number of reasons.
=over
=item Verify that mod_perl.so was compiled against the same Perl and Apache
versions that you are using.
=item Check that the directory containing C<perl.exe> is in your I<PATH>
environment variable.
=item Try inserting a directive
LoadFile "C:/Path/to/your/Perl/bin/perlxx.dll"
before the
LoadModule perl_module modules/mod_perl.so
directive.
=item Try a reboot.
=back
=head2 How do I set the PATH environment variable?
This differs according to the flavour of Win32 you are using.
Search for I<set PATH environment> within the Windows
Help utility under the Start menu for instructions.
=head1 Configuring mod_perl
=head2 How do I know scripts are running under mod_perl?
You can test this by using a script which prints out the
L<environment
variables|docs::1.0::guide::install/Testing_via_a_CGI_script>;
note that for mod_perl 2.0 a slightly L<different
configuration|docs::2.0::os::win32::config/Registry_scripts>
is required.
=head2 My script gets returned as plain text.
See the discussion of configuring
L<Apache::Registry|docs::1.0::guide::config/My_CGI_Perl_Code_Gets_Returned_as_Plain_Text_Instead_of_Being_Executed_by_the_Webserver>;
for mod_perl 2.0, a
L<different
configuration|docs::2.0::user::compat::compat/The_C_Apache__Registry__Family>
is required.
=head2 I get a "Save-As" dialogue box when calling a script.
See the discussion about
L<PerlSendHeader|docs::1.0::guide::config/My_Script_Works_under_mod_cgi__but_when_Called_via_mod_perl_I_Get_a__Save_As__Prompt>;
note that for mod_perl 2.0,
there is a L<different
syntax|docs::2.0::user::compat::compat/C_PerlSendHeader_>.
=head2 My script displays a "Content-type" header in the browser.
Check the setting of
L<PerlSendHeader|docs::1.0::guide::porting/Generating_correct_HTTP_Headers>;
note that for mod_perl 2.0, there is a L<different
syntax|docs::2.0::user::compat::compat/C_PerlSendHeader_>.
=head1 Using mod_perl
=head2 One request must finish before another is processed.
You are probably running into
L<multithreading limitations|docs::1.0::os::win32::multithread>
of mod_perl 1.0; if this is a major problem, you should
consider using
L<mod_perl 2.0|docs::2.0::os::win32::install>.
=head2 My script just hangs.
You should check the setting of
L<PerlSendHeader|docs::1.0::guide::porting/Generating_correct_HTTP_Headers>;
for mod_perl 2.0, there is a L<different
syntax|docs::2.0::user::compat::compat/C_PerlSendHeader_>.
If this setting is correct, and
this occurs under mod_perl 2.0 and
Perl-5.6.1, try upgrading to
L<Perl-5.8.0|docs::2.0::os::win32::install>.
=head2 How do I run ASP scripts?
For a mod_perl solution, check L<http://www.apache-asp.org/>
for a discussion of the Apache::ASP module.
=head2 How do I install additional Apache modules?
If these aren't available via ppm from the repositories
for
L<mod_perl 1.0|docs::1.0::os::win32::install/PPM_Packages>
or
L<mod_perl 2.0|docs::2.0::os::win32::install/PPM_Packages>,
you can build them using the
L<CPAN.pm|docs::1.0::os::win32::config/Apache_modules>
module.
=head1 See Also
The discussion of
L<frequent mod_perl problems|docs::1.0::guide::frequent>,
the L<troubleshooting index|docs::1.0::guide::troubleshooting>,
L<debugging mod_perl|docs::1.0::guide::debug>, and
a L<troubleshooting guide for mod_perl
2.0|docs::2.0::user::troubleshooting::troubleshooting>.
Help is also available through the archives of and subscribing to
the L<mod_perl mailing list|maillist::modperl>; you will
probably find the
L<guide to getting help|docs::1.0::guide::help>
useful reading beforehand.
=head1 Maintainers
Maintainer is the person(s) you should contact with updates,
corrections and patches.
=over
=item *
Randy Kobes E<lt>[EMAIL PROTECTED]<gt>
=back
=head1 Authors
=over
=item *
Randy Kobes E<lt>[EMAIL PROTECTED]<gt>
=back
Only the major authors are listed above. For contributors see the
Changes file.
=cut
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
