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

[Elfyn McBratney]

CVSROOT:        /cvsroot/administration
Module name:    administration
Branch:         
Changes by:     Elfyn McBratney <address@hidden>        04/08/09 21:34:43

Modified files:
        docs/hacking_savannah: hacking_savannah.texi 

Log message:
        New Mailman admin chapter.

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

Patches:
Index: administration/docs/hacking_savannah/hacking_savannah.texi
diff -u administration/docs/hacking_savannah/hacking_savannah.texi:1.16 
administration/docs/hacking_savannah/hacking_savannah.texi:1.17
--- administration/docs/hacking_savannah/hacking_savannah.texi:1.16     Mon Aug 
 9 20:28:53 2004
+++ administration/docs/hacking_savannah/hacking_savannah.texi  Mon Aug  9 
21:34:43 2004
@@ -1,5 +1,5 @@
 \input texinfo   @c -*-texinfo-*-
address@hidden $Id: hacking_savannah.texi,v 1.16 2004/08/09 20:28:53 Beuc Exp $
address@hidden $Id: hacking_savannah.texi,v 1.17 2004/08/09 21:34:43 beu Exp $
 @comment %**start of header
 @setfilename hacking_savannah.info
 @include version.texi
@@ -67,6 +67,7 @@
 * Communication::               How to get in sync with other people working 
on Savannah.gnu.org
 * Savannah configuration::      Precise details on the Savannah configuration, 
including instructions to reproduce it
 * MySQL::                       Basic tips on using MySQL
+* Mailman Administration::      
 * Some Savannah tasks::         
 * Frequent support requests::   Step by step instructions on how to answer 
common support requests
 * Some quirks::                 Stuff we need to clear up sooner or later
@@ -298,7 +299,7 @@
 
 
 
address@hidden MySQL, Some Savannah tasks, Savannah configuration, Top
address@hidden MySQL, , Savannah configuration, Top
 @chapter MySQL
 
 This chapter is about MySQL: its configuration, and how to perform
@@ -351,9 +352,66 @@
 #   mysql> grant select,update on foodb.* to address@hidden identified by 
'baz';
 @end verbatim
 
address@hidden Mailman Administration, Some Savannah tasks, MySQL, Top
address@hidden Mailman Administration
 
+This chapter details common Mailman administration tasks that need
+to be performed for Savannah projects (GNU and non-GNU).
 
address@hidden Some Savannah tasks, Frequent support requests, MySQL, Top
address@hidden Access to lists.gnu.org
+
+Some Mailman admin tasks need to be performed on the actual machine
+where Mailman is installed (though, some tasks like changing the
+password for a list can be done via the web interface).
+
+In order to do this you need to have shell access to the machine that
+run's the master Mailman installation (ask
address@hidden@@gnu.org} if you do not already have access).
+
+Once your ssh public key has been added, you need to log in as the
+user `list'.  Once logged in you will be greeted with the bash prompt:
+
address@hidden
address@hidden list]$
address@hidden verbatim
+
+From here you can perform all sorts of Mailman administrative tasks,
+that are discussed below.
+
address@hidden Creating a new list
+
+To Create a new mailing list, you first need the following information:
+
address@hidden @bullet
address@hidden The name of the new list (and/or the project it belongs to)
address@hidden The email address of the list owner
address@hidden itemize
+
+If you have not been given a specific address, and this request has
+come from a project administrator on Savannah, use the email address
+attached to their account.
+
+To actually create the list, run the following commands from the shell:
+
address@hidden/var/mailman/bin/newlist}
+When prompted enter the list name, the list owner email address and
+an initial pasword.  (Use common sense when choosing the password; 
+make sure it's >= 6 characters long and used at least letters and
+numbers.)
+
address@hidden /var/mailman/lists/<new-list-name>/domains}
+Create the `domains' directory.
+
address@hidden /var/mailman/lists/<new-list-name>/domains/gnu.org}
+If the the list you are creating is for a GNU project, touch the
+file `gnu.org' in the list's `domains' subdirectory.
+
address@hidden /var/mailman/lists/<new-list-name>/domains/nongnu.org}
+Otherwise, for non-GNU projects, touch the file `nongnu.org' in the
+list's `domains' subdirectory.
+
+
address@hidden Some Savannah tasks, Frequent support requests, Mailman 
Administration, Top
 @chapter Some Savannah tasks
 
 @section Adding a Frequently Asked Question