Next: 3. Installing Sympa
Up: Sympa Mailing Lists Management Software
Previous: 1. Presentation
  Contents
  Index
Subsections
2.1 Organization
Here is a snapshot of what Sympa looks like once it has settled
on your system. This also reveals the pruduct's philosophy I guess.
- ~sympa/
The root directory of Sympa, you will find almost everything
related to Sympa under this directory, except logs and main
configuration files.
- ~sympa/bin/
This directory contains the binaries, including CGI. It
also contains the default scenarios, templates and configuration
files.
- ~sympa/bin/etc/
Sympa will find here defaults for what it expects in
~sympa/etc/ (scenarios, templates and configuration
files, recognized S/Mime certificates).
- ~sympa/etc/
This is your site's configuration directory. Take a look at
~sympa/bin/etc/ for designing your own.
- ~sympa/etc/create_list_templates/
Here are your list's templates, those proposed at list
creation time.
- ~sympa/etc/scenari/
This directory will contain your scenarios. If you don't
know what the hell is a scenario, refer to 8.6,
page
.
- ~sympa/etc/wws_templates/
The web interface (WWSympa) is made of template HTML
files parsed by the CGI program.
- ~sympa/etc/templates/
Some replies of the mail robot are defined by templates
(welcome.tpl for SUBSCRIBE). You can overload
these template files in the list's directory, here are
the defaults.
- ~sympa/expl/
The working directory of Sympa.
- ~sympa/expl/mylist
The list directory, refer to 9.2,
page
.
- ~sympa/nls/
Internationalization directory. It contains XPG4-compatible
messages catalogues. Sympa has currently been translated
to 8 different languages.
- ~sympa/spool/
Sympa uses 6 different spools.
- ~sympa/src/
Here is where we store Sympa sources.
2.2 Binaries
- sympa.pl
The main daemon ; it processes commands and delivers
messages. It is permanently scanning the msg/ spool.
- wwsympa.fcgi
This is the CGI program, proposing a complete web interface
to mailing lists. It can work in both classical CGI and
FastCGI modes ; we recommand FastCGI mode though, being
up to 10 times faster.
- bounced.pl
This daemon processes bounces (non-delivery messages),
looking for the bad addresses. List owners will later
access bounces information via WWSympa. It is permanently
scanning the bounce/ spool.
- archived.pl
This daemon feeds the web archives, converting messages
to HTML format and linking them. It uses the amazing
MhOnArc. It is permanently scanning the outgoing/
spool.
- queue
This small program gets the incoming messages from the aliases
and store them in msg/ spool.
- bouncequeue
Same as queue for bounces. It stores bounces in
bounce/ spool.
- sympa.conf
The main configuration file.
See 4, page
.
- wwsympa.conf
WWSympa configuration file.
See 5.1, page
.
- edit_list.conf
It defines what parameters/files are editable by
owners. See 10.2, page
.
- topics.conf
Define your site's topics (classification in WWSympa) in this
file with titles. A sample is provided in sample/ directory
of the sympa distribution.
See 8.5, page
.
2.4 Spools
- ~sympa/spool/auth/
For storing messsages until it has been confirmed.
- ~sympa/spool/bounce/
For storing incoming bouncing messages.
- ~sympa/spool/digest/
For storing lists' digests before it is sent.
- ~sympa/spool/expire/
Related to expire process.
- ~sympa/spool/mod/
For storing unmoderated messages.
- ~sympa/spool/msg/
For storing incoming messages (including commands).
- ~sympa/spool/outgoing/
sympa.pl dumps messages i this spool
for archived.pl to archive them.
Next: 3. Installing Sympa
Up: Sympa Mailing Lists Management Software
Previous: 1. Presentation
  Contents
  Index
root
2000-12-20