

---- Graphing Sendmail Mail Transport Statistics ----

 - The sendmail smtp server is configured to provide statistics
   for it's various mailers via the "mailstats" program.

 - nrg-sendmailstatd is installed on mail servers to provide
   the output of the "mailstats" program via port 88889.

 - Sendmail statistics can then be ingested into NRG using the
   nrg-sendmailstat program, which connects to port 88889 and
   parses the resulting mailstats output into NRG collector 
   format. 

 - Examples of sendmail graphs can be found at:

     http://nrg.hep.wisc.edu/nrg-demo/sendmail/Jasmine/Jasmine-sm-msgs.cgi

     http://nrg.hep.wisc.edu/nrg-demo/sendmail/Jasmine/Jasmine-sm-tp.cgi


---- Instructions for Graphing Sendmail Statistics ----

 - Make sure you have "mailstats".  Some Unix flavors with
   vendor-supplied sendmail (eg OSF1) do not include the "mailstats"
   program.  If you don't have "mailstats", you should build
   "mailstats" from the sendmail source.

 - If you have Sendmail 8.8 or better, make sure you have the 
   following in sendmail.cf:

     O StatusFile=/var/log/sendmail.st

   with older versions of sendmail use:

     OS/var/log/sendmail.st

 - Install bin/nrg-sendmailstatd in /usr/local/etc/nrg-sendmailstatd
   on the mail server.

 - If your "mailstats" program isn't in /usr/sbin, then you need to
   edit the top of "nrg-sendmailstats". 

 - Test nrg-sendmailstatd on the name server by doing
   "/usr/local/etc/nrg-sendmailstatd".  This should print the output
   from sendmail's "mailstats".

 - Configure the name server to provide the nrg-sendmailstat service

      - edit /etc/inetd.conf and /etc/services and add entries for 
        "nrg-sendmailstat":

          - /etc/services:

              nrg-sendmailstat 88889/tcp

          - /etc/inetd.conf:

              nrg-sendmailstat stream tcp nowait root \
                /usr/local/etc/nrg-sendmailstatd nrg-sendmailstatd

      - edit /etc/inetd.conf and add an entry for "nrg-sendmailstat"

      - do "kill -HUP <pid_of_inetd>"

 - Test nrg-bindstat service: do "telnet mail-server 88889"

 - Add the appropiate .mconf strings to Site.mconf using
   examples/sendmail.mconf as your guide.

 - Tell NRG about the new meta target:

     make update
     make notify


