perl-docs-cvs mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From s...@apache.org
Subject cvs commit: modperl-docs README.SITE
Date Wed, 07 Aug 2002 01:35:24 GMT
stas        2002/08/06 18:35:24

  Modified:    .        README.SITE
  Log:
  more site update notes
  
  Revision  Changes    Path
  1.3       +34 -15    modperl-docs/README.SITE
  
  Index: README.SITE
  ===================================================================
  RCS file: /home/cvs/modperl-docs/README.SITE,v
  retrieving revision 1.2
  retrieving revision 1.3
  diff -u -r1.2 -r1.3
  --- README.SITE	6 Aug 2002 09:10:19 -0000	1.2
  +++ README.SITE	7 Aug 2002 01:35:24 -0000	1.3
  @@ -1,9 +1,27 @@
   This docco explains how to update perl.apache.org
   
  -The site is being built under /home/perlwww/apache.org/modperl-docs
  -and then synced into /www/perl.apache.org.
  +The site is being anonymously checked out and built under
  +/home/perlwww/apache.org/modperl-docs and then synced into
  +/www/perl.apache.org. user 'perlwww' is in the 'perl' group, so
  +whatever it creates you should be able to modify at will. All the
  +files under /home/perlwww are made g+rwx to group 'perl', so you can
  +mess with files without becoming 'perlwww'.
   
  -*** Doing Updates ***
  +*** sudo'ing to perlwww ***
  +
  +Sometimes you need to sudo into the 'perlwww' user, to perform things
  +that only that user can do (e.g. modifying crontabs).
  +
  +To sudo into the 'perlwww' user (assuming that you have the perms to
  +do so):
  +
  +sudo -H -u perlwww bash
  +
  +or:
  +
  +sudo -H -u perlwww tcsh
  +
  +*** Automatic Updates ***
   
   The site is being updated automatically from the crontab. So all you
   have to do is to commit your changes and wait for them to be picked up
  @@ -18,6 +36,18 @@
   # update all (only changes and pdfs) once a day
   15 0 * * * /home/perlwww/apache.org/modperl-docs/bin/site_build_pdf_index
   
  +In order to modify the crontab you must sudo into the 'perlwww'
  +user. Notice that the crontab that everybody in the 'perl' group can
  +modify is the main reason for creating this special user.
  +
  +If the updating script emits any warnings/errors, they will be sent to
  +the email address listed in /home/perlwww/.forward. (which is
  +currently my address by in the future I plan to change it to the
  +docs-dev list's address, so if I'm not around others will be able to
  +know that there is a problem and resolve it.)
  +
  +*** Manual Updates ***
  +
   If for some reason you cannot wait before the automatic update
   (e.g. if you've changed the template and don't want to wait a week for
   the update to be picked up) there a few symlinks that you can use to
  @@ -56,18 +86,7 @@
   whether the filesystem is under 95% (which happens quite often) and
   won't update the online version if that's the case.
   
  -*** Permission Problems ***
  -
  -If for some reasons the permissions are getting messed up, first sudo
  -into 'perlwww' user (assuming that you have the perms to do so):
  -
  -sudo -H -u perlwww bash
  -
  -or:
  -
  -sudo -H -u perlwww tcsh
  -
  -*** Other Problems ***
  +*** Resolving Problems ***
   
   If the problem is with the build system email the docs-dev list. If
   the problem with the apache.org machine email root@apache.org.
  
  
  

---------------------------------------------------------------------
To unsubscribe, e-mail: docs-cvs-unsubscribe@perl.apache.org
For additional commands, e-mail: docs-cvs-help@perl.apache.org


Mime
View raw message