CML-4.2-Release 用 qmail パッチ INSTALL

I. インストール・設定作業の概要

  qmail 環境下で CML を使うためには、大きくわけて [1] CML 本体のインストー
ルと、[2] ML の追加・設定作業にわかれます。[1] は一度行なえば終りですが、
[2] の作業は、新しい ML を作成する度に実行する必要があります。（なお、以下
で説明される 'mlname' の部分は、実際のメイリングリスト名に置き換えてくださ
い。）

 [1] CML 本体のインストール
  (1) CML-4.2-Release.tar.gz を展開します。
  (2) CML-qmail.patch を当てて、CML をインストールします。

 [2] ML の追加・設定作業
  (1) addml を実行して、メイリングリストを追加します。
  (2) root 権限で、システム上の alias 設定を施します。
  (3) ユーザ権限で、alias 設定をします。

  詳細は、以下を参照してください。


II. CML for qmail のインストール

  (1) CML-4.2-Release.tar.gz を展開します。
  (2) qmail 用のパッチを当てます。CML 本体を展開したディレクトリで、
           patch < contrib/Patch-kit-for-qmail/CML-qmail.patch
      を実行してください。
  (3) ./Configure を実行します。
  (4) make install を実行します。

  以上でインストールは終りです。
  ./Configure の実行段階で、qmail-inject の実行ファイルを検索します。
  インストールプログラムは、qmail-inject の在処を、/var/qmail/bin, 
  /usr/sbin, /usr/local/sbin, [sendmail ラッパーのインストール・
  ディレクトリ]/ の順に検索します*。これ 以外の場所に、qmail-inject 
  がインストールされている場合は、正しく認識されませんので、KNOWNBUGS 
  ファイルを参照して、修正を試みてください。

  * qmail-inject は、ディフォルトでは、/var/qmail/bin に、Debian 
    GNU/Linux などでは、/usr/sbin にインストールされるようです。


III. ML の追加・設定作業

 (i) ML を管理する『ユーザ権限で』 addml [mlname] を実行します。

 (ii) root での作業（qmail 用 alias の作成）

  (1) root になって作業します。あなた自身が root になれない場合は、システム
      管理者に作業を依頼してください。パッチ・キットの中に含まれる、perl ス
      クリプト alias-root.pl を実行してください**。
          perl alias-root.pl [mlname] [admin-name]
      第一引数はメイリングリスト名、第二引数は ML 管理者のユーザ・アカウント
      名です。@ 以下のドメイン名を含めてはいけません***。なお、引数を指定せず
      にスクリプトを起動すると対話的に作業を進めることができます。この作業で、
      qmail の alias ディレクトリ（デフォルトでは /var/qmail/alias）に、５つ
      の alias ファイル（.qmail-mlname-request, .qmail-mlname, .qmail-mlname-
      control, .qmail-mlname-request, .qmail-mlname-digest-dist）が生成され
      ます。
  (2) alias-root.pl は、実行される度に nobody の alias が正しく設定されてい
     るかどうか精査します。正しい設定がなされていない場合には：
           Set to dump a mail for 'nobody' into null? [y/n]: 
     と聞いてきますので、y と答えてください。

  ** システムに perl がインストールされていない場合にも、manual.install と
     nobody_alias ファイルを参照して、手作業で alias 設定を施せば動作します。
     (ii) のユーザ alias の設定作業についても同様です。
  *** ML 管理者のメイルホストが ML の運用ホストと異なる場合でも、ここでは
     管理者宛メイルの alias 設定を施すことなく、次のユーザ権限での alias 
     作成の段階で、メイルを転送するように設定してください。(ii) 参照。

 (iii) ユーザ権限での作業（ユーザ alias の作成）

  (1) ML を運用する一般ユーザで作業します****。パッチ・キットの中に含まれる、
      perl スクリプト alias-user.pl を実行してください。
          perl alias-user.pl [mlname] [admin-name]
      第一引数はメイリングリスト名、第二引数は ML 管理者のユーザ・アカウント
      名です。第一引数には、@ 以下のドメイン名を含めてはいけません。第二引数
      にメイルアドレスを指定すると、管理者宛のメイルを別のホスト・アドレスへ
      転送することができます。
      なお、引数を指定せずにスクリプトを起動すると対話的に作業を進めることが
      できます（お勧め）。
      alias の作成途中で、cml のインストールディレクトリのパスをたずねられま
      す（デフォルトは alias-user.pl を実行したディレクトリ）。cml の実行フ
      ァイルの置かれているディレクトリがデフォルト値と異なる場合は、フルパス
      を正しく入力してください。
      この作業で ML 管理者のホームディレクトリの下に、５つのファイル（.qmail-
      mlname-request, .qmail-mlname, .qmail-mlname-control, .qmail-mlname-
      dist, .qmail-mlname-digest-dist）が生成されます。
  (2) 管理者宛のメイルを複数の宛先に転送したい場合や、管理者アドレスが変更に
      なった場合は ~/.qmail-mlname-request ファイルをエディタで直接編集して
      ください。

  **** ML 管理者自身が root である場合は、追加的な作業が必要です。qmail は、
      デフォルトでは root へのメイル配送をしない仕様になっています。root の
      ホームディレクトリに生成された .qmail-mlname* ファイルを、qmail の 
      alias ディレクトリ（デフォルトでは /var/qmail/alias）に移動させ、各フ
      ァイルを上書き保存してください。
          mv ~/.qmail-mlname* /var/qmail/alias
      また root 宛てのメイルは /var/qmail/alias/.qmail-root を作成して、実体
      のあるユーザ・アカウントに転送するように設定してください。


・以上で、全てのインストール・設定作業は終了です。お疲れ様でした。後は、CML 
  本体のマニュアル通りの方法で管理できます。
・なお、この qmail パッチは、sendmail, Postfix 環境下でも問題なく動くように
  設計されています。ただし、実践的なテストはなされていません。
・qmail と sendmail の alias 設定の違いについては、qmail 付属の文書を参照し
  てください。なお、拙著の alias 設定スクリプトによるバグや、作業ミスによる
  動作不良が生じた場合には、スクリプトを読んで作業内容を把握するか、qmail 用
  patch の原作者によるマニュアルでの設定作業方法を記した、manual.install フ
  ァイルを参考にして修正を試みてください。このパッケージに含まれるスクリプト
  は、manual.install に記載された patch 原作者の作業内容を自動化させるために
  書かれたものです。
・バグや改善提案などの報告は、以下の E-mail アドレスまで送ってください。


             OKADA Tetsutaro <tetsuta@ec.kagawa-u.ac.jp> 2016年8月25日
