/usr/share/doc/mailping/README is in mailping 0.0.4-3.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 | Mailping
========
monitor email service availability _and_ functioning.
Please read the man pages mailping-cron(1) and mailping-store(1) for
real documentation. This file is just a random collection of notes,
for now.
Overview of files
-----------------
configdir:
from
to
(admin)
interval
warntime
failtime
warnlatency
faillatency
statedir:
pending/
incoming/{tmp,cur,new}
broken/{tmp,cur,new} # valid-looking messages without
# corresponding pendings go here
junk/{tmp,cur,new} # invalid messages go here
success
Rough overview of the internal processing
-----------------------------------------
- for incoming mail
- parse mail to find identifier
- if no identifier, move message to junk/
- if got identifier, find matching entry in pending/
- if not found, move message to broken/
- if found
- if getTime(pending/$THIS) > getTime(success)
- then rename to "success"
- else remove
- if max(getTime("success"), getTime("pending/*")) + interval < time:
- send new probe
- create pending/$THIS
Installation instructions for non-Debian
----------------------------------------
These steps are only needed if you are not using Debian. For Debian
users, these have been taken care of by the maintainer scripts.
Install the software with the usual python distutils stuff, run
"python setup.py install" as root.
Arrange for mailping-cron to be run from cron regularly. It must have
write access to statedir -- I suggest you create a user "mailping"
with homedir /var/lib/mailping (owned by root:root), and make mailping
own /var/lib/mailping/state.
Arrange for email to e.g. mailping+FOO@something to be delivered to
/var/lib/mailping/state/FOO/incoming/. If you created the user above,
just create /var/lib/mailping/.forward with "|/usr/bin/mailping-store"
and things should work.
Register the plugins mailping-success and mailping-latency with munin.
Restart munin-node to make it notice the now plugins.
|