Bug 162862

Summary: DESTDIR environment variable setting is not correct for apache22
Product: Documentation Reporter: pirat sriyotha <jotawski>
Component: Books & ArticlesAssignee: Manolis Kiagias <manolis>
Status: Closed FIXED    
Severity: Affects Only Me    
Priority: Normal    
Version: Latest   
Hardware: Any   
OS: Any   
Attachments:
Description Flags
file.diff none

Description pirat sriyotha 2011-11-25 00:20:07 UTC
in chapter 8 of FDP primer section 8.3 bullet 2 wrote that DESTDIR environment variable must be given in order to install into local servers and the value is /usr/local/www

Nowaday, for apache2 web server, this value is quite far from real situation.  The most appropriate value for apache2 should be /usr/local/www/apache22 as in

# env DESTDIR=/usr/local/www/apache22 make install

Fix: change command line from

# env DESTDIR=/usr/local/www make install

to

# env DESTDIR=/usr/local/www/apache22 make install

a patch for chapter.sgml at books/fdp-primer/the-website is attached

Patch attached with submission follows:
How-To-Repeat: open your web browser and point to http://www.freebsd.org/doc/en_US.ISO8859-1/books/fdp-primer/the-website-install.html
Comment 1 sonic2000gr 2011-11-25 15:25:32 UTC
Hi,

The example is not specific to apache22 or in fact any specific web 
server. You don't have to use apache to serve FreeBSD web pages. The 
/usr/local/www is used as a common preference (or hint) as /usr is the 
largest partition on most FreeBSD systems following the default 
installation scheme. You are supposed to know how to install / configure 
a web server and adapt these instructions to your specific installation.
IMHO, if we add apache specific information to this section we will also 
have to add more sections describing  basic configuration for serving 
the pages (like setting DocumentRoot, encoding etc.). I believe these 
are out of scope for this document.

Best,
Manolis
Comment 2 sonic2000gr 2011-11-27 06:09:59 UTC
On 27/11/2011 5:33 Ïμ, Mniyardfa Jotawski wrote:
>
>
> On Sat, Nov 26, 2011 at 6:09 PM, Manolis Kiagias 
> <sonic2000gr@gmail.com <mailto:sonic2000gr@gmail.com>> wrote:
>
>     On 26/11/2011 1:07 Ïμ, Mniyardfa Jotawski wrote:
>>     2011/11/25 Manolis Kiagias <sonic2000gr@gmail.com
>>     <mailto:sonic2000gr@gmail.com>>
>>
>>         Hi,
>>
>>
>>     Hi,
>>
>>         The example is not specific to apache22 or in fact any
>>         specific web server. You don't have to use apache to serve
>>         FreeBSD web pages. The /usr/local/www is used as a common
>>         preference (or hint) as /usr is the largest partition on most
>>         FreeBSD systems following the default installation scheme.
>>         You are supposed to know how to install / configure a web
>>         server and adapt these instructions to your specific
>>         installation.
>>         IMHO, if we add apache specific information to this section
>>         we will also have to add more sections describing  basic
>>         configuration for serving the pages (like setting
>>         DocumentRoot, encoding etc.). I believe these are out of
>>         scope for this document.
>>
>>
>>     I did agree with your opinion but since I specifically aimed to
>>     apache2, as I wrote in my Problem Description: , that requires
>>     that documents to serve should be in (or under) DocumentRoot
>>     which is /usr/local/www/apache22.  But once I follow suggestion
>>     in FDP Primer chapter 8.3, that installs all documents to
>>     /usr/local/www/data.  In this case, I have to create apache22
>>     subdirectory under what DESTDIR environment variable points to
>>     and mv all data/ into that in order for my apache2 to start quietly.
>
>     What you would really need to do is change the DESTDIR shown in
>     the example to:
>
>     env DESTDIR=/usr/local/www/apache22 make install
>
>     As I said, the example is not to be taken literally.  DESTDIR
>     should be set to your own DocumentRoot (or whatever is called by
>     the web server used) and not copied directly from fdp-primer.
>
>
>>
>>     Anyway, I also see that there will be an endless Notes to mention
>>     to the readers if we wrote to a  specific web-server like apache
>>     as you said me.
>>
>>     May be that we put a few words to mention further  works after
>>     ``make all install''  for some specific server or all documents
>>     will have to be installed to ~/public_html/data otherwise.
>>
>
>     Not necessary if DESTDIR is set correctly beforehand
>
>
>>     Many thanks indeed for your time.
>>
>>     Apologized me for disturbing and apologized me for my English too.
>>
>>
>>
>
>     You are not disturbing, you are trying to make FreeBSD better! Thanks!
>
>
> Hi,
>
> All in all, I do agree with you but I found that the whole documents 
> will be placed under ~/public_html/data if  DESTDIR were not passed to 
> make command line.  Even one passed some value for DESTDIR to make 
> command line, the whole documents still be placed under 
> ${DESTDIR}/data regardless of any web servers used.
>
>
> Should a few words mention this to the readers ?
>
> Really apologized me indeed.  This is my limitation, my English.
>
> With Best Regards,
> psr
>
>

Ah, I see your point now.  It's true, the actual install directory is 
$DESTDIR/data. I'll make sure this gets mentioned in the fdp-primer.

Best,
Manolis
Comment 3 Manolis Kiagias freebsd_committer freebsd_triage 2011-11-27 06:24:14 UTC
Responsible Changed
From-To: freebsd-doc->manolis

Over to me
Comment 4 dfilter service freebsd_committer freebsd_triage 2011-11-27 16:37:39 UTC
manolis     2011-11-27 16:37:30 UTC

  FreeBSD doc repository

  Modified files:
    en_US.ISO8859-1/books/fdp-primer/the-website chapter.sgml 
  Log:
  Note that files from the FreeBSD website build process are actually installed under $DESTDIR/data
  
  PR:             docs/162862
  Submitted by:   Pirat Sriyotha <jotawski at gmail dot com>
  
  Revision  Changes    Path
  1.28      +4 -1      doc/en_US.ISO8859-1/books/fdp-primer/the-website/chapter.sgml
_______________________________________________
cvs-all@freebsd.org mailing list
http://lists.freebsd.org/mailman/listinfo/cvs-all
To unsubscribe, send any mail to "cvs-all-unsubscribe@freebsd.org"
Comment 5 Manolis Kiagias freebsd_committer freebsd_triage 2011-11-27 16:47:37 UTC
State Changed
From-To: open->closed

A suitable note has been added, thanks for submitting this!