|  |  | 
 Site Administrator DocumentationBy 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 theMailman/mm_cfg.pyconfiguration file, and can run the
various and sundry command line scripts.Command line scriptsThis is a brief overview of the current crop of command line scripts
available to the site administrator in thebindirectory.
For more details, run the script with the--helpoption,
which will print out the usage synopsis.  You must run these
scripts from the bin directory in the Mailman installation location,
usually/home/mailman.
add_members
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.
arch
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.
check_db
Use this script to check the integrity of a list's
    config.dbandconfig.db.lastdatabase
    files.check_perms
Use this script to check, and optionally fix, the permissions of
    the various files in a Mailman installation.
clone_member
Use this script to clone 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.
config_list
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.
    Where this might be useful is if you wanted to change the
    web_page_urlattribute on every list.  You could
    create a file containing only the line 
and then feed this file back to
web_page_url = 'http://www.mynewsite.com/mailman-relocated/'
 config_listfor every
    list on your system.config_listonly sets the
    list variables that it finds in the input file.digest_arch
This script is deprecated.
dumpdb
This script dumps the plain text representation for any .dbdatabase file.  These files usually contain Python marshaled
    dictionaries, and can be found in theqfilesdirectory, thelists/listnamedirectory,
    etc.find_member
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.
list_lists
List all, or some subset of, the mailing lists in the system.
list_members
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.
mmsitepass
Use this script to set the site password, which can be used any
    where in the system a list or user password can be used.
    Essentially, the site password trumps any other password, so
    choose wisely!
move_list
Use this script when you move Mailman to a new installation location.
newlist
Use this script to create new mailing lists.
remove_members
Use this list to remove members from a mailing list.
rmlist
Use this script to remove a mailing list.  By default, a list's
    archives are not removed unless the --archivesoption
    is given.sync_members
Use this to synchronize mailing lists in a list's database with a
    plain text file of addresses, similar to what is used for
    add_members.  In a sense, this script combines the
    functionality ofadd_membersandremove_members.  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.Command line options let you send various notification emails,
    preview the changes, etc.
update
Don't use this script manually; it is used as part of the
    installation and upgrade procedures.
version
Prints the Mailman version number.
withlist
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:
Here you see that you're left at the Python prompt after the list
    has been loaded and instantiated.  Note that without the
% cd /home/mailman
% python -i bin/withlist mylist
Loading list: mylist (unlocked)
>>> 
 --lockoption, the list is not locked.  List must be
    locked if you plan to make modifications to any attributes (and
    they must be explicitly saved, aswithlistdoes not
    automatically save changes to list objects).At the prompt, the global object m 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.
     Have a look also at the --runoption, which lets
    you put your programmatic changes into a Python module (file) and
    run that module over any mailing list you want.  This makeswithlistessentially a framework for easily adding
    your own list-specific command line scripts. Cron scriptsMailman 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:
The
% cd /home/mailman
% python -S cron/senddigests
 -Soption is an optimization and (minor) security
recommendation; it inhibits Python's implicitimport siteon initialization.  Not all of these scripts support the--helpoption.  Here is a brief description of what the
cron scripts do:
bumpdigests
Bumps the digest volume numbers for the specified lists.
    Resets the issue number to 1.
checkdbs
Checks for ending list requests (posts and subscriptions) and
    mails the list manager if there are any.
gate_news
Polls the NNTP servers for messages and forwards any new messages
    to their mailing list gateways.
mailpasswds
Sends the password reminder emails to all users and all mailing lists.
nightly_gzip
Regenerates the Pipermail gzip'd flat archive files.qrunner
This is the primary cron script for processing messages in
    Mailman's queue directory qfiles.senddigests
Sends all accumulated digests.
 |