From: <kt...@us...> - 2009-01-28 07:43:56
|
Revision: 2532 http://milter-manager.svn.sourceforge.net/milter-manager/?rev=2532&view=rev Author: ktou Date: 2009-01-28 07:43:44 +0000 (Wed, 28 Jan 2009) Log Message: ----------- * doc/install*: update. Modified Paths: -------------- milter-manager/trunk/ChangeLog milter-manager/trunk/doc/install-options-to-ubuntu.rd.ja milter-manager/trunk/doc/install-to-freebsd.rd.ja milter-manager/trunk/doc/install.rd.ja Added Paths: ----------- milter-manager/trunk/doc/install-options-to-centos.rd.ja milter-manager/trunk/doc/install-options-to-freebsd.rd.ja Modified: milter-manager/trunk/ChangeLog =================================================================== --- milter-manager/trunk/ChangeLog 2009-01-28 07:25:46 UTC (rev 2531) +++ milter-manager/trunk/ChangeLog 2009-01-28 07:43:44 UTC (rev 2532) @@ -1,5 +1,7 @@ 2009-01-28 Kouhei Sutou <ko...@cl...> + * doc/install*: update. + * data/cron.d/debian/milter-manager-log, data/cron.d/redhat/milter-manager-log: use -c option. Added: milter-manager/trunk/doc/install-options-to-centos.rd.ja =================================================================== --- milter-manager/trunk/doc/install-options-to-centos.rd.ja (rev 0) +++ milter-manager/trunk/doc/install-options-to-centos.rd.ja 2009-01-28 07:43:44 UTC (rev 2532) @@ -0,0 +1,153 @@ +# -*- rd -*- + += CentOSへインストール(任意) --- CentOSへのmilter manager関連ソフトウェアのインストール方法 + +CentOSに特化したmilter manager関連ソフトウェアのインストール +方法について説明します。milter manager本体のインストール情報 +は((<CentOSへインストール|install-to-centos.rd.ja>))、CentOS +に依存しない一般的なインストール情報は((<インストール +|install.rd.ja>))を見てください。 + +== milter-manager-log-analyzerのインストール + +グラフはインストール時に作成したmilter-managerユーザのホーム +ディレクトリ以下に出力し、 +http://localhost/~milter-manager/log/で閲覧できるようにします。 + + % sudo -u milter-manager mkdir -p ~milter-manager/public_html/log + +WebサーバとしてApacheをインストールします。 + + % sudo yum install -y httpd + +/etc/cron.d/以下にcronファイルへのシンボリックリンクを作成し +ます。 + + % sudo ln -s /usr/local/etc/milter-manager/cron.d/redhat/milter-manager-log /etc/cron.d/ + % sudo chmod 700 /etc/cron.d/milter-manager-log + +CentOSではmilter-managerのログは/var/log/maillogに出力されま +す。/var/log/maillogはroot以外は読むことができないので、cron +ファイル内では、rootで読み込んだ/var/log/maillogをパイプで +milter-manager-log-analyzerに渡します。 +milter-manager-log-analyzerはrootではなく、インストール時に作 +成したmilter-manager権限で実行します。 + +milter-manager-log-analyzerは5分おきに実行されます。 +/var/log/cronで実行されたかどうかを確認することができます。 + +== milter manager adminのインストール + +=== パッケージのインストール + +以下のパッケージをインストールすることにより、関連するパッケー +ジもインストールされます。 + + % sudo yum install -y ruby-rdoc gcc-c++ httpd-devel sqlite-devel + +=== RubyGemsのインストール + + % 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 + +=== gemのインストール + + % sudo gem install sqlite3-ruby + % sudo gem install rails -v '2.2.2' + % sudo gem install locale_rails + % sudo gem install passenger + +=== Passengerのインストール + +以下のコマンドを実行し、Passengerをビルドします。 + + % (echo 1; echo) | sudo passenger-install-apache2-module + +以下の内容のmilter-manager.confを/etc/httpd/conf.d/に作成しま +す。 + +/etc/httpd/conf.d/milter-manager.conf: + LoadModule passenger_module /usr/lib/ruby/gems/1.8/gems/passenger-2.0.6/ext/apache2/mod_passenger.so + PassengerRoot /usr/lib/ruby/gems/1.8/gems/passenger-2.0.6 + PassengerRuby /usr/bin/ruby + + RailsBaseURI /milter-manager + +設定ファイルを再読み込みします。 + + % sudo /sbin/service httpd reload + +milter manager adminはパスワード認証がついていますが、可能で +あれば信頼できるホストからのみ接続を受け付ける方がセキュリティ +上は好ましいです。例えば、ローカルホストのみ信頼できるのであ +れば、以下の設定を/etc/httpd/conf.d/milter-manager.confに追 +記してください。 + + <Location /milter-manager> + Allow from 127.0.0.1 + Deny from ALL + </Location> + +追記した場合は設定ファイルを再読み込みするのを忘れないでくだ +さい。 + + % sudo /sbin/service httpd reload + +=== milter manager adminのインストール + +milter manager adminは/usr/local/share/milter-manager/admin/ +以下にインストールされています。これをmilter-managerユーザ権 +限で動かし、http://localhost/milter-manager/でアクセスできる +ようにします。 + +FIXME + + % tar cf - -C /usr/local/share/milter-manager admin | sudo -u milter-manager -H tar xf - -C ~milter-manager + % sudo ln -s /usr/local/share/milter-manager/admin/public /var/www/milter-manager + % cd ~milter-manager/admin + % sudo -u milter-manager -H rake RAILS_ENV=production db:migrate + +最後に以下の内容の +~milter-manager/admin/config/initializer/relative_url_root.rb +を作成します。 + +~milter-manager/admin/config/initializer/relative_url_root.rb + ActionController::Base.relative_url_root = "/milter-manager" + +http://localhost/milter-manager/にアクセスしてユーザを登録し +てください。ユーザを登録したら、milter-managerと接続するため +の情報を設定するページへ移動します。milter-managerがどこで接 +続を受け付けているかは以下で確認可能です。 + + % /usr/local/sbin/milter-manager --show-config | grep controller.connection_spec + controller.connection_spec = "unix:/var/run/milter-manager/milter-manager-controller.sock" + +確認した値をブラウザから登録してください。上記の場合だと、 +まず、「種類」から「unix」を選びます。これで編集フォームに +「パス」がでてきます。「パス」には +「/var/run/milter-manager/milter-manager-controller.sock」を +指定してください。 + +登録すると、milter-managerに登録されている子milterやその設定 +状況をブラウザから確認することができます。 + +== まとめ + +milter-manager-log-analyzerを利用することによりmilterを導入し +た効果を視覚的に確認することができます。MTAとしてPostfixを使 +用しているのであれば、 +((<Mailgraph|URL:http://mailgraph.schweikert.ch/>))のグラフと +見くらべてmilter導入の効果を確認することができます。milter の +試験的に導入している場合などに有効に活用できます。 + +milter manager adminを利用することで設定ファイルを変更せずに +運用できる領域が広がり、メールシステムの管理コストを下げるこ +とができます。 + +また、Webブラウザからmilterの有効・無効を切り替えることもでき +るため、milterの効果を試行錯誤する場合に便利です。 +milter-manager-log-analyzerのグラフとあわせて、それぞれのメー +ルシステムに適した迷惑メール対策の適用を支援します。 Added: milter-manager/trunk/doc/install-options-to-freebsd.rd.ja =================================================================== --- milter-manager/trunk/doc/install-options-to-freebsd.rd.ja (rev 0) +++ milter-manager/trunk/doc/install-options-to-freebsd.rd.ja 2009-01-28 07:43:44 UTC (rev 2532) @@ -0,0 +1,159 @@ +# -*- rd -*- + += FreeBSDへインストール(任意) --- FreeBSDへのmilter manager関連ソフトウェアのインストール方法 + +FreeBSDに特化したmilter manager関連ソフトウェアのインストール +方法について説明します。milter manager本体のインストール情報 +は((<FreeBSDへインストール|install-to-freebsd.rd.ja>))、 +FreeBSDに依存しない一般的なインストール情報は((<インストール +|install.rd.ja>))を見てください。 + +== milter-manager-log-analyzerのインストール + +グラフはインストール時に作成したmilter-managerユーザのホーム +ディレクトリ以下に出力し、 +http://localhost/~milter-manager/log/で閲覧できるようにします。 + + % sudo -u milter-manager mkdir -p ~milter-manager/public_html/log + +WebサーバとしてApacheをインストールします。 + +FIXME + + % sudo aptitude -V -D install apache2 + +Apacheで各ユーザ毎にファイルを公開できるようにします。 + + % sudo /usr/sbin/a2enmod userdir + % sudo /etc/init.d/apache2 force-reload + +次に、cronの設定をします。/etc/cron.d/以下にcronファイルへの +シンボリックリンクを作成します。 + + % sudo ln -s /usr/local/etc/milter-manager/cron.d/debian/milter-manager-log /etc/cron.d/ + % sudo chmod 600 /etc/cron.d/milter-manager-log + +Ubuntuではmilter-managerのログは/var/log/mail.infoに出力され +ます。/var/log/mail.infoは管理者用のユーザ以外は読むことがで +きないので、cron ファイル内では、rootで読み込んだ +/var/log/mail.infoをパイプでmilter-manager-log-analyzerに渡し +ます。milter-manager-log-analyzerはrootではなく、インストール +時に作成したmilter-manager権限で実行します。 + +milter-manager-log-analyzerは5分おきに実行されます。 +/var/log/syslogで実行されたかどうかを確認することができます。 + +== milter manager adminのインストール + +=== パッケージのインストール + +以下のパッケージをインストールすることにより、関連するパッケー +ジもインストールされます。 + + % sudo aptitude -V -D install rdoc libopenssl-ruby apache2-threaded-dev libsqlite3-ruby + +=== RubyGemsのインストール + + % 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 + +=== gemのインストール + + % sudo gem1.8 install rails -v '2.2.2' + % sudo gem1.8 install locale_rails + % sudo gem1.8 install passenger + +=== Passengerのインストール + +以下のコマンドを実行し、Passengerをビルドします。 + + % (echo 1; echo) | sudo /var/lib/gems/1.8/bin/passenger-install-apache2-module + +以下の内容のpassenger.loadとpassenger.confを +/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 + +設定ファイルを再読み込みします。 + + % sudo /etc/init.d/apache2 force-reload + +milter manager adminはパスワード認証がついていますが、可能で +あれば信頼できるホストからのみ接続を受け付ける方がセキュリティ +上は好ましいです。例えば、ローカルホストのみ信頼できるのであ +れば、以下の設定を/etc/apache2/mods-available/passenger.conf +に追記してください。 + + <Location /milter-manager> + Allow from 127.0.0.1 + Deny from ALL + </Location> + +追記した場合は設定ファイルを再読み込みするのを忘れないでくだ +さい。 + + % sudo /etc/init.d/apache2 force-reload + +=== milter manager adminのインストール + +milter manager adminは/usr/local/share/milter-manager/admin/ +以下にインストールされています。これをmilter-managerユーザ権 +限で動かし、http://localhost/milter-manager/でアクセスできる +ようにします。 + + % tar cf - -C /usr/local/share/milter-manager admin | sudo -u milter-manager -H tar xf - -C ~milter-manager + % sudo ln -s /usr/local/share/milter-manager/admin/public /var/www/milter-manager + % cd ~milter-manager/admin + % sudo -u milter-manager -H rake RAILS_ENV=production db:migrate + +最後に以下の内容の +~milter-manager/admin/config/initializer/relative_url_root.rb +を作成します。 + +~milter-manager/admin/config/initializer/relative_url_root.rb + ActionController::Base.relative_url_root = "/milter-manager" + +http://localhost/milter-manager/にアクセスしてユーザを登録し +てください。ユーザを登録したら、milter-managerと接続するため +の情報を設定するページへ移動します。milter-managerがどこで接 +続を受け付けているかは以下で確認可能です。 + + % /usr/local/sbin/milter-manager --show-config | grep controller.connection_spec + controller.connection_spec = "unix:/var/run/milter-manager/milter-manager-controller.sock" + +確認した値をブラウザから登録してください。上記の場合だと、 +まず、「種類」から「unix」を選びます。これで編集フォームに +「パス」がでてきます。「パス」には +「/var/run/milter-manager/milter-manager-controller.sock」を +指定してください。 + +登録すると、milter-managerに登録されている子milterやその設定 +状況をブラウザから確認することができます。 + +== まとめ + +milter-manager-log-analyzerを利用することによりmilterを導入し +た効果を視覚的に確認することができます。MTAとしてPostfixを使 +用しているのであれば、 +((<Mailgraph|URL:http://mailgraph.schweikert.ch/>))のグラフと +見くらべてmilter導入の効果を確認することができます。milter の +試験的に導入している場合などに有効に活用できます。 + +milter manager adminを利用することで設定ファイルを変更せずに +運用できる領域が広がり、メールシステムの管理コストを下げるこ +とができます。 + +また、Webブラウザからmilterの有効・無効を切り替えることもでき +るため、milterの効果を試行錯誤する場合に便利です。 +milter-manager-log-analyzerのグラフとあわせて、それぞれのメー +ルシステムに適した迷惑メール対策の適用を支援します。 Modified: milter-manager/trunk/doc/install-options-to-ubuntu.rd.ja =================================================================== --- milter-manager/trunk/doc/install-options-to-ubuntu.rd.ja 2009-01-28 07:25:46 UTC (rev 2531) +++ milter-manager/trunk/doc/install-options-to-ubuntu.rd.ja 2009-01-28 07:43:44 UTC (rev 2532) @@ -5,8 +5,8 @@ Ubuntu Linuxに特化したmilter manager関連ソフトウェアのインス トール方法について説明します。milter manager本体のインストー ル情報は((<Ubuntuへインストール|install-to-ubuntu.rd.ja>))、 -Ubuntuに依存しない一般的なインストール情報は((<インストール -|install.rd.ja>))を見てください。 +Ubuntu Linuxに依存しない一般的なインストール情報は((<インストー +ル|install.rd.ja>))を見てください。 == milter-manager-log-analyzerのインストール @@ -29,7 +29,6 @@ シンボリックリンクを作成します。 % sudo ln -s /usr/local/etc/milter-manager/cron.d/debian/milter-manager-log /etc/cron.d/ - % sudo chmod 600 /etc/cron.d/milter-manager-log Ubuntuではmilter-managerのログは/var/log/mail.infoに出力され ます。/var/log/mail.infoは管理者用のユーザ以外は読むことがで Modified: milter-manager/trunk/doc/install-to-freebsd.rd.ja =================================================================== --- milter-manager/trunk/doc/install-to-freebsd.rd.ja 2009-01-28 07:25:46 UTC (rev 2531) +++ milter-manager/trunk/doc/install-to-freebsd.rd.ja 2009-01-28 07:43:44 UTC (rev 2532) @@ -60,6 +60,8 @@ * SendmailではなくPostfixを使用しているため、mailnullユー ザは使用されていない +ただし、milter-managerはmilter-managerユーザで動かします。 + 必要のない配送遅延をできるだけ抑えるため、milter-greylistは ((<S25R|URL:http://gabacho.reto.jp/anti-spam/>))にマッチする ときのみ適用します。しかし、これはmilter-managerが自動で行う @@ -215,13 +217,19 @@ らえれば、milter-manager.confを編集しなくとも使用できるように 検出方法を改良することができるかもしれません。 +milter-managerはmilter-managerユーザで動作させるので、 +milter-managerユーザを作成します。 + + % sudo /usr/sbin/pw groupadd milter-manager + % sudo /usr/sbin/pw useradd milter-manager -g milter-manager -G mail + FreeBSD上ではデフォルトでは /var/run/milter-manager/milter-manager.sockというソケットファ イルを作成します。そのため、事前に/var/run/milter-manager/ディ レクトリを作成しておく必要があります。 % sudo mkdir -p /var/run/milter-manager - % sudo /usr/sbin/chown -R mailnull:mail /var/run/milter-manager + % sudo /usr/sbin/chown -R milter-manager:mail /var/run/milter-manager milter-managerの設定が完了したので、起動の設定をします。 @@ -244,7 +252,7 @@ /usr/local/bin/milter-test-serverで起動の確認をすることがで きます。 - % sudo -u mailnull milter-test-server -s unix:/var/run/milter-manager/milter-manager.sock + % sudo -u milter-manager milter-test-server -s unix:/var/run/milter-manager/milter-manager.sock このように表示されれば成功です。 Modified: milter-manager/trunk/doc/install.rd.ja =================================================================== --- milter-manager/trunk/doc/install.rd.ja 2009-01-28 07:25:46 UTC (rev 2531) +++ milter-manager/trunk/doc/install.rd.ja 2009-01-28 07:43:44 UTC (rev 2532) @@ -72,39 +72,17 @@ 確認することができます。新しく追加したmilterの効果や、milter の適用結果の傾向などを視覚的に確認したい場合に有用です。 -milter-manager-log-analyzerはsyslogに出力されたmilter-managerのログを解 -析し、((<RRDtool|URL:http://oss.oetiker.ch/rrdtool/>))でグラ -フ化します。ログはcronを設定し、定期的に確認します。 +milter-manager-log-analyzerはsyslogに出力された +milter-managerのログを解析し、 +((<RRDtool|URL:http://oss.oetiker.ch/rrdtool/>))でグラフ化し +ます。ログはcronを設定し、定期的に確認します。 -=== CentOSの場合 +milter-manager-log-analyzerのインストール方法は管理用Webイン +ターフェイスのインストール方法と一緒に、プラットフォーム毎に +解説しています。 -グラフはインストール時に作成したmilter-managerユーザのホーム -ディレクトリ以下に出力し、 -http://localhost/~milter-manager/log/で閲覧できるようにします。 + * ((<Ubuntu|install-options-to-ubuntu.rd.ja>)) - % sudo mkdir -p ~milter-manager/public_html/log - % sudo chown -R milter-manager:milter-manager ~milter-manager - -WebサーバとしてApacheをインストールします。 - - % sudo yum install -y httpd - -/etc/cron.d/以下にcronファイルへのシンボリックリンクを作成し -ます。 - - % sudo ln -s /usr/local/etc/milter-manager/cron.d/redhat/milter-manager-log /etc/cron.d/ - % sudo chmod 600 /etc/cron.d/milter-manager-log - -CentOSではmilter-managerのログは/var/log/maillogに出力されま -す。/var/log/maillogはroot以外は読むことができないので、cron -ファイル内では、rootで読み込んだ/var/log/maillogをパイプで -milter-manager-log-analyzerに渡します。 -milter-manager-log-analyzerはrootではなく、インストール時に作 -成したmilter-manager権限で実行します。 - -milter-manager-log-analyzerは5分おきに実行されます。/var/log/cronで実行 -されたかどうかを確認することができます。 - === FreeBSDの場合 グラフは/usr/local/www/apache22/data/milter-manager/log/以下 @@ -162,3 +140,9 @@ てしまうよりは、必要性の高い機能だけにしぼってシンプルで使い やすいインターフェイスを提供するほうが有用だという判断でこの ような方針になっています。 + +milter manager adminのインストール方法は +milter-manager-log-analyzerのインストール方法と一緒に、プラッ +トフォーム毎に解説しています。 + + * ((<Ubuntu|install-options-to-ubuntu.rd.ja>)) This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site. |