PyPMMN
======
PyPMMN is a pure python port of pmmn_. It will also look for a *subdirectory*
by a command-line parameter!
Requirements
============
PyPMMN does not have any requirements other than the python standard library.
For compatibility, it's targeted for Python 2.4 and up.
Known Issues
============
* The stdin mode does not work correctly. Consider using the original pmmn_
instead.
* It's not multithreaded. Only one connection is handled at a time. But given
the nature of munin, this should not be an issue.
Installation
============
The python way
--------------
Download the folder and run::
python setup.py install
This will install ``pypmmn.py`` into your system's ``bin`` folder. Commonly,
this is ``/usr/local/bin``.
And of course, you can use virtual environments too!
Manually
--------
Download the folder and copy both files ``pypmmn/pypmmn.py`` and
``pypmmn/daemon.py`` to a location of your choice and ensure ``pypmmn.py`` is
executable.
Usage
=====
All command-line parameters are documented. Simply run::
pypmmn.py --help
to get more information.
Example::
pypmmn.py -l /path/to/log-dir -d /path/to/plugins -p 4949
Daemon mode
-----------
In daemon mode, it's very helpful to specify a log folder. It gives you a
means to inspect what's happening. In the case you specified a log folder,
pypmmn will also create a file called ``pypmmn.pid`` containing the PID of the
daemon for convenience.
.. _pmmn: http://blog.pwkf.org/post/2008/11/04/A-Poor-Man-s-Munin-Node-to-Monitor-Hostile-UNIX-Servers