1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
|
<?xml version="1.0" encoding="euc-jp"?>
<!DOCTYPE html
PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta name="ROBOTS" content="NOARCHIVE" />
<title>quickml server: An easy-to-use mailing list system</title>
<link rel="stylesheet" href="http://namazu.org/~satoru/satoru.css" media="all" type="text/css" />
</head>
<body>
<p class="lang-navigator">English | <a href="index.html.ja">Japanese</a></p>
<h1><a name="label-0" id="label-0">quickml server: An easy-to-use mailing list system</a></h1><!-- RDLabel: "quickml server: An easy-to-use mailing list system" -->
<p class="last-modified">Last Modified: 2004-06-09 (Since: 2002-02-12)</p>
<hr />
<p>quickml server is a very-easy-to-use mailing list system.
quickml server provides very-easy-to-use mailing list service.</p>
<p>The latest version is available at
<a href="http://quickml.com/quickml/"><URL:http://quickml.com/quickml/></a>.</p>
<h2><a name="label-1" id="label-1">What's New</a></h2><!-- RDLabel: "What's New" -->
<ul>
<li>2004-06-09: quickml 0.7 released!
<ul>
<li>Some bugs were fixed.</li>
</ul></li>
<li>2004-02-11: quickml 0.6 released!
<ul>
<li>Ruby 1.8 is now supported.</li>
<li>Autotoolized.</li>
<li>Some bugs were fixed.</li>
</ul></li>
<li>2002-03-04: quickml 0.5 released!
<ul>
<li>Fix the bug of handling a large mail.</li>
<li>Require Ruby 1.6.7 (for using time.rb)</li>
</ul></li>
<li>2002-03-01: quickml 0.4 released!
<ul>
<li>Work with other MTAs. (quickmlrc: :port)</li>
<li>Discard root privilege after binding port 25 (quickmlrc: :user, :group)</li>
<li>Support qmail's VERP (quickmlrc: :use_qmail_verp = true/false)</li>
<li>Separate library files.</li>
<li>Some bugs were fixed.</li>
</ul></li>
<li>2002-02-19: quickml 0.3 released!
<ul>
<li>Introduce automatic error mail handling.</li>
<li>Introduce selection mechanism for the language of messages.</li>
<li>Some bugs were fixed.</li>
</ul></li>
<li>2002-02-12: quickml 0.2 released!
<ul>
<li>Fix a fatal bug (String.toeuc raises NameError)</li>
<li>Some bugs were fixed.</li>
</ul></li>
<li>2002-02-12: quickml 0.1 released!</li>
</ul>
<h2><a name="label-2" id="label-2">Characteristics</a></h2><!-- RDLabel: "Characteristics" -->
<ul>
<li>You can create mailing lists of any names you like very easily.</li>
<li>You can create mailing lists with any subdomains you like.</li>
<li>quickml server runs as a stand-alone SMTP server.</li>
<li>quickml server delegates mail delivery to another mail server.</li>
<li>quickml server is simply written in Ruby.</li>
</ul>
<h2><a name="label-3" id="label-3">Download</a></h2><!-- RDLabel: "Download" -->
<p>quickml server is a free software with ABSOLUTELY NO
WARRANTY under the terms of the GNU General Public License
version 2.</p>
<ul>
<li><a href="http://quickml.com/quickml/quickml-0.7.tar.gz"><URL:http://quickml.com/quickml/quickml-0.7.tar.gz></a></li>
<li><a href="http://sourceforge.net/cvs/?group_id=111025"><URL:http://sourceforge.net/cvs/?group_id=111025></a></li>
</ul>
<h2><a name="label-4" id="label-4">Supported Systems</a></h2><!-- RDLabel: "Supported Systems" -->
<p>quickml server should work on most Unix platforms. quickml
server is tested on Red Hat Linux 7.2 and NetBSD 1.5.1.</p>
<h2><a name="label-5" id="label-5">Requirements</a></h2><!-- RDLabel: "Requirements" -->
<ul>
<li><a href="http://www.ruby-lang.org/">Ruby</a> 1.6.7 or later.</li>
<li>Ruby 1.8.x is recommended.</li>
</ul>
<h2><a name="label-6" id="label-6">Installation</a></h2><!-- RDLabel: "Installation" -->
<p>For standard installation, the following commands will do.</p>
<pre>% ./configure && make
# make install # with root privilege</pre>
<p>You can give parameters to configure if necessary.</p>
<pre>--with-user=USER quickml runs as USER [root]
--with-group=GROUP quickml runs as GROUP [root]
--with-pidfile=FILE PID is stored in FILE [/var/run/quickml.pid]
--with-logfile=FILE Log is recorded in FILE [/var/log/quickml.log]
--with-rubydir=DIR Ruby library files go to DIR [guessed]</pre>
<h2><a name="label-7" id="label-7">Configurations</a></h2><!-- RDLabel: "Configurations" -->
<p>The configuration file locates at /usr/local/etc/quickmlrc
by default. Although there are many parameters, all that
you have to change are the only three following parameters.</p>
<h3><a name="label-8" id="label-8">:smtp_host</a></h3><!-- RDLabel: ":smtp_host" -->
<p>Set the mail server for mail delivery.</p>
<h3><a name="label-9" id="label-9">:domain</a></h3><!-- RDLabel: ":domain" -->
<p>Set the domain name of mailing lists. i.e.. a part of a mail
address after `@' mark.</p>
<h3><a name="label-10" id="label-10">:postmaster</a></h3><!-- RDLabel: ":postmaster" -->
<p>Set the From: address for sending error mails.</p>
<h2><a name="label-11" id="label-11">How to Use quickml Server</a></h2><!-- RDLabel: "How to Use quickml Server" -->
<p>Since quickml server uses SMTP (25) port,
quickml server should be invoked with the root privilege.</p>
<h3><a name="label-12" id="label-12">Start</a></h3><!-- RDLabel: "Start" -->
<pre># quickml-ctl start</pre>
<h3><a name="label-13" id="label-13">Stop</a></h3><!-- RDLabel: "Stop" -->
<pre># quickml-ctl stop</pre>
<h3><a name="label-14" id="label-14">Restart</a></h3><!-- RDLabel: "Restart" -->
<pre># quickml-ctl restart</pre>
<h2><a name="label-15" id="label-15">How to Use Mailing List Service</a></h2><!-- RDLabel: "How to Use Mailing List Service" -->
<p>See <a href="ml-usage.en.html">ml-usage.en.rd</a>.</p>
<h2><a name="label-16" id="label-16">Automatic Error Mail Handling</a></h2><!-- RDLabel: "Automatic Error Mail Handling" -->
<p>Automatic error mail handling works if you are using
<a href="http://www.qmail.org/">qmail</a> or
<a href="http://www.postfix.org/">Postfix</a> supporting XVERP
extension as a mail server for delivery. quickml server
automatically removes a mail address when error mail returns
five times from the mail server for delivery. You can change
the threshold :auto_unsubscribe_count by editing quickmlrc
file.</p>
<p>If you are using qmail, set :use_qmail_verp = true in the
quickmlrc file. If you are using Postfix, no additional
configuration is needed.</p>
<h2><a name="label-17" id="label-17">Subdomain Handling</a></h2><!-- RDLabel: "Subdomain Handling" -->
<p>You can create mailing lists with any subudomains you like
by employing DNS's wildcard MX feature. To enable the
subdomain handling, all mails to any subdomains should be
delivered to quickml server. DNS's wildcard MX RR (Resource
Record) allows such a delivery.</p>
<p>The following illustrates a sample configuration for
BIND. In this example, quickml server runs at ml.pitecan.com
(192.168.0.1).</p>
<pre>$ORIGIN pitecan.com.
@ IN MX 10 ml ; 1
* IN MX 10 ml ; 2
ml IN A 192.168.0.1 ; 3
IN MX 10 ml ; 4</pre>
<h3><a name="label-18" id="label-18">Notes</a></h3><!-- RDLabel: "Notes" -->
<ol>
<li>All mails to @pitecan.com are delivered to ml.pitecan.com.</li>
<li>All mails to any subdomains at pitecan.com are delivered to ml.ptiecan.com.</li>
<li>IP address of ml.pitecan.com</li>
<li>MX RR</li>
</ol>
<h2><a name="label-19" id="label-19">Mailing List Data Files</a></h2><!-- RDLabel: "Mailing List Data Files" -->
<p>Mailing list data files locate at /usr/local/var/lib/quickml
by default. The following are basic files.</p>
<ul>
<li>foo: Member list</li>
<li>foo,count: Serial Number</li>
<li>foo,keyword: Keyword for a sub mailing list</li>
</ul>
<h3><a name="label-20" id="label-20">Special Files</a></h3><!-- RDLabel: "Special Files" -->
<p>You can create special mailing lists by creating the
following empty files.</p>
<ul>
<li>foo,permanent: Permanent mailing list</li>
<li>foo,forward: Anyone-can-post mailing list</li>
<li>foo,unlimited: Mailing list with unlimited number of members.</li>
<li>foo,config: Configurations such as Number of members and Max size of mail.</li>
</ul>
<h2><a name="label-21" id="label-21">quickml-analog</a></h2><!-- RDLabel: "quickml-analog" -->
<p>quickml-analog is a tool to analyze quickml's log and
generate charts. gnuplot, ImageMagick, and ghostscript are
required. </p>
<pre>% quickml-analog -i -o output-dir quickml.log</pre>
<h2><a name="label-22" id="label-22">QuickML History</a></h2><!-- RDLabel: "QuickML History" -->
<p>Idea of QuickML emerged from a discussion by <a href="http://namazu.org/~satoru//">Satoru
Takabayashi</a> and
<a href="http://pitecan.com/">Toshiyuki Masui</a>.
quickml server has been implemented in Ruby by Takabayashi
based on the prototype in Perl by Masui. subdomain support
was helped by
<a href="http://www.csl.sony.co.jp/person/sohgo/">Sohgo Takeuchi</a>.</p>
<hr />
<address><a href="http://namazu.org/~satoru/">Satoru Takabayashi</a></address>
</body>
</html>
|
