Install to CentOS (optional) — How to install milter manager related softwares to CentOS

About this document

This document describes how to install milter managerrelated softwares to CentOS. See Install toCentOS for milter manager installinformation and Install for general installinformation.

Install milter-manager-log-analyzer

milter-manager-log-analyzer is already installed because itis included in milter manager's RPM package. We willconfigure Web server to browse graphs generated bymilter-manager-log-analyzer.

There are two ways to view generated graphs; (1) view themvia a Web server at the same host and (2) view them viaMunin (and a Webserver) at other host. If we already have Munin orexclusive system monitoring server, Munin is a betterway. Otherwise, a Web server at the same host is a betterway. FIXME

First, a way that a Web server in the same host will beexplained, then a way that using Munin will be explained.

Way 1: View via a Web server at the same host

Install packages

We use Apache as Web server.

% sudo yum install -y httpd
% sudo /sbin/chkconfig httpd on

Configure milter-manager-log-analyzer

milter-manager-log-analyzer generates graphs tomilter-manager user's homedirectory. (/var/lib/milter-manager/) We configure Webserver to publish them athttp://localhost/milter-manager-log/.

We put /etc/httpd/conf.d/milter-manager-log.conf with thefollowing content:

Alias /milter-manager-log/ /var/lib/milter-manager/public_html/log/

We need to reload configuration after editing:

% sudo /sbin/service httpd reload

Now, we can see graphs at http://localhost/milter-manager-log/.

Way 2: View via Munin at other host

Next way is using Munin at other host.

Install packages

We install milter-manager-munin-plugins package thatprovides statistics data collected bymilter-manager-log-analyzer to Munin:

% sudo yum install -y milter-manager-munin-plugins

NOTE: We need to use databases created bymilter-manager-log-analyzer bundled with milter manager1.5.0 or later to provide statistics data to Munin. If wehave databases that are created by oldermilter-manager-log-analyzer, we need to remove~milter-manager/public_html/log/. If we remove thedirectory, milter-manager-log-analyzer re-creates statisticsdatabases 5 minutes later.

Configure munin-node

Munin-node should accept accesses from Munin server. IfMunin server is 192.168.1.254, we need to append thefollowing lines to /etc/munin/munin-node.conf:

/etc/munin/munin-node.conf:

allow ^192\.168\.1\.254$

We need to restart munin-node to apply our configuration:

% sudo /sbin/service munin-node restart

Configure Munin server

Works in this section at system monitor server. We assumethat system monitor server works on CentOS.

First, we install munin and Apache:

monitoring-server% sudo yum install -y munin httpd

We add our mail server that works munin-node to munin'smonitor target. We assume that mail server has the followingconfiguration:

Host name
mail.example.com
IP address
192.168.1.2

We need to add the following lines to /etc/munin/munin.confto add the mail server:

/etc/munin/munin.conf:

[mail.example.com]
    address 192.168.1.2
    use_node_name yes

We will be able to view graphs at http://monitoring-server/munin/ 5 minutes later.

Conclusion

We can confirm milter's effect visually bymilter-manager-log-analyzer. If we use Postfix as MTA, wecan compare withMailgraph's graphsto confirm milter's effect. We can use graphs generated bymilter-manager-log-analyzer effectively when we are tryingout a milter.