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
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
|
<HTML>
<!-- THIS PAGE IS AUTOMATICALLY GENERATED. DO NOT EDIT. -->
<!-- Thu Jul 12 00:23:15 2001 -->
<!-- USING HT2HTML 1.1 -->
<!-- SEE http://www.wooz.org/barry/software/pyware.html -->
<!-- User-specified headers:
Title: Final system setup
-->
<HEAD>
<TITLE>Final system setup</TITLE>
</HEAD>
<BODY BGCOLOR="#ffffff" TEXT="#000000"
TOPMARGIN="0" LEFTMARGIN="0" MARGINWIDTH="0" MARGINHEIGHT="0"
LINK="#0000bb" VLINK="#551a8b"
ALINK="#ff0000">
<!-- start of page table -->
<TABLE WIDTH="100%" BORDER=0 CELLSPACING=0 CELLPADDING=0>
<!-- start of banner row -->
<TR>
<!-- start of corner cells -->
<TD WIDTH=150 VALIGN=CENTER BGCOLOR="white">
<center>
<a href="./index.html">
<img border=0 src="./images/logo-70.jpg"></a></center> </TD>
<TD WIDTH=15 BGCOLOR="#caa08f"> </TD><!--spacer-->
<!-- end of corner cells -->
<!-- start of banner -->
<TD WIDTH="90%" BGCOLOR="#caa08f">
<!-- start of site links table -->
<TABLE WIDTH="100%" BORDER=0
CELLSPACING=0 CELLPADDING=0
COLS=3 ROWS=4 BGCOLOR="#ffffff">
<TR>
<TD BGCOLOR="#caa08f">
<a href="./index.html">Home</a>
</TD>
<TD BGCOLOR="#caa08f">
<a href="./users.html">Users</a>
</TD>
<TD BGCOLOR="#caa08f">
<a href="http://www.list.org/">List.Org</a>
</TD>
</TR><TR>
<TD BGCOLOR="#caa08f">
<a href="./install-start.html">Installation</a>
</TD>
<TD BGCOLOR="#caa08f">
<a href="./mgrs.html">List Managers</a>
</TD>
<TD BGCOLOR="#caa08f">
<a href="http://www.gnu.org/software/mailman/mailman.html">Mailman at GNU</a>
</TD>
</TR><TR>
<TD BGCOLOR="#caa08f">
<a href="./faq.html">FAQ</a>
</TD>
<TD BGCOLOR="#caa08f">
<a href="./admins.html">Site Administrators</a>
</TD>
<TD BGCOLOR="#caa08f">
<a href="http://www.python.org/">Python.Org</a>
</TD>
</TR><TR>
<TD BGCOLOR="#caa08f">
<a href="./lists.html">Discussion Lists</a>
</TD>
<TD BGCOLOR="#caa08f">
<a href="./devs.html">Developers</a>
</TD>
<TD BGCOLOR="#caa08f">
<a href="http://www.gnu.org/">Gnu.Org</a>
</TD>
</TR>
</TABLE><!-- end of site links table -->
</TD><!-- end of banner -->
</TR><!-- end of banner row -->
<TR><!-- start of sidebar/body row -->
<!-- start of sidebar cells -->
<TD WIDTH=150 VALIGN=TOP BGCOLOR="#caa08f">
<!-- start of sidebar table -->
<TABLE WIDTH="100%" BORDER=0 CELLSPACING=0 CELLPADDING=3
BGCOLOR="#ffffff">
<TR><TD BGCOLOR="#545454"><B><FONT COLOR="#ffffff">
Overview
</FONT></B></TD></TR>
<TR><TD BGCOLOR="#caa08f">
<A HREF="index.html">Home</A>
</TD></TR>
<TR><TD BGCOLOR="#caa08f">
<A HREF="features.html">Features</A>
</TD></TR>
<TR><TD BGCOLOR="#caa08f">
<A HREF="download.html">Requirements, Download</A>
</TD></TR>
<TR><TD BGCOLOR="#caa08f">
<A HREF="install-start.html">Installation</A>
</TD></TR>
<TR><TD BGCOLOR="#caa08f">
<A HREF="lists.html">Discussion Lists</A>
</TD></TR>
<TR><TD BGCOLOR="#caa08f">
<A HREF="bugs.html">Bugs and Patches</A>
</TD></TR>
<TR><TD BGCOLOR="#caa08f">
<A HREF="faq.html">Frequently Asked Questions</A>
</TD></TR>
<TR><TD BGCOLOR="#caa08f">
<A HREF="inthenews.html">Mailman in Use</A>
</TD></TR>
<TR><TD BGCOLOR="#caa08f">
<A HREF="todo.html">Wishlist!</A>
</TD></TR>
<TR><TD BGCOLOR="#caa08f">
<TR><TD BGCOLOR="#545454"><B><FONT COLOR="#ffffff">
Installing Mailman
</FONT></B></TD></TR>
<TR><TD BGCOLOR="#caa08f">
<A HREF="install-start.html">Start installing</A>
</TD></TR>
<TR><TD BGCOLOR="#caa08f">
<A HREF="install-system.html">System setup</A>
</TD></TR>
<TR><TD BGCOLOR="#caa08f">
<A HREF="install-config.html">Running configure</A>
</TD></TR>
<TR><TD BGCOLOR="#caa08f">
<A HREF="install-check.html">Check your installation</A>
</TD></TR>
<TR><TD BGCOLOR="#caa08f">
<b>Final system setup</b>
</TD></TR>
<TR><TD BGCOLOR="#caa08f">
<A HREF="install-custom.html">Customize Mailman</A>
</TD></TR>
<TR><TD BGCOLOR="#caa08f">
<A HREF="install-test.html">Create a test list</A>
</TD></TR>
<TR><TD BGCOLOR="#caa08f">
<A HREF="install-trouble.html">Troubleshooting</A>
</TD></TR>
<TR><TD BGCOLOR="#caa08f">
<A HREF="install-faq.html">Common problems FAQ</A>
</TD></TR>
<TR><TD BGCOLOR="#caa08f">
<TR><TD BGCOLOR="#545454"><B><FONT COLOR="#ffffff">
Email Us
</FONT></B></TD></TR>
<TR><TD BGCOLOR="#caa08f">
<A HREF="mailto:mailman-users@python.org">mailman-users@python.org</A>
</TD></TR>
<TR><TD BGCOLOR="#caa08f">
</TD></TR>
<TR><TD BGCOLOR="#caa08f">
<a href="http://www.python.org/"><img border=0
src="./images/PythonPoweredSmall.png"
></a> <a href="http://sourceforge.net"><img
src="http://sourceforge.net/sflogo.php?group_id=103"
width="88" height="31" border="0"
alt="SourceForge Logo"></a>
</TD></TR>
<TR><TD BGCOLOR="#caa08f">
</TD></TR>
<TR><TD BGCOLOR="#caa08f">
© 1998,1999,2000,2001<br>Free Software Foundation, Inc.
</TD></TR>
</TABLE><!-- end of sidebar table -->
</TD>
<TD WIDTH=15> </TD><!--spacer-->
<!-- end of sidebar cell -->
<!-- start of body cell -->
<TD VALIGN=TOP WIDTH="90%"><BR>
<h3>Final system set-up</h3>
Congratulations! You've installed the Mailman software. To get
everything running you need to hook Mailman up to both your web
server and your mail system.
<ul><p><li>If there is a <tt>README.<em>yourMTA</em>></tt> file
that describes your mail
server (MTA), read it now. Some MTAs are more compatible with
Mailman such that you can do automatic creation and removal of
mailing lists, including through-the-web operations. Examples
are Exim and Postfix. Setup instructions for specific MTAs are
contained in these README files.
<p><li>If you plan on running your MTA and web server on different
machines, sharing Mailman installations via NFS, be sure that
the clocks on those two machines are synchronized closely.
You might take a look at the file
<code>Mailman/LockFile.py</code>; the constant
<code>CLOCK_SLOP</code> helps the locking mechanism compensate
for clock skew in this type of environment.
<p><li>Configure your web server to give <code>$prefix/cgi-bin</code>
permission to run CGI scripts. You probably need to be <b>root</b>
to do this.
<p>The line you should add might look something like one of
the following (with the real absolute directory substituted
for <code>$prefix</code>, of course), depending on your web
server:
<blockquote>
<pre>
ScriptAlias /mailman/ $prefix/cgi-bin/
Exec /mailman/* $prefix/cgi-bin/*
</pre>
</blockquote>
<p>Consult your web server's documentation for details.
<p><li><b>IMPORTANT:</b> You want to be very sure that the user id
under which your CGI scripts run is <b>not</b> in the
<code>mailman</code> group you created above, otherwise
private archives will be accessible to anyone.
<p><li>Copy the Mailman, Python, and GNU logos to a location accessible
to your web server. E.g. with Apache, you've usually got an
<code>icons</code> directory that you can drop the images
into. You want to copy
<code>$prefix/icons/mailman.jpg</code>,
<code>$prefix/icons/PythonPowered.png</code>, and
<code>$prefix/icons/gnu-head-tiny.jpg</code> to this
directory.
<p>You then want to add a line to your
<code>$prefix/Mailman/mm_cfg.py</code> file which sets the
base URL for the logos. For example:
<blockquote>
<pre>
IMAGE_LOGOS = '/images/'
</pre>
</blockquote>
<p>The default value for <code>IMAGE_LOGOS</code> is
<code>/icons/</code>. Read the
comment in <code>Defaults.py.in</code> for details.
<p><li>Configure your web server to point to the Pipermail public
mailing list archives:
For example, in Apache:
<blockquote>
<pre>
Alias /pipermail/ $varprefix/archives/public/
</pre>
</blockquote>
<p>where <code>$varprefix</code> is usually
<code>$prefix</code> unless you've used the
<code>--with-var-prefix</code> option to configure.
<p>Consult your web server's documentation for details. Also
be sure to configure your web server to follow symbolic links
in this directory, otherwise public Pipermail archives won't
be accessible. For Apache users, consult the
<em>FollowSymLinks</em> option.
<p>Now restart your web server.
<p><li>Set up the crontab entries. Mailman runs a number of cron jobs
for its basic functionality. In version of Mailman prior to
2.1alpha2, setting up your crontab was imperative to getting
Mailman to work. With MM2.1alpha2 though, the qrunner is
started from the <tt>bin/mailmanctl</tt> script (see below)
instead of cron. You still want to set up crontab to run the
ancillary scripts, but it isn't as crucial to getting Mailman
working as it once was. Note that if you're upgrading from a
previous version of Mailman, you'll want to install the new
crontab, but be careful if you're running multiple Mailman
installations on your site! Changing the crontab could mess
with other parallel Mailman installations.
<p>If your version of crontab supports the -u option, you must be
root to do this next step. Add $prefix/cron/crontab.in as a
crontab entry by executing these commands:
<blockquote>
<pre>
% cd $prefix/cron
% crontab -u mailman crontab.in
</pre>
</blockquote>
<p>If you used the <tt>--with-ownername</tt> option, use that
user name instead of mailman for the <tt>-u</tt> argument value.
If your crontab does not support the <tt>-u</tt> option, try these
commands:
<blockquote>
<pre>
% su - mailman
% cd $prefix/cron
% crontab crontab.in
</pre>
</blockquote>
<p><li>Start the Mailman qrunner daemon, by executing the following
from the <tt>$prefix</tt> directory:
<blockquote>
<pre>
% bin/mailmanctl start
</pre>
</blockquote>
You can use the mailmanctl script as a typical Unix init
script. <strong>BAW: add more here.</strong>
<p><li>Add aliases for <code>mailman</code> and
<code>mailman-owner</code> to the system's mail alias
database. These aliases should point to whoever is ultimately
responsible for the Mailman installation. Here are
instructions for those running Sendmail:
<ol>
<li>su to root.
<li>Assuming your email is <code>fred@flintstone.com</code>,
add the following lines to the file
<code>/etc/aliases</code>:
<blockquote>
<pre>
mailman: fred@flintstone.com
mailman-owner: mailman
</pre>
</blockquote>
<li>Some versions of sendmail require you to run the program
<code>newaliases</code> explicitly.
</ol>
<p>If you don't run sendmail, consult the documentation of
your mail transport program for information on adding these
aliases.
</ul>
</TD><!-- end of body cell -->
</TR><!-- end of sidebar/body row -->
</TABLE><!-- end of page table -->
</BODY></HTML>
|
