You are viewing a plain text version of this content. The canonical link for it is here.
Posted to modperl@perl.apache.org by William McKee <wi...@knowmad.com> on 2005/02/14 06:20:10 UTC
[mp2] Documentation patch for install.pod
I finally took the plunge and installed mp2 onto my FreeBSD virtual
server. Here are a few updates to the install.pod which would have made
the installation process a bit easier for me.
I'm not sure about the modification I made at line ~617. I installed a
static mod_perl so presume that the server had to be rebuilt. When I
first read the recipe, it didn't make much sense that I would install
Apache then build mod_perl. The line I added helps clear it up. Does the
server also get rebuilt if compiling a dynamic mod_perl?
Thanks,
William
--
Knowmad Services Inc.
http://www.knowmad.com
Re: [mp2] Documentation patch for install.pod
Posted by William McKee <wi...@knowmad.com>.
On Wed, Feb 16, 2005 at 10:52:06PM -0500, Stas Bekman wrote:
> Thanks, William. I've committed an extended version of your patch but at
> the beginning of that section. Please let me know if it needs more work.
Looks good. That explains it the way I now understand it to work.
> I believe the error message should have explained that in first place. If
> it's not clear enough (which is most likely the case, if you did read it),
> you know what to do :)
Yes, I see it now. It had scrolled past so fast that by the time I was
prompted to run the tests, I had forgotten about the messages. Mea
culpa.
William
--
Knowmad Services Inc.
http://www.knowmad.com
Re: [mp2] Documentation patch for install.pod
Posted by Stas Bekman <st...@stason.org>.
William McKee wrote:
>>2) if you build a static mod_perl, it'll configure and make Apache for you.
>
>
> Ahh, so I don't even need to configure Apache if I'm building a static
> mod_perl. I've amended the install.pod to indicate as much.
Thanks, William. I've committed an extended version of your patch but at
the beginning of that section. Please let me know if it needs more work.
>>You should not run it *from under /root directory or similar*, but as long
>>as you run from somewhere where non-root user can access files (e.g.
>>/tmp), running as 'root' should work just fine.
>
> I see the difference now. I was installing from /usr/local/src so that
> test should have worked.
I believe the error message should have explained that in first place. If
it's not clear enough (which is most likely the case, if you did read it),
you know what to do :)
--
__________________________________________________________________
Stas Bekman JAm_pH ------> Just Another mod_perl Hacker
http://stason.org/ mod_perl Guide ---> http://perl.apache.org
mailto:stas@stason.org http://use.perl.org http://apacheweek.com
http://modperlbook.org http://apache.org http://ticketmaster.com
Re: [mp2] Documentation patch for install.pod
Posted by William McKee <wi...@knowmad.com>.
> 2) if you build a static mod_perl, it'll configure and make Apache for you.
Ahh, so I don't even need to configure Apache if I'm building a static
mod_perl. I've amended the install.pod to indicate as much.
> You should not run it *from under /root directory or similar*, but as long
> as you run from somewhere where non-root user can access files (e.g.
> /tmp), running as 'root' should work just fine.
I see the difference now. I was installing from /usr/local/src so that
test should have worked.
William
--
Knowmad Services Inc.
http://www.knowmad.com
Re: [mp2] Documentation patch for install.pod
Posted by Stas Bekman <st...@stason.org>.
William McKee wrote:
>>It's never the case. In the case of DSO it never happens. In the case of
>>static build Apache server is built during 'make'.
>>as you say above, it's not the case with DSO.
>
>
> Yeah, that makes sense now. In the case of static mod_perl builds, is
> there any reason to run make && make install while getting apache source
> files ready? It seems like I could just do the configure part then let
> mod_perl build the server from there.
1) if you build a DSO mod_perl. You must have the Apache installed
*before* you start building mod_perl.
2) if you build a static mod_perl, it'll configure and make Apache for you.
So you should never manually touch the Apache tree during the mod_perl build.
>>Why do you say so? It should work fine under root. If it doesn't, it
>>should be fixed rather than documented. please follow the usual routine
>>as explained here: http://perl.apache.org/bugs/
>
>
> This was my experience and I faintly remembered you suggesting that
> Apache::Test should not be run as root so surmised that that was my
> problem. Right now, I do not have time to track down this error. If I
> can repeat it at a later time, I will file a proper bug report.
You should not run it *from under /root directory or similar*, but as long
as you run from somewhere where non-root user can access files (e.g.
/tmp), running as 'root' should work just fine.
--
__________________________________________________________________
Stas Bekman JAm_pH ------> Just Another mod_perl Hacker
http://stason.org/ mod_perl Guide ---> http://perl.apache.org
mailto:stas@stason.org http://use.perl.org http://apacheweek.com
http://modperlbook.org http://apache.org http://ticketmaster.com
Re: [mp2] Documentation patch for install.pod
Posted by William McKee <wi...@knowmad.com>.
> committed the first part of it (those who know what options to use don't
> need extra explanation, those who don't know won't find the extra
> explanation sufficient).
That's fine. The second part was more for my own edification.
> It's never the case. In the case of DSO it never happens. In the case of
> static build Apache server is built during 'make'.
> as you say above, it's not the case with DSO.
Yeah, that makes sense now. In the case of static mod_perl builds, is
there any reason to run make && make install while getting apache source
files ready? It seems like I could just do the configure part then let
mod_perl build the server from there.
> Why do you say so? It should work fine under root. If it doesn't, it
> should be fixed rather than documented. please follow the usual routine
> as explained here: http://perl.apache.org/bugs/
This was my experience and I faintly remembered you suggesting that
Apache::Test should not be run as root so surmised that that was my
problem. Right now, I do not have time to track down this error. If I
can repeat it at a later time, I will file a proper bug report.
Thanks,
William
--
Knowmad Services Inc.
http://www.knowmad.com
Re: [mp2] Documentation patch for install.pod
Posted by Stas Bekman <st...@stason.org>.
William McKee wrote:
> I finally took the plunge and installed mp2 onto my FreeBSD virtual
> server. Here are a few updates to the install.pod which would have made
> the installation process a bit easier for me.
>
> I'm not sure about the modification I made at line ~617. I installed a
> static mod_perl so presume that the server had to be rebuilt. When I
> first read the recipe, it didn't make much sense that I would install
> Apache then build mod_perl. The line I added helps clear it up. Does the
> server also get rebuilt if compiling a dynamic mod_perl?
Thanks for the patch, William. See the comments below.
> --- install.pod.orig 2005-02-13 09:18:58.000000000 -0500
> +++ install.pod 2005-02-14 00:17:24.000000000 -0500
> @@ -289,7 +289,11 @@
> % cd modperl-1.99_xx
> % perl Makefile.PL <options>
>
> -where I<options> is an optional list of (key,value) pairs.
> +where I<options> is an optional list of (key,value) pairs. These options can
> +include all the usual options supported by ExtUtils::MakeMaker (e.g., PREFIX,
> +LIB, etc.). This is particuarly useful when installing the Apache::* libraries
> +to non-standard locations such as when doing non-root or virtual server
> +installations.
committed the first part of it (those who know what options to use don't
need extra explanation, those who don't know won't find the extra
explanation sufficient).
> The following sections give the details about all the available
> options, but let's mention first an important one.
> @@ -616,7 +620,8 @@
>
> =head2 Installing mod_perl
>
> -Once the test suite has passed, it's a time to install mod_perl.
> +Once the test suite has passed, it's a time to install mod_perl. This step
> +will rebuild the Apache server.
It's never the case. In the case of DSO it never happens. In the case of
static build Apache server is built during 'make'.
as you say above, it's not the case with DSO.
> % make install
>
> @@ -634,6 +639,18 @@
> installation process from scratch, while verifying all the steps with
> this document.
>
> +=over
> +
> +=item *
> +make test exists with "Error code 1" before any tests begin
> +
> +Be sure that you are not trying to run the tests as root. Log in as a regular
> +user and be sure that user has rwx privileges to the files in the source
> +directory.
Why do you say so? It should work fine under root. If it doesn't, it
should be fixed rather than documented. please follow the usual routine
as explained here: http://perl.apache.org/bugs/
--
__________________________________________________________________
Stas Bekman JAm_pH ------> Just Another mod_perl Hacker
http://stason.org/ mod_perl Guide ---> http://perl.apache.org
mailto:stas@stason.org http://use.perl.org http://apacheweek.com
http://modperlbook.org http://apache.org http://ticketmaster.com