Mailman - The GNU Mailing List Management System
Copyright (C) 1998,1999,2000 Free Software Foundation, Inc.
59 Temple Place - Suite 330, Boston, MA 02111-1307, USA

このファイルには Mailman のインストール方法が載っています． Mailman は標準の GNU autoconf ソフトウェアを使って設定されます． まず最初に，以下のセクションで概説されているようにシステムを セットアップしてください．その後，Mailmanソフトウェアを設定し インストールしてください．

重要

バージョンアップ

0. インストールの必要事項

http://www.python.org/

セキュリティ向上のために用いられている wrapper プログラムを構築する ためには ANSI C コンパイラーが必要です． GNUのCコンパイラ gcc 2.8.1 以降のバージョンでうまくいきます．Gcc を取って来るには，

http://www.gnu.org/

1. システムセットアップ

Mailman ソフトウェアのインストールの前に，特定のユーザとグループを 追加登録することでシステムの準備をする必要があります．

• 新しいユーザ 'mailman' を登録してください．普通これは /etc/passwd ファイルに追加されます．(訳注:直接 /etc/passwd を 編集するので無く，adduser/useradd/vipw などのコマンドを使います．) もし、mailmanが(他の目的で)すでに使われていたら，他の名前を 選んで，下の --with-ownername フラグで指定します。
• 新しいグループ 'mailman' を登録します．普通これは /etc/group ファイルに 追加されます．Mailman のファイルは 'mailman' グループでインストール され set-group-id ビットが立てられます．このことによって，Webベースと メールベースの両方のプログラムが正しい書きこみ許可を持つようにできます． (訳注:システムによっては ユーザの登録に「既に登録されたグループ」が 必要なことがあります．また，別のシステムでは，コマンドでユーザ登録する 時に同時にグループ登録もできます) もし，mailmanが既に使われていたら，別の名前を選んで，下の --with-owergroup で指定します．
• インストールディレクトリを作成します．(後のドキュメントでは $prefix と呼びます) Mailman の全てのファイルは $prefix の下に インストールされます．
  もし Mailman ユーザ登録して デフォルトの位置(/home/mailman) に インストールしようと計画していたら，そのディレクトリは既に作られて いる可能性があります．
• このディレクトリが 'mailman' グループにセットされていて，setgid ビット があることを確かめてください．また，このディレクトリは誰にでも読めて実行可能 であることも保証しておいたほうがいいでしょう．これを完成させるには シェルコマンドで，

            % cd $prefix
            % chgrp mailman .
            % chmod a+rx,g+ws .
  

  のようにします．(訳注：root 権限が必要かもしれません)

2. configure の実行

このセクションのステップを実行するには root になる必要はありません． 自分自身の login でやるか，普段ソフトウェアのインストールに使っている アカウントでやってください．

けれども，目的のインストールディレクトリに書きこみ許可があることを 確認しておいてください．また，そのファイルシステムに setgid ファイルを 作る許可も必要です．(NFS やその他の ファイル・マウントでは setgid の設定を禁止することができます)

• もし GNUのソフトウェアをインストールしたことがあるなら，configure スクリプトにはおなじみでしょう．普通は Mailman を展開したディレクトリへ cd して，configure を 引数無しで走らせます．

            % cd mailman-<version>
            % ./configure
  

  そして，'make install' を走らせます．以下の configure のオプションが Mailman の カスタマイズに使うことができます．

  --prefix=dir

  標準的な GNU configure のオプションで Mailman がインストール されることになるベースのディレクトリを変更します．デフォルトでは $prefix は /home/mailman です．このディレクトリはその時点で 存在していなければならず，上のセクション１で説明したようにセットアップ されていなければなりません．

  --exec_prefix=dir

  標準的な GNU configure のオプションでアーキテクチャに依存した バイナリのインストールディレクトリを指定できます．

  --with-python=</path/to/python>

  wrapper プログラムで使用する Python インタプリタを変更して 指定することができます．デフォルトはシェルの $PATH の中で最初に見つかった ものを使います．コマンドラインからスクリプトを実行する際には， $PATH の中で最初に見つかった Python のインタプリタが常に使われます．

  --with-mail-gid=<group-or-groups>

  mail wrapper を介してスクリプトを実行する際のグループを 指定します．<group-or-groups> は，１個または複数の整数のグループID でも，グループの名前であっても可です．リストの最初の値で実際に存在 するグループの値が使用されます．デフォルトでは，これは `other daemon' の リストになっています．

  これは高度にシステム依存であり，正しい値を知っておく必要があります． というのは，グループIDがmail wrapper プログラムにコンパイルされて セキュリティを高めるからです．Sendmail を使っているシステムでは， sendmail.cf に "DefaultUser" を使って sendmail プロセスの gid が 設定されています．(もし，コメントアウトされていたら，それでも デフォルトを示しているかもしれません)

  (訳注:私はこれを知るために，/etc/aliases に abc: "|touch /tmp/abc" というのを入れてみました．mail abc でメールを送ってみると， /tmp/abc ができています．ls -l で見たら，結果は other でした． 結局，デフォルトでよかったんだ．)

  --with-cgi-gid=<group-or-groups>

  CGI wrapper を介してスクリプトを実行する際のグループを指定します． <group-or-groups>は，１個または複数の整数のグループID でも，グループの名前であっても可です．リストの最初の値で実際に存在 するグループの値が使用されます．デフォルトでは，これは `www www-data nobody' の リストになっています．

  この値は Web サーバの設定に依存します．正しい値を知っておく必要があります． というのは，グループIDがCGI wrapper プログラムにコンパイルされて セキュリティを高めるからです．これが違っていると Mailman CGI スクリプトは 動きません．

  もし Apache を使っていれば，httpd.conf に書かれている `Group' オプション の値をチェックしてください．

  --with-cgi-ext=<extension>

  cgi プログラムの拡張子を指定します．$PREFIX/cgi-bin に置かれた CGI wrapper はこの拡張子を持ちます．(Webサーバによっては 拡張子が必要です) <extension> には . (dot) を入れておくこと．

  --with-gcc=no

  gcc が見つかっても使いません．`cc' が $PATH に無いといけません．

• `make install' を実行してください．

3. インストールのチェック

• $prefix ディレクトリへ移って (cd $prefix)
• bin/check_perms を実行

• インストールを実行したユーザ ($prefix のファイルオーナ) または root になって，
• bin/check_perms -f を実行する
• エラーが出なくなるまで前のステップを繰り返します．

4. 最終システムセットアップ

• もし，MTAとWebサーバを別のマシンで動かして，Mailman を NFS 経由で 共有したいと考えていたら，その２つのマシンの時計が同期していることを 確かめてください．この手の環境では，Mailman/LockFile.py に定義された CLOCK_SLOP という定数を使って，時計のずれを補償したファイルロック機構 にすることができます．
• Webサーバの設定で $prefix/cgi-bin に CGI スクリプトの実行許可を 与えてください．これをやるには root になる必要があるでしょう．

  設定ファイル (httpd.conf) に書き加える行は以下のようなものになるはずです． (もちろん，$prefix のところは実際の絶対パスディレクトリにしてください)

            Exec          /mailman/*      $prefix/cgi-bin/*
        又は，
            ScriptAlias   /mailman/       $prefix/cgi-bin/
  

  詳しくは，自分が使っている Webサーバの説明書を読んでください．
• CGIスクリプトを実行する ユーザIDが `mailman' ではないことを よく確認してください．でないと，非公開の保存書庫(private archive) が 誰にでも見られてしまいます．
• Mailman, Python, GNU のロゴをWebサーバのアクセス可能なところに コピーしてください．例えば Apacheの場合，画像ファイルを入れておくのに 'icons' ディレクトリが用意されているはずです．コピーするファイルは misc/mailman.jpg, misc/PythonPowered.png, misc/gnu-head-tiny.jpg です．

  $prefix/Mailman/mm_cfg.py にロゴのベースディレクトリを書いた行を 追加してください．例えば：

        IMAGE_LOGOS = '/images/'
  

  IMAGE_LOGOS のデフォルト値は '/icons/' です．Defaults.py.in に 書かれたコメントを呼んでください．
• Pipermail の公開メーリングリスト保存書庫を参照できるように Web サーバを 設定してください．

  例えば Apache の場合：

           Alias /pipermail/ $prefix/archives/public/
  

  詳しくは，ご利用の Web サーバの説明書を調べてください． また，このディレクトリでシンボリックリンクをたどることが できるように Web サーバを設定してください．でないと，Pipermail の 書庫にアクセスできません．Apache のユーザは FollowSymLinks オプションを 調べてください．

  Webサーバを再起動してください．

• crontab の設定をします．Mailman は沢山の cron ジョブを使って， パスワード覚書を送信したりします．このステップを実行するには `mailman' ユーザになる必要があります．$prefix/cron/crontab.in を crontab の エントリーに追加するため，以下のコマンドを実行してください．

            % su - mailman
            % cd $prefix/cron
            % crontab crontab.in
  

  (訳注:「とりあえずパスワード覚書の送信はしないしー」とか言ってここを 省略することはできません．実は，全ての受信メールの処理が cron で起動されているのです．さらに SMTPでメールを送信する場合にはそれも cron 起動です．)
• 自分の MTA と Mailman を繋ぐのに特別の指示があるかどうか見てください． もしあれば，それはMailman のソースディレクトリの README.<yourMTA> ファイルに書かれています．
• `mailman' と `owner-mailman' のalias(別名)をシステムのメール alias データベースに追加してください．このalias は誰か最終的に Mailman のインストールに責任を持つ人を指すようにします． Sendmailを使っている場合には，

  1. root になります．
  2. あなたのメールアドレスが fred@flintstone.com であったとすると， 以下の行を /etc/aliases に追加します．

                  mailman: fred@flintstone.com
                  mailman-owner: mailman
     

  3. Sendmailのバージョンによっては 'newaliases' コマンドを手動で実行 する必要があります．

  もし，sendmail を使っていなければ，ご自分の使っているメール配送プログラムの 説明書を読んでこれに相当する別名設定をしてください．

5. Mailman のカスタマイズ

• $prefix/Mailman/mm_cfg.py をチェックして正確かどうか確認する． 特に，DEFAULT_HOST_NAMEとDEFAULT_URLが正しいか確かめて，必要なら 変更してください．(訳注：MAILMAN_OWNER も要チェック)

  mm_cfg.py の変数設定は $prefix/Mailman/Defaults.py にあるものを 上書きします．Mailman の制御に使われる変数のリストを知るには そのファイルを参照してください．自分のサイトのために変更したいと思う 項目があれば mm_cfg.py に追加してください (Defaults.py は編集しない こと).

  インストールの過程では mm_cfg.py を上書きしないようになっています． ですから，このファイルに加えた変更は保存されます． また，インストールしたときに自動的に生成される mm_cfg.py は $prefix/Mailman/mm_cfg.py.dist にコピーされます．ですから， 何か新しい有益な変更点や示唆についてはここをチェックしてください．

  注意:HOME_DIR や MAILMAN_DIR を変更してはいけません． configure スクリプトで自動的に設定されます．

• 以下のようにパスワードを設定します：

          % $prefix/bin/mmsitepass <your-site-password>
  

  個人ユーザやメーリングリスト管理者のパスワードが 必要なところはどこでも，このパスワードを使うことができます． つまり，必要なときにはいつでもサイト管理者の権限で調整ができるということです．

6. さあ，始めよう

• `test' という名前のりすとを作りましょう．それには， $prefix/bin/newlist プログラムを走らせます． リストの名前とリスト管理者のメールアドレスを入力するように 言ってきます．ご自分のメールアドレスをリスト管理者アドレスとして入力して 下さい．
• newlist を実行すると，システムに追加すべき alias (別名)のリストが 生成されます．もし Sendmail を使っていれば，これを /etc/aliases に 直接追加すればいいでしょう．(root になって) newaliases コマンドを 実行しなければならないかもしれません．これで，リストと管理者のアドレス が設定できました．もし Sendmailを使っていなければ，自分が使っている MTAの説明書を探して alias を設定してください．
• 自分が作成したリストのホームページへどうしたら行けるかについて メールで指示が届くでしょう．その指示に従って，メーリングリストに subscribe(入会)します．入会ができたら(ここで確認の段階が必要です!) リストにメールを送って自分に届くか見てください．もし届いたら， Mailman のインストールと最初のメーリングリストの設定は成功です!

7. トラブルと対策

あなたのマシンでの syslog の所在はマシンによって変わります．/var/log/maillog にあるかもしれません．/var/log/sylog の可能性もあります．多くのマシンでは /var/log の代わりに /adm/log に syslog ファイルが住み着いています．

もし，エラーに遭遇したら，エラーレポートを mailman-users@python.org に 送ってください．その中には 問題を起こしたとき，あなたが何をやったか 説明を入れてください．また，syslog から関係する行をコピーしてください． また，あなたのオペレーティングシステムと Pythonのバージョンの情報も 入れてください． (訳注：もちろん英語です．)

8. 一般的な問題

   Attempt to exec script with invalid gid 51, expected 99

   Attempt to exec script with invalid gid 51, expected 99

% postalias <the alias file>

% python -c'import os; print os.getgid()'

% ./configure --with-mail-gid=thegid

% make clean
% ./configure --with-the-right-options
% make install