Trotter - メール配信システム

===============================================================
Version 1.01 / 16 July 2003


▼動作環境
---------------------------------------------------------------
次の二点が必須環境となります。

JDK 1.4 または JRE 1.4 以降が動作する環境
SMTP サーバに接続できる環境


必須ではありませんが、Ant 1.5 以降がインストールされていると
Trotter の実行が簡単に行えます。
Apache Ant http://ant.apache.org/
---------------------------------------------------------------


▼同梱ファイル
---------------------------------------------------------------
trotter-xxx.zip または trotter-xxx.tar.gz には、以下のファイル
が含まれています。

build-trotter.xml
lib/
	activation.jar
	commons-beanutils.jar
	commons-collections.jar
	commons-digester.jar
	commons-logging.jar
	jdom.jar
	log4j-1.2.8.jar
	mail.jar
	trotter.jar
	xercesImpl.jar
	xmlParserAPIs.jar
conf/
	config-example.xml
---------------------------------------------------------------


▼インストール
---------------------------------------------------------------
trotter-xxx.zip または trotter-xxx.tar.gz を適当なディレクトリ
に展開してください。
---------------------------------------------------------------


▼使用方法
---------------------------------------------------------------
Trotter 1.0 はコンソール上でコマンドを使用して実行します。

ここでは Ant を使って Trotter を実行する方法を説明します。
また、メールアドレスが改行で区切られたテキストファイルを
アドレスリストとして使用します。

Trotter を展開したディレクトリを「$TROTTER_HOME」とします。

1.
メール本文のテキストファイルを用意します。保存先は
自由です。ここでは $HOME/body.txt に保存されている
こととします。

2.
メールアドレスのリストファイルを用意します。ここでは
$HOME/list.txt に保存されていることとします。

リストファイルは次のようなフォーマットになっていることを
確認してください。
==========================
user_a@example.com
user_b@example.org
user_c@example.co.jp
...
==========================

3.
$TROTTER_HOME/conf ディレクトリに移動してください。

4.
conf ディレクトリにある config-example.xml を config.xml という
ファイル名に変更します。

5.
エディタで config.xml を開き、中のコメントを参考に必要な
項目を設定してください。【重要】と【必須】項目以外は
適当なデフォルト値がプログラム側で設定されています。

25行目付近で本文ファイルを設定します。
	<body>
		<filepath>$HOME/body.txt</filepath>
		<encoding></encoding>
	</body>

100行目付近でリストファイルを設定します。
	<list type="plain">
		<filepath>$HOME/list.txt</filepath>
	</list>
また、この <list> 要素前後にあるコメント <!-- --> を削除して
ください。

120行目付近のログ出力先ファイルの指定を忘れないように
注意してください。

(config-example.xml のエンコーディングは EUC になっています。
環境に合わせて適当なエンコーディングに変更してください。)

6.
$TROTTER_HOME ディレクトリに移動してください。

7.
設定ファイルの確認を行います。次のコマンドを実行してください。

ant -f build-trotter.xml check

「チェックの結果、エラーはありませんでした。」と表示されれば、
実行準備は完了です。

8.
メール配信を実行します。次のコマンドを実行してください。

ant -f build-trotter.xml run

リストファイルの全てのアドレスにメールを送信すると終了します。
---------------------------------------------------------------


▼ライセンス
---------------------------------------------------------------
Trotter は GPL に基づいて配布されています。
http://www.gnu.org/licenses/gpl.ja.html

This product includes software developed by the Apache
Software Foundation (http://www.apache.org/).

This product includes software developed by the JDOM Project
(http://www.jdom.org/).
---------------------------------------------------------------


▼サポート
---------------------------------------------------------------
Trotter についての情報は、SourceForge.jp のページを参照して
ください。
http://sourceforge.jp/projects/trotter/

バグ報告やご質問は、上記ページのバグトラッキング、フォーラムを
ご利用ください。
---------------------------------------------------------------



===============================================================
Developed by OZACC http://www.ozacc.com/