Mupy

Version 3 (Leonidas Poulopoulos, 08/22/2012 10:45 am)

1 3 Leonidas Poulopoulos
!mupy_logo.png!
2 3 Leonidas Poulopoulos
3 2 Leonidas Poulopoulos
h1. Mupy
4 2 Leonidas Poulopoulos
5 2 Leonidas Poulopoulos
h2. What is Mupy?
6 2 Leonidas Poulopoulos
7 2 Leonidas Poulopoulos
Mupy is a Munin Python Parser. It is written in Python and is powered by Django framework.
8 2 Leonidas Poulopoulos
Its functionality is pretty straightforward. It parses the HTML DOM of a munin site, stores the graphable
9 2 Leonidas Poulopoulos
data into a db and provides a friendly user interface for retrieving munin graphs.
10 2 Leonidas Poulopoulos
11 2 Leonidas Poulopoulos
12 2 Leonidas Poulopoulos
h2. Munin version compatibility
13 2 Leonidas Poulopoulos
14 2 Leonidas Poulopoulos
Mupy was built on Munin version 1.4.5, though compatibility with the latest version of Munin will be soon available.
15 2 Leonidas Poulopoulos
16 2 Leonidas Poulopoulos
h2. Installation Requirements
17 2 Leonidas Poulopoulos
18 2 Leonidas Poulopoulos
Mupy's installation and operation depends on the following modules/packages
19 2 Leonidas Poulopoulos
20 2 Leonidas Poulopoulos
* python-django (>=1.2.3)
21 2 Leonidas Poulopoulos
* python-mysqldb
22 2 Leonidas Poulopoulos
* python-ldap (if ldap user auth is needed)
23 2 Leonidas Poulopoulos
* python-beautifulsoup4
24 2 Leonidas Poulopoulos
* memcached
25 2 Leonidas Poulopoulos
26 2 Leonidas Poulopoulos
27 2 Leonidas Poulopoulos
h2. Installation
28 2 Leonidas Poulopoulos
29 2 Leonidas Poulopoulos
# Untar the package to your desired location and edit settings.py according to your needs. Pay special attention to:
30 2 Leonidas Poulopoulos
 *MUNIN_URL* : url that munin welcome page lives, eg. "http://munin.example.com"
31 2 Leonidas Poulopoulos
 *MUNIN_CGI_PATH* : if images are updated frequently (without the need to visit) then set the cgi path here, eg. "cgi-bin/munin-cgi-graph/"
32 2 Leonidas Poulopoulos
# To serve via Apache (static files), create an alias for the static dir in your apache conf and a WSGI script alias eg.  
33 2 Leonidas Poulopoulos
 Alias /static       /<installation_location>/mupy/static
34 2 Leonidas Poulopoulos
 WSGIScriptAlias /      /<installation_location>/mupy/apache/django.wsgi
35 2 Leonidas Poulopoulos
# Run syncdb and create an admin user. Admin users have permissions to all nodegroups/nodes/graphs
36 2 Leonidas Poulopoulos
# Run ./manage.py parse_munin to parse the MUNIN_URL and store data into db
37 2 Leonidas Poulopoulos
# Restart Apache (or "touch apache/django.wsgi") and enjoy