[prev] [thread] [next] [lurker] [Date index for 2003/09/05]
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