Editing Munin

Warning: You are not logged in. Your IP address will be recorded in this page's edit history.

The edit can be undone. Please check the comparison below to verify that this is what you want to do, and then save the changes below to finish undoing the edit.

Learn more about Contributing to the wiki.

==How To Install Munin Node==

[http://munin.projects.linpro.no/ Munin] is a system measuring tool which gives the user a wide range of graphs spanning hours, days, weeks and months. An example set of some graphs are shown [http://ostatic.com/files/images/Munin-%5B1%5D.png here].

''(note: I shall upload some graphs of my own when I have collected data long enough)''

Munin is much loved in the SysAdmin community because of its flexibility and the way it can be extended by writing plugins for the monitored systems, and particularly because the plugins are very easy to write, with a [http://muninexchange.projects.linpro.no/ community resource for sharing them].

Each system being monitored runs "munin node", a simple daemon that listens on TCP port 4949 for connections, and if one comes from a permitted host or network, presents different kinds of information to it as requested.

Installing it on Maemo is quite easy as it's architecture independent, being basically a perl process which invokes scripts. The only trick is knowing to bypass certain dependencies during installation, and a few tweaks in the configuration. The installation has to happen from the command line as root.

===Installing On Diablo===

[[Open development/Maemo roadmap/Diablo|Diablo]] is effectively a relatively old release (Serge) of arm debian linux, so you have to get the packages from a debian archive.

Login as root to a command shell and fetch the packages. You probably want to fetch them to your flash memory card rather than clutter up the system file space.

fetch the packages as follows
<pre>
# cd /media/external/download
# wget http://ftp.de.debian.org/archive/debian/pool/main/a/adduser/adduser_3.63_all.deb
# wget http://ftp.ch.debian.org/debian-archive/pool/main/m/munin/munin-node_1.2.3-1_all.deb
# wget http://ftp.ch.debian.org/debian-archive/pool/main/libn/libnet-server-perl/libnet-server-perl_0.87-3sarge1_all.deb
# wget http://ftp.ch.debian.org/debian-archive/pool/main/libi/libio-multiplex-perl/libio-multiplex-perl_1.08-1_all.deb
</pre>

For future reference, in case the debian archive disappears,, I have uploaded these files to the wiki, I had to tack on .svg to the filenames to stop them being rejected; links to the files below - click on the link to go to the page describing the file then on the file itself, use SAVE AS and rename to drop the .svg (sorry, can't think of a better way to do this).
* [[Image:Libnet-server-perl_0.87-3sarge1_all.deb.svg]]
* [[Image:Munin-node_1.2.3-1_all.deb.svg]]
* [[Image:Libio-multiplex-perl_1.08-1_all.deb.svg]]
* [[Image:Adduser_3.63_all.deb.svg]]

Once fetched, install them thus
<pre>
# dpkg -i adduser_3.63_all.deb
# dpkg -i --ignore-depends=perl libio-multiplex-perl_1.08-1_all.deb
# dpkg -i --ignore-depends=perl libnet-server-perl_0.87-3sarge1_all.deb
# dpkg -i --ignore-depends=perl munin-node_1.2.3-1_all.deb
</pre>

The reason we have to tell dpkg to ignore the dependency on perl is because the tablet has "perl-base" package instead which has everything needed.

''One thing the tablet doesn't have is "pgrep", a simple command line tool, it doesn't really matter, but can anyone help with a suitable place it can be installed from, or a simple substitute script?
''

===Configuration===

The only things you need to do are to permit your munin master monitoring machine to contact your tablet, to set the host name, and to restart munin-node.

The munin node configuration is a imple text file called /etc/munin/munin-node.conf

Firstly, add more "allow" lines such as this one so that your local network can talk to the munin daemon; the example adds 192.168.29.* but has to be written in perl regex format.
<pre>
allow ^192\.168\.1\.\d+$
</pre>

then override the host name, the munin master node's configuration expectation of the host name MUST match the tablet's host name. If you call your tablet gorgonzola, the line would read thus:
<pre>
host_name gorgonzola
</pre>

Save your edits, and at the command line type
<pre>
/etc/init.d/munin-node restart
</pre>

==Testing the installation==

Verify you can now talk to your tablet from the munin master node thus by firing up a shell and typing the words in bold: 
<ul>
<tt>
&#35; '''telnet gorgonzola.example.com 4949''' 
Trying 192.168.1.2... 
Connected to gorgonzola. 
Escape character is '^]'. 
&#35; munin node at gorgonzola 
'''list''' 
open_inodes irqstats entropy processes df interrupts if_err_wlan0 swap load cpu df_inode forks iostat open_files if_wlan0 memory 
'''fetch cpu''' 
user.value 127603 
nice.value 1478 
system.value 44203 
idle.value 4097098 
iowait.value 1878 
irq.value 278 
softirq.value 2228 
. 
'''quit''' 
Connection closed by foreign host.
</tt>
</ul>

==Configuring the Munin Master==

You configure the munin master exactly as per the munin documentation; simply add the tablet to the <code>/etc/munin/munin.conf</code> file like this

<pre>
[gorgonzola]
 address gorgonzola.example.com
 use_node_name yes
</pre>

You could of course use the IP address instead - it would go on the "address" line e.g. "address 192.168.1.2"

You don't need to restart anything, the next time munin runs it will pick up the changes. If you have done it correctly the graphs will begin to appear in about ten minutes as tiny specks on the right. There are troubleshooting pages on the munin wiki.

Good luck and enjoy your newly-metered tablet!

[[Category:Power users]]
[[Category:Diablo]]

Please note that all contributions to maemo.org wiki may be edited, altered, or removed by other contributors. If you do not want your writing to be edited mercilessly, then do not submit it here.
You are also promising us that you wrote this yourself, or copied it from a public domain or similar free resource (see maemo.org wiki:Copyrights for details). Do not submit copyrighted work without permission!

Summary:

Cancel | Editing help (opens in new window)

Retrieved from "http://wiki.maemo.org/Munin"

Personal tools

Navigation

Views

Editing Munin

@@ Line 70: / Line 70: @@
 Verify you can now talk to your tablet from the munin master node thus by firing up a shell and typing the words in bold:<br />
+<ul>
 <tt>
 &#35; '''telnet gorgonzola.example.com 4949'''<br />
@@ Line 91: / Line 91: @@
 Connection closed by foreign host.
 </tt>
+</ul>
 ==Configuring the Munin Master==
@@ Line 111: / Line 111: @@
 [[Category:Power users]]
 [[Category:Diablo]]
-[[Category:Software]]