[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 20:29:11

Modified files:
        docs/hacking_savannah: hacking_savannah.texi 

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

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

Patches:
Index: administration/docs/hacking_savannah/hacking_savannah.texi
diff -u administration/docs/hacking_savannah/hacking_savannah.texi:1.40 
administration/docs/hacking_savannah/hacking_savannah.texi:1.41
--- administration/docs/hacking_savannah/hacking_savannah.texi:1.40     Mon Sep 
20 16:35:00 2004
+++ administration/docs/hacking_savannah/hacking_savannah.texi  Mon Sep 20 
20:29:11 2004
@@ -1,5 +1,5 @@
 \input texinfo   @c -*-texinfo-*-
address@hidden $Id: hacking_savannah.texi,v 1.40 2004/09/20 16:35:00 Beuc Exp $
address@hidden $Id: hacking_savannah.texi,v 1.41 2004/09/20 20:29:11 Beuc Exp $
 @comment %**start of header
 @setfilename hacking_savannah.info
 @include version.texi
@@ -279,6 +279,9 @@
 * Apache::                      
 * MySQL::                       
 * Savane::                      
+* Tuning your local install::   
+* CVS::                         
+* Populating your test install::  
 * Remaining::                   
 @end menu
 
@@ -379,6 +382,11 @@
 $ mkdir /etc/apache/logs
 @end example
 
+The magic configure line in @file{httpd.conf} will be:
address@hidden
+SecChrootDir /savannah
address@hidden example
+
 [TODO: add how to get it from debian testing or unstable
 (libapache-mod-security)]
 
@@ -453,14 +461,8 @@
 the MySQL socket. Document it and determine why it is necessary at
 sv.gnu.org unlike in my Debian stable]
 
-[Another way to create the database is to get the one from Savannah:
address@hidden
-$ mysqldump -C --add-locks -F -l savannah >out.sql
address@hidden example
-
-But you need to install Savane first, don't you?]
 
address@hidden Savane, Remaining, MySQL, Savannah configuration
address@hidden Savane, Tuning your local install, MySQL, Savannah configuration
 @section Savane
 
 Get Savane and install it without configuration:
@@ -567,6 +569,7 @@
 $ chmod 640 savannah.conf.php
 $ chgrp www-data savannah.conf.php
 @end example
+for both gnu-conf and nongnu-conf.
 
 Also update the skills list:
 @example
@@ -578,33 +581,125 @@
 $ cd /savannah
 $ mv /usr/src/savane/frontend .
 $ ln -s frontend/php www
+$ cd /usr/src/savane
+$ ln -s /savannah/frontend
 @end example
 
 The symbolic links are created this way so as to avoid following
 symlinks outside the WWW root.
 
-Now, you need to tune the Savannah configuration files to your installation.
-our $sys_default_domain="dott";
 
-Plus change apache's references to sv.[non]gnu.org.
+Currently, some files from the sysadmins requires a Setuid backport
+from Perl 5.8 to Perl 5.6.
+
+If you stuck to Debian stable, grab it from @file{/usr/src/Setuid} at
+savannah.gnu.org. Installing is easy and classical:
address@hidden
+$ cd /usr/src/Setuid
+$ make Makefile.PL
+$ make
+$ make install
address@hidden example
+
+Else, you should be able to simply update your Perl.
+
+
address@hidden Tuning your local install, CVS, Savane, Savannah configuration
address@hidden Tuning your local install
+
+To be able to test both gnu and nongnu, you can either:
address@hidden
address@hidden Buy 2 ethernet cards: 
+just change the IPs in @file{vhosts-gnu.org} and
address@hidden in @file{/etc/apache}
address@hidden Configure your local @command{named}:
+for example, I created a localdomain zone in @file{named.conf}:
address@hidden
address@hidden
+zone  "1.168.192.in-addr.arpa" @{
+       type master;
+       file  "1.168.192.in-addr.arpa.zone";
address@hidden;
+
+zone  "localdomain" @{
+       type master;
+       file  "localdomain.zone";
address@hidden;
address@hidden
address@hidden example
+and added a @file{localdomain.zone} file:
address@hidden
address@hidden
+dr              IN      A       192.168.1.5
+savannah.gnu    IN      CNAME   dr
+savannah.nongnu IN      CNAME   dr
+audio-video.gnu IN     CNAME   dr
address@hidden
address@hidden example
+Since giving a lesson on named is not the goal of this document, I
+point you to @xref{named,,, *manpages*}.
+Then replace the IPs in vhosts-gnu.org and vhosts-nongnu.org in
+/etc/apache by the domain name; also update @samp{ServerName}s.
+Also add this to @file{httpd.conf}:
address@hidden
+NameVirtualHost savannah.gnu:80
+NameVirtualHost savannah.gnu:443
address@hidden example
address@hidden itemize
+
+Now, you need to tune the Savannah configuration files to your
+installation, namely:
address@hidden
+our $sys_default_domain="savannah.gnu";
+our $sys_brother_domain="savannah.nongnu";
+our $sys_mail_domain="localhost";
address@hidden example
+
+Don't forget to replicate this to the .php configuration file, and
+apply similar changes in the nongnu configuration files.
 
 At this point, you should be able to see Savane's default homepage
 when pointing your browser at your test machine.
 
+[TODO: make that more explicit, and detail the conf for sv.gnu.org and
+savana.gnu.org, among others]
+
 
-Plus install the backport of Setuid fron Perl 5.8 to Perl 5.6 that
-sysadmins apparently used (/usr/src/Setuid), or update your Perl (I
-guess).
address@hidden CVS, Populating your test install, Tuning your local install, 
Savannah configuration
address@hidden CVS
 
 Plus create /savannah/cvsroot.
address@hidden
+$ mkdir -m 755 /savannah/cvsroot
address@hidden example
 
 Plus copy /savannah/cvs-seed to your install.
 
+
address@hidden Populating your test install, Remaining, CVS, Savannah 
configuration
address@hidden Populating your test install
+
 Plus modify the source (/php/include/account.php) to permit group
-'www' creation, and create that group.
+'www' creation, and create that group. Or import the DB from a SQL dump.
+
+At savannah.gnu.org:
address@hidden
+$ mysqldump -C --add-locks -F -l savannah > dump.sql
address@hidden example
+
+and then at your test install:
address@hidden
+# First empty the current database
+$ mysql -p savannah
+mysql> drop database savannah
+mysql> create database savannah
+# Then fill it again
+$ mysql -p savannah < dump.sql
address@hidden example
 
+Just be patient, the dump weighs as of 2004-09 some 155MB.
 
address@hidden Remaining,  , Savane, Savannah configuration
address@hidden Remaining,  , Populating your test install, Savannah 
configuration
 @section Remaining
 
 @itemize