diff options
| -rw-r--r-- | fml/doc/ja/tutorial/book.sgml | 3 | ||||
| -rw-r--r-- | fml/doc/ja/tutorial/include/chapters.ent | 3 | ||||
| -rw-r--r-- | fml/doc/ja/tutorial/setup/merge.fml4to8.sgml | 182 |
3 files changed, 186 insertions, 2 deletions
diff --git a/fml/doc/ja/tutorial/book.sgml b/fml/doc/ja/tutorial/book.sgml index 6258acb0..0c248d45 100644 --- a/fml/doc/ja/tutorial/book.sgml +++ b/fml/doc/ja/tutorial/book.sgml @@ -2,7 +2,7 @@ This is an sgml using DocBook dtd. Use sgmltools version 2.0.x or above to generate various output formats. -$FML: book.sgml,v 1.60 2003/11/29 12:51:35 fukachan Exp $ +$FML: book.sgml,v 1.61 2004/02/26 10:36:04 fukachan Exp $ --> <!doctype book public "-//FML//DTD DocBook V3.1-Based Extension//EN" [ @@ -53,6 +53,7 @@ $FML: book.sgml,v 1.60 2003/11/29 12:51:35 fukachan Exp $ <!-- unix --> &chapter.install.fml.unix; &chapter.setup.newml; + &chapter.merge.fml4to8; <!-- 2000/nt --> &chapter.install.fml.nt; diff --git a/fml/doc/ja/tutorial/include/chapters.ent b/fml/doc/ja/tutorial/include/chapters.ent index e1d433ab..7c036451 100644 --- a/fml/doc/ja/tutorial/include/chapters.ent +++ b/fml/doc/ja/tutorial/include/chapters.ent @@ -1,5 +1,5 @@ <!-- - $FML: chapters.ent,v 1.81 2003/12/21 14:23:10 fukachan Exp $ + $FML: chapters.ent,v 1.82 2004/02/26 10:36:05 fukachan Exp $ --> <!entity versin "1.1"> @@ -47,6 +47,7 @@ <!entity sect.setup.newml.recipes SYSTEM "setup/newml.recipes.sgml"> <!entity chapter.setup.cgi SYSTEM "setup/cgi.sgml"> <!entity chapter.setup.test SYSTEM "setup/test.sgml"> +<!entity chapter.merge.fml4to8 SYSTEM "setup/merge.fml4to8.sgml"> <!-- パート II: 使い方の例とカスタマイズについて --> diff --git a/fml/doc/ja/tutorial/setup/merge.fml4to8.sgml b/fml/doc/ja/tutorial/setup/merge.fml4to8.sgml new file mode 100644 index 00000000..841f1c75 --- /dev/null +++ b/fml/doc/ja/tutorial/setup/merge.fml4to8.sgml @@ -0,0 +1,182 @@ +<!-- + $FML$ +--> + + +<chapter id="mergeml.fml4to8"> + <title> + fml4 のＭＬを fml8 形式のＭＬへ変換する + </title> + +<para> +2004/03: +fml4 の $DIR ($ml_home_dirにあたるもの)、 +たとえば /var/spool/ml/elena、 +を fml8 形式の構成へ自動変換するコマンドを実装しました。 +ただ、まだ設定ファイルの翻訳機能は予備的なもので、 +順次、改良されていく予定です。 +</para> + + +<sect1 id="mergeml.fml4to8.overview"> + <title> + 概要: fml4 から fml8 へ + </title> + +<para> +要するに fml4 から fml8 への移行ということですが、fml4 の実行ファイル +を fml8 で上書きすれば、そのまま動くようにはなっていません。 +</para> + +<para> +上書きしてしまうと、一斉に移行を強制することになるし、失敗した時が痛過 +ぎます。やっぱり、少しずつ移行していきたいよね？また、少しずつ移行する +場合にも、出来れば、逆戻りができたほうがいい。 +</para> + +<para> +そんなわけで、ＭＬ一つ一つを移行できるような仕組みにしておきたい。 +できれば、リカバリも出来ると良いです。 +</para> + +<para> +ちなみに、いま考えている操作手順は、こんな感じです。 +<screen> +1. fml8 をインストールする + +2. (postfix の場合) alias_maps に fml8 の aliases を追加 + + 例: + alias_maps = hash:/etc/mail/aliases + hash:/var/spool/ml/etc/aliases (fml4) + hash:/var/spool/ml/etc/mail/aliases (fml8) + + +3. fml4 の ML を fml8 へコンバートする。 + + fml $ml mergeml fml4の$DIR +たとえば + fml elena mergeml /var/spool/ml/elena +</screen> +fml8 へ移行したいＭＬに対して 3. を繰り返す。 +</para> + +<para> +aliases や include の自動変換は、makefml mergeml コマンドが頑張ります。 +また、fml4 の設定ファイルとメンバーリストを fml8 形式へ変換する作業も +頑張ります。 +</para> + +<para> +さすがに、難しい設定がてんこ盛りのconfig.phは無理ですが、簡単な +config.ph であれば、fml8 の config.cf へ全自動で変換できる予定です。な +お、簡単な config.ph とは、たとえば、Subjectのタグと投稿制限の設定など +の、makefml config (メニュー)で設定変更ができたレベルのものを想定して +います。 +</para> + +</sect1> + + +<sect1 id="mergeml.fml4to8.config.diff"> + <title> + 概要: fml4 と fml8 の相違点 + </title> + +<para> +fml8 は fml4 を一旦忘れて、一から再設計、再コーディングされたソフトウ +エアです。そのため、fml4 と fml8 では直接の対応関係がない機能や変数が +あります。 +</para> + +<para> +また、対応関係があったとしても、一対一対応でないものも多いです。 +</para> + +</sect1> + + +<sect1 id="mergeml.fml4to8.boot"> + <title> + 実装: ブートプロセスの変更 + </title> + +<para> +以下の作業ですが、実際には変換するコマンド(makefml mergeml)が自動で頑 +張ります。 +</para> + +<para> +しかしながら、行なっている作業について理解してもらうために、 +aliasesとincludeファイルについての説明をしておきます。 +</para> + +<para> +まず、メールサーバに fml4 から fml8 を起動させるように変更しなくてはな +りません。最終的に fml8 が起動されることができれば、fml4 の config.ph +を適宜解釈するとかする部分は、なんとかなるとはおもいます。 +</para> + +<para> +もうすこし詳細な解説をしましょう。 +<link linkend="overview.ml"> +ＭＬドライバの仕組み +</link> +を思い出してください。 +</para> + +<para> +たとえば Postfix を使う場合、Postfix は aliases ファイルから include +ファイルを読むべきことを知り、include ファイルから fml8 の起動の仕方を +知ります。最終的に Postfix は /usr/local/libexec/fml/distribute コマン +ドを実行します。 +</para> + +<para> +起動された distribute コマンドは、config.cfを読み込み、config.cfからメ +ンバーリストなどの場所を知り、さまざまな処理を行なうといった具合です。 +</para> + +<para> +つまり、fml8 が起動されるまでに +<screen> +aliases ファイル (MTA の設定) +include ファイル +</screen> +の２つの段階を経るわけです。 +</para> + +<para> +そして、aliases ファイル（群）には同じＭＬの設定が重複していてはいけま +せん。だから /etc/postfix/main.cf には次のように fml4 と fml8 の設定両 +方を書いてもよいのですが、 +<screen> +alias_maps = hash:/etc/mail/aliases + hash:/var/spool/ml/etc/aliases (fml4) + hash:/var/spool/ml/etc/mail/aliases (fml8) +</screen> +fml4 と fml8 の aliases ファイル間での重複はきちんと削除していかないと +いけません。 +</para> + +<para> +別の言い方をすると、 +<screen> +MTA -> fml4のaliases -> fml4のinclude -> fml4 (fml.pl)を起動する +</screen> +となっている起動の順番を次のように変更するわけです。 +<screen> +MTA -> fml8のaliases -> fml8のinclude -> fml8 を起動する +</screen> +そのためには +<screen> +fml4 の aliases ファイルから該当するＭＬ部分の設定を削除 +fml8 の aliases ファイルに該当するＭＬ部分の設定を追加 +</screen> +が必要です。 +</para> + +</sect1> + + +</chapter> |