OX munin scripts

Revision as of 12:51, 15 September 2011 by 217.7.151.106 (talk) (munin and munin-node)

How to install Munin scripts for Open-Xchange

Prerequisites

Munin-Node must be installed prior installing the Munin scripts package for Open-Xchange. Note that SUSE LINUX Enterprise Server does not include Munin.

To get the munin graphs generated for the webserver, munin needs to be installed and configured, too. For more information, please visit http://munin-monitoring.org/.

If you are running RHEL6 you need to enable to optional RHN channel to get munin. Also you need to add the EPEL repo. An instruction for this can be found on https://fedoraproject.org/wiki/EPEL6-FAQ.

Install on OX AppSuite

Debian GNU/Linux 8.0

Add the following entry to /etc/apt/sources.list.d/open-xchange.list if not already present:

deb https://software.open-xchange.com/OX6/unsupported/repo/DebianJessie/ /
# 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/OX6/unsupported/repo/updates/DebianJessie/ /

and run

$ apt-get update
$ apt-get install open-xchange-munin-scripts

Debian GNU/Linux 9.0

Add the following entry to /etc/apt/sources.list.d/open-xchange.list if not already present:

deb https://software.open-xchange.com/OX6/unsupported/repo/DebianStretch/ /
# 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/OX6/unsupported/repo/updates/DebianStretch/ /

and run

$ apt-get update
$ apt-get install open-xchange-munin-scripts

SUSE Linux Enterprise Server 12

Add the package repository using zypper if not already present:

$ zypper ar https://software.open-xchange.com/OX6/unsupported/repo/SLE_12 oxmunin

If you have a valid maintenance subscription, please run the following command and add the ldb account data to the url so that the most recent packages get installed:

$ zypper ar https://[CUSTOMERID:PASSWORD]@software.open-xchange.com/OX6/unsupported/repo/updates/SLES11 ox-updates

and run

$ zypper ref
$ zypper in open-xchange-munin-scripts

RedHat Enterprise Linux 6

Start a console and create a software repository file if not already present:

$ vim /etc/yum.repos.d/oxmunin.repo

[oxmunin]
name=Open-Xchange
baseurl=https://software.open-xchange.com/OX6/unsupported/repo/RHEL6/
gpgkey=https://software.open-xchange.com/oxbuildkey.pub
enabled=1
gpgcheck=1
metadata_expire=0m
# 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
# [ox-updates]
# name=Open-Xchange Updates
# baseurl=https://[CUSTOMERID:PASSWORD]@software.open-xchange.com/OX6/unsupported/repo/updates/RHEL6/
# gpgkey=https://software.open-xchange.com/oxbuildkey.pub
# enabled=1
# gpgcheck=1
# metadata_expire=0m

and run

$ yum update
$ yum install open-xchange-munin-scripts

RedHat Enterprise Linux 7

Start a console and create a software repository file if not already present:

$ vim /etc/yum.repos.d/oxmunin.repo

[oxmunin]
name=Open-Xchange
baseurl=https://software.open-xchange.com/OX6/unsupported/repo/RHEL7/
gpgkey=https://software.open-xchange.com/oxbuildkey.pub
enabled=1
gpgcheck=1
metadata_expire=0m
# 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
# [ox-updates]
# name=Open-Xchange Updates
# baseurl=https://[CUSTOMERID:PASSWORD]@software.open-xchange.com/OX6/unsupported/repo/updates/RHEL7/
# gpgkey=https://software.open-xchange.com/oxbuildkey.pub
# enabled=1
# gpgcheck=1
# metadata_expire=0m

and run

$ yum update
$ yum install open-xchange-munin-scripts

CentOS 6

Start a console and create a software repository file if not already present:

$ vim /etc/yum.repos.d/oxmunin.repo

[oxmunin]
name=Open-Xchange
baseurl=https://software.open-xchange.com/OX6/unsupported/repo/RHEL6/
gpgkey=https://software.open-xchange.com/oxbuildkey.pub
enabled=1
gpgcheck=1
metadata_expire=0m
# 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
# [ox-updates]
# name=Open-Xchange Updates
# baseurl=https://[CUSTOMERID:PASSWORD]@software.open-xchange.com/OX6/unsupported/repo/updates/RHEL6/
# gpgkey=https://software.open-xchange.com/oxbuildkey.pub
# enabled=1
# gpgcheck=1
# metadata_expire=0m

and run

$ yum update
$ yum install open-xchange-munin-scripts

CentOS 7

Start a console and create a software repository file if not already present:

$ vim /etc/yum.repos.d/oxmunin.repo

[oxmunin]
name=Open-Xchange
baseurl=https://software.open-xchange.com/OX6/unsupported/repo/RHEL7/
gpgkey=https://software.open-xchange.com/oxbuildkey.pub
enabled=1
gpgcheck=1
metadata_expire=0m
# 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
# [ox-updates]
# name=Open-Xchange Updates
# baseurl=https://[CUSTOMERID:PASSWORD]@software.open-xchange.com/OX6/unsupported/repo/updates/RHEL7/
# gpgkey=https://software.open-xchange.com/oxbuildkey.pub
# enabled=1
# gpgcheck=1
# metadata_expire=0m

and run

$ yum update
$ yum install open-xchange-munin-scripts

munin and munin-node

munin collects the prepared data (by munin-node) from the nodes. Munin can run on the same system as the node, but if you want to monitor more nodes it makes sense to have it on another server running without Open-Xchange.

munin-node has to be installed on every Open-Xchange server you want to monitor

Configuring munin-node scripts for Open-Xchange

The configuration of the scripts is done automatically. The database pool monitoring scripts will get configured only if the Open-Xchange server is running when installing the open-xchange-munin-scripts packages.

The default configuration allows connections from the localhost, means that munin has to run on the same host. If you have already a munin host running or decided to use not the same as the Open-Xchange server, 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.

Configure Munin host

Make sure you have the munin and apache packages installed. If you just monitor the localhost, you have to do nothing. Adding other nodes via the /etc/munin/munin.conf file:

# a simple host tree
[localhost.localdomain]
    address 127.0.0.1
    use_node_name yes

add the needed nodes like this example.

By default you can reach the munin page only from localhost, so you usually have to allow other hosts or networks to connect. In /etc/apache2/conf.d/munin you can add them:

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.