Final system setup

Home | Users | List.Org
Installation | List Managers | Mailman at GNU
FAQ | Site Administrators | Python.Org
Discussion Lists | Developers | Gnu.Org
Overview
Home
Features
Requirements, Download
Installation
Discussion Lists
Bugs and Patches
Frequently Asked Questions
Mailman in Use
Wishlist!
Installing Mailman
Start installing
System setup
Running configure
Check your installation
Final system setup
Customize Mailman
Create a test list
Troubleshooting
Common problems FAQ
Email Us
mailman-users@python.org
© 1998,1999,2000,2001 Free Software Foundation, Inc.
- > |  | ### Final system set-up 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. 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 `Mailman/LockFile.py`; the constant `CLOCK_SLOP` helps the locking mechanism compensate for clock skew in this type of environment. Configure your web server to give `$prefix/cgi-bin` permission to run CGI scripts. You probably need to be root to do this. The line you should add might look something like one of the following (with the real absolute directory substituted for `$prefix`, of course), depending on your web server:
  >     ScriptAlias   /mailman/       $prefix/cgi-bin/
  >     Exec          /mailman/*      $prefix/cgi-bin/*
- > Consult your web server's documentation for details. IMPORTANT: You want to be very sure that the user id under which your CGI scripts run is not in the `mailman` group you created above, otherwise private archives will be accessible to anyone. Copy the Mailman, Python, and GNU logos to a location accessible to your web server. E.g. with Apache, you've usually got an `icons` directory that you can drop the images into. You want to copy `$prefix/icons/mailman.jpg`, `$prefix/icons/PythonPowered.png`, and `$prefix/icons/gnu-head-tiny.jpg` to this directory. You then want to add a line to your `$prefix/Mailman/mm_cfg.py` file which sets the base URL for the logos. For example:
  >     IMAGE_LOGOS = '/images/'
- > The default value for `IMAGE_LOGOS` is `/icons/`. Read the comment in `Defaults.py.in` for details. Configure your web server to point to the Pipermail public mailing list archives: For example, in Apache:
  >     Alias /pipermail/ $varprefix/archives/public/
- > where `$varprefix` is usually `$prefix` unless you've used the `--with-var-prefix` option to configure. 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 FollowSymLinks option. Now restart your web server. IMPERATIVE! IMPORTANT! DO THIS! YOU'LL BE SORRY IF YOU DON'T! Set up the crontab entries. Mailman runs a number of cron jobs for its basic functionality. You need to be user `mailman` (or whatever you specified as `--with-ownername`) to perform this step. Add `$prefix/cron/crontab.in` as a crontab entry by executing these commands:
  >     % su - mailman
  >     % cd $prefix/cron
  >     % crontab crontab.in
- 2. > Look to see if there is special instructions about hooking your MTA up to Mailman. If so, there will be a README.yourMTA file in the Mailman source directory. Add aliases for `mailman` and `mailman-owner` 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: su to root. Assuming your email is `fred@flintstone.com`, add the following lines to the file `/etc/aliases`:
     >     mailman: fred@flintstone.com
     >     mailman-owner: mailman
Some versions of sendmail require you to run the program `newaliases` explicitly. If you don't run sendmail, consult the documentation of your mail transport program for information on adding these aliases.