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 |