rev 1404 - trunk/siesta

[prev] [thread] [next] [lurker] [Date index for 2003/09/05]

From: richardc
Subject: rev 1404 - trunk/siesta
Date: 15:40 on 05 Sep 2003
Author: richardc
Date: 2003-09-05 15:40:10 +0100 (Fri, 05 Sep 2003)
New Revision: 1404

Modified:
   trunk/siesta/INSTALL
Log:
be clearer


Modified: trunk/siesta/INSTALL
===================================================================
--- trunk/siesta/INSTALL	2003-09-05 14:24:25 UTC (rev 1403)
+++ trunk/siesta/INSTALL	2003-09-05 14:40:10 UTC (rev 1404)
@@ -1,71 +1,53 @@
--------------------------------------
-  NOTE : this is *alpha* software
-  It will probably kill your system,
-  murder your friends and bring 
-  about the apocalypse. You have  
-  been warned. So watch it.
--------------------------------------
+=head1 Installing the modules
 
-
--------------------------------------
- * Installing the modules
--------------------------------------
-
 Currently just install like any other Perl module :
 
-% perl Build.PL
-% perl Build test
-% su
-# perl Build install
+ % perl Build.PL
+ % perl Build test
+ % su
+ # perl Build install
 
+During the configuration step you will be asked to name a directory to
+install the system into.  /usr/local/siesta is the default.  We'll assume
+you chose that for the rest of this document.
 
-During the install process you will be asked to provide a directory to
-install the database in. '/usr/local/siesta/' will probably be ok. 
-
 From now on we'll assume that you've chosen '/usr/local/siesta' however
 you should subsitute whatever you actually chose wherever this document 
 mentions it.
 
 
+=head1 Set up the group and database
 
--------------------------------------
- * Setting up the database
--------------------------------------
+The first thing you'll need to do is set up a group.
 
-The first thing you'll need to do is create the database. 
+Assuming you use the default SQLite backend you will need to arrange
+for the user that runs the mail process to have read and write access
+to /usr/local/siesta.
 
-Because of the way it will be run the user that runs the mail process 
-will need read and write access to that directory and the database that 
-goes in there. Make a new group called siesta or something and add the 
-mail user (usually 'mail' or 'exim' or something), the webserver user 
-(for when we have a web based interface, this is usually 'nobody') and, 
-if you want to, either yourself or a new user expecially for 
-configuring siesta ('siesta' is a good name for this). Then 
+Make a new group called siesta and add the mail user (usually 'mail'
+or 'exim' but check your local convention), the webserver user (if you
+wish to use the web interface).
 
-  % sudo nacho create-database
+  # nacho create-database
+  # chgrp -R siesta /usr/local/siesta
+  # chmod -R g+rwx /usr/local/siesta
 
-  % chgrp -R siesta /usr/local/siesta
-  
-  % chmod -R g+rwx /usr/local/siesta
 
-or some combination of these. Basically you want to end up with an empty 
-database with all the tables set up that is readable and writeable by 
-your mail user and, optionally, the web server user and anybody else you 
-want to have configuration rights for Siesta.
+=head1 Regular operation 
 
 Then read the B<Siesta::UserGuide> file using 
 
   % perldoc Siesta::UserGuide
 
-for how to create new lists and members, add members to lists, configure 
-plugins and generally administer the system.
+for how to create new lists and members, add members to lists,
+configure plugins and generally administer the system.
 
 
 -------------------------------------
  * Installing the web frontend
 -------------------------------------
 
-You need to add a line like this to your Apache config in one of the 
+You need to add a line like this to your Apache config in one of the
 virtual server sections
 
   ScriptAliasMatch /siesta/.*\.tt2 /usr/local/siesta/web-frontend/tt2.cgi
@@ -81,8 +63,3 @@
 functionality is there but work needs to be done on making it not completely 
 braindead usability wise.
 
-
-
-
-
- 

Generated at 13:57 on 01 Jul 2004 by mariachi 0.52