![]() |
![]() |
![]() |
milter manager Reference Manual | ![]() |
---|
Install to Ubuntu Linux (optional)Install to Ubuntu Linux (optional) — How to install milter manager related softwares to Ubuntu Linux |
This document describes how to install milter manager related softwares to Ubuntu Linux. See Install to Ubuntu Linux for milter manager install information and Install for general install information.
milter-manager-log-analyzer is already installed because it is included in milter manager's package. We will configure Web server to browse graphs generated by milter-manager-log-analyzer.
milter-manager-log-analyzer generates graphs into milter-manager user's home directory. (/var/lib/milter-manager/) We configure Web server to publish them at http://localhost/milter-manager-log/.
% sudo -u milter-manager mkdir -p ~milter-manager/public_html/log
We put /etc/apache2/conf.d/milter-manager-log with the following content:
Alias /milter-manager-log/ /var/lib/milter-manager/public_html/log/
We need to reload configuration after editing:
% sudo /etc/init.d/apache2 force-reload
Now, we can see graphs at http://localhost/milter-manager-log/.
To install the following packages, related packages are also installed:
% sudo aptitude -V -D -y install build-essential rdoc libopenssl-ruby apache2-threaded-dev libsqlite3-ruby milter-manager-admin
% cd ~/src/ % wget http://rubyforge.org/frs/download.php/45905/rubygems-1.3.1.tgz % tar xvzf rubygems-1.3.1.tgz % cd rubygems-1.3.1 % sudo ruby setup.rb --no-format-executable
To build Passenger we run the following command:
% (echo 1; echo) | sudo passenger-install-apache2-module
We create passenger.load and passenger.conf under /etc/apache2/mods-available/.
/etc/apache2/mods-available/passenger.load:
LoadModule passenger_module /usr/lib/ruby/gems/1.8/gems/passenger-2.0.6/ext/apache2/mod_passenger.so
/etc/apache2/mods-available/passenger.conf:
PassengerRoot /usr/lib/ruby/gems/1.8/gems/passenger-2.0.6 PassengerRuby /usr/bin/ruby1.8 RailsBaseURI /milter-manager
We enables the configuration and reload it.
% sudo /usr/sbin/a2enmod passenger % sudo /etc/init.d/apache2 force-reload
milter manager admin has password authentication but it's better that milter manager admin accepts connections only from trusted hosts. For example, here is an example configuration that accepts connections only from localhost. We can use the configuration by appending it to /etc/apache2/mods-available/passenger.conf.
<Location /milter-manager> Allow from 127.0.0.1 Deny from ALL </Location>
If we append the configuration, we should not forget to reload configuration:
% sudo /etc/init.d/apache2 force-reload
milter manager admin is installed to /usr/share/milter-manager/admin/. We run it as milter-manager user authority, and access it at http://localhost/milter-manager/.
% tar cf - -C /usr/share/milter-manager admin | sudo -u milter-manager -H tar xf - -C ~milter-manager % sudo ln -s ~milter-manager/admin/public /var/www/apache22/data/milter-manager % cd ~milter-manager/admin % sudo -u milter-manager -H rake gems:install % sudo -u milter-manager -H rake RAILS_ENV=production db:migrate
Then we create a file to ~milter-manager/admin/config/initializers/relative_url_root.rb with the following content:
~milter-manager/admin/config/initializers/relative_url_root.rb
ActionController::Base.relative_url_root = "/milter-manager"
Now, we can access to http://localhost/milter-manager/. The first work is registering a user. We will move to milter-manager connection configuration page after register a user. We can confirm where milter-manager accepts control connection:
% sudo -u milter-manager -H /usr/sbin/milter-manager --show-config | grep controller.connection_spec controller.connection_spec = "unix:/var/run/milter-manager/milter-manager-controller.sock"
We register confirmed value by browser. In the above case, we select "unix" from "Type" at first. "Path" will be appeared. We specify "/var/run/milter-manager/milter-manager-controller.sock" to "Path".
We can confirm registered child milters and their configuration by browser.
We can confirm milter's effect visually by milter-manager-log-analyzer. If we use Postfix as MTA, we can compare with Mailgraph 's graphs to confirm milter's effect. We can use graphs generated by milter-manager-log-analyzer effectively when we are trying out a milter.
We can reduce administration cost by using milter manager admin. Because we can change configurations without editing configuration file.
It's convenient that we can enable and/or disable milters by browser when we try out milters. We can use graphs generated by milter-manager-log-analyzer to find what is the best milter combination for our mail system.