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
|
<HTML>
<!-- THIS PAGE IS AUTOMATICALLY GENERATED. DO NOT EDIT. -->
<!-- Wed Nov 8 13:38:28 2000 -->
<!-- USING HT2HTML 1.1 -->
<!-- SEE http://www.python.org/~bwarsaw/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="black">
<center>
<a href="./index.html">
<img border=0 src="./images/logo-70.jpg"></a></center> </TD>
<TD WIDTH=15 BGCOLOR="#99997c"> </TD><!--spacer-->
<!-- end of corner cells -->
<!-- start of banner -->
<TD WIDTH="90%" BGCOLOR="#99997c">
<!-- start of site links table -->
<TABLE WIDTH="100%" BORDER=0
CELLSPACING=0 CELLPADDING=0
COLS=3 ROWS=4 BGCOLOR="#ffffff">
<TR>
<TD BGCOLOR="#99997c">
<a href="./index.html">Home</a>
</TD>
<TD BGCOLOR="#99997c">
<a href="./users.html">Users</a>
</TD>
<TD BGCOLOR="#99997c">
<a href="http://www.list.org/">List.Org</a>
</TD>
</TR><TR>
<TD BGCOLOR="#99997c">
<a href="./install-start.html">Installation</a>
</TD>
<TD BGCOLOR="#99997c">
<a href="./mgrs.html">List Managers</a>
</TD>
<TD BGCOLOR="#99997c">
<a href="http://www.gnu.org/software/mailman/mailman.html">Mailman at GNU</a>
</TD>
</TR><TR>
<TD BGCOLOR="#99997c">
<a href="./faq.html">FAQ</a>
</TD>
<TD BGCOLOR="#99997c">
<a href="./admins.html">Site Administrators</a>
</TD>
<TD BGCOLOR="#99997c">
<a href="http://www.python.org/">Python.Org</a>
</TD>
</TR><TR>
<TD BGCOLOR="#99997c">
<a href="./lists.html">Discussion Lists</a>
</TD>
<TD BGCOLOR="#99997c">
<a href="./devs.html">Developers</a>
</TD>
<TD BGCOLOR="#99997c">
<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="#99997c">
<!-- start of sidebar table -->
<TABLE WIDTH="100%" BORDER=0 CELLSPACING=0 CELLPADDING=3
BGCOLOR="#ffffff">
<TR><TD BGCOLOR="#663300"><B><FONT COLOR="#ffffff">
Overview
</FONT></B></TD></TR>
<TR><TD BGCOLOR="#99997c">
<A HREF="index.html">Home</A>
</TD></TR>
<TR><TD BGCOLOR="#99997c">
<A HREF="features.html">Features</A>
</TD></TR>
<TR><TD BGCOLOR="#99997c">
<A HREF="download.html">Requirements, Download</A>
</TD></TR>
<TR><TD BGCOLOR="#99997c">
<A HREF="install-start.html">Installation</A>
</TD></TR>
<TR><TD BGCOLOR="#99997c">
<A HREF="lists.html">Discussion Lists</A>
</TD></TR>
<TR><TD BGCOLOR="#99997c">
<A HREF="bugs.html">Bugs and Patches</A>
</TD></TR>
<TR><TD BGCOLOR="#99997c">
<A HREF="faq.html">Frequently Asked Questions</A>
</TD></TR>
<TR><TD BGCOLOR="#99997c">
<A HREF="inthenews.html">Mailman in Use</A>
</TD></TR>
<TR><TD BGCOLOR="#99997c">
<A HREF="todo.html">Wishlist!</A>
</TD></TR>
<TR><TD BGCOLOR="#99997c">
<TR><TD BGCOLOR="#663300"><B><FONT COLOR="#ffffff">
Installing Mailman
</FONT></B></TD></TR>
<TR><TD BGCOLOR="#99997c">
<A HREF="install-start.html">Start installing</A>
</TD></TR>
<TR><TD BGCOLOR="#99997c">
<A HREF="install-system.html">System setup</A>
</TD></TR>
<TR><TD BGCOLOR="#99997c">
<A HREF="install-config.html">Running configure</A>
</TD></TR>
<TR><TD BGCOLOR="#99997c">
<A HREF="install-check.html">Check your installation</A>
</TD></TR>
<TR><TD BGCOLOR="#99997c">
<b>Final system setup</b>
</TD></TR>
<TR><TD BGCOLOR="#99997c">
<A HREF="install-custom.html">Customize Mailman</A>
</TD></TR>
<TR><TD BGCOLOR="#99997c">
<A HREF="install-test.html">Create a test list</A>
</TD></TR>
<TR><TD BGCOLOR="#99997c">
<A HREF="install-trouble.html">Troubleshooting</A>
</TD></TR>
<TR><TD BGCOLOR="#99997c">
<A HREF="install-faq.html">Common problems FAQ</A>
</TD></TR>
<TR><TD BGCOLOR="#99997c">
<TR><TD BGCOLOR="#663300"><B><FONT COLOR="#ffffff">
Email Us
</FONT></B></TD></TR>
<TR><TD BGCOLOR="#99997c">
<A HREF="mailto:mailman-cabal@python.org">mailman-cabal@python.org</A>
</TD></TR>
<TR><TD BGCOLOR="#99997c">
</TD></TR>
<TR><TD BGCOLOR="#99997c">
<A HREF="http://www.python.org/">
<center>
<img border=0 src="./images/PythonPoweredSmall.png"></center></A>
</TD></TR>
<TR><TD BGCOLOR="#99997c">
</TD></TR>
<TR><TD BGCOLOR="#99997c">
© 1998,1999,2000
</TD></TR>
<TR><TD BGCOLOR="#99997c">
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>
<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><b>IMPERATIVE! IMPORTANT! DO THIS! YOU'LL BE SORRY IF
YOU DON'T!</b>
<p>Set up the crontab entries. Mailman runs a number of cron
jobs for its basic functionality. You need to be user
<code>mailman</code> (or whatever you specified as
<code>--with-ownername</code>) to perform this step. Add
<code>$prefix/cron/crontab.in</code> as a crontab entry by
executing these commands:
<blockquote>
<pre>
% su - mailman
% cd $prefix/cron
% crontab crontab.in
</pre>
</blockquote>
<p><li>Look to see if there is special instructions about hooking your
MTA up to Mailman. If so, there will be a
README.<em>yourMTA</em> file in the Mailman source directory.
<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>
|
