mailman: add archives documentation
[doc-infra.git] / doc / mailman.rst
CommitLineData
21a713aa
NI
1Fonctionnement de Mailman
2=========================
3
4Mailman est un serveur de listes mails.
5Il s'occupe de la gestion des abonnements, des archives ...
6
7La gestion sur les serveurs mail
8--------------------------------
9
10Un seul serveur mail a mailman installé et configuré pour envoyer des mails : c'est celui qui héberge le site web (à cause du RPC qui tourne en local).
11Les autres MXs peuvent (éventuellement) recevoir des mails à destination d'une liste ; dans ce cas, ils transmettront au plus tôt à svoboda.
12
13Le serveur de développement peut aussi avoir mailman installé.
14
15La gestion sur le Web
16---------------------
17
18XMLRPC
19------
20
21Le démon RPC tourne sous ``supervise``, un programme des daemontools, qui se charge de relancer un service (exécutable) s'il s'arrête. Quand tout se passe bien, on peut utiliser ``svc -[option]`` pour (re)lancer / arrêter / ... le démon RPC.
22
23Le RPC reçoit des commandes depuis le site web, qui viennent par XMLRPC. (Détails)
24
25Debug
26-----
27
28Mailman, comme postfix, possède plusieurs queues mail.
29Elles sont dans plusieurs sous-dossiers de ``/var/lib/mailman/qfiles``.
30
31On dispose de
32
33* ``/var/lib/mailman/bin/show_qfiles`` pour inspecter le contenu d'un message (argument = fichier ``.pck`` du message) ;
34* ``/var/lib/mailman/bin/unshunt`` pour libérer des messages.
35* ``/var/lib/mailman/bin/discard`` pour supprimer un message en modération (dans le cas de spam vraiment massif).
36
37Mailman logge dans ``/var/log/mailman``.
f2e56c55
NI
38
39Archives
40--------
41
42Les archives de mailman se trouvent dans ``/var/lib/mailman/archives/private``. Par exemple la liste ma-liste@listes.example.org a ses archives dans un fichier MBOX situé dans ``/var/lib/mailman/archives/private/ma-liste.mbox/ma-liste.mbox``.
43À Polytechnique.org, la visualisation de ces archives sur internet utilise Banana, qui communique avec mailman en NNTP pour obtenir les arborescences de messages.
44
45Pour supprimer un message, il suffit d'éditer le fichier MBOX avec par exemple Mutt::
46
47 cp ma-liste.mbox modif.mbox
48 mutt -f modif.mbox
49
50À la fin de l'édition du fichier mbox, Mutt a pu ajouter des entêtes suivants dans les messages::
51
52 Status: O
53 Content-Length: 357
54 Lines: 15
55
56Pour les supprimer, il suffit d'éxecuter la commande ``sed`` suivante::
57
58 sed '/^Status: /{N;N;/Content-Length: .*Lines: /d}' < modif.mbox > modif-clean.mbox
59
60À la fin du traitement, si ``ma-liste.mbox`` n'a pas été modifié (ie. si aucun message n'a été reçu), il est possible de régénérer les archives comme décrit sur http://wiki.list.org/pages/viewpage.action?pageId=4030681)::
61
62 mv ma-liste.mbox OLD-ma-liste.mbox
63 mv modif-clean.mbox ma-liste.mbox
64 cd /var/lib/mailman
65 ./bin/arch ma-liste
66
67De plus, il faut vider le cache de banana concernant les archives de la liste::
68
69 rm ~web/prod/platal/spool/banana/MLArchives/ma-liste/*