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
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
|
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/html4/loose.dtd" >
<html>
<!-- THIS PAGE IS AUTOMATICALLY GENERATED. DO NOT EDIT. -->
<!-- Mon Jul 12 23:01:08 2004 -->
<!-- USING HT2HTML 2.0 -->
<!-- SEE http://ht2html.sf.net -->
<!-- User-specified headers:
Title: Site Administrator Documentation
-->
<head>
<title>Site Administrator Documentation</title>
<meta http-equiv="Content-Type" content="text/html; charset=us-ascii" />
<meta name="generator" content="HT2HTML/2.0" />
<style type="text/css">
body { margin: 0px; }
</style>
</head>
<body bgcolor="#ffffff" text="#000000"
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="middle" bgcolor="white" class="corner">
<center>
<a href="./index.html">
<img border=0 src="./images/logo-70.jpg"></a></center> </td>
<td width="15" bgcolor="#eecfa1"> </td><!--spacer-->
<!-- end of corner cells -->
<!-- start of banner -->
<td width="90%" bgcolor="#eecfa1" class="banner">
<!-- start of site links table -->
<table width="100%" border="0"
CELLSPACING=0 CELLPADDING=0
bgcolor="#ffffff">
<tr>
<td bgcolor="#eecfa1">
<a href="./index.html">Home</a>
</td>
<td bgcolor="#eecfa1">
<a href="./docs.html">Documentation</a>
</td>
<td bgcolor="#eecfa1">
<a href="./lists.html">Mailing lists</a>
</td>
</tr><tr>
<td bgcolor="#eecfa1">
<a href="./help.html">Help</a>
</td>
<td bgcolor="#eecfa1">
<a href="./download.html">Download</a>
</td>
<td bgcolor="#eecfa1">
<a href="./devs.html">Developers</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="#eecfa1" class="sidebar">
<!-- start of sidebar table -->
<table width="100%" border="0" cellspacing="0" cellpadding="3"
bgcolor="#ffffff">
<tr><td bgcolor="#36648b"><b><font color="#ffffff">
Overview
</font></b></td></tr>
<tr><td bgcolor="#eecfa1">
<a href="index.html">Home</a>
</td></tr>
<tr><td bgcolor="#eecfa1">
<a href="features.html">Features</a>
</td></tr>
<tr><td bgcolor="#eecfa1">
<a href="i18n.html">Internationalization</a>
</td></tr>
<tr><td bgcolor="#eecfa1">
<a href="otherstuff.html">Rants, Papers, and Logos</a>
</td></tr>
<tr><td bgcolor="#eecfa1">
<a href="inthenews.html">Mailman in Use</a>
</td></tr>
<tr><td bgcolor="#eecfa1">
<a href="prev.html">Previous Releases</a>
</td></tr>
<tr><td bgcolor="#eecfa1">
<a href="bugs.html">Bugs and Patches</a>
</td></tr>
<tr><td bgcolor="#eecfa1">
<a href="mirrors.html">Mirrors</a>
</td></tr>
<tr><td bgcolor="#eecfa1"> </td></tr>
<tr><td bgcolor="#36648b"><b><font color="#ffffff">
Documentation
</font></b></td></tr>
<tr><td bgcolor="#eecfa1">
<a href="docs.html">Overview</a>
</td></tr>
<tr><td bgcolor="#eecfa1">
<a href="users.html">Users</a>
</td></tr>
<tr><td bgcolor="#eecfa1">
<a href="admins.html">List Managers</a>
</td></tr>
<tr><td bgcolor="#eecfa1">
<b>Site Administrators</b>
</td></tr>
<tr><td bgcolor="#eecfa1">
<a href="i18n.html">Translators</a>
</td></tr>
<tr><td bgcolor="#eecfa1"> </td></tr>
<tr><td bgcolor="#36648b"><b><font color="#ffffff">
Exits
</font></b></td></tr>
<tr><td bgcolor="#eecfa1">
<a href="http://sf.net/projects/mailman">SF Project Page</a>
</td></tr>
<tr><td bgcolor="#eecfa1">
<a href="lists.html">Discussion Lists</a>
</td></tr>
<tr><td bgcolor="#eecfa1">
<a href="http://www.python.org/">Python</a>
</td></tr>
<tr><td bgcolor="#eecfa1">
<a href="http://www.gnu.org/">GNU</a>
</td></tr>
<tr><td bgcolor="#eecfa1">
<a href="http://barry.warsaw.us/">Barry Warsaw</a>
</td></tr>
<tr><td bgcolor="#eecfa1"> </td></tr>
<tr><td bgcolor="#36648b"><b><font color="#ffffff">
Email Us
</font></b></td></tr>
<tr><td bgcolor="#eecfa1">
<a href="mailto:mailman-users@python.org">mailman-users@python.org</a>
</td></tr>
<tr><td bgcolor="#eecfa1">
</td></tr>
<tr><td bgcolor="#eecfa1">
<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="#eecfa1">
</td></tr>
<tr><td bgcolor="#eecfa1">
© 1998-2004
Free Software Foundation, Inc. Verbatim copying and distribution of this
entire article is permitted in any medium, provided this notice is preserved.
</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%" class="body"><br />
<h3>Site Administrator Documentation</h3>
By definition, the site administrator has shell access to the Mailman
installation, and the proper permissions for total control over
Mailman at the site. The site admin can edit the
<code>Mailman/mm_cfg.py</code> configuration file, and can run the
various and sundry command line scripts.
<h3>Command line scripts</h3>
This is a brief overview of the current crop of command line scripts
available to the site administrator in the <code>bin</code> directory.
For more details, run the script with the <code>--help</code> option,
which will print out the usage synopsis. <em>You must run these
scripts from the bin directory in the Mailman installation location,
usually <code>/home/mailman</code></em>.
<dl>
<dt><b>add_members</b>
<dd>Use this script to mass add members to a mailing list. Input
files are plain text, with one address per line. Command line
options allow you to add the addresses as digest or regular
members, select whether various notification emails are sent, and
choose which list to add the members to.
<dt><b>arch</b>
<dd>Use this to rebuild a list's archive. This script can't be used
to modify a list's raw mbox file, but once you've edited the mbox
file some other way, you can use this script to regenerate the
HTML version of the on-line archive.
<dt><b>change_pw</b>
<dd>Use this to change the password for a specific mailing list.
<dt><b>check_db</b>
<dd>Use this script to check the integrity of a list's
<code>config.pck</code> and <code>config.pck.last</code> database
files.
<dt><b>check_perms</b>
<dd>Use this script to check, and optionally fix, the permissions of
the various files in a Mailman installation.
<dt><b>clone_member</b>
<dd>Use this script to <em>clone</em> an address on a particular list
into different address. This is useful when someone is changing
email addresses and wants to keep all their old configuration
options. Eventually members will be able to do their own cloning,
but for now, only the site administrator can do this. Command
line options let you remove the old address, clone addresses in
the list managers addresses, etc.
<dt><b>config_list</b>
<dd>This is a very powerful script which lets you view and modify a
list's configuration variables from the command line. E.g. you
can dump out all the list options into a plain text file (actually
a valid Python file!), complete with comments explaining each
variable. Or you can apply the configuration from such a file to
a particular list.
<p>Where this might be useful is if you wanted to change the
<code>web_page_url</code> attribute on every list. You could
create a file containing only the line
<blockquote>
<pre>
web_page_url = 'http://www.mynewsite.com/mailman-relocated/'
</pre>
</blockquote>
and then feed this file back to <code>config_list</code> for every
list on your system. <code>config_list</code> only sets the
list variables that it finds in the input file.
<dt><b>digest_arch</b>
<dd>This script is deprecated.
<dt><b>dumpdb</b>
<dd>This script dumps the plain text representation for any <code>.db</code>
database file. These files usually contain Python marshaled
dictionaries, and can be found in the <code>qfiles</code>
directory, the <code>lists/<em>listname</em></code> directory,
etc. This script can also be used to print out the contents of a
pickled message file, which are stored in <code>.pck</code> files.
<dt><b>find_member</b>
<dd>Use this script to search all the lists, or some subset of lists,
for an address matching a regular expression. command line
options let you also search the list managers as well.
<dt><b>genaliases</b>
<dd>Use this script to regenerate the plain text and <em>db</em> alias
files for Postfix (if you're using Postfix as your MTA).
<dt><b>list_admins</b>
<dd>List all the owners of a mailing list.
<dt><b>list_lists</b>
<dd>List all, or some subset of, the mailing lists in the system.
<dt><b>list_members</b>
<dd>List the members of a mailing list. Command line options let you
print just the regular or just the digest members, print the
case-preserved addresses of the members, etc.
<dt><b>mailmanctl</b>
<dd>The main qrunner control script. Use this to start, stop, and
restart the qrunner.
<dt><b>mmsitepass</b>
<dd>Use this script to set the site password, which can be used anywhere in
the system a list or user password can be used.
Essentially, the site password trumps any other password, so
choose wisely!
<dt><b>move_list</b>
<dd>Use this script when you move Mailman to a new installation location.
<dt><b>newlist</b>
<dd>Use this script to create new mailing lists.
<dt><b>qrunner</b>
<dd>Use this to run a single qrunner once (for debugging).
<dt><b>remove_members</b>
<dd>Use this list to remove members from a mailing list.
<dt><b>rmlist</b>
<dd>Use this script to remove a mailing list. By default, a list's
archives are not removed unless the <code>--archives</code> option
is given.
<dt><b>sync_members</b>
<dd>Use this to synchronize mailing lists in a list's database with a
plain text file of addresses, similar to what is used for
<code>add_members</code>. In a sense, this script combines the
functionality of <code>add_members</code> and
<code>remove_members</code>. Any addresses in the file that are
not present in the list roster are added, and any addresses in the
roster that are not present in the file are removed.
<p>Command line options let you send various notification emails,
preview the changes, etc.
<dt><b>update</b>
<dd>Don't use this script manually; it is used as part of the
installation and upgrade procedures.
<dt><b>version</b>
<dd>Prints the Mailman version number.
<dt><b>withlist</b>
<dd>This is the most powerful and flexible script in Mailman. With it
you can do all manner of programmatic changes to mailing lists, or
look at and interactively inspect almost any aspect of Mailman.
By default, you run this using Python's interactive prompt, like
so:
<blockquote>
<pre>
% cd /home/mailman
% python -i bin/withlist mylist
Loading list: mylist (unlocked)
>>>
</pre>
</blockquote>
Here you see that you're left at the Python prompt after the list
has been loaded and instantiated. Note that without the
<code>--lock</code> option, the list is not locked. List must be
locked if you plan to make modifications to any attributes (and
they must be explicitly saved, as <code>withlist</code> does not
automatically save changes to list objects).
<p>At the prompt, the global object <em>m</em> is the instantiated
list object. It's a Python instance so you can do all the normal
things to it, view or change attributes, or make method calls on
it.
<p>Have a look also at the <code>--run</code> option, which lets
you put your programmatic changes into a Python module (file) and
run that module over any mailing list you want. This makes
<code>withlist</code> essentially a framework for easily adding
your own list-specific command line scripts.
</dl>
<h3>Cron scripts</h3>
Mailman comes with a number of scripts that are typically only run by
cron. However, it is generally okay for the site administrator to run
these scripts manually, say to force a sending of accumulated digests,
or to mail out member passwords, etc. You generally run these by
invoking the Python executable on them, like so:
<blockquote>
<pre>
% cd /home/mailman
% python -S cron/senddigests
</pre>
</blockquote>
The <code>-S</code> option is an optimization and (minor) security
recommendation; it inhibits Python's implicit <code>import site</code>
on initialization. Not all of these scripts support the
<code>--help</code> option. Here is a brief description of what the
cron scripts do:
<dl>
<dt><b>bumpdigests</b>
<dd><em>Bumps</em> the digest volume numbers for the specified lists.
Resets the issue number to 1.
<dt><b>checkdbs</b>
<dd>Checks for ending list requests (posts and subscriptions) and
mails the list manager if there are any.
<dt><b>gate_news</b>
<dd>Polls the NNTP servers for messages and forwards any new messages
to their mailing list gateways.
<dt><b>mailpasswds</b>
<dd>Sends the password reminder emails to all users and all mailing lists.
<dt><b>nightly_gzip</b>
<dd>Regenerates the Pipermail <code>gzip</code>'d flat archive files.
<dt><b>senddigests</b>
<dd>Sends all accumulated digests.
</dl>
</td><!-- end of body cell -->
</tr><!-- end of sidebar/body row -->
</table><!-- end of page table -->
</body></html>
|
