OX munin scripts: Difference between revisions
| Line 12: | Line 12: | ||
{{InstallPlugin|pluginname=open-xchange-munin-scripts|sopath=unsupported/repo|reponame=oxmunin}} | {{InstallPlugin|pluginname=open-xchange-munin-scripts|sopath=unsupported/repo|reponame=oxmunin}} | ||
== Configuring munin-node scripts for Open-Xchange == | == Configuring munin-node scripts for Open-Xchange == | ||
| Line 24: | Line 19: | ||
Note: The database pool monitoring script will get only configured if the Open-Xchange server is running when installing the open-xchange-munin-scripts package. | Note: The database pool monitoring script will get only configured if the Open-Xchange server is running when installing the open-xchange-munin-scripts package. | ||
= | = Supplementary notes for distributed munin clients = | ||
== Munin node == | |||
The default munin node configuration only allows connections from localhost, which means that the munin master has to run on the same host. If you already have a munin host running or decided to not use the Open-Xchange server as munin master, you have to change the file <code>/etc/munin/munin-node.conf</code> on each node you want to monitor: | The default munin node configuration only allows connections from localhost, which means that the munin master has to run on the same host. If you already have a munin host running or decided to not use the Open-Xchange server as munin master, you have to change the file <code>/etc/munin/munin-node.conf</code> on each node you want to monitor: | ||
| Line 37: | Line 33: | ||
Replace the <code>allow</code> line with the IP of the munin host server IP. | Replace the <code>allow</code> line with the IP of the munin host server IP. | ||
== | == Munin master == | ||
Make sure you have the munin and apache packages installed. If you just monitor | |||
Make sure you have the munin and apache packages installed. If you just monitor localhost, you have to do nothing. Other nodes can be added in the <code>/etc/munin/munin.conf</code> file: | |||
# a simple host tree | # a simple host tree | ||
| Line 45: | Line 42: | ||
use_node_name yes | use_node_name yes | ||
By default, the munin monitoring web page is only reached from localhost, other hosts or networks can be added in <code>/etc/apache2/conf.d/munin</code>: | |||
By default | |||
Allow from localhost 127.0.0.0/8 ::1 # the default setting | Allow from localhost 127.0.0.0/8 ::1 # the default setting | ||
Revision as of 05:46, 4 October 2011
How to install Munin scripts for Open-Xchange
Prerequisites
Munin node and munin master must be installed and configured prior using the Munin scripts package for Open-Xchange. The installation for this core components differs on various linux distributions. For details, please visit:
especially:
http://munin-monitoring.org/wiki/LinuxInstallation
Install on OX AppSuite
Debian GNU/Linux 11.0
Add the following entry to /etc/apt/sources.list.d/open-xchange.list if not already present:
deb https://software.open-xchange.com/products/unsupported/repo/DebianBullseye/ /
# if you have a valid maintenance subscription, please uncomment the
# following and add the ldb account data to the url so that the most recent
# packages get installed
# deb https://[CUSTOMERID:PASSWORD]@software.open-xchange.com/products/unsupported/repo/updates/DebianBullseye/ /
and run
$ apt-get update $ apt-get install open-xchange-munin-scripts
Debian GNU/Linux 12.0
Add the following entry to /etc/apt/sources.list.d/open-xchange.list if not already present:
deb https://software.open-xchange.com/products/unsupported/repo/DebianBookworm/ /
# if you have a valid maintenance subscription, please uncomment the
# following and add the ldb account data to the url so that the most recent
# packages get installed
# deb https://[CUSTOMERID:PASSWORD]@software.open-xchange.com/products/unsupported/repo/updates/DebianBookworm/ /
and run
$ apt-get update $ apt-get install open-xchange-munin-scripts
Configuring munin-node scripts for Open-Xchange
The configuration of the scripts is done automatically.
Note: The database pool monitoring script will get only configured if the Open-Xchange server is running when installing the open-xchange-munin-scripts package.
Supplementary notes for distributed munin clients
Munin node
The default munin node configuration only allows connections from localhost, which means that the munin master has to run on the same host. If you already have a munin host running or decided to not use the Open-Xchange server as munin master, you have to change the file /etc/munin/munin-node.conf on each node you want to monitor:
# A list of addresses that are allowed to connect. This must be a # regular expression, since Net::Server does not understand CIDR-style # network notation unless the perl module Net::CIDR is installed. You # may repeat the allow line as many times as you'd like allow ^127\.0\.0\.1$
Replace the allow line with the IP of the munin host server IP.
Munin master
Make sure you have the munin and apache packages installed. If you just monitor localhost, you have to do nothing. Other nodes can be added in the /etc/munin/munin.conf file:
# a simple host tree
[localhost.localdomain]
address 127.0.0.1
use_node_name yes
By default, the munin monitoring web page is only reached from localhost, other hosts or networks can be added in /etc/apache2/conf.d/munin:
Allow from localhost 127.0.0.0/8 ::1 # the default setting Allow from 10.99.0.0/8 # added network
The munin webpage is located at http://yourhost_where_munin_is_running.org/munin.