+------------------------------------------------------------------------------+
| ESL-HOWTO: Postfix Log Entry Summarizer                                      |
| Ryan W. Maple <ryan@guardiandigital.com>                                     |
+------------------------------------------------------------------------------+

1.0 Introduction
----------------
  This document is intended to outline installation and configuration of the
  "Postfix Log Entry Summarizer", a Postfix log analysis script written by
  James S. Seymour.  

  Please verify you have correctly followed the instructions in this ESL-HOWTO
  before reporting a problem.  The correct forum to report bugs or ask questions
  about this package is the engarde-users mailing list:

    http://www.engardelinux.org/support.html


2.0 Installation Steps
----------------------
  Unpack this tarball and change into the 'postfix-report-0.1' directory:

    # tar -zxvf postfix-report-0.1.tar.gz
    # cd postfix-report-0.1

  Copy the files into /etc/postfix, set up ownership/permissions, and create
  the directory for the report output:

    # cp postfix-report.sh pflogsumm.pl /etc/postfix

    # cd /etc/postfix
    # chown root.root postfix-report.sh pflogsumm.pl
    # chmod 700 postfix-report.sh pflogsumm.pl

    # mkdir /var/log/postfix
    # chmod 700 /var/log/postfix


3.0 Configuration
-----------------
  The only thing you must define is the email address the reports should be
  sent to.  Edit the file '/etc/postfix/postfix-report.sh' and change the
  $ADMIN variable to the desired address.  For example:

    ADMIN="ryan@guardiandigital.com"

  Finally, add a line like this to /etc/crontab to make the script run at
  12:01am daily:

    # Perform Postfix log analysis
    1 0 * * * root /etc/postfix/postfix-report.sh > /dev/null 2>&1


4.0 Credits and References
--------------------------
  The "Postfix Log Entry Summarizer" (pflogsumm.pl) was written by James S.
  Seymour (<jseymour@jimsun.LinxNet.com>) and may be found at:

    http://jimsun.LinxNet.com/postfix_contrib.html

  Pete O'Hara (pete@guardiandigital.com) initially got this running on
  EnGarde and Ryan W. Maple (ryan@guardiandigital.com) wrote this ESL-HOWTO
  and packaged the system.
