Changes between Version 18 and Version 19 of TracNotification

Timestamp:

May 24, 2006, 3:02:09 AM (18 years ago)

Author:

Emmanuel Blot

Comment:

Add troubleshooting section

TracNotification

@@ -76 +76 @@
 My Project <http://myproj.example.com/>
 }}}
+
+== Troubleshooting ==
+
+If you cannot get the notification working, first make sure the log is activated and have a look at the log to find if an error message has been logged.
+
+Notification errors are not reported through the web server, so the user who submit a change or a new ticket never gets notified about a notification failure. The Trac administrator needs to look at the log to find the error trace.
+
+=== ''Permission denied'' error ===
+
+Typical error message:
+{{{
+  ...
+  File ".../smtplib.py", line 303, in connect
+    raise socket.error, msg
+  error: (13, 'Permission denied')
+}}}
+
+This error usually comes from a security settings on the server: many Linux distributions do not let the web server (Apache, ...) to post email message to the local SMTP server.
+
+Many users get confused as they try and success to communicate with the SMTP server:
+{{{
+telnet localhost 25
+}}}
+Trouble is that a regular user may connect to the SMTP server, but the web server cannot:
+{{{
+sudo -u www-data telnet localhost 25
+}}}
+
+In such a case, you need to configure your server so that the web server is authorize to post to the SMTP server. The actual settings depend on your Linux distribution and current security policy. You may find help browsing the Trac MailingList archive.
+
+Relevant ML threads:
+ * SELinux: http://article.gmane.org/gmane.comp.version-control.subversion.trac.general/7518
+ 
+=== ''Suspected spam'' error ===
+
+Some SMTP servers may reject the notification email sent by Trac.
+
+The default Trac configuration uses Base64 encoding to send emails to the recipients. The whole body of the email is encoded, which sometimes trigger ''false positive'' SPAM detection on sensitive email servers. In such an event, it is recommended to change the default encoding to "quoted-printable" using the `mime_encoding` option.
+
+Quoted printable enconding works better with languages that use one of the Latin charsets. For Asian charsets, it is recommended to stick with the Base64 encoding. 
+
 ----
 See also: TracTickets, TracIni, TracGuide