Monitoring the open-xchange application
=======================================

this directory contains scripts, written for munin, to collect
OXHE internal application data. This scripts can be used to be
adapted for own tools or to be directly integrated into a running
or new munin environment.

Example how to set up munin and integration of the scripts
----------------------------------------------------------

There are two munin packages. munin-node for collecting data on
nodes and munin which receives the collected data from the note
to generate graphical overviews.
more information about munin is to be found on the munin project
website:
http://munin.projects.linpro.no/


installing munin on etch:
~# apt-get install munin-node
~# apt-get install munin

make sure that following executable gives an output of current
application values:
~# /opt/open-xchange/sbin/showruntimestats -x

extract the scripts and add them to be included in munin:
~# tar xvfz ox_munin_scripts_1.1.tar.gz 
~# munin-node-configure --libdir $(pwd)/ox_munin_scripts/ --shell | sh
~# /etc/init.d/munin-node restart
Stopping munin-node: done.
Starting munin-node: done.
~#


munin is then available through any web browser http://oxserver/munin

UPDATE
======
munin generates links from /etc/munin/plugins/ to the directory where
you have extracted. On update, just extract the update package to
the same drictory. Afterwards following command is needed to make the
changes have affect:
~# /etc/init.d/munin-node restart