Chapril DokuWiki

Outils pour utilisateurs

Outils du site

Vous êtes ici : start » admin » infrastructure » sympa
admin:infrastructure:sympa

Différences

Ci-dessous, les différences entre deux révisions de la page.

Lien vers cette vue comparative

Les deux révisions précédentesRévision précédente
admin:infrastructure:sympa [2022/01/05 13:56] – Ajout explication pour modifier d'un message de Sympa ticket #5736 fcouchetadmin:infrastructure:sympa [2026/03/03 22:53] (Version actuelle) – Correction typographique fhenry2
Ligne 1: Ligne 1:
-====== Création d'une liste ======+====== Service Listes ======
  
-Pour créer une liste il faut utiliser l'interface WWSympa https://listes.chapril.org/sympa/create_list_request+===== Création d'une liste =====
  
-Pour une liste de type support, il faut choisir le template « Template pour une liste de type support » qui contient notamment des éléments de configuration en lien avec la gestion des adresses en erreur. Voir le ticket https://agir.april.org/issues/5692 pour plus d'information.+Pour créer une liste il faut utiliser l'interface WWSympa depuis la page de [[https://listes.chapril.org/sympa/create_list_request|requête de création de liste]].
  
-Il faut choisir un Objet pour la liste.+Pour une liste de type support, il faut choisir le modèle //Template pour une liste de type support// qui contient notamment des éléments de configuration en lien avec la gestion des adresses en erreur. 
 +Voir le [[https://agir.april.org/issues/5692|ticket n°5692]] pour plus d'information.
  
-L'interface demande aussi de choisir un « Public visé », ce qui est inutile dans notre cas. Choisir « Autre » (tout en cas de la liste).+Il faut choisir un //objet// pour la liste.
  
-Ajouter une courte description.+L'interface demande aussi de choisir un //public visé//, ce qui est inutile dans notre cas. 
 +Choisir //Autre// tout en bas de la liste.
  
-Puis cliquer sur « Envoyer votre demande de création ».+Ajouter une //description// courte.
  
-La liste est créée. Il faut ensuite ajouter les adresses courriels des personnes qui recevront les courriels de support (dans l'onglet « Les utilisateurs -> Abonnés ». Mettre aussi ces adresses en Propriétaires de la liste, dans l'onglet « Les utilisateurs -> Propriétaires », en pensant à cocher la case « Gestionnaire privilégié ».+Puis cliquer sur //Envoyer votre demande de création//. 
 + 
 +La liste est créée. 
 +Il faut ensuite ajouter les adresses courriels des personnes qui recevront les courriels de support dans l'onglet //Les utilisateurs// puis //Abonnés//. 
 +Mettre aussi ces adresses en //Propriétaires de la liste//, dans l'onglet //Les utilisateurs// puis //Propriétaires//, en pensant à cocher la case //Gestionnaire privilégié//.
  
 Puis envoyer un courriel de test avec une adresse non inscrite à la liste, pour vérifier la bonne diffusion du message. Puis envoyer un courriel de test avec une adresse non inscrite à la liste, pour vérifier la bonne diffusion du message.
  
-Pour la création du template « Template pour une liste de type support », création du répertoire /etc/sympa/create_list_templates/liste-support/ puis copie des fichiers /usr/share/doc/sympa/examples/samples/intranet/create_list_templates/intranet_list/comment.tt2 et /usr/share/doc/sympa/examples/samples/intranet/create_list_templates/intranet_list/config.tt2 puis modification des fichiers.+Pour la création du modèle //Template pour une liste de type support// procéder comme suit : 
 +<code bash> 
 +mkdir -p /etc/sympa/create_list_templates/liste-support/ 
 +cp /usr/share/doc/sympa/examples/samples/intranet/create_list_templates/intranet_list/{comment,config}.tt2 \ 
 +/etc/sympa/create_list_templates/liste-support/ 
 +</code>
  
-====== Modification d'un message envoyé par Sympa ======+Ces deux copies peuvent être éditées pour personnaliser le modèle.
  
-Il y a un mauvais message affiché lorsqu'une personne tente de s'inscrire à une liste qui demande une confirmation d'inscription par courriel (que ce soit via l'interface web ou par courriel). Celaa induit en erreur la personne qui du coup ne validera peut-être pas l'inscription.+===== Modification d'un message envoyé par Sympa =====
  
-La personne reçoit deux courriel. Un courriel de Sympa pour valider son inscription mais elle reçoit un 2e courriel indiquant //La demande a été soumise au gestionnaire de la liste//.+Il y a un mauvais message affiché lorsqu'une personne tente de s'inscrire à une liste qui demande une confirmation d'inscription par courriel que ce soit via l'interface Web ou par courriel. 
 +Cela induit en erreur la personne qui, du coup, peut ne pas valider l'inscription.
  
-Le ticket https://agir.april.org/issues/5736+La personne reçoit deux courriels. 
 +Un courriel de Sympa pour valider son inscription mais elle reçoit un 2e courriel indiquant //La demande a été soumise au gestionnaire de la liste//.
  
-C'est exactement le même souci qu'avec le Sympa de l'April, voir https://agir.april.org/issues/5736+C'est exactement le même souci qu'avec l’instance Sympa de l'April, comme indiqué au [[https://agir.april.org/issues/5736|ticket n°5736]].
  
-On applique la même résolution que pour le Sympa de l'April :+On applique la même résolution que pour l’instance Sympa de l'April : 
 +<code bash> 
 +apt install gettext 
 +mkdir /root/sympa-ticket-5736 
 +cd /root/sympa-ticket-5736 
 +dpkg -s sympa |grep Version 
 +wget http://deb.debian.org/debian/pool/main/s/sympa/sympa_6.2.60~dfsg.orig.tar.xz 
 +tar Jxvf sympa_6.2.60~dfsg.orig.tar.xz 
 +cd sympa-6.2.60/po/sympa/ 
 +msgfmt -c -o fr.mo -v fr.po 
 +</code> 
 +<code> 
 +-> 2810 messages traduits, 1 traduction approximative, 1 message non traduit. 
 +</code>
  
-  apt install gettext +En comparant au fichier qui est livré avec le paquet Debian : 
-  mkdir /root/sympa-ticket-5736 +<code bash> 
-  cd /root/sympa-ticket-5736 +diff -u /usr/share/locale/fr/LC_MESSAGES/sympa.mo fr.mo 
-  dpkg -s sympa |grep Version +</code> 
-  wget http://deb.debian.org/debian/pool/main/s/sympa/sympa_6.2.60~dfsg.orig.tar.xz +<code> 
-  tar Jxvf sympa_6.2.60~dfsg.orig.tar.xz +fichier identique (parfait) 
-  cd sympa-6.2.60/po/sympa/ +</code>
-  msgfmt -c -o fr.mo -v fr.po +
-  -> 2810 messages traduits, 1 traduction approximative, 1 message non traduit. +
-  Diff avec le fichier qui est livré avec le paquet Debian : +
-  diff -u /usr/share/locale/fr/LC_MESSAGES/sympa.mo fr.mo +
-  fichier identique (parfait)+
  
-On peut donc modifier le fichier fr.po pour remplacer la chaîne et avoir un nouveau fichier MO :+On peut donc modifier le fichier ''fr.po'' pour remplacer la chaîne et avoir un nouveau fichier MO : 
 +<code bash> 
 +cp fr.po fr.po.orig 
 +vi fr.po 
 +diff -u fr.po.orig fr.po 
 +</code> 
 +<code> 
 +-msgstr "La demande a été soumise au gestionnaire de la liste (%1)"  
 ++msgstr "Votre requête à été transmise à l'adresse (%1) pour une demande de confirmation. Le message envoyé contenant un lien de validation."  
 +</code> 
 +<code bash> 
 +msgfmt -c -o fr.mo -v fr.po 
 +</code>
  
-  cp fr.po fr.po.orig +On met en production : 
-  vi fr.po +<code bash> 
-  diff -u fr.po.orig fr.po +cd /usr/share/locale/fr/LC_MESSAGES/ 
-  -msgstr "La demande a été soumise au gestionnaire de la liste (%1)"  +cp sympa.mo sympa.mo.dpkg 
-  +msgstr "Votre requête à été transmise à l'adresse (%1) pour une demande de confirmation. Le message envoyé contenant un lien de validation."  +cp ~/sympa-ticket-5736/sympa-6.2.40/po/sympa/fr.mo sympa.mo 
-  msgfmt -c -o fr.mo -v fr.po+systemctl restart sympa 
 +systemctl restart wwsympa 
 +</code> 
 +   
 +===== Interconnexion entre Sympa et Postfix =====
  
-On met en prod :+Pour rappel on a une architecture avec un relais courriel qui gère tout ce qui entre ou sort du //cluster// au niveau du courriel. 
 +Le service Listes est installé sur une VM séparée. 
 +Pour éviter la confusion on nommera ''guest'' la machine hébergeant Listes et on nommera ''relais'' la machine hébergeant l’instance Postfix frontale.
  
-  cd /usr/share/locale/fr/LC_MESSAGES/ +<note important> 
-  cp sympa.mo sympa.mo.dpkg +On est ici dans une documentation //a posteriori// d'un truc un peu //touchy//, donc il est possible que des erreurs subsistent. 
-  cp ~/sympa-ticket-5736/sympa-6.2.40/po/sympa/fr.mo sympa.mo +</note>
-  systemctl restart sympa +
-  systemctl restart wwsympa +
-   +
-====== Interconnexion entre sympa et postfix ======+
  
-Pour rappel on a une architecture avec un relais mail qui gère tout ce qui entre/sort du cluster au niveau du mail. Le sympa est installé sur une machine séparée. Pour éviter la confusion on nommera //guest// la machine hébergeant le sympa et on nommera //relais// la machine hébergeant le postfix frontal.+==== Postfix coté relais ====
  
-<note important>On est ici dans une documentation a posteriori d'un truc un peu touchy, donc il est possible que des erreurs subsistent.</note> +Pour que la VM ''relais'' transmette les courriel à ''guest'', il faut installer les bons transports.
-===== Postfix coté relais =====+
  
-Pour que le relais transmette les emails au bon guest, il faut installer les bons transports. +<code - /etc/postfix/conf.d/40-sympa.conf>
-<code conf /etc/postfix/conf.d/40-sympa.conf>+
 transport_maps = hash:/etc/postfix/transports/sympa, hash:/etc/postfix/transports/slow_domains, hash:/etc/postfix/transports/sympa-static transport_maps = hash:/etc/postfix/transports/sympa, hash:/etc/postfix/transports/slow_domains, hash:/etc/postfix/transports/sympa-static
 </code> </code>
  
-Par ailleurs il faut que le relais reconnaisse les transports comme des destinataires valides. Nous avons donc +Par ailleurs il faut que ''relais'' reconnaisse les transports comme des destinataires valides. 
-<code conf /etc/postfix/conf.d/42-recipients.conf >+Nous avons donc cette ligne : 
 +<code - /etc/postfix/conf.d/42-recipients.conf >
 local_recipient_maps = proxy:unix:passwd.byname $alias_maps $transport_maps local_recipient_maps = proxy:unix:passwd.byname $alias_maps $transport_maps
 </code> </code>
  
-Examinons les définitions des transports : +On examine les définitions des transports : 
-  - ''slow_domains'' : pour limiter le débit de soumission des courrier à des domaine pauvres comme laposte.net qui n'ont pas les moyens d'encaisser plus de 1 courriel à la fois. Ce n'est pas à proprement parler essentiel à sympa, mais de fait le besoin s'en fait largement sentir lorsqu'un sympa est installé.<code conf /etc/postfix/transports/slow_domains.map >+  - ''slow_domains'' : pour limiter le débit de soumission des courriels à des domaines pauvres comme ''laposte.net'' qui n'ont pas les moyens d'encaisser plus d’un courriel à la fois((Ce n'est pas à proprement parler essentiel à Sympa, mais de fait le besoin s'en fait largement sentir lorsqu’une instance de Sympa est déployée.)) : 
 +<code - /etc/postfix/transports/slow_domains.map>
 aliceadsl.fr slow: aliceadsl.fr slow:
 free.fr slow: free.fr slow:
Ligne 96: Ligne 131:
 yahoo.fr slow: yahoo.fr slow:
 </code> </code>
-  - ''sympa-static'' : les adresses de services pour le sympa.<code conf /etc/postfix/transports/sympa-static.map >+  - ''sympa-static'' : les adresses de services pour Sympa : 
 +<code - /etc/postfix/transports/sympa-static.map>
 sympa@chapril.org            smtp:[sympa.cluster.chapril.org] sympa@chapril.org            smtp:[sympa.cluster.chapril.org]
 sympa-request@chapril.org    smtp:[sympa.cluster.chapril.org] sympa-request@chapril.org    smtp:[sympa.cluster.chapril.org]
 sympa-owner@chapril.org      smtp:[sympa.cluster.chapril.org] sympa-owner@chapril.org      smtp:[sympa.cluster.chapril.org]
 </code> </code>
-  - ''sympa'' : c'est là que les sont les transports spécifiques aux listes. On verra plus tard sa fabrication.<code conf /etc/postfix/transports/sympa.map>+  - ''sympa'' :les transports spécifiques aux listes((On verra plus tard sa fabrication.)) : 
 +<code - /etc/postfix/transports/sympa.map>
 ## Généré automatiquement sur sympa.cluster.april.org via systemd (sympa-transports.path) ## Généré automatiquement sur sympa.cluster.april.org via systemd (sympa-transports.path)
 ## À copier dans mail.cluster.chapril.org:/etc/postfix/transports/ ## À copier dans mail.cluster.chapril.org:/etc/postfix/transports/
Ligne 112: Ligne 149:
 </code> </code>
  
-===== Postfix coté guest =====+==== Postfix coté guest ====
  
-C'est plus direct car basiquement on applique moins de contrôle. Une conf postfix satellite avec chapril.org en mailname et mail.cluster.chapril.org en relais suffit plus quelques adaptations. Cf [[admin:procedures:installation_postfix_satellite|Installation d'un postfix en satellite]].+C'est plus direct car basiquement on applique moins de contrôle. 
 +Une configuration Postfix satellite avec ''chapril.org'' en //mailname// et ''mail.cluster.chapril.org'' en ''relais'' suffit selon l’[[admin:procedures:installation_postfix_satellite|Installation de Postfix en satellite]]. 
 +Ne restent plus que quelques adaptations.
  
 Les adaptations : Les adaptations :
-<code conf /etc/postfix/main.cf>+<code - /etc/postfix/main.cf>
 # On sert localement le domaine chapril.org # On sert localement le domaine chapril.org
 mydestination = $myhostname, sympa.cluster.chapril.org, localhost.cluster.chapril.org, localhost, chapril.org mydestination = $myhostname, sympa.cluster.chapril.org, localhost.cluster.chapril.org, localhost, chapril.org
Ligne 141: Ligne 180:
  
 <note important> <note important>
-On passe par des transports vers de nouveaux services et non par des alias car ça nous permet de contrôler l'uid du service dans ''master.cf''. Cf https://agir.april.org/issues/3149+On passe par des transports vers de nouveaux services et non par des alias car ça nous permet de contrôler l'UID du service dans ''master.cf''. 
 +Se référer au [[https://agir.april.org/issues/3149|ticket n°3149]].
 </note> </note>
  
-<code conf /etc/postfix/sympa-transports.regex>+<code - /etc/postfix/sympa-transports.regex>
 /^.*\@sympaqueue$/         sympaqueue: /^.*\@sympaqueue$/         sympaqueue:
 /^.*\@sympabouncequeue$/   sympabouncequeue: /^.*\@sympabouncequeue$/   sympabouncequeue:
 </code> </code>
  
-<code conf /etc/postfix/master.cf>+<code - /etc/postfix/master.cf>
 # Sympa mailing list manager transports # Sympa mailing list manager transports
 sympaqueue       unix  -       n       n       -       -       pipe sympaqueue       unix  -       n       n       -       -       pipe
Ligne 158: Ligne 198:
  
  
-<code conf /etc/aliases.local>+<code - /etc/aliases.local>
 # default contact emails # default contact emails
 postmaster:     listmaster@chapril.org postmaster:     listmaster@chapril.org
Ligne 166: Ligne 206:
  
 Enfin, notre fichier de transports est ainsi fait (on voit sa construction juste après) : Enfin, notre fichier de transports est ainsi fait (on voit sa construction juste après) :
- +<code - /etc/mail/sympa/sympa-transports.map>
-<code conf /etc/mail/sympa/sympa-transports.map>+
 ## Généré automatiquement sur sympa.cluster.april.org via systemd (sympa-transports.path) ## Généré automatiquement sur sympa.cluster.april.org via systemd (sympa-transports.path)
 ## Destiné à sympa.cluster.chapril.org:/etc/postfix/transports/ ## Destiné à sympa.cluster.chapril.org:/etc/postfix/transports/
Ligne 181: Ligne 220:
 test-owner@chapril.org test+chapril.org@sympabouncequeue. test-owner@chapril.org test+chapril.org@sympabouncequeue.
 </code> </code>
-====== Construction du fichier d'aliases sur le guest ====== 
  
-En fait sympa fait ça tout seul comme un grand si on lui demande. +===== Construction du fichier d'aliases sur le guest ===== 
-<code conf /etc/sympa/sympa/sympa.conf>+ 
 +En fait Sympa fait ça tout seul comme un grand si on lui demande. 
 + 
 +<code - /etc/sympa/sympa/sympa.conf>
 sendmail_aliases /etc/mail/sympa/aliases sendmail_aliases /etc/mail/sympa/aliases
 alias_manager    /usr/lib/sympa/bin/alias_manager.pl alias_manager    /usr/lib/sympa/bin/alias_manager.pl
 </code> </code>
  
-Il est poli et exécute newaliases quand il a fini.+Il est poli et exécute ''newaliases'' quand il a fini.
  
-<note tip>Si d'aventure le format de ce qui est généré ne vous satisfait pas, le template à modifier c'est ''/usr/share/sympa/default/list_aliases.tt2''+<note tip> 
 +Si d'aventure le format de ce qui est généré ne vous satisfait pas, le modèle à modifier est ''/usr/share/sympa/default/list_aliases.tt2''.
  
-Ce fichier par défaut a les alias de type nomdelaliste-subscribe@ en commentaires. Or ce type d'alias est utile. Donc, copie du fichier ''/usr/share/sympa/default/list_aliases.tt2'' dans ''/etc/sympa/list_aliases.tt2''. Modifier du fichier pour avoir les alias subscribe. La régénération du fichier /etc/mail/sympa/aliases est faite à chaque création de nouvelle liste. Mais pour les listes déjà existantes les entrées dans le fichier ne sont pas modifiées. Il faut donc modifier manuellement ce fichier.+Ce fichier par défaut a les alias de type ''nomdelaliste-subscribe@'' en commentaires. 
 +Or ce type d'alias est utile. 
 +Donc, copier le fichier ''/usr/share/sympa/default/list_aliases.tt2'' dans ''/etc/sympa/list_aliases.tt2''. 
 +Modifier cette copie pour avoir les alias ''subscribe''. 
 +La régénération du fichier ''/etc/mail/sympa/aliases'' est faite à chaque création de nouvelle liste. 
 +Mais pour les listes déjà existantes les entrées dans le fichier ne sont pas modifiées. 
 +Il faut donc modifier manuellement ce fichier.
 </note> </note>
  
-Maintenant il faut pousser cette conf proprement sur le relais.+Maintenant il faut pousser cette configuration proprement sur ''relais''.
  
-====== Création et installation du fichier d'aliases sur le relais ======+===== Création et installation du fichier d'aliases sur le relais =====
  
 <note tip> <note tip>
-On va se faire aider de ''systemd'' à l'aide d'une unit de type ''path''. Cf https://www.redhat.com/sysadmin/introduction-path-units+On va se faire aider de Systemd à l'aide d'une //unit// de type ''path''. 
 +Se référer à //[[https://www.redhat.com/en/blog/introduction-path-units|RedHat : A brief introduction to path units]]//
 </note> </note>
  
-===== Sur la machine guest =====+==== Sur la machine guest ====
  
 On va installer le programme suivant : On va installer le programme suivant :
-<code bash cat /usr/local/bin/alias_push.sh >+<file bash /usr/local/bin/alias_push.sh>
 #!/bin/bash #!/bin/bash
 echo '## Généré automatiquement sur sympa.cluster.april.org via systemd (sympa-transports.path)' > /etc/mail/sympa/sympa.map echo '## Généré automatiquement sur sympa.cluster.april.org via systemd (sympa-transports.path)' > /etc/mail/sympa/sympa.map
Ligne 227: Ligne 276:
  
 git -C /etc add /etc/mail/sympa/ git -C /etc add /etc/mail/sympa/
-git -C /etc commit -m 'MaJ des alias des listes'</code> +git -C /etc commit -m 'MaJ des alias des listes' 
-ainsi que les units systemd suivantes : +</file> 
-<code ini /etc/systemd/system/sympa-transports.path >+ 
 +Ainsi que les //units// suivantes de Systemd : 
 +<code ini /etc/systemd/system/sympa-transports.path>
 [Unit] [Unit]
 Description=Wait for new sympa transports Description=Wait for new sympa transports
Ligne 253: Ligne 304:
 </code> </code>
  
-qu'on va penser à activer : +Ce qu'on va penser à activer : 
-  systemctl enable sympa-transports.path sympa-transports.service +<code bash> 
-  systemctl start sympa-transports.path sympa-transports.service +systemctl enable sympa-transports.path sympa-transports.service 
-===== Sur la machine relais =====+systemctl start sympa-transports.path sympa-transports.service 
 +</code> 
 +   
 +==== Sur la machine relais ====
  
 On va installer le programme suivant : On va installer le programme suivant :
-<code bash cat /usr/local/bin/alias_update.sh >+<file bash /usr/local/bin/alias_update.sh>
 #!/bin/bash #!/bin/bash
 cd /etc/postfix && make && postfix reload cd /etc/postfix && make && postfix reload
Ligne 268: Ligne 322:
 git add transports/sympa.map transports/sympa.db git add transports/sympa.map transports/sympa.db
 git commit -m 'MaJ des alias des listes' git commit -m 'MaJ des alias des listes'
-</code> +</file> 
-ainsi que les units systemd suivantes :+ 
 +Ainsi que les //units// suivantes de Systemd :
 <code ini /etc/systemd/system/sympa-transports.path > <code ini /etc/systemd/system/sympa-transports.path >
 [Unit] [Unit]
Ligne 282: Ligne 337:
 </code> </code>
  
-<code ini /etc/systemd/system/sympa-transports.service >+<code ini /etc/systemd/system/sympa-transports.service>
 [Unit] [Unit]
 Description=Push sympa transports toward postfix Description=Push sympa transports toward postfix
Ligne 294: Ligne 349:
 </code> </code>
  
-qu'on va penser à activer : +Ce qu'on va penser à activer : 
-  systemctl enable sympa-transports.path sympa-transports.service +<code bash> 
-  systemctl start sympa-transports.path sympa-transports.service+systemctl enable sympa-transports.path sympa-transports.service 
 +systemctl start sympa-transports.path sympa-transports.service 
 +</code>
admin/infrastructure/sympa.txt · Dernière modification : 2026/03/03 22:53 de fhenry2