SYMPA

Système de Multipostage Atomatique



















































Attention : Cette notice est réalisée en fonction de ma machine c'est à dire que ma configuration du logiciel Sympa ne s'appliquera peut-être pas à la votre. Voici ma configuration :
























Sympa est un logiciel libre répondant aux terme de la licence GPL les auteurs sont :

Serge AUMONT, Olivier SALAÜN et Christophe WOLFHULGEL



Traduction et guide par Frédéric LALLOUET



  1. Installation de Sympa


1.1. Prérequis


L'installation de Sympa demande l'installation de plusieurs autres logiciels ces logiciels seront en intéraction avec lui durant son fonctionnement. Les logiciels et/ou modules sont :


La majorité des logiciels et/ou modules nécessaires à l'installation sont disponible à partir du site de sympa http://listes.cru.fr/sympa et pour les autres rien qu'un bon moteur de recherche ne puisse vaincre



    1. . Création d'un utilisateur UNIX


Le premier pas avant d'installer sympa est de créer un utilisateur (que l'on nomera <user>) puis un groupe (pourquoi pas le même nom tout ceci en serait simplifié).


    1. Compilation et Installation


Pour commencer il faut décompresser la source dans un répertoire de votre choix on prendra par défaut /home/sympa

[<user>@localhost]# su - <user>

[<user>@localhost]$ gzip -dc nomdufichier.tar.gz | tar xf -


Ensuite avant de lancer make dans les répertoires /home/sympa/src et /home/sympa/nls, il vous faut configurer les fichiers Makefile présents dans ces deux répertoires en fonction de votre machine. Petit conseil pas touche après la ligne STOP.


[<user>@localhost / src]$ make

[<user>@localhost / src]$ make install


[<user>@localhost / nls]$ make

[<user>@localhost / nls]$ make install


Si tout c'est bien passer le répertoire /home/sympa/bin devrait être empli de programmes en Perl et autres.


    1. Choisir un répertoire de localisation


La phase suivante est de créer si nécessaire les répertoires suivants :


    1. Configuration de sympa.conf


Le fichier sympa.conf se trouve dans le répertoire /etc/

Voici le mien essayer de l'adapter à votre machine :


------------------------------DEBUT DU FICHIER-------------------------

## Configuration file for Sympa

## many parameters are optional (defined in src/Conf.pm)

## refer to the documentation for a detailed list of parameters


## Directory containing config. files for the lists, helpfile and list

## of lists. Non-absolute path is relative to this directory.

home /home/sympa/expl/


## File containing Sympa PID while running. Sympa also locks this file to

## ensure that it isn't running more than once. Caution : user sympa

## need to write access without special privilegee.

pidfile /home/sympa/sympa.pid


## Umask used for file creation by Sympa

umask 027


## List's welcome message filename

#welcome welcome


## List's subscribers filename (unless database is used)

#subscribers subscribers


## Facility used by Syslogd

syslog LOCAL1


## Communication mode with syslogd is either 'unix' (via Unix sockets) or

## 'inet' (use of UDP)

log_socket_type inet


## Maximum number of recipients per call to Sendmail

nrcpt 25


## Average number of recipients (ie max. number of different domains)

## per call to Sendmail

avg 10


## Max. number of Sendmail processes (launched by Sympa) running simultaneously

## Proposed value is quite low, you can rise it up to 100, 200 or even 300

## with powerfull systems.

maxsmtp 20


## The full path to the Message Transfer Agent program (default is Sendmail 8.7

## or above)

sendmail /var/qmail/


## Name of the host for Sympa

host localhost.localdomain


## E-mail address for sending / replying to administrative commands

## Effective address will be $EMAIL@$HOST

email sympa


## Directory containig available NLS catalogues (Message internationalization).

## At startup, Sympa uses default.cat if it exists.

msgcat /home/sympa/nls


## default language

lang fr


#### Spools location

## Directory is the main spool containing mails to be processed by Sympa

## (commands or messages). This should be the absolute path.

queue /home/sympa/spool/msg


queueoutgoing /home/sympa/spool/outgoing


## Digest spool

queuedigest /home/sympa/spool/digest


## Moderation spool (when send is set to editorkey or editorkeyonly)

queuemod /home/sympa/spool/mod


## Authentication spool. It contains authentication requests waiting for

## the requester to confirm (send param. set to privatekey/publickey)

queueauth /home/sympa/spool/auth

## Subscription expiration spool (Cf EXPIRE command)

queueexpire /home/sympa/spool/expire


## Delay between two scan of the main spool (queue). Avoid Zero value !

sleep 5

## data base parameters

db_type Pg


db_name sympa


db_host localhost


db_user sympa


db_passwd désolé



listmaster root@localhost.localdomain

cookie gh869jku5

queuebounce /home/sympa/spool/bounce

------------------------------FIN DU FICHIER----------------------------




    1. Alias Robot


Il vous suffit d'ajouter ces lignes au fichier alias de Qmail (/var/qmail/alias/.qmail-sympa) ou de Sendmail (/etc/aliases).

sympa : « |/usr/local/sympa/bin/queue sympa »

bounce+*: « |/usr/local/sympa/bin/bouncequeue sympa »

sympa-request: <user>@localhost.localdomain

sympa-owner: <user>@localhost.localdomain

listserv: sympa

listserv-request: sympa-request

majordomo: sympa

listserv-owner: sympa-owner


Ne pas oublier de relancer votre programme qmail ou sendmail


    1. Logs


Sympa garde une trace de toutes les procédures qu'il éxécute dans un fichier log. Ce qui demande la configuration du fichier /etc/syslog.conf, ajouter simplement :

local1.* /var/log/sympa


Ensuite relancer syslogd.


    1. Lancement du Daemon


Après avoir effectué ces quelques modifications il faut encore ajouter (mieux vaut donner que recevoir comme disait l'autre !!!!!) la séquence suivante dans votre fichier /etc/rc.d/rc.local

su sympa -c « /home/sympa/bin/sympa.pl -l fr »


  1. Configuration des paramêtres Robot


Cette configuration se fait dans le fichier /etc/sympa.conf je pense que les commentaires sont assez précis pour que vous puissiez comprendre. Je ne peut que vous conseiller de regarder le fichier sympa.conf que j'ai fournit de manière à atteindre la lumière.


  1. World Wide Sympa

    1. Installation


  1. installer sympa (ça peut toujours servir :-] )

  2. télécharger wwsympa-xx.tar.gz

  3. [<user>@localhost]#gunzip wwsympa-xx.tar.gz ; tar -xvf wwsympa-xx.tar

  4. [<user>@localhost]#cd wwsympa-xx

  5. Edition de Makefile et configuration de Perl, Installdir, Config, Sympadir

Exemple :

## Absolute path to the Perl interpreter

PERL = /usr/bin/perl


## Target directory for installing WWSympa

INSTALLDIR = /home/sympa/wwsympa


## User and group used by Sympa

USER = sympa

GROUP = sympa


## Emplacement du fichier de configuration de WWSympa

CONFIG = /etc/wwsympa.conf


## Bin directory for Sympa

## This directory contains perl modules of Sympa

SYMPADIR = /home/sympa/bin


## Programme d'installation des fichiers. Attention : on utilise la syntaxe

## Berkeley : install -c -g sympa -o sympa -m 4755 fichier repertoire-dest.

## Il faut vérifier que votre programme installe supporte cette syntaxe,

## sinon vous devrez modifier la partie "install" (ci-après) du fichier

## Makefile.

## installbsd Digital Unix

## install SunOS 4, Linux

## /usr/ucb/install Solaris 2

INSTALL = install


  1. [<user>@localhost /wwsympa]# make install

  2. [<user>@localhost /wwsympa]# perl -c wwsympa.fcgi

  3. Créer un fichier /etc/wwsympa.conf


Exemple :


------------------------------DEBUT DU FICHIER-------------------------

# chose to use cgilib or Fast_CGI. CGILIB is probably just for test and will

# provide bad response delay but easier install if you don't want to compile apache ...

use_fast_cgi 1


# where sympa load it's config

sympa_conf_file /etc/sympa.conf


# where to store html archives, probably NOT on the same partition as sympa

arc_path /home/httpd/html/arc


# Bounces are stored in [bounce_path]/[listname] dir

bounce_path /tmp/bounces


# path to the wonderfull mhonarc application. Required for html archives

# http://www.oac.uci.edu/indiv/ehood/mhonarc.html

mhonarc /usr/bin/mhonarc


# the title of main page

title Universalistes


# the main site root URL (probably the URL of your company)

site_url http://www.cru.fr


# the main site root anchor (may be some icon ?)

#site_anchor <IMG SRC="http://www.cru.fr/logos/logo-cru-80x40.gif" WIDTH=50 HEIGTH=25 border=0>

# because of a bug in the config parser site_anchor can't contain<SPACE> and " and / and : ...

site_anchor CRU


#################### You probably don't need to modify parameter under this line

#################### if you did standard installation of sympa.


# wws-archived.pl is a deamon you may run it

archived_pidfile /home/sympa/wwsympa/archived.pid


# wws-archived.pl is a deamon you may run it

bounced_pidfile /home/sympa/wwsympa/bounced.pid


# log facility, configure your syslog to chose a file

log_facility LOCAL2


cookie_expire 30000


review_page_size 20


# parameters for mhonarc, the file used is $mhonarc_ressources.$default_lang

mhonarc_ressources mhonarc-ressources


------------------------------FIN DU FICHIER----------------------------


    1. Configuration de httpd.conf


Ajouter :

ScriptAlias /wws /home/sympa/wwsympa.fcgi


  1. Sympa et Postgres


    1. Création de la Base de Données



createdb sympa


create table user table (

email_user varchar (100) not null,

gecos_user varchar (150),

password_user varchar (20),

cookie_delay_user int,

lang_user varchar (100),

primary key (email_user)

);

create table subscriber_table (

list_subscriber varchar (50) not null,

user_subscriber varchar (100) not null,

date_subscriber datetime not null,

update_subscriber datetime,

visibility_subscriber varchar (20),

reception_subscriber varchar (20),

bounce_subscriber varchar (30),

primary key (list_subscriber, user_subscriber)

);


  1. Personnalisation de Sympa


La personnalisation de sympa n'est pas le but de cette notice (qui est une version light c'est à dire une version servant à démarrer le plus rapidement possible sympa). Mais si cela vous interesse vous pouvez toujours télécharger la notice (en anglais celle-ci qui est plus complête et ou la personnalisation de sympa est expliquée).

A l'adresse suivante : http://liste.cru.fr/sympa/distribution/doc/sympa en version html

ou

http://liste.cru.fr/sympa/distribution/doc/sympa.ps en version postscript


  1. Création d'une mailing list



    1. Alias de Mail


Ce qui suit est pour Qmail (si vous possédez Sendmail désolé !!!!!)