From f5c93d1a3fea4a91d8fd3e004f6549557381958e Mon Sep 17 00:00:00 2001 From: viennet Date: Mon, 16 May 2022 07:50:45 +0200 Subject: [PATCH] =?UTF-8?q?D=C3=A9atils=20config=20mail?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/ProblemesMail.md | 46 ++++++++++++++++++++++++++++++++----------- 1 file changed, 34 insertions(+), 12 deletions(-) diff --git a/docs/ProblemesMail.md b/docs/ProblemesMail.md index c816b735..608fe46d 100644 --- a/docs/ProblemesMail.md +++ b/docs/ProblemesMail.md @@ -1,19 +1,25 @@ # Problèmes d'envoi de courriers électroniques -ScoDoc envoie des mails en plusieurs occasions (bulletins de notes, importation d'utilisateurs, alertes sur absences, exceptions dans le code). +ScoDoc envoie des mails en plusieurs occasions (bulletins de notes, importation +d'utilisateurs, alertes sur absences, exceptions dans le code). -Cette page explique ce qu'il faut vérifier si l'envoi des messages ne fonctionne pas. +Cette page explique ce qu'il faut vérifier si l'envoi des messages ne fonctionne +pas. + +## Configuration du serveur +ScoDoc suppose que la machine serveur sur laquelle il s'exécute est dotée d'un +serveur de mail capable d'envoyer des messages (soit directement, soit via un +relais). L'installeur propose d'installer le logiciel serveur Postfix. -ScoDoc suppose que la machine serveur sur laquelle il s'exécute est dotée d'un serveur de mail capable d'envoyer des messages (soit directement, soit via un relais). L'installeur propose d'installer le logiciel serveur Postfix. - - - 1. Vérifier que votre serveur de messagerie est bien configuré: dans un terminal, envoyez un message + 1. Vérifier que votre serveur de messagerie est bien configuré: dans un + terminal, envoyez un message ``` mail mon_adresse@universite.fr ... entrer votre texte, terminez par ctrl-d ... ``` -Si vous ne recevez pas le message que vous vous envoyiez, revoir la configuration de votre serveur, par exemple avec la commande +Si vous ne recevez pas le message que vous vous envoyiez, revoir la +configuration de votre serveur, par exemple avec la commande ``` dpkg-reconfigure postfix ``` @@ -29,14 +35,19 @@ Connected to localhost. Escape character is '^]'. 220 nom_du_serveur ESMTP Postfix (Debian/GNU) ``` -(quitter avec ctrl-] puis quit) +(quitter avec ctrl-] puis `quit`) - 3. Si cela fonctionne, passer au test de ScoDoc: créer un étudiant bidon, lui attribuer une adresse mail que vous pouvez lire, l'inscrire à un semestre, et lui envoyer son bulletin par mail. (sur la page web de son bulletin, petit menu "Autres opérations"). +## Tests avec ScoDoc -A ce moment, regarder le log +Une fois que le mail, fonctionne, passer au test de ScoDoc: créer un étudiant +bidon, lui attribuer une adresse mail que vous pouvez lire, l'inscrire à un +semestre, et lui envoyer son bulletin par mail. (sur la page web de son +bulletin, petit menu "Autres opérations"). + +À ce moment, regarder le log `/opt/scodoc/instance/log/notes.log` -on devrait voir quelque chose ressemblant à: +On devrait voir quelque chose ressemblant à: ``` [Sun Sep 07 11:37:40 2008] mail bulletin a emmanuel.viennet@gmail.com [Sun Sep 07 11:37:40 2008] sendEmail: ok @@ -51,6 +62,17 @@ delays=0.03/0/0.41/1, dsn=2.0.0, status=sent (250 2.0.0 OK 1220942550 y2si226470 Cela devrait permettre de savoir: - 1. si ScoDoc tente d'envoyer un mail (notes.log) + 1. si ScoDoc tente d'envoyer un mail (`notes.log`); + 2. si le serveur SMTP arrive à traiter ce mail. +## Redirection des tous les mails de ScoDoc + +Afin de vérifier les envois de mail, il peut être pratique de détourner tous les +envois vers une adresse (cela permet par exemple de tester les envois de +notification ou de bulletins sans déranger les étudiants ou les collègues). + +Pour cela, aller sur la page *Paramétrage*, tout en bas, et indiquer une +*Adresse de test*. Ne pas oublier de l'enlever une fois les essais effectués ! + +