[Savannah-cvs] administration lists/pending_projects_to_keep.t...

[Sylvain Beucler]

CVSROOT:        /cvsroot/administration
Module name:    administration
Branch:         
Changes by:     Sylvain Beucler <address@hidden>        04/08/22 11:08:50

Modified files:
        lists          : pending_projects_to_keep.txt 

Log message:
        Approved gperf.

CVSWeb URLs:
http://savannah.gnu.org/cgi-bin/viewcvs/administration/administration/lists/pending_projects_to_keep.txt.diff?tr1=1.56&tr2=1.57&r1=text&r2=text

Modified files:
        docs/hacking_savannah: hacking_savannah.texi 

Log message:
        Clean-up the test install chapter, continued (updates related to the 
Savane upgrade and Texinfo formatting)

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

Patches:
Index: administration/lists/pending_projects_to_keep.txt
diff -u administration/lists/pending_projects_to_keep.txt:1.158 
administration/lists/pending_projects_to_keep.txt:1.159
--- administration/lists/pending_projects_to_keep.txt:1.158     Wed Aug 18 
20:36:06 2004
+++ administration/lists/pending_projects_to_keep.txt   Wed Aug 18 20:42:07 2004
@@ -26,7 +26,6 @@
 cjvgs
 ekse
 imp
-kioskmv
 upangea
 danaxu
 parafianin
@@ -85,7 +84,8 @@
 magnus (beu)
 ilias (beu)
 contractchecker (x-nicolovici)
-easyblog (tsauter)
+easyblog (tsauter; request for tarball)
+kioskmv (tsauter; request for tarball)
 
 Approved:
 ~~~~~~~~~
Index: administration/docs/hacking_savannah/hacking_savannah.texi
diff -u administration/docs/hacking_savannah/hacking_savannah.texi:1.32 
administration/docs/hacking_savannah/hacking_savannah.texi:1.33
--- administration/docs/hacking_savannah/hacking_savannah.texi:1.32     Sun Aug 
22 10:02:35 2004
+++ administration/docs/hacking_savannah/hacking_savannah.texi  Sun Aug 22 
11:08:49 2004
@@ -1,5 +1,5 @@
 \input texinfo   @c -*-texinfo-*-
address@hidden $Id: hacking_savannah.texi,v 1.32 2004/08/22 10:02:35 Beuc Exp $
address@hidden $Id: hacking_savannah.texi,v 1.33 2004/08/22 11:08:49 Beuc Exp $
 @comment %**start of header
 @setfilename hacking_savannah.info
 @include version.texi
@@ -301,24 +301,25 @@
 
 First, install Debian woody v3.0r1 CD1, as well as the security updates.
 Make sure your /etc/apt/sources.list contains a debian mirrror:
address@hidden
-deb cdrom:[Debian GNU/Linux 3.0 r1 _Woody_ - Official i386 Binary-1 
(20021218)]/ unstable contrib main non-US/contrib non-US/main
address@hidden
address@hidden
 deb http://security.debian.org/ stable/updates main
 deb http://ftp.fr.debian.org/debian woody main
address@hidden smallexample
address@hidden
address@hidden example
 
 Then update your system:
address@hidden
address@hidden
 $ apt-get update
 $ apt-get upgrade
address@hidden smallexample
address@hidden example
 
 and install some additional basic software packages:
address@hidden
address@hidden
 $ apt-get install wget
 $ apt-get install rsync
 @dots{}
address@hidden smallexample
address@hidden example
 
 
 @node WWW root directory, Apache, System base, Savannah configuration
@@ -328,17 +329,17 @@
 directory (@pxref{chroot invocation, , , , coreutils}).
 
 Let's create the new root:
address@hidden
address@hidden
 $ cd /savannah
 $ mkdir dev && mknod dev/null c 1 3 && chmod 666 dev/null
address@hidden smallexample
address@hidden example
 
 and configure the network:
address@hidden
address@hidden
 $ mkdir etc
 $ cp /etc/resolv.conf etc
 $ cp /etc/services etc # ?
address@hidden smallexample
address@hidden example
 
 [TODO: this network configuration seems not to work, fix it]
 
@@ -347,31 +348,31 @@
 @section Apache
 
  Install some Apache 1 and PHP modules:
address@hidden
address@hidden
 $ apt-get install mod_ssl # (not apache-ssl)
 $ apt-get install apache-dev # (apxs)
 $ apt-get install php4-mysql
address@hidden smallexample
address@hidden example
 
 Also install mod_security:
address@hidden
address@hidden
 $ wget http://www.modsecurity.org/download/mod_security-1.7.6.tar.gz
 $ tar xzf mod_security-1.7.6.tar.gz
 $ cd mod_security-1.7.6/apache1
 $ apxs -cia mod_security.c
address@hidden smallexample
address@hidden example
 
 [TODO: add how to get it from debian unstable (libapache-mod-security)]
 
 Generate SSL keys (cheap solution):
address@hidden
address@hidden
 $ cd /etc/apache/ssl.crt
 $ ln -s snakeoil-dsa.crt savannah_gnu.crt
 $ ln -s snakeoil-dsa.crt savannah_nongnu.crt
 $ cd /etc/apache/ssl.key
 $ ln -s snakeoil-dsa.key savannah_nongnu.key
 $ ln -s snakeoil-dsa.key savannah_gnu.key
address@hidden smallexample
address@hidden example
 
 [TODO: add here how to create custom SSL keys]
 
@@ -388,101 +389,121 @@
 System}) used by Savane.
 
 Install MySQL:
address@hidden
address@hidden
 $ apt-get install mysql-server
address@hidden smallexample
address@hidden example
 
 Add a root password:
address@hidden
address@hidden
 /usr/bin/mysqladmin -u root password 'rootpass'
address@hidden smallexample
address@hidden example
 
 Add an account for Savane:
address@hidden
address@hidden
 $ mysql -u root -p mysql
 Enter password: <type your root password>
-mysql> add user values  localhost, savannahscripts, PASSWORD('scriptspass');
-mysql> GRANT SELECT,INSERT,UPDATE,DELETE,CREATE,DROP ON savannah.* TO 
'savannahscripts'@@'localhost'
address@hidden smallexample
+mysql> add user values  localhost, savannahscripts,
+       PASSWORD('scriptspass');
+mysql> GRANT SELECT,INSERT,UPDATE,DELETE,CREATE,DROP
+       ON savannah.* TO 'savannahscripts'@@'localhost'
address@hidden example
 
 MySQL must then be configured so as to run in the Savane root
 directory. In @file{my.cnf} replace @code{/var/run/mysqld/mysqld.sock}
 by @code{/savannah/mysqld/mysqld.sock}.
 
 And in @file{/etc/php4/apache/php.ini}, set:
address@hidden
address@hidden
 mysql.default_socket = /mysqld/mysqld.sock
address@hidden smallexample
address@hidden example
 
 While you are in @file{php.ini}, check
 that MySQL persistent connections are activated, via
address@hidden
address@hidden
 mysql.allow_persistent = On
address@hidden smallexample
address@hidden example
 
 Last, create the MySQL directory in Savane's root directory:
address@hidden
address@hidden
 $ mkdir -m 755 /savannah/mysqld
 $ chown mysql /savannah/mysqld
address@hidden smallexample
address@hidden example
 
 
 @node Savane, Remaining, MySQL, Savannah configuration
 @section Savane
 
 Get Savane and install it without configuration:
address@hidden
address@hidden
 $ cd /usr/src
 $ cvs -d:pserver:anonymous@@cvs.gna.org:/cvs/savane co savane
 $ ./configure # say no to interactive configuration
 $ make
 $ make database
 $ make conf
address@hidden smallexample
address@hidden example
+
+Now is the time to install Savane's Savannah.[non]gnu.org
+configuration:
+
address@hidden
+$ cd /savannah
+$ mkdir -m 755 etc
+$ cd etc
+$ cvs -d:ext:anoncvs@@savannah.gnu.org:/cvsroot/administration \
+  co -d savane administration/subversions
+$ ln -s savane/gnu-content
+$ ln -s savane/nongnu-content
address@hidden example
 
-Then copy Savannah's configuration file.
+Copy the @file{[non]gnu.conf} directories from Savannah.
 
 [TODO: explain how to reproduce this configuration file instead. Well,
 at least explain it]
 
address@hidden
+$ cd etc
+$ ln -s savane/gnu-conf
+$ ln -s savane/nongnu-conf
address@hidden example
+
address@hidden and @file{nongnu-conf} contain sensitive information
+such as MySQL passwords.
+
+Last, make the default configuration path point to the WWW root:
address@hidden
+$ cd /etc
+$ ln -s /savannah/etc/savane/gnu-conf savannah
address@hidden example
+
+You can infer from this that gnu-conf is the configuration file for
+the backend.
+
 You then can propagate the changes:
address@hidden
address@hidden
 $ make update-conf
address@hidden smallexample
address@hidden example
+
+Be sure that the @file{savannah.conf*} files have proper permissions:
address@hidden
+$ chmod 600 savannah.conf.pl
+$ chmod 644 savannah.conf.php
address@hidden example
 
 Also update the skills list:
address@hidden
address@hidden
 $ /usr/local/savannah/bin/sv_skill
address@hidden smallexample
address@hidden example
 
 You then can install the frontend in the WWW root directory:
address@hidden
address@hidden
 $ cd /savannah
-$ mv /usr/src/savannah/frontend .
+$ mv /usr/src/savane/frontend .
 $ ln -s frontend/php www
address@hidden smallexample
-
-Now is the time to install Savane's Savannah.[non]gnu.org
-configuration:
-
address@hidden
-$ cd /savannah
-$ mkdir -m 755 etc
-$ cd etc
-$ cvs -d:ext:anoncvs@@savannah.gnu.org:/cvsroot/administration co -d 
subversions administration/subversions
-$ ln -s subversions/gnu-content
-$ ln -s subversions/nongnu-content
address@hidden smallexample
-
-Copy directories @file{savannah} and @file{nongnu-conf} - contain
-sensitive information such as MySQL passwords.
-
address@hidden
-$ ln -s savannah gnu-conf
-$ chmod 600 savannah.conf.pl
-$ chmod 644 savannah.conf.php
address@hidden smallexample
address@hidden example
 
+The symbolic links are created this way so as to avoid to configure
+Apache to follow symlinks.
 
 At this point, you should be able to see Savane's default homepage
 when pointing your browser at your test machine.