Merge remote-tracking branch 'openaustralia_github/postfix_log_support' into develop

Conflicts:
  Gemfile.lock
  app/models/exim_log.rb

1 files changed, 28 insertions, 0 deletions

diff --git a/doc/INSTALL-postfix.md b/doc/INSTALL-postfix.md
index 70a2954bd..a73d67ce1 100644
--- a/doc/INSTALL-postfix.md
+++ b/doc/INSTALL-postfix.md
@@ -31,6 +31,34 @@ following to /etc/aliases:
     # We use this for envelope from for some messages where we don't care about delivery
     do-not-reply-to-this-address:        :blackhole:
 
+# Logging
+
+For the postfix logs to be read by the script 'load-mail-server-logs' succesfully they need to be log rotated with a date in the filename. Since that will create a lot of rotated log files (one for each day), it's good to have them in their own directory. For example (on Ubuntu) /etc/rsyslog.d/50-default.conf
+
+  mail.*                          -/var/log/mail/mail.log
+
+And also edit /etc/logrotate.d/rsyslog:
+
+  /var/log/mail/mail.log
+  {
+          rotate 30
+          daily
+          dateext
+          missingok
+          notifempty
+          compress
+          delaycompress
+          sharedscripts
+          postrotate
+                  reload rsyslog >/dev/null 2>&1 || true
+          endscript
+  }
+
+You'll also need to tell Alaveteli where the log files are stored and that they're in postfix format. Update config/general.yml with:
+
+  MTA_LOG_PATH: '/var/log/mail/mail.log-*'
+  MTA_LOG_TYPE: "postfix"
+
 # Troubleshooting
 
 To test mail delivery, run: