[Savannah-cvs] administration/docs/hacking_savannah hacking_sa...

[Sylvain Beucler]

CVSROOT:        /cvsroot/administration
Module name:    administration
Branch:         
Changes by:     Sylvain Beucler <address@hidden>        04/09/20 22:53:27

Modified files:
        docs/hacking_savannah: hacking_savannah.texi 

Log message:
        Various updates and fixes during my Nth test install (ter)

CVSWeb URLs:
http://savannah.gnu.org/cgi-bin/viewcvs/administration/administration/docs/hacking_savannah/hacking_savannah.texi.diff?tr1=1.41&tr2=1.42&r1=text&r2=text

Patches:
Index: administration/docs/hacking_savannah/hacking_savannah.texi
diff -u administration/docs/hacking_savannah/hacking_savannah.texi:1.41 
administration/docs/hacking_savannah/hacking_savannah.texi:1.42
--- administration/docs/hacking_savannah/hacking_savannah.texi:1.41     Mon Sep 
20 20:29:11 2004
+++ administration/docs/hacking_savannah/hacking_savannah.texi  Mon Sep 20 
22:53:26 2004
@@ -1,5 +1,5 @@
 \input texinfo   @c -*-texinfo-*-
address@hidden $Id: hacking_savannah.texi,v 1.41 2004/09/20 20:29:11 Beuc Exp $
address@hidden $Id: hacking_savannah.texi,v 1.42 2004/09/20 22:53:26 Beuc Exp $
 @comment %**start of header
 @setfilename hacking_savannah.info
 @include version.texi
@@ -71,7 +71,7 @@
 * Some quirks::                 To clear up sooner or later.
 * Projects approval::           Savannah policies and HOWTO.
 * Terminology::                 Precise wording.
-* Acknowledgements::            
+* Thanks to...::                
 * Copying This Manual::         The GNU Free Documentation License.
 * Indices::                     A menu covering many topics.
 @end menu
@@ -664,6 +664,48 @@
 [TODO: make that more explicit, and detail the conf for sv.gnu.org and
 savana.gnu.org, among others]
 
address@hidden GateKeeper
+GateKeeper is a script ran by cron job to check the project upload
+area and move files signed by admins to its download area. It is used
+for uploads to ftp.gnu.org and alpha.gnu.org. We used a modified
+version of GateKeeper at Savannah.
+
+You need to setup a gpg-writer user (to keep the GPG options ???), a
+gatekpr place for the scripts and the project public key-rings, an
+upload area, and of course a properly configured FTP server.
+
+Again, I only describe what Savannah is, not what it should be.
+
+[TODO: check default group, dir perms, dir own/grp, and the
+appropriate useradd options]
+
address@hidden
+$ useradd -m gpg-writer
+~> su - gpg-writer
+~> gpg # creates .gnupg
+~> exit
+$ useradd -m gatekpr
+$ cd ~gatekpr
+$ mkdir -m 755 bin
address@hidden example
+
+There, get lsof v4.64 and install it in @file{bin/}.
+
address@hidden
+$ mkdir -m 755 projects
+$ chown gpg-writer:nogroup projects
address@hidden example
+
+Copy upload-savannah.pl in @file{~gatekpr}.
+
+
address@hidden
+$ useradd -m upload
+$ cd ~upload
+$ mkdir -m 555 -p incoming/savannah
+$ chown upload:gatekpr incoming/savannah
address@hidden example
+
 
 @node CVS, Populating your test install, Tuning your local install, Savannah 
configuration
 @section CVS
@@ -699,6 +741,10 @@
 
 Just be patient, the dump weighs as of 2004-09 some 155MB.
 
+
+The default project files should be created, since the groups are not
+present in your @file{/etc/passwd} and @file{/etc/group}.
+
 @node Remaining,  , Populating your test install, Savannah configuration
 @section Remaining
 
@@ -2143,7 +2189,7 @@
 
 
 
address@hidden Terminology, Acknowledgements, Projects approval, Top
address@hidden Terminology, Thanks to..., Projects approval, Top
 @appendix Terminology
 
 @itemize @bullet
@@ -2181,10 +2227,9 @@
 
 @end itemize
 
address@hidden Acknowledgements, Copying This Manual, Terminology, Top
address@hidden Acknowledgements
address@hidden Thanks to..., Copying This Manual, Terminology, Top
address@hidden Thanks to...
 
-Thanks to:
 @table @bullet
 @item Rudy Gevaert & Hugo Gayosso
 for insights and explanations when the new Savannah Hackers team
@@ -2197,7 +2242,7 @@
 e-mail change
 @end table
 
address@hidden Copying This Manual, Indices, Acknowledgements, Top
address@hidden Copying This Manual, Indices, Thanks to..., Top
 @appendix Copying This Manual
 
 @menu