diff options
Diffstat (limited to 'admin/www/mailman-install')
60 files changed, 7353 insertions, 0 deletions
diff --git a/admin/www/mailman-install/about.html b/admin/www/mailman-install/about.html new file mode 100644 index 00000000..2d88ea62 --- /dev/null +++ b/admin/www/mailman-install/about.html @@ -0,0 +1,108 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> +<html> +<head> +<link rel="STYLESHEET" href="mailman-install.css" type='text/css' /> +<link rel="first" href="mailman-install.html" title='GNU Mailman - Installation Manual' /> +<link rel='last' href='about.html' title='About this document...' /> +<link rel='help' href='about.html' title='About this document...' /> +<link rel="prev" href="front.html" /> +<link rel="parent" href="mailman-install.html" /> +<meta name='aesop' content='information' /> +<title>About this document ...</title> +</head> +<body> +<DIV CLASS="navigation"> +<div id='top-navigation-panel' xml:id='top-navigation-panel'> +<table align="center" width="100%" cellpadding="0" cellspacing="2"> +<tr> +<td class='online-navigation'><a rel="prev" title="14.3 MacOSX issues" + href="node49.html"><img src='previous.png' + border='0' height='32' alt='Previous Page' width='32' /></A></td> +<td class='online-navigation'><a rel="parent" title="GNU Mailman - Installation" + href="mailman-install.html"><img src='up.png' + border='0' height='32' alt='Up One Level' width='32' /></A></td> +<td class='online-navigation'><img src='next.png' + border='0' height='32' alt='Next Page' width='32' /></td> +<td align="center" width="100%">GNU Mailman - Installation Manual</td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +</tr></table> +<div class='online-navigation'> +<b class="navlabel">Previous:</b> +<a class="sectref" rel="prev" href="node49.html">14.3 MacOSX issues</A> +<b class="navlabel">Up:</b> +<a class="sectref" rel="parent" href="mailman-install.html">GNU Mailman - Installation</A> +</div> +<hr /></div> +</DIV> +<!--End of Navigation Panel--> + +<H1><A NAME="SECTION002000000000000000000"> +About this document ...</A> +</H1> + <strong>GNU Mailman - Installation Manual</strong>, +December 13, 2004, Release 2.1 +<p> This document was generated using the <a + href="http://saftsack.fs.uni-bayreuth.de/~latex2ht/"> + <strong>LaTeX</strong>2<tt>HTML</tt></a> translator. +</p> + +<p> <a + href="http://saftsack.fs.uni-bayreuth.de/~latex2ht/"> + <strong>LaTeX</strong>2<tt>HTML</tt></a> is Copyright © + 1993, 1994, 1995, 1996, 1997, <a + href="http://cbl.leeds.ac.uk/nikos/personal.html">Nikos + Drakos</a>, Computer Based Learning Unit, University of + Leeds, and Copyright © 1997, 1998, <a + href="http://www.maths.mq.edu.au/~ross/">Ross + Moore</a>, Mathematics Department, Macquarie University, + Sydney. +</p> + +<p> The application of <a + href="http://saftsack.fs.uni-bayreuth.de/~latex2ht/"> + <strong>LaTeX</strong>2<tt>HTML</tt></a> to the Python + documentation has been heavily tailored by Fred L. Drake, + Jr. Original navigation icons were contributed by Christopher + Petrilli. +</p> + +<DIV CLASS="navigation"> +<div class='online-navigation'> +<p></p><hr /> +<table align="center" width="100%" cellpadding="0" cellspacing="2"> +<tr> +<td class='online-navigation'><a rel="prev" title="14.3 MacOSX issues" + href="node49.html"><img src='previous.png' + border='0' height='32' alt='Previous Page' width='32' /></A></td> +<td class='online-navigation'><a rel="parent" title="GNU Mailman - Installation" + href="mailman-install.html"><img src='up.png' + border='0' height='32' alt='Up One Level' width='32' /></A></td> +<td class='online-navigation'><img src='next.png' + border='0' height='32' alt='Next Page' width='32' /></td> +<td align="center" width="100%">GNU Mailman - Installation Manual</td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +</tr></table> +<div class='online-navigation'> +<b class="navlabel">Previous:</b> +<a class="sectref" rel="prev" href="node49.html">14.3 MacOSX issues</A> +<b class="navlabel">Up:</b> +<a class="sectref" rel="parent" href="mailman-install.html">GNU Mailman - Installation</A> +</div> +</div> +<hr /> +<span class="release-info">Release 2.1, documentation updated on December 13, 2004.</span> +</DIV> +<!--End of Navigation Panel--> + +</BODY> +</HTML> diff --git a/admin/www/mailman-install/blank.png b/admin/www/mailman-install/blank.png Binary files differnew file mode 100644 index 00000000..2af5639b --- /dev/null +++ b/admin/www/mailman-install/blank.png diff --git a/admin/www/mailman-install/bsd-issues.html b/admin/www/mailman-install/bsd-issues.html new file mode 100644 index 00000000..88b899d3 --- /dev/null +++ b/admin/www/mailman-install/bsd-issues.html @@ -0,0 +1,113 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> +<html> +<head> +<link rel="STYLESHEET" href="mailman-install.css" type='text/css' /> +<link rel="first" href="mailman-install.html" title='GNU Mailman - Installation Manual' /> +<link rel='last' href='about.html' title='About this document...' /> +<link rel='help' href='about.html' title='About this document...' /> +<link rel="next" href="node49.html" /> +<link rel="prev" href="node47.html" /> +<link rel="parent" href="node46.html" /> +<link rel="next" href="node49.html" /> +<meta name='aesop' content='information' /> +<title>14.2 BSD issues</title> +</head> +<body> +<DIV CLASS="navigation"> +<div id='top-navigation-panel' xml:id='top-navigation-panel'> +<table align="center" width="100%" cellpadding="0" cellspacing="2"> +<tr> +<td class='online-navigation'><a rel="prev" title="14.1 GNU/Linux issues" + href="node47.html"><img src='previous.png' + border='0' height='32' alt='Previous Page' width='32' /></A></td> +<td class='online-navigation'><a rel="parent" title="14 Platform and operating" + href="node46.html"><img src='up.png' + border='0' height='32' alt='Up One Level' width='32' /></A></td> +<td class='online-navigation'><a rel="next" title="14.3 MacOSX issues" + href="node49.html"><img src='next.png' + border='0' height='32' alt='Next Page' width='32' /></A></td> +<td align="center" width="100%">GNU Mailman - Installation Manual</td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +</tr></table> +<div class='online-navigation'> +<b class="navlabel">Previous:</b> +<a class="sectref" rel="prev" href="node47.html">14.1 GNU/Linux issues</A> +<b class="navlabel">Up:</b> +<a class="sectref" rel="parent" href="node46.html">14 Platform and operating</A> +<b class="navlabel">Next:</b> +<a class="sectref" rel="next" href="node49.html">14.3 MacOSX issues</A> +</div> +<hr /></div> +</DIV> +<!--End of Navigation Panel--> + +<H2><A NAME="SECTION0011420000000000000000"></A><A NAME="bsd-issues"></A> +<BR> +14.2 BSD issues +</H2> + +<P> +Vivek Khera writes that some BSDs do nightly security scans for setuid file +changes. setgid directories also come up on the scan when they change. Also, +the setgid bit is not necessary on BSD systems because group ownership is +automatically inherited on files created in directories. On other <span class="Unix">Unix</span>es, +this only happens when the directory has the setgid bit turned on. + +<P> +To install without turning on the setgid bit on directories, simply pass in +the <var>DIRSETGID</var> variable to <b class="program">make</b>, after you've run +<b class="program">configure</b>: + +<P> +<div class="verbatim"><pre> + % make DIRSETGID=: install +</pre></div> + +<P> +This disables the <b class="program">chmod g+s</b> command on installed directories. + +<P> + +<DIV CLASS="navigation"> +<div class='online-navigation'> +<p></p><hr /> +<table align="center" width="100%" cellpadding="0" cellspacing="2"> +<tr> +<td class='online-navigation'><a rel="prev" title="14.1 GNU/Linux issues" + href="node47.html"><img src='previous.png' + border='0' height='32' alt='Previous Page' width='32' /></A></td> +<td class='online-navigation'><a rel="parent" title="14 Platform and operating" + href="node46.html"><img src='up.png' + border='0' height='32' alt='Up One Level' width='32' /></A></td> +<td class='online-navigation'><a rel="next" title="14.3 MacOSX issues" + href="node49.html"><img src='next.png' + border='0' height='32' alt='Next Page' width='32' /></A></td> +<td align="center" width="100%">GNU Mailman - Installation Manual</td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +</tr></table> +<div class='online-navigation'> +<b class="navlabel">Previous:</b> +<a class="sectref" rel="prev" href="node47.html">14.1 GNU/Linux issues</A> +<b class="navlabel">Up:</b> +<a class="sectref" rel="parent" href="node46.html">14 Platform and operating</A> +<b class="navlabel">Next:</b> +<a class="sectref" rel="next" href="node49.html">14.3 MacOSX issues</A> +</div> +</div> +<hr /> +<span class="release-info">Release 2.1, documentation updated on December 13, 2004.</span> +</DIV> +<!--End of Navigation Panel--> + +</BODY> +</HTML> diff --git a/admin/www/mailman-install/contents.png b/admin/www/mailman-install/contents.png Binary files differnew file mode 100644 index 00000000..3429be0c --- /dev/null +++ b/admin/www/mailman-install/contents.png diff --git a/admin/www/mailman-install/create-install-dir.html b/admin/www/mailman-install/create-install-dir.html new file mode 100644 index 00000000..026042db --- /dev/null +++ b/admin/www/mailman-install/create-install-dir.html @@ -0,0 +1,148 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> +<html> +<head> +<link rel="STYLESHEET" href="mailman-install.css" type='text/css' /> +<link rel="first" href="mailman-install.html" title='GNU Mailman - Installation Manual' /> +<link rel='last' href='about.html' title='About this document...' /> +<link rel='help' href='about.html' title='About this document...' /> +<link rel="prev" href="node4.html" /> +<link rel="parent" href="node3.html" /> +<link rel="next" href="node6.html" /> +<meta name='aesop' content='information' /> +<title>2.2 Create the installation directory</title> +</head> +<body> +<DIV CLASS="navigation"> +<div id='top-navigation-panel' xml:id='top-navigation-panel'> +<table align="center" width="100%" cellpadding="0" cellspacing="2"> +<tr> +<td class='online-navigation'><a rel="prev" title="2.1 Add the group" + href="node4.html"><img src='previous.png' + border='0' height='32' alt='Previous Page' width='32' /></A></td> +<td class='online-navigation'><a rel="parent" title="2 Set up your" + href="node3.html"><img src='up.png' + border='0' height='32' alt='Up One Level' width='32' /></A></td> +<td class='online-navigation'><a rel="next" title="3 Build and install" + href="node6.html"><img src='next.png' + border='0' height='32' alt='Next Page' width='32' /></A></td> +<td align="center" width="100%">GNU Mailman - Installation Manual</td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +</tr></table> +<div class='online-navigation'> +<b class="navlabel">Previous:</b> +<a class="sectref" rel="prev" href="node4.html">2.1 Add the group</A> +<b class="navlabel">Up:</b> +<a class="sectref" rel="parent" href="node3.html">2 Set up your</A> +<b class="navlabel">Next:</b> +<a class="sectref" rel="next" href="node6.html">3 Build and install</A> +</div> +<hr /></div> +</DIV> +<!--End of Navigation Panel--> + +<H2><A NAME="SECTION001220000000000000000"></A><A NAME="create-install-dir"></A> +<BR> +2.2 Create the installation directory +</H2> +Typically, Mailman is installed into a single directory, which includes both +the Mailman source code and the run-time list and archive data. It is +possible to split the static program files from the variable data files and +install them in separate directories. This section will describe the +available options. + +<P> +The default is to install all of Mailman to +<span class="file">/usr/local/mailman</span><A NAME="tex2html2" + HREF="#foot676"><SUP>2</SUP></A>. You can change this base installation directory (referred to here +as <var>$prefix</var>) by specifying the directory with the +<b class="programopt">--prefix</b> <b class="program">configure</b> option. If you're upgrading from +a previous version of Mailman, you may want to use the <b class="programopt">--prefix</b> +option unless you move your mailing lists. + +<P> +<div class="warning"><b class="label">Warning:</b> + +You cannot install Mailman on a filesystem that is mounted with the +<code>nosuid</code> option. This will break Mailman, which relies on setgid +programs for its security. If this describes your environment, simply install +Mailman in a location that allows setgid programs. +</div> + +<P> +Make sure the installation directory is set to group <code>mailman</code> (or +whatever you're going to specify with <b class="programopt">--with-groupname</b>) and has +the setgid bit set<A NAME="tex2html3" + HREF="#foot677"><SUP>3</SUP></A>. You probably also want to guarantee that this +directory is readable and executable by everyone. For example, these shell +commands will accomplish this: + +<P> +<div class="verbatim"><pre> + % cd $prefix + % chgrp mailman . + % chmod a+rx,g+ws . +</pre></div> + +<P> +You are now ready to configure and install the Mailman software. + +<P> +<BR><HR><H4>Footnotes</H4> +<DL> +<DT><A NAME="foot676">.../usr/local/mailman</A><A + href="create-install-dir.html#tex2html2"><SUP>2</SUP></A></DT> +<DD>This is the default for Mailman 2.1. +Earlier versions of Mailman installed everything under <span class="file">/home/mailman</span> by +default. + +</DD> +<DT><A NAME="foot677">... set</A><A + href="create-install-dir.html#tex2html3"><SUP>3</SUP></A></DT> +<DD>BSD users should see the <A href="bsd-issues.html#bsd-issues">14.2</A> section +for additional information. + +</DD> +</DL> +<DIV CLASS="navigation"> +<div class='online-navigation'> +<p></p><hr /> +<table align="center" width="100%" cellpadding="0" cellspacing="2"> +<tr> +<td class='online-navigation'><a rel="prev" title="2.1 Add the group" + href="node4.html"><img src='previous.png' + border='0' height='32' alt='Previous Page' width='32' /></A></td> +<td class='online-navigation'><a rel="parent" title="2 Set up your" + href="node3.html"><img src='up.png' + border='0' height='32' alt='Up One Level' width='32' /></A></td> +<td class='online-navigation'><a rel="next" title="3 Build and install" + href="node6.html"><img src='next.png' + border='0' height='32' alt='Next Page' width='32' /></A></td> +<td align="center" width="100%">GNU Mailman - Installation Manual</td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +</tr></table> +<div class='online-navigation'> +<b class="navlabel">Previous:</b> +<a class="sectref" rel="prev" href="node4.html">2.1 Add the group</A> +<b class="navlabel">Up:</b> +<a class="sectref" rel="parent" href="node3.html">2 Set up your</A> +<b class="navlabel">Next:</b> +<a class="sectref" rel="next" href="node6.html">3 Build and install</A> +</div> +</div> +<hr /> +<span class="release-info">Release 2.1, documentation updated on December 13, 2004.</span> +</DIV> +<!--End of Navigation Panel--> + +</BODY> +</HTML> diff --git a/admin/www/mailman-install/customizing.html b/admin/www/mailman-install/customizing.html new file mode 100644 index 00000000..a8a39d79 --- /dev/null +++ b/admin/www/mailman-install/customizing.html @@ -0,0 +1,145 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> +<html> +<head> +<link rel="STYLESHEET" href="mailman-install.css" type='text/css' /> +<link rel="first" href="mailman-install.html" title='GNU Mailman - Installation Manual' /> +<link rel='last' href='about.html' title='About this document...' /> +<link rel='help' href='about.html' title='About this document...' /> +<link rel="next" href="node44.html" /> +<link rel="prev" href="node42.html" /> +<link rel="parent" href="front.html" /> +<link rel="next" href="node44.html" /> +<meta name='aesop' content='information' /> +<title>11 Customize Mailman</title> +</head> +<body> +<DIV CLASS="navigation"> +<div id='top-navigation-panel' xml:id='top-navigation-panel'> +<table align="center" width="100%" cellpadding="0" cellspacing="2"> +<tr> +<td class='online-navigation'><a rel="prev" title="10 Check the hostname" + href="node42.html"><img src='previous.png' + border='0' height='32' alt='Previous Page' width='32' /></A></td> +<td class='online-navigation'><a rel="parent" title="Front Matter" + href="front.html"><img src='up.png' + border='0' height='32' alt='Up One Level' width='32' /></A></td> +<td class='online-navigation'><a rel="next" title="12 Create your first" + href="node44.html"><img src='next.png' + border='0' height='32' alt='Next Page' width='32' /></A></td> +<td align="center" width="100%">GNU Mailman - Installation Manual</td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +</tr></table> +<div class='online-navigation'> +<b class="navlabel">Previous:</b> +<a class="sectref" rel="prev" href="node42.html">10 Check the hostname</A> +<b class="navlabel">Up:</b> +<a class="sectref" rel="parent" href="front.html">Front Matter</A> +<b class="navlabel">Next:</b> +<a class="sectref" rel="next" href="node44.html">12 Create your first</A> +</div> +<hr /></div> +</DIV> +<!--End of Navigation Panel--> + +<H1><A NAME="SECTION0011100000000000000000"></A><A NAME="customizing"></A> +<BR> +11 Customize Mailman +</H1> + +<P> +Now that Mailman is all set up, there are a few site-wide configurations you +can make before you start creating mailing lists. You should do these steps +using the account you installed Mailman under in the <A href="troubleshooting.html#building">13</A> section. + +<P> + +<UL> +<LI>The file <span class="file"><var>$prefix/Mailman/Defaults.py</var></span> contains a number of + defaults for your installation. If any of these are incorrect, override + them in <span class="file"><var>$prefix</var>/Mailman/mm_cfg.py</span>, <strong>not</strong> in the + <span class="file">Defaults.py</span> file! See the comments in <span class="file">Defaults.py</span> for + details. Once a list is created, editing many of these variables will + have no effect. At that point, you'll need to configure your lists + through the web administration interface or through the command line + scripts <b class="program">bin/withlist</b> and <b class="program">bin/config_list</b>. + +<P> +The install process will never overwrite an existing <span class="file">mm_cfg.py</span> + file so you can freely make changes to this file. + +<P> +<div class="note"><b class="label">Note:</b> + + Do <strong>not</strong> change the <var>HOME_DIR</var> or <var>MAILMAN_DIR</var> + variables. These are set automatically by the <b class="program">configure</b> + script, and you will break your Mailman installation by if you change + these. + </div> +</LI> +<LI>Create the site password. Use this command: + +<P> +<div class="verbatim"><pre> + % $prefix/bin/mmsitepass <your-site-password> +</pre></div> + +<P> +This password can be used anywhere that individual user or mailing list + administrator passwords are required, giving the mailman site + administrator the ability to adjust these things when necessary. + +<P> +You may also want to create a password for the site-wide ``list creator'' + role. The list creator is someone other than the site administrator who + has privileges to create and remove lists through the web interface. Use + the <b class="programopt">-c</b> option to <b class="program">mmsitepass</b> to set this. + +<P> +</LI> +</UL> + +<P> + +<DIV CLASS="navigation"> +<div class='online-navigation'> +<p></p><hr /> +<table align="center" width="100%" cellpadding="0" cellspacing="2"> +<tr> +<td class='online-navigation'><a rel="prev" title="10 Check the hostname" + href="node42.html"><img src='previous.png' + border='0' height='32' alt='Previous Page' width='32' /></A></td> +<td class='online-navigation'><a rel="parent" title="Front Matter" + href="front.html"><img src='up.png' + border='0' height='32' alt='Up One Level' width='32' /></A></td> +<td class='online-navigation'><a rel="next" title="12 Create your first" + href="node44.html"><img src='next.png' + border='0' height='32' alt='Next Page' width='32' /></A></td> +<td align="center" width="100%">GNU Mailman - Installation Manual</td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +</tr></table> +<div class='online-navigation'> +<b class="navlabel">Previous:</b> +<a class="sectref" rel="prev" href="node42.html">10 Check the hostname</A> +<b class="navlabel">Up:</b> +<a class="sectref" rel="parent" href="front.html">Front Matter</A> +<b class="navlabel">Next:</b> +<a class="sectref" rel="next" href="node44.html">12 Create your first</A> +</div> +</div> +<hr /> +<span class="release-info">Release 2.1, documentation updated on December 13, 2004.</span> +</DIV> +<!--End of Navigation Panel--> + +</BODY> +</HTML> diff --git a/admin/www/mailman-install/exim3-transport.html b/admin/www/mailman-install/exim3-transport.html new file mode 100644 index 00000000..2fcb6606 --- /dev/null +++ b/admin/www/mailman-install/exim3-transport.html @@ -0,0 +1,112 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> +<html> +<head> +<link rel="STYLESHEET" href="mailman-install.css" type='text/css' /> +<link rel="first" href="mailman-install.html" title='GNU Mailman - Installation Manual' /> +<link rel='last' href='about.html' title='About this document...' /> +<link rel='help' href='about.html' title='About this document...' /> +<link rel="next" href="node20.html" /> +<link rel="prev" href="node18.html" /> +<link rel="parent" href="node16.html" /> +<link rel="next" href="node20.html" /> +<meta name='aesop' content='information' /> +<title>6.2.3 Transport for Exim 3</title> +</head> +<body> +<DIV CLASS="navigation"> +<div id='top-navigation-panel' xml:id='top-navigation-panel'> +<table align="center" width="100%" cellpadding="0" cellspacing="2"> +<tr> +<td class='online-navigation'><a rel="prev" title="6.2.2 Main configuration settings" + href="node18.html"><img src='previous.png' + border='0' height='32' alt='Previous Page' width='32' /></A></td> +<td class='online-navigation'><a rel="parent" title="6.2 Using the Exim" + href="node16.html"><img src='up.png' + border='0' height='32' alt='Up One Level' width='32' /></A></td> +<td class='online-navigation'><a rel="next" title="6.2.4 Director for Exim" + href="node20.html"><img src='next.png' + border='0' height='32' alt='Next Page' width='32' /></A></td> +<td align="center" width="100%">GNU Mailman - Installation Manual</td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +</tr></table> +<div class='online-navigation'> +<b class="navlabel">Previous:</b> +<a class="sectref" rel="prev" href="node18.html">6.2.2 Main configuration settings</A> +<b class="navlabel">Up:</b> +<a class="sectref" rel="parent" href="node16.html">6.2 Using the Exim</A> +<b class="navlabel">Next:</b> +<a class="sectref" rel="next" href="node20.html">6.2.4 Director for Exim</A> +</div> +<hr /></div> +</DIV> +<!--End of Navigation Panel--> + +<H3><A NAME="SECTION001623000000000000000"></A><A NAME="exim3-transport"></A> +<BR> +6.2.3 Transport for Exim 3 +</H3> + +<P> +Add this to the transports section of your Exim config file, +i.e. somewhere between the first and second ``end'' line: + +<P> +<div class="verbatim"><pre> + mailman_transport: + driver = pipe + command = MAILMAN_WRAP \ + '${if def:local_part_suffix \ + {${sg{$local_part_suffix}{-(\\w+)(\\+.*)?}{\$1}}} \ + {post}}' \ + $local_part + current_directory = MAILMAN_HOME + home_directory = MAILMAN_HOME + user = MAILMAN_USER + group = MAILMAN_GROUP +</pre></div> + +<P> + +<DIV CLASS="navigation"> +<div class='online-navigation'> +<p></p><hr /> +<table align="center" width="100%" cellpadding="0" cellspacing="2"> +<tr> +<td class='online-navigation'><a rel="prev" title="6.2.2 Main configuration settings" + href="node18.html"><img src='previous.png' + border='0' height='32' alt='Previous Page' width='32' /></A></td> +<td class='online-navigation'><a rel="parent" title="6.2 Using the Exim" + href="node16.html"><img src='up.png' + border='0' height='32' alt='Up One Level' width='32' /></A></td> +<td class='online-navigation'><a rel="next" title="6.2.4 Director for Exim" + href="node20.html"><img src='next.png' + border='0' height='32' alt='Next Page' width='32' /></A></td> +<td align="center" width="100%">GNU Mailman - Installation Manual</td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +</tr></table> +<div class='online-navigation'> +<b class="navlabel">Previous:</b> +<a class="sectref" rel="prev" href="node18.html">6.2.2 Main configuration settings</A> +<b class="navlabel">Up:</b> +<a class="sectref" rel="parent" href="node16.html">6.2 Using the Exim</A> +<b class="navlabel">Next:</b> +<a class="sectref" rel="next" href="node20.html">6.2.4 Director for Exim</A> +</div> +</div> +<hr /> +<span class="release-info">Release 2.1, documentation updated on December 13, 2004.</span> +</DIV> +<!--End of Navigation Panel--> + +</BODY> +</HTML> diff --git a/admin/www/mailman-install/front.html b/admin/www/mailman-install/front.html new file mode 100644 index 00000000..d3aeb5f4 --- /dev/null +++ b/admin/www/mailman-install/front.html @@ -0,0 +1,180 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> +<html> +<head> +<link rel="STYLESHEET" href="mailman-install.css" type='text/css' /> +<link rel="first" href="mailman-install.html" title='GNU Mailman - Installation Manual' /> +<link rel='last' href='about.html' title='About this document...' /> +<link rel='help' href='about.html' title='About this document...' /> +<link rel="next" href="about.html" /> +<link rel="prev" href="mailman-install.html" /> +<link rel="parent" href="mailman-install.html" /> +<link rel="next" href="node2.html" /> +<meta name='aesop' content='information' /> +<title>Front Matter</title> +</head> +<body> +<DIV CLASS="navigation"> +<div id='top-navigation-panel' xml:id='top-navigation-panel'> +<table align="center" width="100%" cellpadding="0" cellspacing="2"> +<tr> +<td class='online-navigation'><a rel="prev" title="GNU Mailman - Installation" + href="mailman-install.html"><img src='previous.png' + border='0' height='32' alt='Previous Page' width='32' /></A></td> +<td class='online-navigation'><a rel="parent" title="GNU Mailman - Installation" + href="mailman-install.html"><img src='up.png' + border='0' height='32' alt='Up One Level' width='32' /></A></td> +<td class='online-navigation'><a rel="next" title="1 Installation Requirements" + href="node2.html"><img src='next.png' + border='0' height='32' alt='Next Page' width='32' /></A></td> +<td align="center" width="100%">GNU Mailman - Installation Manual</td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +</tr></table> +<div class='online-navigation'> +<b class="navlabel">Previous:</b> +<a class="sectref" rel="prev" href="mailman-install.html">GNU Mailman - Installation</A> +<b class="navlabel">Up:</b> +<a class="sectref" rel="parent" href="mailman-install.html">GNU Mailman - Installation</A> +<b class="navlabel">Next:</b> +<a class="sectref" rel="next" href="node2.html">1 Installation Requirements</A> +</div> +<hr /></div> +</DIV> +<!--End of Navigation Panel--> + +<H1><A NAME="SECTION001000000000000000000"></A><A NAME="front"></A> +<BR> +Front Matter +</H1> + +<P> + +<H3>Abstract:</H3> +<DIV CLASS="ABSTRACT"> + +This document describes how to install GNU Mailman on a POSIX-based system +such as <span class="Unix">Unix</span>, MacOSX, or GNU/Linux. It will cover basic installation +instructions, as well as guidelines for integrating Mailman with your web and +mail servers. + +<P> +The GNU Mailman website is at <a class="url" href="http://www.list.org">http://www.list.org</a></DIV> +<P> + +<P> + +<p><br /></p><hr class='online-navigation' /> +<div class='online-navigation'> +<!--Table of Child-Links--> +<A NAME="CHILD_LINKS"><STRONG>Subsections</STRONG></a> + +<UL CLASS="ChildLinks"> +<LI><A href="node2.html">1 Installation Requirements</a> +<LI><A href="node3.html">2 Set up your system</a> +<UL> +<LI><A href="node4.html">2.1 Add the group and user</a> +<LI><A href="create-install-dir.html">2.2 Create the installation directory</a> +</ul> +<LI><A href="node6.html">3 Build and install Mailman</a> +<UL> +<LI><A href="node7.html">3.1 Run <b class="program">configure</b></a> +<LI><A href="node8.html">3.2 Make and install</a> +</ul> +<LI><A href="node9.html">4 Check your installation</a> +<LI><A href="node10.html">5 Set up your web server</a> +<LI><A href="mail-server.html">6 Set up your mail server</a> +<UL> +<LI><A href="node12.html">6.1 Using the Postfix mail server</a> +<UL> +<LI><A href="node13.html">6.1.1 Integrating Postfix and Mailman</a> +<LI><A href="postfix-virtual.html">6.1.2 Virtual domains</a> +<LI><A href="node15.html">6.1.3 An alternative approach</a> +</ul> +<LI><A href="node16.html">6.2 Using the Exim mail server</a> +<UL> +<LI><A href="node17.html">6.2.1 Exim configuration</a> +<LI><A href="node18.html">6.2.2 Main configuration settings</a> +<LI><A href="exim3-transport.html">6.2.3 Transport for Exim 3</a> +<LI><A href="node20.html">6.2.4 Director for Exim 3</a> +<LI><A href="node21.html">6.2.5 Router for Exim 4</a> +<LI><A href="node22.html">6.2.6 Transports for Exim 4</a> +<LI><A href="node23.html">6.2.7 Additional notes</a> +<LI><A href="node24.html">6.2.8 Problems</a> +<LI><A href="node25.html">6.2.9 Receiver Verification</a> +<LI><A href="node26.html">6.2.10 SMTP Callback</a> +<LI><A href="node27.html">6.2.11 Doing VERP with Exim and Mailman</a> +<LI><A href="node28.html">6.2.12 Virtual Domains</a> +<LI><A href="node29.html">6.2.13 List Verification</a> +<LI><A href="node30.html">6.2.14 Document History</a> +</ul> +<LI><A href="node31.html">6.3 Using the Sendmail mail server</a> +<UL> +<LI><A href="node32.html">6.3.1 Sendmail ``smrsh'' compatibility</a> +<LI><A href="node33.html">6.3.2 Integrating Sendmail and Mailman</a> +<LI><A href="node34.html">6.3.3 Performance notes</a> +</ul> +<LI><A href="qmail-issues.html">6.4 Using the Qmail mail server</a> +<UL> +<LI><A href="node36.html">6.4.1 Information on VERP</a> +<LI><A href="node37.html">6.4.2 Virtual mail server</a> +<LI><A href="node38.html">6.4.3 More information</a> +</ul> +</ul> +<LI><A href="node39.html">7 Create a site-wide mailing list</a> +<LI><A href="node40.html">8 Set up cron</a> +<LI><A href="node41.html">9 Start the Mailman qrunner</a> +<LI><A href="node42.html">10 Check the hostname settings</a> +<LI><A href="customizing.html">11 Customize Mailman</a> +<LI><A href="node44.html">12 Create your first mailing list</a> +<LI><A href="troubleshooting.html">13 Troubleshooting</a> +<LI><A href="node46.html">14 Platform and operating system notes</a> +<UL> +<LI><A href="node47.html">14.1 GNU/Linux issues</a> +<LI><A href="bsd-issues.html">14.2 BSD issues</a> +<LI><A href="node49.html">14.3 MacOSX issues</a> +</ul></ul> +<!--End of Table of Child-Links--> +</div> + +<DIV CLASS="navigation"> +<div class='online-navigation'> +<p></p><hr /> +<table align="center" width="100%" cellpadding="0" cellspacing="2"> +<tr> +<td class='online-navigation'><a rel="prev" title="GNU Mailman - Installation" + href="mailman-install.html"><img src='previous.png' + border='0' height='32' alt='Previous Page' width='32' /></A></td> +<td class='online-navigation'><a rel="parent" title="GNU Mailman - Installation" + href="mailman-install.html"><img src='up.png' + border='0' height='32' alt='Up One Level' width='32' /></A></td> +<td class='online-navigation'><a rel="next" title="1 Installation Requirements" + href="node2.html"><img src='next.png' + border='0' height='32' alt='Next Page' width='32' /></A></td> +<td align="center" width="100%">GNU Mailman - Installation Manual</td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +</tr></table> +<div class='online-navigation'> +<b class="navlabel">Previous:</b> +<a class="sectref" rel="prev" href="mailman-install.html">GNU Mailman - Installation</A> +<b class="navlabel">Up:</b> +<a class="sectref" rel="parent" href="mailman-install.html">GNU Mailman - Installation</A> +<b class="navlabel">Next:</b> +<a class="sectref" rel="next" href="node2.html">1 Installation Requirements</A> +</div> +</div> +<hr /> +<span class="release-info">Release 2.1, documentation updated on December 13, 2004.</span> +</DIV> +<!--End of Navigation Panel--> + +</BODY> +</HTML> diff --git a/admin/www/mailman-install/index.html b/admin/www/mailman-install/index.html new file mode 100644 index 00000000..cb9e0ceb --- /dev/null +++ b/admin/www/mailman-install/index.html @@ -0,0 +1,133 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> +<html> +<head> +<link rel="STYLESHEET" href="mailman-install.css" type='text/css' /> +<link rel="first" href="mailman-install.html" title='GNU Mailman - Installation Manual' /> +<link rel='last' href='about.html' title='About this document...' /> +<link rel='help' href='about.html' title='About this document...' /> +<link rel="next" href="front.html" /> +<meta name='aesop' content='information' /> +<title>GNU Mailman - Installation Manual</title> +</head> +<body> +<DIV CLASS="navigation"> +<div id='top-navigation-panel' xml:id='top-navigation-panel'> +<table align="center" width="100%" cellpadding="0" cellspacing="2"> +<tr> +<td class='online-navigation'><img src='previous.png' + border='0' height='32' alt='Previous Page' width='32' /></td> +<td class='online-navigation'><img src='up.png' + border='0' height='32' alt='Up One Level' width='32' /></td> +<td class='online-navigation'><a rel="next" title="Front Matter" + href="front.html"><img src='next.png' + border='0' height='32' alt='Next Page' width='32' /></A></td> +<td align="center" width="100%">GNU Mailman - Installation Manual</td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +</tr></table> +<div class='online-navigation'> +<b class="navlabel">Next:</b> +<a class="sectref" rel="next" href="front.html">Front Matter</A> +</div> +<hr /></div> +</DIV> +<!--End of Navigation Panel--> + +<P> + +<div class="titlepage"> +<div class='center'> +<h1>GNU Mailman - Installation Manual</h1> +<p><b><font size="+2">Barry Warsaw</font></b></p> +<p><span class="email">barry(at)python.org</span></p> +<p><strong>Release 2.1</strong><br /> +<strong>December 13, 2004</strong></p> +<p></p> +</div> +</div> + +<P> + +<p><br /></p><hr class='online-navigation' /> +<div class='online-navigation'> +<!--Table of Child-Links--> +<A NAME="CHILD_LINKS"></a> + +<UL CLASS="ChildLinks"> +<LI><A href="front.html">Front Matter</a> +<UL> +<LI><A href="node2.html">1 Installation Requirements</a> +<LI><A href="node3.html">2 Set up your system</a> +<UL> +<LI><A href="node4.html">2.1 Add the group and user</a> +<LI><A href="create-install-dir.html">2.2 Create the installation directory</a> +</ul> +<LI><A href="node6.html">3 Build and install Mailman</a> +<UL> +<LI><A href="node7.html">3.1 Run <b class="program">configure</b></a> +<LI><A href="node8.html">3.2 Make and install</a> +</ul> +<LI><A href="node9.html">4 Check your installation</a> +<LI><A href="node10.html">5 Set up your web server</a> +<LI><A href="mail-server.html">6 Set up your mail server</a> +<UL> +<LI><A href="node12.html">6.1 Using the Postfix mail server</a> +<LI><A href="node16.html">6.2 Using the Exim mail server</a> +<LI><A href="node31.html">6.3 Using the Sendmail mail server</a> +<LI><A href="qmail-issues.html">6.4 Using the Qmail mail server</a> +</ul> +<LI><A href="node39.html">7 Create a site-wide mailing list</a> +<LI><A href="node40.html">8 Set up cron</a> +<LI><A href="node41.html">9 Start the Mailman qrunner</a> +<LI><A href="node42.html">10 Check the hostname settings</a> +<LI><A href="customizing.html">11 Customize Mailman</a> +<LI><A href="node44.html">12 Create your first mailing list</a> +<LI><A href="troubleshooting.html">13 Troubleshooting</a> +<LI><A href="node46.html">14 Platform and operating system notes</a> +<UL> +<LI><A href="node47.html">14.1 GNU/Linux issues</a> +<LI><A href="bsd-issues.html">14.2 BSD issues</a> +<LI><A href="node49.html">14.3 MacOSX issues</a> +</ul> +</ul> +<LI><A href="about.html">About this document ...</a> +</ul> +<!--End of Table of Child-Links--> +</div> + +<DIV CLASS="navigation"> +<div class='online-navigation'> +<p></p><hr /> +<table align="center" width="100%" cellpadding="0" cellspacing="2"> +<tr> +<td class='online-navigation'><img src='previous.png' + border='0' height='32' alt='Previous Page' width='32' /></td> +<td class='online-navigation'><img src='up.png' + border='0' height='32' alt='Up One Level' width='32' /></td> +<td class='online-navigation'><a rel="next" title="Front Matter" + href="front.html"><img src='next.png' + border='0' height='32' alt='Next Page' width='32' /></A></td> +<td align="center" width="100%">GNU Mailman - Installation Manual</td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +</tr></table> +<div class='online-navigation'> +<b class="navlabel">Next:</b> +<a class="sectref" rel="next" href="front.html">Front Matter</A> +</div> +</div> +<hr /> +<span class="release-info">Release 2.1, documentation updated on December 13, 2004.</span> +</DIV> +<!--End of Navigation Panel--> + +</BODY> +</HTML> diff --git a/admin/www/mailman-install/index.png b/admin/www/mailman-install/index.png Binary files differnew file mode 100644 index 00000000..cd918afe --- /dev/null +++ b/admin/www/mailman-install/index.png diff --git a/admin/www/mailman-install/mail-server.html b/admin/www/mailman-install/mail-server.html new file mode 100644 index 00000000..4353f0b8 --- /dev/null +++ b/admin/www/mailman-install/mail-server.html @@ -0,0 +1,144 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> +<html> +<head> +<link rel="STYLESHEET" href="mailman-install.css" type='text/css' /> +<link rel="first" href="mailman-install.html" title='GNU Mailman - Installation Manual' /> +<link rel='last' href='about.html' title='About this document...' /> +<link rel='help' href='about.html' title='About this document...' /> +<link rel="next" href="node39.html" /> +<link rel="prev" href="node10.html" /> +<link rel="parent" href="front.html" /> +<link rel="next" href="node12.html" /> +<meta name='aesop' content='information' /> +<title>6 Set up your mail server</title> +</head> +<body> +<DIV CLASS="navigation"> +<div id='top-navigation-panel' xml:id='top-navigation-panel'> +<table align="center" width="100%" cellpadding="0" cellspacing="2"> +<tr> +<td class='online-navigation'><a rel="prev" title="5 Set up your" + href="node10.html"><img src='previous.png' + border='0' height='32' alt='Previous Page' width='32' /></A></td> +<td class='online-navigation'><a rel="parent" title="Front Matter" + href="front.html"><img src='up.png' + border='0' height='32' alt='Up One Level' width='32' /></A></td> +<td class='online-navigation'><a rel="next" title="6.1 Using the Postfix" + href="node12.html"><img src='next.png' + border='0' height='32' alt='Next Page' width='32' /></A></td> +<td align="center" width="100%">GNU Mailman - Installation Manual</td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +</tr></table> +<div class='online-navigation'> +<b class="navlabel">Previous:</b> +<a class="sectref" rel="prev" href="node10.html">5 Set up your</A> +<b class="navlabel">Up:</b> +<a class="sectref" rel="parent" href="front.html">Front Matter</A> +<b class="navlabel">Next:</b> +<a class="sectref" rel="next" href="node12.html">6.1 Using the Postfix</A> +</div> +<hr /></div> +</DIV> +<!--End of Navigation Panel--> + +<H1><A NAME="SECTION001600000000000000000"></A><A NAME="mail-server"></A> +<BR> +6 Set up your mail server +</H1> + +<P> +This section describes some of the things you need to do to connect Mailman's +email interface to your mail server. The instructions here are different for +each mail server; if your mail server is not described in the following +subsections, try to generalize from the existing documentation, and consider +contributing documentation updates to the Mailman developers. + +<P> + +<p><br /></p><hr class='online-navigation' /> +<div class='online-navigation'> +<!--Table of Child-Links--> +<A NAME="CHILD_LINKS"><STRONG>Subsections</STRONG></a> + +<UL CLASS="ChildLinks"> +<LI><A href="node12.html">6.1 Using the Postfix mail server</a> +<UL> +<LI><A href="node13.html">6.1.1 Integrating Postfix and Mailman</a> +<LI><A href="postfix-virtual.html">6.1.2 Virtual domains</a> +<LI><A href="node15.html">6.1.3 An alternative approach</a> +</ul> +<LI><A href="node16.html">6.2 Using the Exim mail server</a> +<UL> +<LI><A href="node17.html">6.2.1 Exim configuration</a> +<LI><A href="node18.html">6.2.2 Main configuration settings</a> +<LI><A href="exim3-transport.html">6.2.3 Transport for Exim 3</a> +<LI><A href="node20.html">6.2.4 Director for Exim 3</a> +<LI><A href="node21.html">6.2.5 Router for Exim 4</a> +<LI><A href="node22.html">6.2.6 Transports for Exim 4</a> +<LI><A href="node23.html">6.2.7 Additional notes</a> +<LI><A href="node24.html">6.2.8 Problems</a> +<LI><A href="node25.html">6.2.9 Receiver Verification</a> +<LI><A href="node26.html">6.2.10 SMTP Callback</a> +<LI><A href="node27.html">6.2.11 Doing VERP with Exim and Mailman</a> +<LI><A href="node28.html">6.2.12 Virtual Domains</a> +<LI><A href="node29.html">6.2.13 List Verification</a> +<LI><A href="node30.html">6.2.14 Document History</a> +</ul> +<LI><A href="node31.html">6.3 Using the Sendmail mail server</a> +<UL> +<LI><A href="node32.html">6.3.1 Sendmail ``smrsh'' compatibility</a> +<LI><A href="node33.html">6.3.2 Integrating Sendmail and Mailman</a> +<LI><A href="node34.html">6.3.3 Performance notes</a> +</ul> +<LI><A href="qmail-issues.html">6.4 Using the Qmail mail server</a> +<UL> +<LI><A href="node36.html">6.4.1 Information on VERP</a> +<LI><A href="node37.html">6.4.2 Virtual mail server</a> +<LI><A href="node38.html">6.4.3 More information</a> +</ul></ul> +<!--End of Table of Child-Links--> +</div> + +<DIV CLASS="navigation"> +<div class='online-navigation'> +<p></p><hr /> +<table align="center" width="100%" cellpadding="0" cellspacing="2"> +<tr> +<td class='online-navigation'><a rel="prev" title="5 Set up your" + href="node10.html"><img src='previous.png' + border='0' height='32' alt='Previous Page' width='32' /></A></td> +<td class='online-navigation'><a rel="parent" title="Front Matter" + href="front.html"><img src='up.png' + border='0' height='32' alt='Up One Level' width='32' /></A></td> +<td class='online-navigation'><a rel="next" title="6.1 Using the Postfix" + href="node12.html"><img src='next.png' + border='0' height='32' alt='Next Page' width='32' /></A></td> +<td align="center" width="100%">GNU Mailman - Installation Manual</td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +</tr></table> +<div class='online-navigation'> +<b class="navlabel">Previous:</b> +<a class="sectref" rel="prev" href="node10.html">5 Set up your</A> +<b class="navlabel">Up:</b> +<a class="sectref" rel="parent" href="front.html">Front Matter</A> +<b class="navlabel">Next:</b> +<a class="sectref" rel="next" href="node12.html">6.1 Using the Postfix</A> +</div> +</div> +<hr /> +<span class="release-info">Release 2.1, documentation updated on December 13, 2004.</span> +</DIV> +<!--End of Navigation Panel--> + +</BODY> +</HTML> diff --git a/admin/www/mailman-install/mailman-install.css b/admin/www/mailman-install/mailman-install.css new file mode 100644 index 00000000..06a613c2 --- /dev/null +++ b/admin/www/mailman-install/mailman-install.css @@ -0,0 +1,243 @@ +/* + * The first part of this is the standard CSS generated by LaTeX2HTML, + * with the "empty" declarations removed. + */ + +/* Century Schoolbook font is very similar to Computer Modern Math: cmmi */ +.math { font-family: "Century Schoolbook", serif; } +.math i { font-family: "Century Schoolbook", serif; + font-weight: bold } +.boldmath { font-family: "Century Schoolbook", serif; + font-weight: bold } + +/* + * Implement both fixed-size and relative sizes. + * + * I think these can be safely removed, as it doesn't appear that + * LaTeX2HTML ever generates these, even though these are carried + * over from the LaTeX2HTML stylesheet. + */ +small.xtiny { font-size : xx-small; } +small.tiny { font-size : x-small; } +small.scriptsize { font-size : smaller; } +small.footnotesize { font-size : small; } +big.xlarge { font-size : large; } +big.xxlarge { font-size : x-large; } +big.huge { font-size : larger; } +big.xhuge { font-size : xx-large; } + +/* + * Document-specific styles come next; + * these are added for the Python documentation. + * + * Note that the size specifications for the H* elements are because + * Netscape on Solaris otherwise doesn't get it right; they all end up + * the normal text size. + */ + +body { color: #000000; + background-color: #ffffff; } + +a:link:active { color: #ff0000; } +a:link:hover { background-color: #bbeeff; } +a:visited:hover { background-color: #bbeeff; } +a:visited { color: #551a8b; } +a:link { color: #0000bb; } + +h1, h2, h3, h4, h5, h6 { font-family: avantgarde, sans-serif; + font-weight: bold; } +h1 { font-size: 180%; } +h2 { font-size: 150%; } +h3, h4 { font-size: 120%; } + +/* These are section titles used in navigation links, so make sure we + * match the section header font here, even it not the weight. + */ +.sectref { font-family: avantgarde, sans-serif; } +/* And the label before the titles in navigation: */ +.navlabel { font-size: 85%; } + + +/* LaTeX2HTML insists on inserting <br> elements into headers which + * are marked with \label. This little bit of CSS magic ensures that + * these elements don't cause spurious whitespace to be added. + */ +h1>br, h2>br, h3>br, +h4>br, h5>br, h6>br { display: none; } + +code, tt { font-family: "lucida typewriter", lucidatypewriter, + monospace; } +var { font-family: times, serif; + font-style: italic; + font-weight: normal; } + +.Unix { font-variant: small-caps; } + +.typelabel { font-family: lucida, sans-serif; } + +.navigation td { background-color: #99ccff; + font-weight: bold; + font-family: avantgarde, sans-serif; + font-size: 110%; } + +div.warning { background-color: #fffaf0; + border: thin solid black; + padding: 1em; + margin-left: 2em; + margin-right: 2em; } + +div.warning .label { font-family: sans-serif; + font-size: 110%; + margin-right: 0.5em; } + +div.note { background-color: #fffaf0; + border: thin solid black; + padding: 1em; + margin-left: 2em; + margin-right: 2em; } + +div.note .label { margin-right: 0.5em; + font-family: sans-serif; } + +address { font-size: 80%; } +.release-info { font-style: italic; + font-size: 80%; } + +.titlegraphic { vertical-align: top; } + +.verbatim pre { color: #00008b; + font-family: "lucida typewriter", lucidatypewriter, + monospace; + font-size: 90%; } +.verbatim { margin-left: 2em; } +.verbatim .footer { padding: 0.05in; + font-size: 85%; + background-color: #99ccff; + margin-right: 0.5in; } + +.grammar { background-color: #99ccff; + margin-right: 0.5in; + padding: 0.05in; } +.grammar-footer { padding: 0.05in; + font-size: 85%; } +.grammartoken { font-family: "lucida typewriter", lucidatypewriter, + monospace; } + +.productions { background-color: #bbeeff; } +.productions a:active { color: #ff0000; } +.productions a:link:hover { background-color: #99ccff; } +.productions a:visited:hover { background-color: #99ccff; } +.productions a:visited { color: #551a8b; } +.productions a:link { color: #0000bb; } +.productions table { vertical-align: baseline; + empty-cells: show; } +.productions > table td, +.productions > table th { padding: 2px; } +.productions > table td:first-child, +.productions > table td:last-child { + font-family: "lucida typewriter", + lucidatypewriter, + monospace; + } +/* same as the second selector above, but expressed differently for Opera */ +.productions > table td:first-child + td + td { + font-family: "lucida typewriter", + lucidatypewriter, + monospace; + vertical-align: baseline; + } +.productions > table td:first-child + td { + padding-left: 1em; + padding-right: 1em; + } +.productions > table tr { vertical-align: baseline; } + +.email { font-family: avantgarde, sans-serif; } +.mailheader { font-family: avantgarde, sans-serif; } +.mimetype { font-family: avantgarde, sans-serif; } +.newsgroup { font-family: avantgarde, sans-serif; } +.url { font-family: avantgarde, sans-serif; } +.file { font-family: avantgarde, sans-serif; } +.guilabel { font-family: avantgarde, sans-serif; } + +.realtable { border-collapse: collapse; + border-color: black; + border-style: solid; + border-width: 0px 0px 2px 0px; + empty-cells: show; + margin-left: auto; + margin-right: auto; + padding-left: 0.4em; + padding-right: 0.4em; + } +.realtable tbody { vertical-align: baseline; } +.realtable tfoot { display: table-footer-group; } +.realtable thead { background-color: #99ccff; + border-width: 0px 0px 2px 1px; + display: table-header-group; + font-family: avantgarde, sans-serif; + font-weight: bold; + vertical-align: baseline; + } +.realtable thead :first-child { + border-width: 0px 0px 2px 0px; + } +.realtable thead th { border-width: 0px 0px 2px 1px } +.realtable td, +.realtable th { border-color: black; + border-style: solid; + border-width: 0px 0px 1px 1px; + padding-left: 0.4em; + padding-right: 0.4em; + } +.realtable td:first-child, +.realtable th:first-child { + border-left-width: 0px; + vertical-align: baseline; + } +.center { text-align: center; } +.left { text-align: left; } +.right { text-align: right; } + +.refcount-info { font-style: italic; } +.refcount-info .value { font-weight: bold; + color: #006600; } + +/* + * Some decoration for the "See also:" blocks, in part inspired by some of + * the styling on Lars Marius Garshol's XSA pages. + * (The blue in the navigation bars is #99CCFF.) + */ +.seealso { background-color: #fffaf0; + border: thin solid black; + padding: 0pt 1em 4pt 1em; } + +.seealso > .heading { font-size: 110%; + font-weight: bold; } + +/* + * Class 'availability' is used for module availability statements at + * the top of modules. + */ +.availability .platform { font-weight: bold; } + + +/* + * Additional styles for the distutils package. + */ +.du-command { font-family: monospace; } +.du-option { font-family: avantgarde, sans-serif; } +.du-filevar { font-family: avantgarde, sans-serif; + font-style: italic; } +.du-xxx:before { content: "** "; + font-weight: bold; } +.du-xxx:after { content: " **"; + font-weight: bold; } + + +/* + * Some specialization for printed output. + */ +@media print { + .online-navigation { display: none; } + } diff --git a/admin/www/mailman-install/mailman-install.html b/admin/www/mailman-install/mailman-install.html new file mode 100644 index 00000000..cb9e0ceb --- /dev/null +++ b/admin/www/mailman-install/mailman-install.html @@ -0,0 +1,133 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> +<html> +<head> +<link rel="STYLESHEET" href="mailman-install.css" type='text/css' /> +<link rel="first" href="mailman-install.html" title='GNU Mailman - Installation Manual' /> +<link rel='last' href='about.html' title='About this document...' /> +<link rel='help' href='about.html' title='About this document...' /> +<link rel="next" href="front.html" /> +<meta name='aesop' content='information' /> +<title>GNU Mailman - Installation Manual</title> +</head> +<body> +<DIV CLASS="navigation"> +<div id='top-navigation-panel' xml:id='top-navigation-panel'> +<table align="center" width="100%" cellpadding="0" cellspacing="2"> +<tr> +<td class='online-navigation'><img src='previous.png' + border='0' height='32' alt='Previous Page' width='32' /></td> +<td class='online-navigation'><img src='up.png' + border='0' height='32' alt='Up One Level' width='32' /></td> +<td class='online-navigation'><a rel="next" title="Front Matter" + href="front.html"><img src='next.png' + border='0' height='32' alt='Next Page' width='32' /></A></td> +<td align="center" width="100%">GNU Mailman - Installation Manual</td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +</tr></table> +<div class='online-navigation'> +<b class="navlabel">Next:</b> +<a class="sectref" rel="next" href="front.html">Front Matter</A> +</div> +<hr /></div> +</DIV> +<!--End of Navigation Panel--> + +<P> + +<div class="titlepage"> +<div class='center'> +<h1>GNU Mailman - Installation Manual</h1> +<p><b><font size="+2">Barry Warsaw</font></b></p> +<p><span class="email">barry(at)python.org</span></p> +<p><strong>Release 2.1</strong><br /> +<strong>December 13, 2004</strong></p> +<p></p> +</div> +</div> + +<P> + +<p><br /></p><hr class='online-navigation' /> +<div class='online-navigation'> +<!--Table of Child-Links--> +<A NAME="CHILD_LINKS"></a> + +<UL CLASS="ChildLinks"> +<LI><A href="front.html">Front Matter</a> +<UL> +<LI><A href="node2.html">1 Installation Requirements</a> +<LI><A href="node3.html">2 Set up your system</a> +<UL> +<LI><A href="node4.html">2.1 Add the group and user</a> +<LI><A href="create-install-dir.html">2.2 Create the installation directory</a> +</ul> +<LI><A href="node6.html">3 Build and install Mailman</a> +<UL> +<LI><A href="node7.html">3.1 Run <b class="program">configure</b></a> +<LI><A href="node8.html">3.2 Make and install</a> +</ul> +<LI><A href="node9.html">4 Check your installation</a> +<LI><A href="node10.html">5 Set up your web server</a> +<LI><A href="mail-server.html">6 Set up your mail server</a> +<UL> +<LI><A href="node12.html">6.1 Using the Postfix mail server</a> +<LI><A href="node16.html">6.2 Using the Exim mail server</a> +<LI><A href="node31.html">6.3 Using the Sendmail mail server</a> +<LI><A href="qmail-issues.html">6.4 Using the Qmail mail server</a> +</ul> +<LI><A href="node39.html">7 Create a site-wide mailing list</a> +<LI><A href="node40.html">8 Set up cron</a> +<LI><A href="node41.html">9 Start the Mailman qrunner</a> +<LI><A href="node42.html">10 Check the hostname settings</a> +<LI><A href="customizing.html">11 Customize Mailman</a> +<LI><A href="node44.html">12 Create your first mailing list</a> +<LI><A href="troubleshooting.html">13 Troubleshooting</a> +<LI><A href="node46.html">14 Platform and operating system notes</a> +<UL> +<LI><A href="node47.html">14.1 GNU/Linux issues</a> +<LI><A href="bsd-issues.html">14.2 BSD issues</a> +<LI><A href="node49.html">14.3 MacOSX issues</a> +</ul> +</ul> +<LI><A href="about.html">About this document ...</a> +</ul> +<!--End of Table of Child-Links--> +</div> + +<DIV CLASS="navigation"> +<div class='online-navigation'> +<p></p><hr /> +<table align="center" width="100%" cellpadding="0" cellspacing="2"> +<tr> +<td class='online-navigation'><img src='previous.png' + border='0' height='32' alt='Previous Page' width='32' /></td> +<td class='online-navigation'><img src='up.png' + border='0' height='32' alt='Up One Level' width='32' /></td> +<td class='online-navigation'><a rel="next" title="Front Matter" + href="front.html"><img src='next.png' + border='0' height='32' alt='Next Page' width='32' /></A></td> +<td align="center" width="100%">GNU Mailman - Installation Manual</td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +</tr></table> +<div class='online-navigation'> +<b class="navlabel">Next:</b> +<a class="sectref" rel="next" href="front.html">Front Matter</A> +</div> +</div> +<hr /> +<span class="release-info">Release 2.1, documentation updated on December 13, 2004.</span> +</DIV> +<!--End of Navigation Panel--> + +</BODY> +</HTML> diff --git a/admin/www/mailman-install/modules.png b/admin/www/mailman-install/modules.png Binary files differnew file mode 100644 index 00000000..8fa8b755 --- /dev/null +++ b/admin/www/mailman-install/modules.png diff --git a/admin/www/mailman-install/next.png b/admin/www/mailman-install/next.png Binary files differnew file mode 100644 index 00000000..cfe5e51c --- /dev/null +++ b/admin/www/mailman-install/next.png diff --git a/admin/www/mailman-install/node10.html b/admin/www/mailman-install/node10.html new file mode 100644 index 00000000..617b509e --- /dev/null +++ b/admin/www/mailman-install/node10.html @@ -0,0 +1,192 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> +<html> +<head> +<link rel="STYLESHEET" href="mailman-install.css" type='text/css' /> +<link rel="first" href="mailman-install.html" title='GNU Mailman - Installation Manual' /> +<link rel='last' href='about.html' title='About this document...' /> +<link rel='help' href='about.html' title='About this document...' /> +<link rel="next" href="mail-server.html" /> +<link rel="prev" href="node9.html" /> +<link rel="parent" href="front.html" /> +<link rel="next" href="mail-server.html" /> +<meta name='aesop' content='information' /> +<title>5 Set up your web server</title> +</head> +<body> +<DIV CLASS="navigation"> +<div id='top-navigation-panel' xml:id='top-navigation-panel'> +<table align="center" width="100%" cellpadding="0" cellspacing="2"> +<tr> +<td class='online-navigation'><a rel="prev" title="4 Check your installation" + href="node9.html"><img src='previous.png' + border='0' height='32' alt='Previous Page' width='32' /></A></td> +<td class='online-navigation'><a rel="parent" title="Front Matter" + href="front.html"><img src='up.png' + border='0' height='32' alt='Up One Level' width='32' /></A></td> +<td class='online-navigation'><a rel="next" title="6 Set up your" + href="mail-server.html"><img src='next.png' + border='0' height='32' alt='Next Page' width='32' /></A></td> +<td align="center" width="100%">GNU Mailman - Installation Manual</td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +</tr></table> +<div class='online-navigation'> +<b class="navlabel">Previous:</b> +<a class="sectref" rel="prev" href="node9.html">4 Check your installation</A> +<b class="navlabel">Up:</b> +<a class="sectref" rel="parent" href="front.html">Front Matter</A> +<b class="navlabel">Next:</b> +<a class="sectref" rel="next" href="mail-server.html">6 Set up your</A> +</div> +<hr /></div> +</DIV> +<!--End of Navigation Panel--> + +<H1><A NAME="SECTION001500000000000000000"> +5 Set up your web server</A> +</H1> + +<P> +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. + +<P> +If you plan on running your mail and web servers 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 +<span class="file">Mailman/LockFile.py</span>; the constant <var>CLOCK_SLOP</var> helps the locking +mechanism compensate for clock skew in this type of environment. + +<P> +This section describes some of the things you need to do to connect Mailman's +web interface to your web server. The instructions here are somewhat geared +toward the Apache web server, so you should consult your web server +documentation for details. + +<P> +You must configure your web server to enable CGI script permission in the +<span class="file"><var>$prefix</var>/cgi-bin</span> to run CGI scripts. The line you should add +might look something like the following, with the real absolute directory +substituted for <var>$prefix</var>, of course: + +<P> +<div class="verbatim"><pre> + Exec /mailman/* $prefix/cgi-bin/* +</pre></div> + +<P> +or: + +<P> +<div class="verbatim"><pre> + ScriptAlias /mailman/ $prefix/cgi-bin/ +</pre></div> + +<P> +<div class="warning"><b class="label">Warning:</b> + +You want to be very sure that the user id under which your CGI scripts run is +<strong>not</strong> in the <code>mailman</code> group you created above, otherwise private +archives will be accessible to anyone. +</div> + +<P> +Copy the Mailman, Python, and GNU logos to a location accessible to your web +server. E.g. with Apache, you've usually got an <span class="file">icons</span> directory that +you can drop the images into. For example: + +<P> +<div class="verbatim"><pre> + % cp $prefix/icons/*.{jpg,png} /path/to/apache/icons +</pre></div> + +<P> +You then want to add a line to your <span class="file"><var>$prefix</var>/Mailman/mm_cfg.py</span> +file which sets the base URL for the logos. For example: + +<P> +<div class="verbatim"><pre> + IMAGE_LOGOS = '/images/' +</pre></div> + +<P> +The default value for <var>IMAGE_LOGOS</var> is <span class="file">/icons/</span>. Read the comment +in <span class="file">Defaults.py.in</span> for details. + +<P> +Configure your web server to point to the Pipermail public mailing list +archives. For example, in Apache: + +<P> +<div class="verbatim"><pre> + Alias /pipermail/ $varprefix/archives/public/ +</pre></div> + +<P> +where <var>$varprefix</var> is usually <var>$prefix</var> unless you've used the +<b class="programopt">--with-var-prefix</b> option to <b class="program">configure</b>. 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 <var>FollowSymLinks</var> option. + +<P> +If you're going to be supporting internationalized public archives, you will +probably want to turn off any default charset directive for the Pipermail +directory, otherwise your multilingual archive pages won't show up correctly. +Here's an example for Apache, based on the standard installation directories: + +<P> +<div class="verbatim"><pre> + <Directory "/usr/local/mailman/archives/public/"> + AddDefaultCharset Off + </Directory> +</pre></div> + +<P> +Now restart your web server. + +<P> + +<DIV CLASS="navigation"> +<div class='online-navigation'> +<p></p><hr /> +<table align="center" width="100%" cellpadding="0" cellspacing="2"> +<tr> +<td class='online-navigation'><a rel="prev" title="4 Check your installation" + href="node9.html"><img src='previous.png' + border='0' height='32' alt='Previous Page' width='32' /></A></td> +<td class='online-navigation'><a rel="parent" title="Front Matter" + href="front.html"><img src='up.png' + border='0' height='32' alt='Up One Level' width='32' /></A></td> +<td class='online-navigation'><a rel="next" title="6 Set up your" + href="mail-server.html"><img src='next.png' + border='0' height='32' alt='Next Page' width='32' /></A></td> +<td align="center" width="100%">GNU Mailman - Installation Manual</td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +</tr></table> +<div class='online-navigation'> +<b class="navlabel">Previous:</b> +<a class="sectref" rel="prev" href="node9.html">4 Check your installation</A> +<b class="navlabel">Up:</b> +<a class="sectref" rel="parent" href="front.html">Front Matter</A> +<b class="navlabel">Next:</b> +<a class="sectref" rel="next" href="mail-server.html">6 Set up your</A> +</div> +</div> +<hr /> +<span class="release-info">Release 2.1, documentation updated on December 13, 2004.</span> +</DIV> +<!--End of Navigation Panel--> + +</BODY> +</HTML> diff --git a/admin/www/mailman-install/node12.html b/admin/www/mailman-install/node12.html new file mode 100644 index 00000000..1584f476 --- /dev/null +++ b/admin/www/mailman-install/node12.html @@ -0,0 +1,153 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> +<html> +<head> +<link rel="STYLESHEET" href="mailman-install.css" type='text/css' /> +<link rel="first" href="mailman-install.html" title='GNU Mailman - Installation Manual' /> +<link rel='last' href='about.html' title='About this document...' /> +<link rel='help' href='about.html' title='About this document...' /> +<link rel="next" href="node16.html" /> +<link rel="prev" href="mail-server.html" /> +<link rel="parent" href="mail-server.html" /> +<link rel="next" href="node13.html" /> +<meta name='aesop' content='information' /> +<title>6.1 Using the Postfix mail server</title> +</head> +<body> +<DIV CLASS="navigation"> +<div id='top-navigation-panel' xml:id='top-navigation-panel'> +<table align="center" width="100%" cellpadding="0" cellspacing="2"> +<tr> +<td class='online-navigation'><a rel="prev" title="6 Set up your" + href="mail-server.html"><img src='previous.png' + border='0' height='32' alt='Previous Page' width='32' /></A></td> +<td class='online-navigation'><a rel="parent" title="6 Set up your" + href="mail-server.html"><img src='up.png' + border='0' height='32' alt='Up One Level' width='32' /></A></td> +<td class='online-navigation'><a rel="next" title="6.1.1 Integrating Postfix and" + href="node13.html"><img src='next.png' + border='0' height='32' alt='Next Page' width='32' /></A></td> +<td align="center" width="100%">GNU Mailman - Installation Manual</td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +</tr></table> +<div class='online-navigation'> +<b class="navlabel">Previous:</b> +<a class="sectref" rel="prev" href="mail-server.html">6 Set up your</A> +<b class="navlabel">Up:</b> +<a class="sectref" rel="parent" href="mail-server.html">6 Set up your</A> +<b class="navlabel">Next:</b> +<a class="sectref" rel="next" href="node13.html">6.1.1 Integrating Postfix and</A> +</div> +<hr /></div> +</DIV> +<!--End of Navigation Panel--> + +<H2><A NAME="SECTION001610000000000000000"> +6.1 Using the Postfix mail server</A> +</H2> + +<P> +Mailman should work pretty much out of the box with a standard Postfix +installation. It has been tested with various Postfix versions up to and +including Postfix 2.1.5. + +<P> +By default, Postfix treats <code>-owner</code> and <code>-request</code> addresses +specially. Since you want Postfix to deliver such messages to Mailman, you +should turn off this option by adding this to your <span class="file">main.cf</span> file: + +<P> +<div class="verbatim"><pre> + owner_request_special = no +</pre></div> + +<P> +In order to support Mailman's optional VERP delivery, you will want to disable +<code>luser_relay</code> (the default) and you will want to set +<code>recipient_delimiter</code> for extended address semantics. You should comment +out any <code>luser_relay</code> value in your <span class="file">main.cf</span> and just go with the +defaults. Also, add this to your <span class="file">main.cf</span> file: + +<P> +<div class="verbatim"><pre> + recipient_delimiter = + +</pre></div> + +<P> +Using "<tt class="samp">+</tt>" as the delimiter works well with the default values for +<var>VERP_FORMAT</var> and <var>VERP_REGEXP</var> in <span class="file">Defaults.py</span>. + +<P> +When attempting to deliver a message to a non-existent local address, Postfix +may return a 450 error code. Since this is a transient error code, Mailman +will continue to attempt to deliver the message for +<var>DELIVERY_RETRY_PERIOD</var> - 5 days by default. You might want to set +Postfix up so that it returns permanent error codes for non-existent local +users by adding the following to your <span class="file">main.cf</span> file: + +<P> +<div class="verbatim"><pre> + unknown_local_recipient_reject_code = 550 +</pre></div> + +<P> +Finally, if you are using Postfix-style virtual domains, read the section on +virtual domain support below. + +<P> + +<p><br /></p><hr class='online-navigation' /> +<div class='online-navigation'> +<!--Table of Child-Links--> +<A NAME="CHILD_LINKS"><STRONG>Subsections</STRONG></a> + +<UL CLASS="ChildLinks"> +<LI><A href="node13.html">6.1.1 Integrating Postfix and Mailman</a> +<LI><A href="postfix-virtual.html">6.1.2 Virtual domains</a> +<LI><A href="node15.html">6.1.3 An alternative approach</a> +</ul> +<!--End of Table of Child-Links--> +</div> + +<DIV CLASS="navigation"> +<div class='online-navigation'> +<p></p><hr /> +<table align="center" width="100%" cellpadding="0" cellspacing="2"> +<tr> +<td class='online-navigation'><a rel="prev" title="6 Set up your" + href="mail-server.html"><img src='previous.png' + border='0' height='32' alt='Previous Page' width='32' /></A></td> +<td class='online-navigation'><a rel="parent" title="6 Set up your" + href="mail-server.html"><img src='up.png' + border='0' height='32' alt='Up One Level' width='32' /></A></td> +<td class='online-navigation'><a rel="next" title="6.1.1 Integrating Postfix and" + href="node13.html"><img src='next.png' + border='0' height='32' alt='Next Page' width='32' /></A></td> +<td align="center" width="100%">GNU Mailman - Installation Manual</td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +</tr></table> +<div class='online-navigation'> +<b class="navlabel">Previous:</b> +<a class="sectref" rel="prev" href="mail-server.html">6 Set up your</A> +<b class="navlabel">Up:</b> +<a class="sectref" rel="parent" href="mail-server.html">6 Set up your</A> +<b class="navlabel">Next:</b> +<a class="sectref" rel="next" href="node13.html">6.1.1 Integrating Postfix and</A> +</div> +</div> +<hr /> +<span class="release-info">Release 2.1, documentation updated on December 13, 2004.</span> +</DIV> +<!--End of Navigation Panel--> + +</BODY> +</HTML> diff --git a/admin/www/mailman-install/node13.html b/admin/www/mailman-install/node13.html new file mode 100644 index 00000000..e2fca7b5 --- /dev/null +++ b/admin/www/mailman-install/node13.html @@ -0,0 +1,205 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> +<html> +<head> +<link rel="STYLESHEET" href="mailman-install.css" type='text/css' /> +<link rel="first" href="mailman-install.html" title='GNU Mailman - Installation Manual' /> +<link rel='last' href='about.html' title='About this document...' /> +<link rel='help' href='about.html' title='About this document...' /> +<link rel="next" href="postfix-virtual.html" /> +<link rel="prev" href="node12.html" /> +<link rel="parent" href="node12.html" /> +<link rel="next" href="postfix-virtual.html" /> +<meta name='aesop' content='information' /> +<title>6.1.1 Integrating Postfix and Mailman</title> +</head> +<body> +<DIV CLASS="navigation"> +<div id='top-navigation-panel' xml:id='top-navigation-panel'> +<table align="center" width="100%" cellpadding="0" cellspacing="2"> +<tr> +<td class='online-navigation'><a rel="prev" title="6.1 Using the Postfix" + href="node12.html"><img src='previous.png' + border='0' height='32' alt='Previous Page' width='32' /></A></td> +<td class='online-navigation'><a rel="parent" title="6.1 Using the Postfix" + href="node12.html"><img src='up.png' + border='0' height='32' alt='Up One Level' width='32' /></A></td> +<td class='online-navigation'><a rel="next" title="6.1.2 Virtual domains" + href="postfix-virtual.html"><img src='next.png' + border='0' height='32' alt='Next Page' width='32' /></A></td> +<td align="center" width="100%">GNU Mailman - Installation Manual</td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +</tr></table> +<div class='online-navigation'> +<b class="navlabel">Previous:</b> +<a class="sectref" rel="prev" href="node12.html">6.1 Using the Postfix</A> +<b class="navlabel">Up:</b> +<a class="sectref" rel="parent" href="node12.html">6.1 Using the Postfix</A> +<b class="navlabel">Next:</b> +<a class="sectref" rel="next" href="postfix-virtual.html">6.1.2 Virtual domains</A> +</div> +<hr /></div> +</DIV> +<!--End of Navigation Panel--> + +<H3><A NAME="SECTION001611000000000000000"> +6.1.1 Integrating Postfix and Mailman</A> +</H3> + +<P> +You can integrate Postfix and Mailman such that when new lists are created, or +lists are removed, Postfix's alias database will be automatically updated. +The following are the steps you need to take to make this work. + +<P> +In the description below, we assume that you've installed Mailman in the +default location, i.e. <span class="file">/usr/local/mailman</span>. If that's not the case, +adjust the instructions according to your use of <b class="program">configure</b>'s +<b class="programopt">--prefix</b> and <b class="programopt">--with-var-prefix</b> options. + +<P> +<div class="note"><b class="label">Note:</b> + +If you are using virtual domains and you want Mailman to honor your virtual +domains, read the <A href="postfix-virtual.html#postfix-virtual">6.1</A> section below first! +</div> + +<P> + +<UL> +<LI>Add this to the bottom of the <span class="file"><var>$prefix</var>/Mailman/mm_cfg.py</span> + file: + +<P> +<div class="verbatim"><pre> + MTA = 'Postfix' +</pre></div> + +<P> +The MTA variable names a module in the <span class="file">Mailman/MTA</span> directory + which contains the mail server-specific functions to be executed when a + list is created or removed. + +<P> +</LI> +<LI>Look at the <span class="file">Defaults.py</span> file for the variables + <var>POSTFIX_ALIAS_CMD</var> and <var>POSTFIX_MAP_CMD</var> command. Make sure + these point to your <b class="program">postalias</b> and <b class="program">postmap</b> programs + respectively. Remember that if you need to make changes, do it in + <span class="file">mm_cfg.py</span>. + +<P> +</LI> +<LI>Run the <b class="program">bin/genaliases</b> script to initialize your + <span class="file">aliases</span> file. + +<P> +<div class="verbatim"><pre> + % cd /usr/local/mailman + % bin/genaliases + </pre></div> + +<P> +Make sure that the owner of the <span class="file">data/aliases</span> and + <span class="file">data/aliases.db</span> file is <code>mailman</code> and that the group owner + for those files is <code>mailman</code>, or whatever user and group you used + in the configure command: + +<P> +<div class="verbatim"><pre> + % su + % chown mailman:mailman data/aliases* + </pre></div> + +<P> +</LI> +<LI>Hack your Postfix's <span class="file">main.cf</span> file to include the following path in + your <var>alias_maps</var> variable: + +<P> +<div class="verbatim"><pre> + /usr/local/mailman/data/aliases +</pre></div> + +<P> +Note that there should be no trailing <code>.db</code>. Do not include this + in your <var>alias_database</var> variable. This is because you do not want + Postfix's <b class="program">newaliases</b> command to modify Mailman's + <span class="file">aliases.db</span> file, but you do want Postfix to consult + <span class="file">aliases.db</span> when looking for local addresses. + +<P> +You probably want to use a <code>hash:</code> style database for this entry. + Here's an example: + +<P> +<div class="verbatim"><pre> + alias_maps = hash:/etc/postfix/aliases, + hash:/usr/local/mailman/data/aliases +</pre></div> + +<P> +</LI> +<LI>When you configure Mailman, use the + <b class="programopt">--with-mail-gid=mailman</b> switch; this will be the default + if you configured Mailman after adding the <code>mailman</code> owner. + Because the owner of the <span class="file">aliases.db</span> file is <code>mailman</code>, + Postfix will execute Mailman's wrapper program as uid and gid + <code>mailman</code>. + +<P> +</LI> +</UL> + +<P> +That's it! One caveat: when you add or remove a list, the <span class="file">aliases.db</span> +file will updated, but it will not automatically run <b class="program">postfix reload</b>. +This is because you need to be root to run this and suid-root scripts are not +secure. The only effect of this is that it will take about a minute for +Postfix to notice the change to the <span class="file">aliases.db</span> file and update its +tables. + +<P> + +<DIV CLASS="navigation"> +<div class='online-navigation'> +<p></p><hr /> +<table align="center" width="100%" cellpadding="0" cellspacing="2"> +<tr> +<td class='online-navigation'><a rel="prev" title="6.1 Using the Postfix" + href="node12.html"><img src='previous.png' + border='0' height='32' alt='Previous Page' width='32' /></A></td> +<td class='online-navigation'><a rel="parent" title="6.1 Using the Postfix" + href="node12.html"><img src='up.png' + border='0' height='32' alt='Up One Level' width='32' /></A></td> +<td class='online-navigation'><a rel="next" title="6.1.2 Virtual domains" + href="postfix-virtual.html"><img src='next.png' + border='0' height='32' alt='Next Page' width='32' /></A></td> +<td align="center" width="100%">GNU Mailman - Installation Manual</td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +</tr></table> +<div class='online-navigation'> +<b class="navlabel">Previous:</b> +<a class="sectref" rel="prev" href="node12.html">6.1 Using the Postfix</A> +<b class="navlabel">Up:</b> +<a class="sectref" rel="parent" href="node12.html">6.1 Using the Postfix</A> +<b class="navlabel">Next:</b> +<a class="sectref" rel="next" href="postfix-virtual.html">6.1.2 Virtual domains</A> +</div> +</div> +<hr /> +<span class="release-info">Release 2.1, documentation updated on December 13, 2004.</span> +</DIV> +<!--End of Navigation Panel--> + +</BODY> +</HTML> diff --git a/admin/www/mailman-install/node15.html b/admin/www/mailman-install/node15.html new file mode 100644 index 00000000..b7a7c8d8 --- /dev/null +++ b/admin/www/mailman-install/node15.html @@ -0,0 +1,110 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> +<html> +<head> +<link rel="STYLESHEET" href="mailman-install.css" type='text/css' /> +<link rel="first" href="mailman-install.html" title='GNU Mailman - Installation Manual' /> +<link rel='last' href='about.html' title='About this document...' /> +<link rel='help' href='about.html' title='About this document...' /> +<link rel="prev" href="postfix-virtual.html" /> +<link rel="parent" href="node12.html" /> +<link rel="next" href="node16.html" /> +<meta name='aesop' content='information' /> +<title>6.1.3 An alternative approach</title> +</head> +<body> +<DIV CLASS="navigation"> +<div id='top-navigation-panel' xml:id='top-navigation-panel'> +<table align="center" width="100%" cellpadding="0" cellspacing="2"> +<tr> +<td class='online-navigation'><a rel="prev" title="6.1.2 Virtual domains" + href="postfix-virtual.html"><img src='previous.png' + border='0' height='32' alt='Previous Page' width='32' /></A></td> +<td class='online-navigation'><a rel="parent" title="6.1 Using the Postfix" + href="node12.html"><img src='up.png' + border='0' height='32' alt='Up One Level' width='32' /></A></td> +<td class='online-navigation'><a rel="next" title="6.2 Using the Exim" + href="node16.html"><img src='next.png' + border='0' height='32' alt='Next Page' width='32' /></A></td> +<td align="center" width="100%">GNU Mailman - Installation Manual</td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +</tr></table> +<div class='online-navigation'> +<b class="navlabel">Previous:</b> +<a class="sectref" rel="prev" href="postfix-virtual.html">6.1.2 Virtual domains</A> +<b class="navlabel">Up:</b> +<a class="sectref" rel="parent" href="node12.html">6.1 Using the Postfix</A> +<b class="navlabel">Next:</b> +<a class="sectref" rel="next" href="node16.html">6.2 Using the Exim</A> +</div> +<hr /></div> +</DIV> +<!--End of Navigation Panel--> + +<H3><A NAME="SECTION001613000000000000000"> +6.1.3 An alternative approach</A> +</H3> + +<P> +Fil <span class="email">fil@rezo.net</span> has an alternative approach based on virtual maps and +regular expressions, as described at: + +<P> + +<UL> +<LI>(French) <a class="url" href="http://listes.rezo.net/comment.php">http://listes.rezo.net/comment.php</a> +</LI> +<LI>(English) <a class="url" href="http://listes.rezo.net/how.php">http://listes.rezo.net/how.php</a> +</LI> +</UL> + +<P> +This is a good (and simpler) alternative if you don't mind exposing an +additional hostname in the domain part of the addresses people will use to +contact your list. I.e. if people should use <code>mylist@lists.dom.ain</code> +instead of <code>mylist@dom.ain</code>. + +<P> + +<DIV CLASS="navigation"> +<div class='online-navigation'> +<p></p><hr /> +<table align="center" width="100%" cellpadding="0" cellspacing="2"> +<tr> +<td class='online-navigation'><a rel="prev" title="6.1.2 Virtual domains" + href="postfix-virtual.html"><img src='previous.png' + border='0' height='32' alt='Previous Page' width='32' /></A></td> +<td class='online-navigation'><a rel="parent" title="6.1 Using the Postfix" + href="node12.html"><img src='up.png' + border='0' height='32' alt='Up One Level' width='32' /></A></td> +<td class='online-navigation'><a rel="next" title="6.2 Using the Exim" + href="node16.html"><img src='next.png' + border='0' height='32' alt='Next Page' width='32' /></A></td> +<td align="center" width="100%">GNU Mailman - Installation Manual</td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +</tr></table> +<div class='online-navigation'> +<b class="navlabel">Previous:</b> +<a class="sectref" rel="prev" href="postfix-virtual.html">6.1.2 Virtual domains</A> +<b class="navlabel">Up:</b> +<a class="sectref" rel="parent" href="node12.html">6.1 Using the Postfix</A> +<b class="navlabel">Next:</b> +<a class="sectref" rel="next" href="node16.html">6.2 Using the Exim</A> +</div> +</div> +<hr /> +<span class="release-info">Release 2.1, documentation updated on December 13, 2004.</span> +</DIV> +<!--End of Navigation Panel--> + +</BODY> +</HTML> diff --git a/admin/www/mailman-install/node16.html b/admin/www/mailman-install/node16.html new file mode 100644 index 00000000..92e82c8e --- /dev/null +++ b/admin/www/mailman-install/node16.html @@ -0,0 +1,131 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> +<html> +<head> +<link rel="STYLESHEET" href="mailman-install.css" type='text/css' /> +<link rel="first" href="mailman-install.html" title='GNU Mailman - Installation Manual' /> +<link rel='last' href='about.html' title='About this document...' /> +<link rel='help' href='about.html' title='About this document...' /> +<link rel="next" href="node31.html" /> +<link rel="prev" href="node12.html" /> +<link rel="parent" href="mail-server.html" /> +<link rel="next" href="node17.html" /> +<meta name='aesop' content='information' /> +<title>6.2 Using the Exim mail server</title> +</head> +<body> +<DIV CLASS="navigation"> +<div id='top-navigation-panel' xml:id='top-navigation-panel'> +<table align="center" width="100%" cellpadding="0" cellspacing="2"> +<tr> +<td class='online-navigation'><a rel="prev" title="6.1.3 An alternative approach" + href="node15.html"><img src='previous.png' + border='0' height='32' alt='Previous Page' width='32' /></A></td> +<td class='online-navigation'><a rel="parent" title="6 Set up your" + href="mail-server.html"><img src='up.png' + border='0' height='32' alt='Up One Level' width='32' /></A></td> +<td class='online-navigation'><a rel="next" title="6.2.1 Exim configuration" + href="node17.html"><img src='next.png' + border='0' height='32' alt='Next Page' width='32' /></A></td> +<td align="center" width="100%">GNU Mailman - Installation Manual</td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +</tr></table> +<div class='online-navigation'> +<b class="navlabel">Previous:</b> +<a class="sectref" rel="prev" href="node15.html">6.1.3 An alternative approach</A> +<b class="navlabel">Up:</b> +<a class="sectref" rel="parent" href="mail-server.html">6 Set up your</A> +<b class="navlabel">Next:</b> +<a class="sectref" rel="next" href="node17.html">6.2.1 Exim configuration</A> +</div> +<hr /></div> +</DIV> +<!--End of Navigation Panel--> + +<H2><A NAME="SECTION001620000000000000000"> +6.2 Using the Exim mail server</A> +</H2> + +<P> +<div class="note"><b class="label">Note:</b> + +This section is derived from Nigel Metheringham's ``HOWTO - Using Exim and +Mailman together'', which covers Mailman 2.0.x and Exim 3. It has been +updated to cover Mailman 2.1 and Exim 4. The original document is here: +<a class="url" href="http://www.exim.org/howto/mailman.html">http://www.exim.org/howto/mailman.html</a>. +</div> + +<P> +There is no Mailman configuration needed other than the standard options +detailed in the Mailman install documentation. The Exim configuration is +transparent to Mailman. The user and group settings for Mailman must match +those in the config fragments given below. + +<P> + +<p><br /></p><hr class='online-navigation' /> +<div class='online-navigation'> +<!--Table of Child-Links--> +<A NAME="CHILD_LINKS"><STRONG>Subsections</STRONG></a> + +<UL CLASS="ChildLinks"> +<LI><A href="node17.html">6.2.1 Exim configuration</a> +<LI><A href="node18.html">6.2.2 Main configuration settings</a> +<LI><A href="exim3-transport.html">6.2.3 Transport for Exim 3</a> +<LI><A href="node20.html">6.2.4 Director for Exim 3</a> +<LI><A href="node21.html">6.2.5 Router for Exim 4</a> +<LI><A href="node22.html">6.2.6 Transports for Exim 4</a> +<LI><A href="node23.html">6.2.7 Additional notes</a> +<LI><A href="node24.html">6.2.8 Problems</a> +<LI><A href="node25.html">6.2.9 Receiver Verification</a> +<LI><A href="node26.html">6.2.10 SMTP Callback</a> +<LI><A href="node27.html">6.2.11 Doing VERP with Exim and Mailman</a> +<LI><A href="node28.html">6.2.12 Virtual Domains</a> +<LI><A href="node29.html">6.2.13 List Verification</a> +<LI><A href="node30.html">6.2.14 Document History</a> +</ul> +<!--End of Table of Child-Links--> +</div> + +<DIV CLASS="navigation"> +<div class='online-navigation'> +<p></p><hr /> +<table align="center" width="100%" cellpadding="0" cellspacing="2"> +<tr> +<td class='online-navigation'><a rel="prev" title="6.1.3 An alternative approach" + href="node15.html"><img src='previous.png' + border='0' height='32' alt='Previous Page' width='32' /></A></td> +<td class='online-navigation'><a rel="parent" title="6 Set up your" + href="mail-server.html"><img src='up.png' + border='0' height='32' alt='Up One Level' width='32' /></A></td> +<td class='online-navigation'><a rel="next" title="6.2.1 Exim configuration" + href="node17.html"><img src='next.png' + border='0' height='32' alt='Next Page' width='32' /></A></td> +<td align="center" width="100%">GNU Mailman - Installation Manual</td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +</tr></table> +<div class='online-navigation'> +<b class="navlabel">Previous:</b> +<a class="sectref" rel="prev" href="node15.html">6.1.3 An alternative approach</A> +<b class="navlabel">Up:</b> +<a class="sectref" rel="parent" href="mail-server.html">6 Set up your</A> +<b class="navlabel">Next:</b> +<a class="sectref" rel="next" href="node17.html">6.2.1 Exim configuration</A> +</div> +</div> +<hr /> +<span class="release-info">Release 2.1, documentation updated on December 13, 2004.</span> +</DIV> +<!--End of Navigation Panel--> + +</BODY> +</HTML> diff --git a/admin/www/mailman-install/node17.html b/admin/www/mailman-install/node17.html new file mode 100644 index 00000000..f7cea2f0 --- /dev/null +++ b/admin/www/mailman-install/node17.html @@ -0,0 +1,151 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> +<html> +<head> +<link rel="STYLESHEET" href="mailman-install.css" type='text/css' /> +<link rel="first" href="mailman-install.html" title='GNU Mailman - Installation Manual' /> +<link rel='last' href='about.html' title='About this document...' /> +<link rel='help' href='about.html' title='About this document...' /> +<link rel="next" href="node18.html" /> +<link rel="prev" href="node16.html" /> +<link rel="parent" href="node16.html" /> +<link rel="next" href="node18.html" /> +<meta name='aesop' content='information' /> +<title>6.2.1 Exim configuration</title> +</head> +<body> +<DIV CLASS="navigation"> +<div id='top-navigation-panel' xml:id='top-navigation-panel'> +<table align="center" width="100%" cellpadding="0" cellspacing="2"> +<tr> +<td class='online-navigation'><a rel="prev" title="6.2 Using the Exim" + href="node16.html"><img src='previous.png' + border='0' height='32' alt='Previous Page' width='32' /></A></td> +<td class='online-navigation'><a rel="parent" title="6.2 Using the Exim" + href="node16.html"><img src='up.png' + border='0' height='32' alt='Up One Level' width='32' /></A></td> +<td class='online-navigation'><a rel="next" title="6.2.2 Main configuration settings" + href="node18.html"><img src='next.png' + border='0' height='32' alt='Next Page' width='32' /></A></td> +<td align="center" width="100%">GNU Mailman - Installation Manual</td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +</tr></table> +<div class='online-navigation'> +<b class="navlabel">Previous:</b> +<a class="sectref" rel="prev" href="node16.html">6.2 Using the Exim</A> +<b class="navlabel">Up:</b> +<a class="sectref" rel="parent" href="node16.html">6.2 Using the Exim</A> +<b class="navlabel">Next:</b> +<a class="sectref" rel="next" href="node18.html">6.2.2 Main configuration settings</A> +</div> +<hr /></div> +</DIV> +<!--End of Navigation Panel--> + +<H3><A NAME="SECTION001621000000000000000"> +6.2.1 Exim configuration</A> +</H3> + +<P> +The Exim configuration is built so that a list created within Mailman +automatically appears to Exim without the need for defining any additional +aliases. + +<P> +The drawback of this configuration is that it will work poorly on systems +supporting lists in several different mail domains. While Mailman handles +virtual domains, it does not yet support having two distinct lists with the +same name in different virtual domains, using the same Mailman installation. +This will eventually change. (But see below for a variation on this scheme +that should accommodate virtual domains better.) + +<P> +The configuration file excerpts below are for use in an already functional +Exim configuration, which accepts mail for the domain in which the list +resides. If this domain is separate from the others handled by your Exim +configuration, then you'll need to: + +<P> + +<UL> +<LI>add the list domain, ``my.list.domain'' to <var>local_domains</var> + +<P> +</LI> +<LI>add a ``domains=my.list.domain'' option to the director (router) for the + list + +<P> +</LI> +<LI>(optional) exclude that domain from your other directors (routers) +</LI> +</UL> + +<P> +<div class="note"><b class="label">Note:</b> + +The instructions in this document should work with either Exim 3 or Exim 4. +In Exim 3, you must have a <var>local_domains</var> configuration setting; in Exim +4, you most likely have a <var>local_domains</var> domainlist. If you don't, you +probably know what you're doing and can adjust accordingly. Similarly, in +Exim 4 the concept of ``directors'' has disappeared - there are only routers +now. So if you're using Exim 4, whenever this document says ``director'', +read ``router''. +</div> + +<P> +Whether you are using Exim 3 or Exim 4, you will need to add some macros to +the main section of your Exim config file. You will also need to define one +new transport. With Exim 3, you'll need to add a new director; with Exim 4, a +new router plays the same role. + +<P> +Finally, the configuration supplied here should allow co-habiting Mailman 2.0 +and 2.1 installations, with the proviso that you'll probably want to use +<code>mm21</code> in place of <code>mailman</code> - e.g., <var>MM21_HOME</var>, +<var>mm21_transport</var>, etc. + +<P> + +<DIV CLASS="navigation"> +<div class='online-navigation'> +<p></p><hr /> +<table align="center" width="100%" cellpadding="0" cellspacing="2"> +<tr> +<td class='online-navigation'><a rel="prev" title="6.2 Using the Exim" + href="node16.html"><img src='previous.png' + border='0' height='32' alt='Previous Page' width='32' /></A></td> +<td class='online-navigation'><a rel="parent" title="6.2 Using the Exim" + href="node16.html"><img src='up.png' + border='0' height='32' alt='Up One Level' width='32' /></A></td> +<td class='online-navigation'><a rel="next" title="6.2.2 Main configuration settings" + href="node18.html"><img src='next.png' + border='0' height='32' alt='Next Page' width='32' /></A></td> +<td align="center" width="100%">GNU Mailman - Installation Manual</td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +</tr></table> +<div class='online-navigation'> +<b class="navlabel">Previous:</b> +<a class="sectref" rel="prev" href="node16.html">6.2 Using the Exim</A> +<b class="navlabel">Up:</b> +<a class="sectref" rel="parent" href="node16.html">6.2 Using the Exim</A> +<b class="navlabel">Next:</b> +<a class="sectref" rel="next" href="node18.html">6.2.2 Main configuration settings</A> +</div> +</div> +<hr /> +<span class="release-info">Release 2.1, documentation updated on December 13, 2004.</span> +</DIV> +<!--End of Navigation Panel--> + +</BODY> +</HTML> diff --git a/admin/www/mailman-install/node18.html b/admin/www/mailman-install/node18.html new file mode 100644 index 00000000..eee3fde4 --- /dev/null +++ b/admin/www/mailman-install/node18.html @@ -0,0 +1,110 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> +<html> +<head> +<link rel="STYLESHEET" href="mailman-install.css" type='text/css' /> +<link rel="first" href="mailman-install.html" title='GNU Mailman - Installation Manual' /> +<link rel='last' href='about.html' title='About this document...' /> +<link rel='help' href='about.html' title='About this document...' /> +<link rel="next" href="exim3-transport.html" /> +<link rel="prev" href="node17.html" /> +<link rel="parent" href="node16.html" /> +<link rel="next" href="exim3-transport.html" /> +<meta name='aesop' content='information' /> +<title>6.2.2 Main configuration settings</title> +</head> +<body> +<DIV CLASS="navigation"> +<div id='top-navigation-panel' xml:id='top-navigation-panel'> +<table align="center" width="100%" cellpadding="0" cellspacing="2"> +<tr> +<td class='online-navigation'><a rel="prev" title="6.2.1 Exim configuration" + href="node17.html"><img src='previous.png' + border='0' height='32' alt='Previous Page' width='32' /></A></td> +<td class='online-navigation'><a rel="parent" title="6.2 Using the Exim" + href="node16.html"><img src='up.png' + border='0' height='32' alt='Up One Level' width='32' /></A></td> +<td class='online-navigation'><a rel="next" title="6.2.3 Transport for Exim" + href="exim3-transport.html"><img src='next.png' + border='0' height='32' alt='Next Page' width='32' /></A></td> +<td align="center" width="100%">GNU Mailman - Installation Manual</td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +</tr></table> +<div class='online-navigation'> +<b class="navlabel">Previous:</b> +<a class="sectref" rel="prev" href="node17.html">6.2.1 Exim configuration</A> +<b class="navlabel">Up:</b> +<a class="sectref" rel="parent" href="node16.html">6.2 Using the Exim</A> +<b class="navlabel">Next:</b> +<a class="sectref" rel="next" href="exim3-transport.html">6.2.3 Transport for Exim</A> +</div> +<hr /></div> +</DIV> +<!--End of Navigation Panel--> + +<H3><A NAME="SECTION001622000000000000000"> +6.2.2 Main configuration settings</A> +</H3> + +<P> +First, you need to add some macros to the top of your Exim config file. These +just make the director (router) and transport below a bit cleaner. Obviously, +you'll need to edit these based on how you configured and installed Mailman. + +<P> +<div class="verbatim"><pre> + # Home dir for your Mailman installation -- aka Mailman's prefix + # directory. + MAILMAN_HOME=/usr/local/mailman + MAILMAN_WRAP=MAILMAN_HOME/mail/mailman + + # User and group for Mailman, should match your --with-mail-gid + # switch to Mailman's configure script. + MAILMAN_USER=mailman + MAILMAN_GROUP=mailman +</pre></div> + +<P> + +<DIV CLASS="navigation"> +<div class='online-navigation'> +<p></p><hr /> +<table align="center" width="100%" cellpadding="0" cellspacing="2"> +<tr> +<td class='online-navigation'><a rel="prev" title="6.2.1 Exim configuration" + href="node17.html"><img src='previous.png' + border='0' height='32' alt='Previous Page' width='32' /></A></td> +<td class='online-navigation'><a rel="parent" title="6.2 Using the Exim" + href="node16.html"><img src='up.png' + border='0' height='32' alt='Up One Level' width='32' /></A></td> +<td class='online-navigation'><a rel="next" title="6.2.3 Transport for Exim" + href="exim3-transport.html"><img src='next.png' + border='0' height='32' alt='Next Page' width='32' /></A></td> +<td align="center" width="100%">GNU Mailman - Installation Manual</td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +</tr></table> +<div class='online-navigation'> +<b class="navlabel">Previous:</b> +<a class="sectref" rel="prev" href="node17.html">6.2.1 Exim configuration</A> +<b class="navlabel">Up:</b> +<a class="sectref" rel="parent" href="node16.html">6.2 Using the Exim</A> +<b class="navlabel">Next:</b> +<a class="sectref" rel="next" href="exim3-transport.html">6.2.3 Transport for Exim</A> +</div> +</div> +<hr /> +<span class="release-info">Release 2.1, documentation updated on December 13, 2004.</span> +</DIV> +<!--End of Navigation Panel--> + +</BODY> +</HTML> diff --git a/admin/www/mailman-install/node2.html b/admin/www/mailman-install/node2.html new file mode 100644 index 00000000..03cd22ae --- /dev/null +++ b/admin/www/mailman-install/node2.html @@ -0,0 +1,122 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> +<html> +<head> +<link rel="STYLESHEET" href="mailman-install.css" type='text/css' /> +<link rel="first" href="mailman-install.html" title='GNU Mailman - Installation Manual' /> +<link rel='last' href='about.html' title='About this document...' /> +<link rel='help' href='about.html' title='About this document...' /> +<link rel="next" href="node3.html" /> +<link rel="prev" href="front.html" /> +<link rel="parent" href="front.html" /> +<link rel="next" href="node3.html" /> +<meta name='aesop' content='information' /> +<title>1 Installation Requirements</title> +</head> +<body> +<DIV CLASS="navigation"> +<div id='top-navigation-panel' xml:id='top-navigation-panel'> +<table align="center" width="100%" cellpadding="0" cellspacing="2"> +<tr> +<td class='online-navigation'><a rel="prev" title="Front Matter" + href="front.html"><img src='previous.png' + border='0' height='32' alt='Previous Page' width='32' /></A></td> +<td class='online-navigation'><a rel="parent" title="Front Matter" + href="front.html"><img src='up.png' + border='0' height='32' alt='Up One Level' width='32' /></A></td> +<td class='online-navigation'><a rel="next" title="2 Set up your" + href="node3.html"><img src='next.png' + border='0' height='32' alt='Next Page' width='32' /></A></td> +<td align="center" width="100%">GNU Mailman - Installation Manual</td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +</tr></table> +<div class='online-navigation'> +<b class="navlabel">Previous:</b> +<a class="sectref" rel="prev" href="front.html">Front Matter</A> +<b class="navlabel">Up:</b> +<a class="sectref" rel="parent" href="front.html">Front Matter</A> +<b class="navlabel">Next:</b> +<a class="sectref" rel="next" href="node3.html">2 Set up your</A> +</div> +<hr /></div> +</DIV> +<!--End of Navigation Panel--> + +<H1><A NAME="SECTION001100000000000000000"> +1 Installation Requirements</A> +</H1> + +<P> +GNU Mailman works on most POSIX-based systems such as <span class="Unix">Unix</span>, MacOSX, or +GNU/Linux. It does not currently work on Windows. You must have a mail +server that you can send messages to, and a web server that supports the +CGI/1.1 API. <a class="ulink" href="http://httpd.apache.org" + >Apache</a> makes a fine choice for +web server, and mail servers such as +<a class="ulink" href="http://www.postfix.org" + >Postfix</a>, +<a class="ulink" href="http://www.exim.org" + >Exim</a>, +<a class="ulink" href="http://www.sendmail.org" + >Sendmail</a>, and +<a class="ulink" href="http://cr.yp.to/qmail.html" + >qmail</a> should +work just fine. + +<P> +To install Mailman from source, you will need an ANSI C compiler to build +Mailman's security wrappers. The +<a class="ulink" href="http://gcc.gnu.org" + >GNU C compiler gcc</a> 2.8.1 or later is known +to work well. + +<P> +You must have the <a class="ulink" href="http://www.python.org" + >Python</a> interpreter installed +somewhere on your system. Mailman 2.1 requires Python 2.1 or newer, although +Python 2.3 or newer is recommended. + +<P> + +<DIV CLASS="navigation"> +<div class='online-navigation'> +<p></p><hr /> +<table align="center" width="100%" cellpadding="0" cellspacing="2"> +<tr> +<td class='online-navigation'><a rel="prev" title="Front Matter" + href="front.html"><img src='previous.png' + border='0' height='32' alt='Previous Page' width='32' /></A></td> +<td class='online-navigation'><a rel="parent" title="Front Matter" + href="front.html"><img src='up.png' + border='0' height='32' alt='Up One Level' width='32' /></A></td> +<td class='online-navigation'><a rel="next" title="2 Set up your" + href="node3.html"><img src='next.png' + border='0' height='32' alt='Next Page' width='32' /></A></td> +<td align="center" width="100%">GNU Mailman - Installation Manual</td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +</tr></table> +<div class='online-navigation'> +<b class="navlabel">Previous:</b> +<a class="sectref" rel="prev" href="front.html">Front Matter</A> +<b class="navlabel">Up:</b> +<a class="sectref" rel="parent" href="front.html">Front Matter</A> +<b class="navlabel">Next:</b> +<a class="sectref" rel="next" href="node3.html">2 Set up your</A> +</div> +</div> +<hr /> +<span class="release-info">Release 2.1, documentation updated on December 13, 2004.</span> +</DIV> +<!--End of Navigation Panel--> + +</BODY> +</HTML> diff --git a/admin/www/mailman-install/node20.html b/admin/www/mailman-install/node20.html new file mode 100644 index 00000000..ebb49487 --- /dev/null +++ b/admin/www/mailman-install/node20.html @@ -0,0 +1,114 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> +<html> +<head> +<link rel="STYLESHEET" href="mailman-install.css" type='text/css' /> +<link rel="first" href="mailman-install.html" title='GNU Mailman - Installation Manual' /> +<link rel='last' href='about.html' title='About this document...' /> +<link rel='help' href='about.html' title='About this document...' /> +<link rel="next" href="node21.html" /> +<link rel="prev" href="exim3-transport.html" /> +<link rel="parent" href="node16.html" /> +<link rel="next" href="node21.html" /> +<meta name='aesop' content='information' /> +<title>6.2.4 Director for Exim 3</title> +</head> +<body> +<DIV CLASS="navigation"> +<div id='top-navigation-panel' xml:id='top-navigation-panel'> +<table align="center" width="100%" cellpadding="0" cellspacing="2"> +<tr> +<td class='online-navigation'><a rel="prev" title="6.2.3 Transport for Exim" + href="exim3-transport.html"><img src='previous.png' + border='0' height='32' alt='Previous Page' width='32' /></A></td> +<td class='online-navigation'><a rel="parent" title="6.2 Using the Exim" + href="node16.html"><img src='up.png' + border='0' height='32' alt='Up One Level' width='32' /></A></td> +<td class='online-navigation'><a rel="next" title="6.2.5 Router for Exim" + href="node21.html"><img src='next.png' + border='0' height='32' alt='Next Page' width='32' /></A></td> +<td align="center" width="100%">GNU Mailman - Installation Manual</td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +</tr></table> +<div class='online-navigation'> +<b class="navlabel">Previous:</b> +<a class="sectref" rel="prev" href="exim3-transport.html">6.2.3 Transport for Exim</A> +<b class="navlabel">Up:</b> +<a class="sectref" rel="parent" href="node16.html">6.2 Using the Exim</A> +<b class="navlabel">Next:</b> +<a class="sectref" rel="next" href="node21.html">6.2.5 Router for Exim</A> +</div> +<hr /></div> +</DIV> +<!--End of Navigation Panel--> + +<H3><A NAME="SECTION001624000000000000000"> +6.2.4 Director for Exim 3</A> +</H3> + +<P> +If you're using Exim 3, you'll need to add the following director to your +config file (directors go between the second and third ``end'' lines). Also, +don't forget that order matters - e.g. you can make Mailman lists take +precedence over system aliases by putting this director in front of your +aliasfile director, or vice-versa. + +<P> +<div class="verbatim"><pre> + # Handle all addresses related to a list 'foo': the posting address. + # Automatically detects list existence by looking + # for lists/$local_part/config.pck under MAILMAN_HOME. + mailman_director: + driver = smartuser + require_files = MAILMAN_HOME/lists/$local_part/config.pck + suffix_optional + suffix = -bounces : -bounces+* : \ + -confirm+* : -join : -leave : \ + -owner : -request : -admin + transport = mailman_transport +</pre></div> + +<P> + +<DIV CLASS="navigation"> +<div class='online-navigation'> +<p></p><hr /> +<table align="center" width="100%" cellpadding="0" cellspacing="2"> +<tr> +<td class='online-navigation'><a rel="prev" title="6.2.3 Transport for Exim" + href="exim3-transport.html"><img src='previous.png' + border='0' height='32' alt='Previous Page' width='32' /></A></td> +<td class='online-navigation'><a rel="parent" title="6.2 Using the Exim" + href="node16.html"><img src='up.png' + border='0' height='32' alt='Up One Level' width='32' /></A></td> +<td class='online-navigation'><a rel="next" title="6.2.5 Router for Exim" + href="node21.html"><img src='next.png' + border='0' height='32' alt='Next Page' width='32' /></A></td> +<td align="center" width="100%">GNU Mailman - Installation Manual</td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +</tr></table> +<div class='online-navigation'> +<b class="navlabel">Previous:</b> +<a class="sectref" rel="prev" href="exim3-transport.html">6.2.3 Transport for Exim</A> +<b class="navlabel">Up:</b> +<a class="sectref" rel="parent" href="node16.html">6.2 Using the Exim</A> +<b class="navlabel">Next:</b> +<a class="sectref" rel="next" href="node21.html">6.2.5 Router for Exim</A> +</div> +</div> +<hr /> +<span class="release-info">Release 2.1, documentation updated on December 13, 2004.</span> +</DIV> +<!--End of Navigation Panel--> + +</BODY> +</HTML> diff --git a/admin/www/mailman-install/node21.html b/admin/www/mailman-install/node21.html new file mode 100644 index 00000000..435220f4 --- /dev/null +++ b/admin/www/mailman-install/node21.html @@ -0,0 +1,111 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> +<html> +<head> +<link rel="STYLESHEET" href="mailman-install.css" type='text/css' /> +<link rel="first" href="mailman-install.html" title='GNU Mailman - Installation Manual' /> +<link rel='last' href='about.html' title='About this document...' /> +<link rel='help' href='about.html' title='About this document...' /> +<link rel="next" href="node22.html" /> +<link rel="prev" href="node20.html" /> +<link rel="parent" href="node16.html" /> +<link rel="next" href="node22.html" /> +<meta name='aesop' content='information' /> +<title>6.2.5 Router for Exim 4</title> +</head> +<body> +<DIV CLASS="navigation"> +<div id='top-navigation-panel' xml:id='top-navigation-panel'> +<table align="center" width="100%" cellpadding="0" cellspacing="2"> +<tr> +<td class='online-navigation'><a rel="prev" title="6.2.4 Director for Exim" + href="node20.html"><img src='previous.png' + border='0' height='32' alt='Previous Page' width='32' /></A></td> +<td class='online-navigation'><a rel="parent" title="6.2 Using the Exim" + href="node16.html"><img src='up.png' + border='0' height='32' alt='Up One Level' width='32' /></A></td> +<td class='online-navigation'><a rel="next" title="6.2.6 Transports for Exim" + href="node22.html"><img src='next.png' + border='0' height='32' alt='Next Page' width='32' /></A></td> +<td align="center" width="100%">GNU Mailman - Installation Manual</td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +</tr></table> +<div class='online-navigation'> +<b class="navlabel">Previous:</b> +<a class="sectref" rel="prev" href="node20.html">6.2.4 Director for Exim</A> +<b class="navlabel">Up:</b> +<a class="sectref" rel="parent" href="node16.html">6.2 Using the Exim</A> +<b class="navlabel">Next:</b> +<a class="sectref" rel="next" href="node22.html">6.2.6 Transports for Exim</A> +</div> +<hr /></div> +</DIV> +<!--End of Navigation Panel--> + +<H3><A NAME="SECTION001625000000000000000"> +6.2.5 Router for Exim 4</A> +</H3> + +<P> +In Exim 4, there's no such thing as directors - you need to add a new router +instead. Also, the canonical order of the configuration file was changed so +routers come before transports, so the router for Exim 4 comes first here. +Put this router somewhere after the ``begin routers'' line of your config +file, and remember that order matters. + +<P> +<div class="verbatim"><pre> + mailman_router: + driver = accept + require_files = MAILMAN_HOME/lists/$local_part/config.pck + local_part_suffix_optional + local_part_suffix = -bounces : -bounces+* : \ + -confirm+* : -join : -leave : \ + -owner : -request : -admin + transport = mailman_transport +</pre></div> + +<P> + +<DIV CLASS="navigation"> +<div class='online-navigation'> +<p></p><hr /> +<table align="center" width="100%" cellpadding="0" cellspacing="2"> +<tr> +<td class='online-navigation'><a rel="prev" title="6.2.4 Director for Exim" + href="node20.html"><img src='previous.png' + border='0' height='32' alt='Previous Page' width='32' /></A></td> +<td class='online-navigation'><a rel="parent" title="6.2 Using the Exim" + href="node16.html"><img src='up.png' + border='0' height='32' alt='Up One Level' width='32' /></A></td> +<td class='online-navigation'><a rel="next" title="6.2.6 Transports for Exim" + href="node22.html"><img src='next.png' + border='0' height='32' alt='Next Page' width='32' /></A></td> +<td align="center" width="100%">GNU Mailman - Installation Manual</td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +</tr></table> +<div class='online-navigation'> +<b class="navlabel">Previous:</b> +<a class="sectref" rel="prev" href="node20.html">6.2.4 Director for Exim</A> +<b class="navlabel">Up:</b> +<a class="sectref" rel="parent" href="node16.html">6.2 Using the Exim</A> +<b class="navlabel">Next:</b> +<a class="sectref" rel="next" href="node22.html">6.2.6 Transports for Exim</A> +</div> +</div> +<hr /> +<span class="release-info">Release 2.1, documentation updated on December 13, 2004.</span> +</DIV> +<!--End of Navigation Panel--> + +</BODY> +</HTML> diff --git a/admin/www/mailman-install/node22.html b/admin/www/mailman-install/node22.html new file mode 100644 index 00000000..e3a93a50 --- /dev/null +++ b/admin/www/mailman-install/node22.html @@ -0,0 +1,97 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> +<html> +<head> +<link rel="STYLESHEET" href="mailman-install.css" type='text/css' /> +<link rel="first" href="mailman-install.html" title='GNU Mailman - Installation Manual' /> +<link rel='last' href='about.html' title='About this document...' /> +<link rel='help' href='about.html' title='About this document...' /> +<link rel="next" href="node23.html" /> +<link rel="prev" href="node21.html" /> +<link rel="parent" href="node16.html" /> +<link rel="next" href="node23.html" /> +<meta name='aesop' content='information' /> +<title>6.2.6 Transports for Exim 4</title> +</head> +<body> +<DIV CLASS="navigation"> +<div id='top-navigation-panel' xml:id='top-navigation-panel'> +<table align="center" width="100%" cellpadding="0" cellspacing="2"> +<tr> +<td class='online-navigation'><a rel="prev" title="6.2.5 Router for Exim" + href="node21.html"><img src='previous.png' + border='0' height='32' alt='Previous Page' width='32' /></A></td> +<td class='online-navigation'><a rel="parent" title="6.2 Using the Exim" + href="node16.html"><img src='up.png' + border='0' height='32' alt='Up One Level' width='32' /></A></td> +<td class='online-navigation'><a rel="next" title="6.2.7 Additional notes" + href="node23.html"><img src='next.png' + border='0' height='32' alt='Next Page' width='32' /></A></td> +<td align="center" width="100%">GNU Mailman - Installation Manual</td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +</tr></table> +<div class='online-navigation'> +<b class="navlabel">Previous:</b> +<a class="sectref" rel="prev" href="node21.html">6.2.5 Router for Exim</A> +<b class="navlabel">Up:</b> +<a class="sectref" rel="parent" href="node16.html">6.2 Using the Exim</A> +<b class="navlabel">Next:</b> +<a class="sectref" rel="next" href="node23.html">6.2.7 Additional notes</A> +</div> +<hr /></div> +</DIV> +<!--End of Navigation Panel--> + +<H3><A NAME="SECTION001626000000000000000"> +6.2.6 Transports for Exim 4</A> +</H3> + +<P> +The transport for Exim 4 is the same as for Exim 3 (see <A href="exim3-transport.html#exim3-transport">6.2</A>; +just copy the transport given above to somewhere under the ``begin +transports'' line of your Exim config file. + +<P> + +<DIV CLASS="navigation"> +<div class='online-navigation'> +<p></p><hr /> +<table align="center" width="100%" cellpadding="0" cellspacing="2"> +<tr> +<td class='online-navigation'><a rel="prev" title="6.2.5 Router for Exim" + href="node21.html"><img src='previous.png' + border='0' height='32' alt='Previous Page' width='32' /></A></td> +<td class='online-navigation'><a rel="parent" title="6.2 Using the Exim" + href="node16.html"><img src='up.png' + border='0' height='32' alt='Up One Level' width='32' /></A></td> +<td class='online-navigation'><a rel="next" title="6.2.7 Additional notes" + href="node23.html"><img src='next.png' + border='0' height='32' alt='Next Page' width='32' /></A></td> +<td align="center" width="100%">GNU Mailman - Installation Manual</td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +</tr></table> +<div class='online-navigation'> +<b class="navlabel">Previous:</b> +<a class="sectref" rel="prev" href="node21.html">6.2.5 Router for Exim</A> +<b class="navlabel">Up:</b> +<a class="sectref" rel="parent" href="node16.html">6.2 Using the Exim</A> +<b class="navlabel">Next:</b> +<a class="sectref" rel="next" href="node23.html">6.2.7 Additional notes</A> +</div> +</div> +<hr /> +<span class="release-info">Release 2.1, documentation updated on December 13, 2004.</span> +</DIV> +<!--End of Navigation Panel--> + +</BODY> +</HTML> diff --git a/admin/www/mailman-install/node23.html b/admin/www/mailman-install/node23.html new file mode 100644 index 00000000..249408e0 --- /dev/null +++ b/admin/www/mailman-install/node23.html @@ -0,0 +1,101 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> +<html> +<head> +<link rel="STYLESHEET" href="mailman-install.css" type='text/css' /> +<link rel="first" href="mailman-install.html" title='GNU Mailman - Installation Manual' /> +<link rel='last' href='about.html' title='About this document...' /> +<link rel='help' href='about.html' title='About this document...' /> +<link rel="next" href="node24.html" /> +<link rel="prev" href="node22.html" /> +<link rel="parent" href="node16.html" /> +<link rel="next" href="node24.html" /> +<meta name='aesop' content='information' /> +<title>6.2.7 Additional notes</title> +</head> +<body> +<DIV CLASS="navigation"> +<div id='top-navigation-panel' xml:id='top-navigation-panel'> +<table align="center" width="100%" cellpadding="0" cellspacing="2"> +<tr> +<td class='online-navigation'><a rel="prev" title="6.2.6 Transports for Exim" + href="node22.html"><img src='previous.png' + border='0' height='32' alt='Previous Page' width='32' /></A></td> +<td class='online-navigation'><a rel="parent" title="6.2 Using the Exim" + href="node16.html"><img src='up.png' + border='0' height='32' alt='Up One Level' width='32' /></A></td> +<td class='online-navigation'><a rel="next" title="6.2.8 Problems" + href="node24.html"><img src='next.png' + border='0' height='32' alt='Next Page' width='32' /></A></td> +<td align="center" width="100%">GNU Mailman - Installation Manual</td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +</tr></table> +<div class='online-navigation'> +<b class="navlabel">Previous:</b> +<a class="sectref" rel="prev" href="node22.html">6.2.6 Transports for Exim</A> +<b class="navlabel">Up:</b> +<a class="sectref" rel="parent" href="node16.html">6.2 Using the Exim</A> +<b class="navlabel">Next:</b> +<a class="sectref" rel="next" href="node24.html">6.2.8 Problems</A> +</div> +<hr /></div> +</DIV> +<!--End of Navigation Panel--> + +<H3><A NAME="SECTION001627000000000000000"> +6.2.7 Additional notes</A> +</H3> + +<P> +Exim should be configured to allow reasonable volume - e.g. don't set +<var>max_recipients</var> down to a silly value - and with normal degrees of +security - specifically, be sure to allow relaying from 127.0.0.1, but pretty +much nothing else. Parallel deliveries and other tweaks can also be used if +you like; experiment with your setup to see what works. Delay warning +messages should be switched off or configured to only happen for non-list +mail, unless you like receiving tons of mail when some random host is down. + +<P> + +<DIV CLASS="navigation"> +<div class='online-navigation'> +<p></p><hr /> +<table align="center" width="100%" cellpadding="0" cellspacing="2"> +<tr> +<td class='online-navigation'><a rel="prev" title="6.2.6 Transports for Exim" + href="node22.html"><img src='previous.png' + border='0' height='32' alt='Previous Page' width='32' /></A></td> +<td class='online-navigation'><a rel="parent" title="6.2 Using the Exim" + href="node16.html"><img src='up.png' + border='0' height='32' alt='Up One Level' width='32' /></A></td> +<td class='online-navigation'><a rel="next" title="6.2.8 Problems" + href="node24.html"><img src='next.png' + border='0' height='32' alt='Next Page' width='32' /></A></td> +<td align="center" width="100%">GNU Mailman - Installation Manual</td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +</tr></table> +<div class='online-navigation'> +<b class="navlabel">Previous:</b> +<a class="sectref" rel="prev" href="node22.html">6.2.6 Transports for Exim</A> +<b class="navlabel">Up:</b> +<a class="sectref" rel="parent" href="node16.html">6.2 Using the Exim</A> +<b class="navlabel">Next:</b> +<a class="sectref" rel="next" href="node24.html">6.2.8 Problems</A> +</div> +</div> +<hr /> +<span class="release-info">Release 2.1, documentation updated on December 13, 2004.</span> +</DIV> +<!--End of Navigation Panel--> + +</BODY> +</HTML> diff --git a/admin/www/mailman-install/node24.html b/admin/www/mailman-install/node24.html new file mode 100644 index 00000000..c12a58fb --- /dev/null +++ b/admin/www/mailman-install/node24.html @@ -0,0 +1,127 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> +<html> +<head> +<link rel="STYLESHEET" href="mailman-install.css" type='text/css' /> +<link rel="first" href="mailman-install.html" title='GNU Mailman - Installation Manual' /> +<link rel='last' href='about.html' title='About this document...' /> +<link rel='help' href='about.html' title='About this document...' /> +<link rel="next" href="node25.html" /> +<link rel="prev" href="node23.html" /> +<link rel="parent" href="node16.html" /> +<link rel="next" href="node25.html" /> +<meta name='aesop' content='information' /> +<title>6.2.8 Problems</title> +</head> +<body> +<DIV CLASS="navigation"> +<div id='top-navigation-panel' xml:id='top-navigation-panel'> +<table align="center" width="100%" cellpadding="0" cellspacing="2"> +<tr> +<td class='online-navigation'><a rel="prev" title="6.2.7 Additional notes" + href="node23.html"><img src='previous.png' + border='0' height='32' alt='Previous Page' width='32' /></A></td> +<td class='online-navigation'><a rel="parent" title="6.2 Using the Exim" + href="node16.html"><img src='up.png' + border='0' height='32' alt='Up One Level' width='32' /></A></td> +<td class='online-navigation'><a rel="next" title="6.2.9 Receiver Verification" + href="node25.html"><img src='next.png' + border='0' height='32' alt='Next Page' width='32' /></A></td> +<td align="center" width="100%">GNU Mailman - Installation Manual</td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +</tr></table> +<div class='online-navigation'> +<b class="navlabel">Previous:</b> +<a class="sectref" rel="prev" href="node23.html">6.2.7 Additional notes</A> +<b class="navlabel">Up:</b> +<a class="sectref" rel="parent" href="node16.html">6.2 Using the Exim</A> +<b class="navlabel">Next:</b> +<a class="sectref" rel="next" href="node25.html">6.2.9 Receiver Verification</A> +</div> +<hr /></div> +</DIV> +<!--End of Navigation Panel--> + +<H3><A NAME="SECTION001628000000000000000"> +6.2.8 Problems</A> +</H3> + +<P> + +<UL> +<LI>Mailman will send as many <code>MAIL FROM</code>/<code>RCPT TO</code> as it needs. + It may result in more than 10 or 100 messages sent in one connection, + which will exceed the default value of Exim's + <var>smtp_accept_queue_per_connection</var> value. This is bad because it + will cause Exim to switch into queue mode and severely delay delivery of + your list messages. The way to fix this is to set Mailman's + <var>SMTP_MAX_SESSIONS_PER_CONNECTION</var> (in + <span class="file"><var>$prefix</var>/Mailman/mm_cfg.py</span>) to a smaller value than Exim's + <var>smtp_accept_queue_per_connection</var>. + +<P> +</LI> +<LI>Mailman should ignore Exim delay warning messages, even though Exim + should never send this to list messages. Mailman 2.1's general bounce + detection and VERP support should greatly improve the bounce detector's + hit rates. + +<P> +</LI> +<LI>List existence is determined by the existence of a <span class="file">config.pck</span> + file for a list. If you delete lists by foul means, be aware of this. + +<P> +</LI> +<LI>If you are getting Exim or Mailman complaining about user ids when you + send mail to a list, check that the <var>MAILMAN_USER</var> and + <var>MAILMAN_GROUP</var> match those of Mailman itself (i.e. what were used + in the <b class="program">configure</b> script). Also make sure you do not have + aliases in the main alias file for the list. +</LI> +</UL> + +<P> + +<DIV CLASS="navigation"> +<div class='online-navigation'> +<p></p><hr /> +<table align="center" width="100%" cellpadding="0" cellspacing="2"> +<tr> +<td class='online-navigation'><a rel="prev" title="6.2.7 Additional notes" + href="node23.html"><img src='previous.png' + border='0' height='32' alt='Previous Page' width='32' /></A></td> +<td class='online-navigation'><a rel="parent" title="6.2 Using the Exim" + href="node16.html"><img src='up.png' + border='0' height='32' alt='Up One Level' width='32' /></A></td> +<td class='online-navigation'><a rel="next" title="6.2.9 Receiver Verification" + href="node25.html"><img src='next.png' + border='0' height='32' alt='Next Page' width='32' /></A></td> +<td align="center" width="100%">GNU Mailman - Installation Manual</td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +</tr></table> +<div class='online-navigation'> +<b class="navlabel">Previous:</b> +<a class="sectref" rel="prev" href="node23.html">6.2.7 Additional notes</A> +<b class="navlabel">Up:</b> +<a class="sectref" rel="parent" href="node16.html">6.2 Using the Exim</A> +<b class="navlabel">Next:</b> +<a class="sectref" rel="next" href="node25.html">6.2.9 Receiver Verification</A> +</div> +</div> +<hr /> +<span class="release-info">Release 2.1, documentation updated on December 13, 2004.</span> +</DIV> +<!--End of Navigation Panel--> + +</BODY> +</HTML> diff --git a/admin/www/mailman-install/node25.html b/admin/www/mailman-install/node25.html new file mode 100644 index 00000000..ad16c524 --- /dev/null +++ b/admin/www/mailman-install/node25.html @@ -0,0 +1,134 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> +<html> +<head> +<link rel="STYLESHEET" href="mailman-install.css" type='text/css' /> +<link rel="first" href="mailman-install.html" title='GNU Mailman - Installation Manual' /> +<link rel='last' href='about.html' title='About this document...' /> +<link rel='help' href='about.html' title='About this document...' /> +<link rel="next" href="node26.html" /> +<link rel="prev" href="node24.html" /> +<link rel="parent" href="node16.html" /> +<link rel="next" href="node26.html" /> +<meta name='aesop' content='information' /> +<title>6.2.9 Receiver Verification</title> +</head> +<body> +<DIV CLASS="navigation"> +<div id='top-navigation-panel' xml:id='top-navigation-panel'> +<table align="center" width="100%" cellpadding="0" cellspacing="2"> +<tr> +<td class='online-navigation'><a rel="prev" title="6.2.8 Problems" + href="node24.html"><img src='previous.png' + border='0' height='32' alt='Previous Page' width='32' /></A></td> +<td class='online-navigation'><a rel="parent" title="6.2 Using the Exim" + href="node16.html"><img src='up.png' + border='0' height='32' alt='Up One Level' width='32' /></A></td> +<td class='online-navigation'><a rel="next" title="6.2.10 SMTP Callback" + href="node26.html"><img src='next.png' + border='0' height='32' alt='Next Page' width='32' /></A></td> +<td align="center" width="100%">GNU Mailman - Installation Manual</td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +</tr></table> +<div class='online-navigation'> +<b class="navlabel">Previous:</b> +<a class="sectref" rel="prev" href="node24.html">6.2.8 Problems</A> +<b class="navlabel">Up:</b> +<a class="sectref" rel="parent" href="node16.html">6.2 Using the Exim</A> +<b class="navlabel">Next:</b> +<a class="sectref" rel="next" href="node26.html">6.2.10 SMTP Callback</A> +</div> +<hr /></div> +</DIV> +<!--End of Navigation Panel--> + +<H3><A NAME="SECTION001629000000000000000"> +6.2.9 Receiver Verification</A> +</H3> + +<P> +Exim's receiver verification feature is very useful - it lets Exim reject +unrouteable addresses at SMTP time. However, this is most useful for +externally-originating mail that is addressed to mail in one of your local +domains. For Mailman list traffic, mail originates on your server, and is +addressed to random external domains that are not under your control. +Furthermore, each message is addressed to many recipients +- up to 500 if you use Mailman's default configuration and don't tweak +<var>SMTP_MAX_RCPTS</var>. + +<P> +Doing receiver verification on Mailman list traffic is a recipe for trouble. +In particular, Exim will attempt to route every recipient addresses in +outgoing Mailman list posts. Even though this requires nothing more than a +few DNS lookups for each address, it can still introduce significant delays. +Therefore, you should disable recipient verification for Mailman traffic. + +<P> +Under Exim 3, put this in your main configuration section: + +<P> +<div class="verbatim"><pre> + receiver_verify_hosts = !127.0.0.1 +</pre></div> + +<P> +Under Exim 4, this is probably already taken care of for you by the default +recipient verification ACL statement (in the <code>RCPT TO</code> ACL): + +<P> +<div class="verbatim"><pre> + accept domains = +local_domains + endpass + message = unknown user + verify = recipient +</pre></div> + +<P> +which only does recipient verification on addresses in your domain. (That's +not exactly the same as doing recipient verification only on messages coming +from non-127.0.0.1 hosts, but it should do the trick for Mailman.) + +<P> + +<DIV CLASS="navigation"> +<div class='online-navigation'> +<p></p><hr /> +<table align="center" width="100%" cellpadding="0" cellspacing="2"> +<tr> +<td class='online-navigation'><a rel="prev" title="6.2.8 Problems" + href="node24.html"><img src='previous.png' + border='0' height='32' alt='Previous Page' width='32' /></A></td> +<td class='online-navigation'><a rel="parent" title="6.2 Using the Exim" + href="node16.html"><img src='up.png' + border='0' height='32' alt='Up One Level' width='32' /></A></td> +<td class='online-navigation'><a rel="next" title="6.2.10 SMTP Callback" + href="node26.html"><img src='next.png' + border='0' height='32' alt='Next Page' width='32' /></A></td> +<td align="center" width="100%">GNU Mailman - Installation Manual</td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +</tr></table> +<div class='online-navigation'> +<b class="navlabel">Previous:</b> +<a class="sectref" rel="prev" href="node24.html">6.2.8 Problems</A> +<b class="navlabel">Up:</b> +<a class="sectref" rel="parent" href="node16.html">6.2 Using the Exim</A> +<b class="navlabel">Next:</b> +<a class="sectref" rel="next" href="node26.html">6.2.10 SMTP Callback</A> +</div> +</div> +<hr /> +<span class="release-info">Release 2.1, documentation updated on December 13, 2004.</span> +</DIV> +<!--End of Navigation Panel--> + +</BODY> +</HTML> diff --git a/admin/www/mailman-install/node26.html b/admin/www/mailman-install/node26.html new file mode 100644 index 00000000..68ca1212 --- /dev/null +++ b/admin/www/mailman-install/node26.html @@ -0,0 +1,139 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> +<html> +<head> +<link rel="STYLESHEET" href="mailman-install.css" type='text/css' /> +<link rel="first" href="mailman-install.html" title='GNU Mailman - Installation Manual' /> +<link rel='last' href='about.html' title='About this document...' /> +<link rel='help' href='about.html' title='About this document...' /> +<link rel="next" href="node27.html" /> +<link rel="prev" href="node25.html" /> +<link rel="parent" href="node16.html" /> +<link rel="next" href="node27.html" /> +<meta name='aesop' content='information' /> +<title>6.2.10 SMTP Callback</title> +</head> +<body> +<DIV CLASS="navigation"> +<div id='top-navigation-panel' xml:id='top-navigation-panel'> +<table align="center" width="100%" cellpadding="0" cellspacing="2"> +<tr> +<td class='online-navigation'><a rel="prev" title="6.2.9 Receiver Verification" + href="node25.html"><img src='previous.png' + border='0' height='32' alt='Previous Page' width='32' /></A></td> +<td class='online-navigation'><a rel="parent" title="6.2 Using the Exim" + href="node16.html"><img src='up.png' + border='0' height='32' alt='Up One Level' width='32' /></A></td> +<td class='online-navigation'><a rel="next" title="6.2.11 Doing VERP with" + href="node27.html"><img src='next.png' + border='0' height='32' alt='Next Page' width='32' /></A></td> +<td align="center" width="100%">GNU Mailman - Installation Manual</td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +</tr></table> +<div class='online-navigation'> +<b class="navlabel">Previous:</b> +<a class="sectref" rel="prev" href="node25.html">6.2.9 Receiver Verification</A> +<b class="navlabel">Up:</b> +<a class="sectref" rel="parent" href="node16.html">6.2 Using the Exim</A> +<b class="navlabel">Next:</b> +<a class="sectref" rel="next" href="node27.html">6.2.11 Doing VERP with</A> +</div> +<hr /></div> +</DIV> +<!--End of Navigation Panel--> + +<H3><A NAME="SECTION0016210000000000000000"> +6.2.10 SMTP Callback</A> +</H3> + +<P> +Exim's SMTP callback feature is an even more powerful way to detect bogus +sender addresses than normal sender verification. Unfortunately, lots of +servers send bounce messages with a bogus address in the header, and there are +plenty that send bounces with bogus envelope senders (even though they're +supposed to just use an empty envelope sender for bounces). + +<P> +In order to ensure that Mailman can disable/remove bouncing addresses, you +generally want to receive bounces for Mailman lists, even if those bounces are +themselves not bounceable. Thus, you might want to disable SMTP callback on +bounce messages. + +<P> +With Exim 4, you can accomplish this using something like the following in +your <code>RCPT TO</code> ACL: + +<P> +<div class="verbatim"><pre> + # Accept bounces to lists even if callbacks or other checks would fail + warn message = X-WhitelistedRCPT-nohdrfromcallback: Yes + condition = \ + ${if and {{match{$local_part}{(.*)-bounces\+.*}} \ + {exists {MAILMAN_HOME/lists/$1/config.pck}}} \ + {yes}{no}} + {yes}{no}} + + accept condition = \ + ${if and {{match{$local_part}{(.*)-bounces\+.*}} \ + {exists {MAILMAN_HOME/lists/$1/config.pck}}} \ + {yes}{no}} + {yes}{no}} + + # Now, check sender address with SMTP callback. + deny !verify = sender/callout=90s +</pre></div> + +<P> +If you also do SMTP callbacks on header addresses, you'll want something like +this in your <code>DATA</code> ACL: + +<P> +<div class="verbatim"><pre> + deny !condition = $header_X-WhitelistedRCPT-nohdrfromcallback: + !verify = header_sender/callout=90s +</pre></div> + +<P> + +<DIV CLASS="navigation"> +<div class='online-navigation'> +<p></p><hr /> +<table align="center" width="100%" cellpadding="0" cellspacing="2"> +<tr> +<td class='online-navigation'><a rel="prev" title="6.2.9 Receiver Verification" + href="node25.html"><img src='previous.png' + border='0' height='32' alt='Previous Page' width='32' /></A></td> +<td class='online-navigation'><a rel="parent" title="6.2 Using the Exim" + href="node16.html"><img src='up.png' + border='0' height='32' alt='Up One Level' width='32' /></A></td> +<td class='online-navigation'><a rel="next" title="6.2.11 Doing VERP with" + href="node27.html"><img src='next.png' + border='0' height='32' alt='Next Page' width='32' /></A></td> +<td align="center" width="100%">GNU Mailman - Installation Manual</td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +</tr></table> +<div class='online-navigation'> +<b class="navlabel">Previous:</b> +<a class="sectref" rel="prev" href="node25.html">6.2.9 Receiver Verification</A> +<b class="navlabel">Up:</b> +<a class="sectref" rel="parent" href="node16.html">6.2 Using the Exim</A> +<b class="navlabel">Next:</b> +<a class="sectref" rel="next" href="node27.html">6.2.11 Doing VERP with</A> +</div> +</div> +<hr /> +<span class="release-info">Release 2.1, documentation updated on December 13, 2004.</span> +</DIV> +<!--End of Navigation Panel--> + +</BODY> +</HTML> diff --git a/admin/www/mailman-install/node27.html b/admin/www/mailman-install/node27.html new file mode 100644 index 00000000..a66dc0fe --- /dev/null +++ b/admin/www/mailman-install/node27.html @@ -0,0 +1,109 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> +<html> +<head> +<link rel="STYLESHEET" href="mailman-install.css" type='text/css' /> +<link rel="first" href="mailman-install.html" title='GNU Mailman - Installation Manual' /> +<link rel='last' href='about.html' title='About this document...' /> +<link rel='help' href='about.html' title='About this document...' /> +<link rel="next" href="node28.html" /> +<link rel="prev" href="node26.html" /> +<link rel="parent" href="node16.html" /> +<link rel="next" href="node28.html" /> +<meta name='aesop' content='information' /> +<title>6.2.11 Doing VERP with Exim and Mailman</title> +</head> +<body> +<DIV CLASS="navigation"> +<div id='top-navigation-panel' xml:id='top-navigation-panel'> +<table align="center" width="100%" cellpadding="0" cellspacing="2"> +<tr> +<td class='online-navigation'><a rel="prev" title="6.2.10 SMTP Callback" + href="node26.html"><img src='previous.png' + border='0' height='32' alt='Previous Page' width='32' /></A></td> +<td class='online-navigation'><a rel="parent" title="6.2 Using the Exim" + href="node16.html"><img src='up.png' + border='0' height='32' alt='Up One Level' width='32' /></A></td> +<td class='online-navigation'><a rel="next" title="6.2.12 Virtual Domains" + href="node28.html"><img src='next.png' + border='0' height='32' alt='Next Page' width='32' /></A></td> +<td align="center" width="100%">GNU Mailman - Installation Manual</td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +</tr></table> +<div class='online-navigation'> +<b class="navlabel">Previous:</b> +<a class="sectref" rel="prev" href="node26.html">6.2.10 SMTP Callback</A> +<b class="navlabel">Up:</b> +<a class="sectref" rel="parent" href="node16.html">6.2 Using the Exim</A> +<b class="navlabel">Next:</b> +<a class="sectref" rel="next" href="node28.html">6.2.12 Virtual Domains</A> +</div> +<hr /></div> +</DIV> +<!--End of Navigation Panel--> + +<H3><A NAME="SECTION0016211000000000000000"> +6.2.11 Doing VERP with Exim and Mailman</A> +</H3> + +<P> +VERP will send one email, with a separate envelope sender (return path), for +each of your subscribers - read the information in +<span class="file"><var>$prefix</var>/Mailman/Default.py</span> for the options that start with VERP. +In a nutshell, all you need to do to enable VERP with Exim is to add these lines to <span class="file"><var>$prefix</var>/Mailman/mm_cfg.py</span>: + +<P> +<div class="verbatim"><pre> + VERP_PASSWORD_REMINDERS = Yes + VERP_PERSONALIZED_DELIVERIES = Yes + VERP_DELIVERY_INTERVAL = Yes + VERP_CONFIRMATIONS = Yes +</pre></div> + +<P> +(The director (router) above is smart enough to deal with VERP bounces.) + +<P> + +<DIV CLASS="navigation"> +<div class='online-navigation'> +<p></p><hr /> +<table align="center" width="100%" cellpadding="0" cellspacing="2"> +<tr> +<td class='online-navigation'><a rel="prev" title="6.2.10 SMTP Callback" + href="node26.html"><img src='previous.png' + border='0' height='32' alt='Previous Page' width='32' /></A></td> +<td class='online-navigation'><a rel="parent" title="6.2 Using the Exim" + href="node16.html"><img src='up.png' + border='0' height='32' alt='Up One Level' width='32' /></A></td> +<td class='online-navigation'><a rel="next" title="6.2.12 Virtual Domains" + href="node28.html"><img src='next.png' + border='0' height='32' alt='Next Page' width='32' /></A></td> +<td align="center" width="100%">GNU Mailman - Installation Manual</td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +</tr></table> +<div class='online-navigation'> +<b class="navlabel">Previous:</b> +<a class="sectref" rel="prev" href="node26.html">6.2.10 SMTP Callback</A> +<b class="navlabel">Up:</b> +<a class="sectref" rel="parent" href="node16.html">6.2 Using the Exim</A> +<b class="navlabel">Next:</b> +<a class="sectref" rel="next" href="node28.html">6.2.12 Virtual Domains</A> +</div> +</div> +<hr /> +<span class="release-info">Release 2.1, documentation updated on December 13, 2004.</span> +</DIV> +<!--End of Navigation Panel--> + +</BODY> +</HTML> diff --git a/admin/www/mailman-install/node28.html b/admin/www/mailman-install/node28.html new file mode 100644 index 00000000..3148a7b0 --- /dev/null +++ b/admin/www/mailman-install/node28.html @@ -0,0 +1,121 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> +<html> +<head> +<link rel="STYLESHEET" href="mailman-install.css" type='text/css' /> +<link rel="first" href="mailman-install.html" title='GNU Mailman - Installation Manual' /> +<link rel='last' href='about.html' title='About this document...' /> +<link rel='help' href='about.html' title='About this document...' /> +<link rel="next" href="node29.html" /> +<link rel="prev" href="node27.html" /> +<link rel="parent" href="node16.html" /> +<link rel="next" href="node29.html" /> +<meta name='aesop' content='information' /> +<title>6.2.12 Virtual Domains</title> +</head> +<body> +<DIV CLASS="navigation"> +<div id='top-navigation-panel' xml:id='top-navigation-panel'> +<table align="center" width="100%" cellpadding="0" cellspacing="2"> +<tr> +<td class='online-navigation'><a rel="prev" title="6.2.11 Doing VERP with" + href="node27.html"><img src='previous.png' + border='0' height='32' alt='Previous Page' width='32' /></A></td> +<td class='online-navigation'><a rel="parent" title="6.2 Using the Exim" + href="node16.html"><img src='up.png' + border='0' height='32' alt='Up One Level' width='32' /></A></td> +<td class='online-navigation'><a rel="next" title="6.2.13 List Verification" + href="node29.html"><img src='next.png' + border='0' height='32' alt='Next Page' width='32' /></A></td> +<td align="center" width="100%">GNU Mailman - Installation Manual</td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +</tr></table> +<div class='online-navigation'> +<b class="navlabel">Previous:</b> +<a class="sectref" rel="prev" href="node27.html">6.2.11 Doing VERP with</A> +<b class="navlabel">Up:</b> +<a class="sectref" rel="parent" href="node16.html">6.2 Using the Exim</A> +<b class="navlabel">Next:</b> +<a class="sectref" rel="next" href="node29.html">6.2.13 List Verification</A> +</div> +<hr /></div> +</DIV> +<!--End of Navigation Panel--> + +<H3><A NAME="SECTION0016212000000000000000"> +6.2.12 Virtual Domains</A> +</H3> + +<P> +One approach to handling virtual domains is to use a separate Mailman +installation for each virtual domain. Currently, this is the only way to have +lists with the same name in different virtual domains handled by the same +machine. + +<P> +In this case, the <var>MAILMAN_HOME</var> and <var>MAILMAN_WRAP</var> macros are useless +- you can remove them. Change your director (router) to something like this: + +<P> +<div class="verbatim"><pre> + require_files = /virtual/${domain}/mailman/lists/${lc:$local_part}/config.pck +</pre></div> + +<P> +and change your transport like this: + +<P> +<div class="verbatim"><pre> + command = /virtual/${domain}/mailman/mail/mailman \ + ${if def:local_part_suffix \ + {${sg{$local_part_suffix}{-(\\w+)(\\+.*)?}{\$1}}} + {post}} \ + $local_part + current_directory = /virtual/${domain}/mailman + home_directory = /virtual/${domain}/mailman +</pre></div> + +<P> + +<DIV CLASS="navigation"> +<div class='online-navigation'> +<p></p><hr /> +<table align="center" width="100%" cellpadding="0" cellspacing="2"> +<tr> +<td class='online-navigation'><a rel="prev" title="6.2.11 Doing VERP with" + href="node27.html"><img src='previous.png' + border='0' height='32' alt='Previous Page' width='32' /></A></td> +<td class='online-navigation'><a rel="parent" title="6.2 Using the Exim" + href="node16.html"><img src='up.png' + border='0' height='32' alt='Up One Level' width='32' /></A></td> +<td class='online-navigation'><a rel="next" title="6.2.13 List Verification" + href="node29.html"><img src='next.png' + border='0' height='32' alt='Next Page' width='32' /></A></td> +<td align="center" width="100%">GNU Mailman - Installation Manual</td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +</tr></table> +<div class='online-navigation'> +<b class="navlabel">Previous:</b> +<a class="sectref" rel="prev" href="node27.html">6.2.11 Doing VERP with</A> +<b class="navlabel">Up:</b> +<a class="sectref" rel="parent" href="node16.html">6.2 Using the Exim</A> +<b class="navlabel">Next:</b> +<a class="sectref" rel="next" href="node29.html">6.2.13 List Verification</A> +</div> +</div> +<hr /> +<span class="release-info">Release 2.1, documentation updated on December 13, 2004.</span> +</DIV> +<!--End of Navigation Panel--> + +</BODY> +</HTML> diff --git a/admin/www/mailman-install/node29.html b/admin/www/mailman-install/node29.html new file mode 100644 index 00000000..bcf4d814 --- /dev/null +++ b/admin/www/mailman-install/node29.html @@ -0,0 +1,122 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> +<html> +<head> +<link rel="STYLESHEET" href="mailman-install.css" type='text/css' /> +<link rel="first" href="mailman-install.html" title='GNU Mailman - Installation Manual' /> +<link rel='last' href='about.html' title='About this document...' /> +<link rel='help' href='about.html' title='About this document...' /> +<link rel="next" href="node30.html" /> +<link rel="prev" href="node28.html" /> +<link rel="parent" href="node16.html" /> +<link rel="next" href="node30.html" /> +<meta name='aesop' content='information' /> +<title>6.2.13 List Verification</title> +</head> +<body> +<DIV CLASS="navigation"> +<div id='top-navigation-panel' xml:id='top-navigation-panel'> +<table align="center" width="100%" cellpadding="0" cellspacing="2"> +<tr> +<td class='online-navigation'><a rel="prev" title="6.2.12 Virtual Domains" + href="node28.html"><img src='previous.png' + border='0' height='32' alt='Previous Page' width='32' /></A></td> +<td class='online-navigation'><a rel="parent" title="6.2 Using the Exim" + href="node16.html"><img src='up.png' + border='0' height='32' alt='Up One Level' width='32' /></A></td> +<td class='online-navigation'><a rel="next" title="6.2.14 Document History" + href="node30.html"><img src='next.png' + border='0' height='32' alt='Next Page' width='32' /></A></td> +<td align="center" width="100%">GNU Mailman - Installation Manual</td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +</tr></table> +<div class='online-navigation'> +<b class="navlabel">Previous:</b> +<a class="sectref" rel="prev" href="node28.html">6.2.12 Virtual Domains</A> +<b class="navlabel">Up:</b> +<a class="sectref" rel="parent" href="node16.html">6.2 Using the Exim</A> +<b class="navlabel">Next:</b> +<a class="sectref" rel="next" href="node30.html">6.2.14 Document History</A> +</div> +<hr /></div> +</DIV> +<!--End of Navigation Panel--> + +<H3><A NAME="SECTION0016213000000000000000"> +6.2.13 List Verification</A> +</H3> + +<P> +This is how a set of address tests for the Exim lists look on a working +system. The list in question is <span class="email">quixote-users@mems-exchange.org</span>, and +these commands were run on the <code>mems-exchange.org</code> mail server ("indicates the Unix shell prompt): + +<P> +<div class="verbatim"><pre> + % exim -bt quixote-users + quixote-users@mems-exchange.org + router = mailman_main_router, transport = mailman_transport + + % exim -bt quixote-users-request + quixote-users-request@mems-exchange.org + router = mailman_router, transport = mailman_transport + + % exim -bt quixote-users-bounces + quixote-users-bounces@mems-exchange.org + router = mailman_router, transport = mailman_transport + + % exim -bt quixote-users-bounces+luser=example.com + quixote-users-bounces+luser=example.com@mems-exchange.org + router = mailman_router, transport = mailman_transport +</pre></div> + +<P> +If your <b class="program">exim -bt</b> output looks something like this, that's a start: +at least it means Exim will pass the right messages to the right Mailman +commands. It by no means guarantees that your Exim/Mailman installation is +functioning perfectly, though! + +<P> + +<DIV CLASS="navigation"> +<div class='online-navigation'> +<p></p><hr /> +<table align="center" width="100%" cellpadding="0" cellspacing="2"> +<tr> +<td class='online-navigation'><a rel="prev" title="6.2.12 Virtual Domains" + href="node28.html"><img src='previous.png' + border='0' height='32' alt='Previous Page' width='32' /></A></td> +<td class='online-navigation'><a rel="parent" title="6.2 Using the Exim" + href="node16.html"><img src='up.png' + border='0' height='32' alt='Up One Level' width='32' /></A></td> +<td class='online-navigation'><a rel="next" title="6.2.14 Document History" + href="node30.html"><img src='next.png' + border='0' height='32' alt='Next Page' width='32' /></A></td> +<td align="center" width="100%">GNU Mailman - Installation Manual</td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +</tr></table> +<div class='online-navigation'> +<b class="navlabel">Previous:</b> +<a class="sectref" rel="prev" href="node28.html">6.2.12 Virtual Domains</A> +<b class="navlabel">Up:</b> +<a class="sectref" rel="parent" href="node16.html">6.2 Using the Exim</A> +<b class="navlabel">Next:</b> +<a class="sectref" rel="next" href="node30.html">6.2.14 Document History</A> +</div> +</div> +<hr /> +<span class="release-info">Release 2.1, documentation updated on December 13, 2004.</span> +</DIV> +<!--End of Navigation Panel--> + +</BODY> +</HTML> diff --git a/admin/www/mailman-install/node3.html b/admin/www/mailman-install/node3.html new file mode 100644 index 00000000..1028abc5 --- /dev/null +++ b/admin/www/mailman-install/node3.html @@ -0,0 +1,109 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> +<html> +<head> +<link rel="STYLESHEET" href="mailman-install.css" type='text/css' /> +<link rel="first" href="mailman-install.html" title='GNU Mailman - Installation Manual' /> +<link rel='last' href='about.html' title='About this document...' /> +<link rel='help' href='about.html' title='About this document...' /> +<link rel="next" href="node6.html" /> +<link rel="prev" href="node2.html" /> +<link rel="parent" href="front.html" /> +<link rel="next" href="node4.html" /> +<meta name='aesop' content='information' /> +<title>2 Set up your system</title> +</head> +<body> +<DIV CLASS="navigation"> +<div id='top-navigation-panel' xml:id='top-navigation-panel'> +<table align="center" width="100%" cellpadding="0" cellspacing="2"> +<tr> +<td class='online-navigation'><a rel="prev" title="1 Installation Requirements" + href="node2.html"><img src='previous.png' + border='0' height='32' alt='Previous Page' width='32' /></A></td> +<td class='online-navigation'><a rel="parent" title="Front Matter" + href="front.html"><img src='up.png' + border='0' height='32' alt='Up One Level' width='32' /></A></td> +<td class='online-navigation'><a rel="next" title="2.1 Add the group" + href="node4.html"><img src='next.png' + border='0' height='32' alt='Next Page' width='32' /></A></td> +<td align="center" width="100%">GNU Mailman - Installation Manual</td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +</tr></table> +<div class='online-navigation'> +<b class="navlabel">Previous:</b> +<a class="sectref" rel="prev" href="node2.html">1 Installation Requirements</A> +<b class="navlabel">Up:</b> +<a class="sectref" rel="parent" href="front.html">Front Matter</A> +<b class="navlabel">Next:</b> +<a class="sectref" rel="next" href="node4.html">2.1 Add the group</A> +</div> +<hr /></div> +</DIV> +<!--End of Navigation Panel--> + +<H1><A NAME="SECTION001200000000000000000"> +2 Set up your system</A> +</H1> + +<P> +Before installing Mailman, you need to prepare your system by adding certain +users and groups. You will need to have root privileges to perform the steps +in this section. + +<P> + +<p><br /></p><hr class='online-navigation' /> +<div class='online-navigation'> +<!--Table of Child-Links--> +<A NAME="CHILD_LINKS"><STRONG>Subsections</STRONG></a> + +<UL CLASS="ChildLinks"> +<LI><A href="node4.html">2.1 Add the group and user</a> +<LI><A href="create-install-dir.html">2.2 Create the installation directory</a> +</ul> +<!--End of Table of Child-Links--> +</div> + +<DIV CLASS="navigation"> +<div class='online-navigation'> +<p></p><hr /> +<table align="center" width="100%" cellpadding="0" cellspacing="2"> +<tr> +<td class='online-navigation'><a rel="prev" title="1 Installation Requirements" + href="node2.html"><img src='previous.png' + border='0' height='32' alt='Previous Page' width='32' /></A></td> +<td class='online-navigation'><a rel="parent" title="Front Matter" + href="front.html"><img src='up.png' + border='0' height='32' alt='Up One Level' width='32' /></A></td> +<td class='online-navigation'><a rel="next" title="2.1 Add the group" + href="node4.html"><img src='next.png' + border='0' height='32' alt='Next Page' width='32' /></A></td> +<td align="center" width="100%">GNU Mailman - Installation Manual</td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +</tr></table> +<div class='online-navigation'> +<b class="navlabel">Previous:</b> +<a class="sectref" rel="prev" href="node2.html">1 Installation Requirements</A> +<b class="navlabel">Up:</b> +<a class="sectref" rel="parent" href="front.html">Front Matter</A> +<b class="navlabel">Next:</b> +<a class="sectref" rel="next" href="node4.html">2.1 Add the group</A> +</div> +</div> +<hr /> +<span class="release-info">Release 2.1, documentation updated on December 13, 2004.</span> +</DIV> +<!--End of Navigation Panel--> + +</BODY> +</HTML> diff --git a/admin/www/mailman-install/node30.html b/admin/www/mailman-install/node30.html new file mode 100644 index 00000000..60c2d98b --- /dev/null +++ b/admin/www/mailman-install/node30.html @@ -0,0 +1,97 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> +<html> +<head> +<link rel="STYLESHEET" href="mailman-install.css" type='text/css' /> +<link rel="first" href="mailman-install.html" title='GNU Mailman - Installation Manual' /> +<link rel='last' href='about.html' title='About this document...' /> +<link rel='help' href='about.html' title='About this document...' /> +<link rel="prev" href="node29.html" /> +<link rel="parent" href="node16.html" /> +<link rel="next" href="node31.html" /> +<meta name='aesop' content='information' /> +<title>6.2.14 Document History</title> +</head> +<body> +<DIV CLASS="navigation"> +<div id='top-navigation-panel' xml:id='top-navigation-panel'> +<table align="center" width="100%" cellpadding="0" cellspacing="2"> +<tr> +<td class='online-navigation'><a rel="prev" title="6.2.13 List Verification" + href="node29.html"><img src='previous.png' + border='0' height='32' alt='Previous Page' width='32' /></A></td> +<td class='online-navigation'><a rel="parent" title="6.2 Using the Exim" + href="node16.html"><img src='up.png' + border='0' height='32' alt='Up One Level' width='32' /></A></td> +<td class='online-navigation'><a rel="next" title="6.3 Using the Sendmail" + href="node31.html"><img src='next.png' + border='0' height='32' alt='Next Page' width='32' /></A></td> +<td align="center" width="100%">GNU Mailman - Installation Manual</td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +</tr></table> +<div class='online-navigation'> +<b class="navlabel">Previous:</b> +<a class="sectref" rel="prev" href="node29.html">6.2.13 List Verification</A> +<b class="navlabel">Up:</b> +<a class="sectref" rel="parent" href="node16.html">6.2 Using the Exim</A> +<b class="navlabel">Next:</b> +<a class="sectref" rel="next" href="node31.html">6.3 Using the Sendmail</A> +</div> +<hr /></div> +</DIV> +<!--End of Navigation Panel--> + +<H3><A NAME="SECTION0016214000000000000000"> +6.2.14 Document History</A> +</H3> + +<P> +Originally written by Nigel Metheringham <span class="email">postmaster@exim.org</span>. Updated +by Marc Merlin <span class="email">marc_soft@merlins.org</span> for Mailman 2.1, Exim 4. +Overhauled/reformatted/clarified/simplified by Greg Ward +<span class="email">gward@python.net</span>. + +<P> + +<DIV CLASS="navigation"> +<div class='online-navigation'> +<p></p><hr /> +<table align="center" width="100%" cellpadding="0" cellspacing="2"> +<tr> +<td class='online-navigation'><a rel="prev" title="6.2.13 List Verification" + href="node29.html"><img src='previous.png' + border='0' height='32' alt='Previous Page' width='32' /></A></td> +<td class='online-navigation'><a rel="parent" title="6.2 Using the Exim" + href="node16.html"><img src='up.png' + border='0' height='32' alt='Up One Level' width='32' /></A></td> +<td class='online-navigation'><a rel="next" title="6.3 Using the Sendmail" + href="node31.html"><img src='next.png' + border='0' height='32' alt='Next Page' width='32' /></A></td> +<td align="center" width="100%">GNU Mailman - Installation Manual</td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +</tr></table> +<div class='online-navigation'> +<b class="navlabel">Previous:</b> +<a class="sectref" rel="prev" href="node29.html">6.2.13 List Verification</A> +<b class="navlabel">Up:</b> +<a class="sectref" rel="parent" href="node16.html">6.2 Using the Exim</A> +<b class="navlabel">Next:</b> +<a class="sectref" rel="next" href="node31.html">6.3 Using the Sendmail</A> +</div> +</div> +<hr /> +<span class="release-info">Release 2.1, documentation updated on December 13, 2004.</span> +</DIV> +<!--End of Navigation Panel--> + +</BODY> +</HTML> diff --git a/admin/www/mailman-install/node31.html b/admin/www/mailman-install/node31.html new file mode 100644 index 00000000..232e027b --- /dev/null +++ b/admin/www/mailman-install/node31.html @@ -0,0 +1,128 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> +<html> +<head> +<link rel="STYLESHEET" href="mailman-install.css" type='text/css' /> +<link rel="first" href="mailman-install.html" title='GNU Mailman - Installation Manual' /> +<link rel='last' href='about.html' title='About this document...' /> +<link rel='help' href='about.html' title='About this document...' /> +<link rel="next" href="qmail-issues.html" /> +<link rel="prev" href="node16.html" /> +<link rel="parent" href="mail-server.html" /> +<link rel="next" href="node32.html" /> +<meta name='aesop' content='information' /> +<title>6.3 Using the Sendmail mail server</title> +</head> +<body> +<DIV CLASS="navigation"> +<div id='top-navigation-panel' xml:id='top-navigation-panel'> +<table align="center" width="100%" cellpadding="0" cellspacing="2"> +<tr> +<td class='online-navigation'><a rel="prev" title="6.2.14 Document History" + href="node30.html"><img src='previous.png' + border='0' height='32' alt='Previous Page' width='32' /></A></td> +<td class='online-navigation'><a rel="parent" title="6 Set up your" + href="mail-server.html"><img src='up.png' + border='0' height='32' alt='Up One Level' width='32' /></A></td> +<td class='online-navigation'><a rel="next" title="6.3.1 Sendmail ``smrsh'' compatibility" + href="node32.html"><img src='next.png' + border='0' height='32' alt='Next Page' width='32' /></A></td> +<td align="center" width="100%">GNU Mailman - Installation Manual</td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +</tr></table> +<div class='online-navigation'> +<b class="navlabel">Previous:</b> +<a class="sectref" rel="prev" href="node30.html">6.2.14 Document History</A> +<b class="navlabel">Up:</b> +<a class="sectref" rel="parent" href="mail-server.html">6 Set up your</A> +<b class="navlabel">Next:</b> +<a class="sectref" rel="next" href="node32.html">6.3.1 Sendmail ``smrsh'' compatibility</A> +</div> +<hr /></div> +</DIV> +<!--End of Navigation Panel--> + +<H2><A NAME="SECTION001630000000000000000"> +6.3 Using the Sendmail mail server</A> +</H2> + +<P> +<div class="warning"><b class="label">Warning:</b> + +You may be tempted to set the <var>DELIVERY_MODULE</var> configuration variable in +<span class="file">mm_cfg.py</span> to <code>'Sendmail'</code> when using the Sendmail mail server. +<strong>Don't</strong>. The <span class="file">Sendmail.py</span> module is misnamed - it's really a +command line based message handoff scheme as opposed to the SMTP scheme used +in <span class="file">SMTPDirect.py</span> (the default). <span class="file">Sendmail.py</span> has known security +holes and is provided as a proof-of-concept only<A NAME="tex2html4" + HREF="#foot393"><SUP>4</SUP></A>. If you are having problems +using <span class="file">SMTPDirect.py</span> fix those instead of using <span class="file">Sendmail.py</span>, or +you may open your system up to security exploits. +</div> + +<P> +<BR><HR><H4>Footnotes</H4> +<DL> +<DT><A NAME="foot393">... only</A><A + HREF="node31.html#tex2html4"><SUP>4</SUP></A></DT> +<DD>In fact, in later +versions of Mailman, this module is explicitly sabotaged. You have to know +what you're doing in order to re-enable it. + +</DD> +</DL> +<p><br /></p><hr class='online-navigation' /> +<div class='online-navigation'> +<!--Table of Child-Links--> +<A NAME="CHILD_LINKS"><STRONG>Subsections</STRONG></a> + +<UL CLASS="ChildLinks"> +<LI><A href="node32.html">6.3.1 Sendmail ``smrsh'' compatibility</a> +<LI><A href="node33.html">6.3.2 Integrating Sendmail and Mailman</a> +<LI><A href="node34.html">6.3.3 Performance notes</a> +</ul> +<!--End of Table of Child-Links--> +</div> + +<DIV CLASS="navigation"> +<div class='online-navigation'> +<p></p><hr /> +<table align="center" width="100%" cellpadding="0" cellspacing="2"> +<tr> +<td class='online-navigation'><a rel="prev" title="6.2.14 Document History" + href="node30.html"><img src='previous.png' + border='0' height='32' alt='Previous Page' width='32' /></A></td> +<td class='online-navigation'><a rel="parent" title="6 Set up your" + href="mail-server.html"><img src='up.png' + border='0' height='32' alt='Up One Level' width='32' /></A></td> +<td class='online-navigation'><a rel="next" title="6.3.1 Sendmail ``smrsh'' compatibility" + href="node32.html"><img src='next.png' + border='0' height='32' alt='Next Page' width='32' /></A></td> +<td align="center" width="100%">GNU Mailman - Installation Manual</td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +</tr></table> +<div class='online-navigation'> +<b class="navlabel">Previous:</b> +<a class="sectref" rel="prev" href="node30.html">6.2.14 Document History</A> +<b class="navlabel">Up:</b> +<a class="sectref" rel="parent" href="mail-server.html">6 Set up your</A> +<b class="navlabel">Next:</b> +<a class="sectref" rel="next" href="node32.html">6.3.1 Sendmail ``smrsh'' compatibility</A> +</div> +</div> +<hr /> +<span class="release-info">Release 2.1, documentation updated on December 13, 2004.</span> +</DIV> +<!--End of Navigation Panel--> + +</BODY> +</HTML> diff --git a/admin/www/mailman-install/node32.html b/admin/www/mailman-install/node32.html new file mode 100644 index 00000000..4645c551 --- /dev/null +++ b/admin/www/mailman-install/node32.html @@ -0,0 +1,147 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> +<html> +<head> +<link rel="STYLESHEET" href="mailman-install.css" type='text/css' /> +<link rel="first" href="mailman-install.html" title='GNU Mailman - Installation Manual' /> +<link rel='last' href='about.html' title='About this document...' /> +<link rel='help' href='about.html' title='About this document...' /> +<link rel="next" href="node33.html" /> +<link rel="prev" href="node31.html" /> +<link rel="parent" href="node31.html" /> +<link rel="next" href="node33.html" /> +<meta name='aesop' content='information' /> +<title>6.3.1 Sendmail ``smrsh'' compatibility</title> +</head> +<body> +<DIV CLASS="navigation"> +<div id='top-navigation-panel' xml:id='top-navigation-panel'> +<table align="center" width="100%" cellpadding="0" cellspacing="2"> +<tr> +<td class='online-navigation'><a rel="prev" title="6.3 Using the Sendmail" + href="node31.html"><img src='previous.png' + border='0' height='32' alt='Previous Page' width='32' /></A></td> +<td class='online-navigation'><a rel="parent" title="6.3 Using the Sendmail" + href="node31.html"><img src='up.png' + border='0' height='32' alt='Up One Level' width='32' /></A></td> +<td class='online-navigation'><a rel="next" title="6.3.2 Integrating Sendmail and" + href="node33.html"><img src='next.png' + border='0' height='32' alt='Next Page' width='32' /></A></td> +<td align="center" width="100%">GNU Mailman - Installation Manual</td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +</tr></table> +<div class='online-navigation'> +<b class="navlabel">Previous:</b> +<a class="sectref" rel="prev" href="node31.html">6.3 Using the Sendmail</A> +<b class="navlabel">Up:</b> +<a class="sectref" rel="parent" href="node31.html">6.3 Using the Sendmail</A> +<b class="navlabel">Next:</b> +<a class="sectref" rel="next" href="node33.html">6.3.2 Integrating Sendmail and</A> +</div> +<hr /></div> +</DIV> +<!--End of Navigation Panel--> + +<H3><A NAME="SECTION001631000000000000000"> +6.3.1 Sendmail ``smrsh'' compatibility</A> +</H3> + +<P> +Many newer versions of Sendmail come with a restricted execution utility +called ``smrsh'', which limits the executables that Sendmail will allow to be +used as mail programs. You need to explicitly allow Mailman's wrapper program +to be used with smrsh or Mailman will not work. If mail is not getting +delivered to Mailman's wrapper program and you're getting an ``operating +system error'' in your mail syslog, this could be your problem. + +<P> +One good way of enabling this is: + +<P> + +<UL> +<LI>Find out where your Sendmail executes its smrsh wrapper + +<P> +<div class="verbatim"><pre> + % grep smrsh /etc/mail/sendmail.cf + </pre></div> + +<P> +</LI> +<LI>Figure out where smrsh expects symlinks for allowable mail + programs. At the very beginning of the following output you will + see a full path to some directory, e.g. <span class="file">/var/adm/sm.bin</span> or + similar: + +<P> +<div class="verbatim"><pre> + % strings $path_to_smrsh | less + </pre></div> + +<P> +</LI> +<LI>cd into <span class="file">/var/adm/sm.bin</span>, or where ever it happens to reside + on your system - alternatives include <span class="file">/etc/smrsh</span>, + <span class="file">/var/smrsh</span> and <span class="file">/usr/local/smrsh</span>. + +<P> +<div class="verbatim"><pre> + % cd /var/adm/sm.bin + </pre></div> + +<P> +</LI> +<LI>Create a symbolic link to Mailman's wrapper program: + +<P> +<div class="verbatim"><pre> + % ln -s /usr/local/mailman/mail/mailman mailman + </pre></div> +</LI> +</UL> + +<P> + +<DIV CLASS="navigation"> +<div class='online-navigation'> +<p></p><hr /> +<table align="center" width="100%" cellpadding="0" cellspacing="2"> +<tr> +<td class='online-navigation'><a rel="prev" title="6.3 Using the Sendmail" + href="node31.html"><img src='previous.png' + border='0' height='32' alt='Previous Page' width='32' /></A></td> +<td class='online-navigation'><a rel="parent" title="6.3 Using the Sendmail" + href="node31.html"><img src='up.png' + border='0' height='32' alt='Up One Level' width='32' /></A></td> +<td class='online-navigation'><a rel="next" title="6.3.2 Integrating Sendmail and" + href="node33.html"><img src='next.png' + border='0' height='32' alt='Next Page' width='32' /></A></td> +<td align="center" width="100%">GNU Mailman - Installation Manual</td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +</tr></table> +<div class='online-navigation'> +<b class="navlabel">Previous:</b> +<a class="sectref" rel="prev" href="node31.html">6.3 Using the Sendmail</A> +<b class="navlabel">Up:</b> +<a class="sectref" rel="parent" href="node31.html">6.3 Using the Sendmail</A> +<b class="navlabel">Next:</b> +<a class="sectref" rel="next" href="node33.html">6.3.2 Integrating Sendmail and</A> +</div> +</div> +<hr /> +<span class="release-info">Release 2.1, documentation updated on December 13, 2004.</span> +</DIV> +<!--End of Navigation Panel--> + +</BODY> +</HTML> diff --git a/admin/www/mailman-install/node33.html b/admin/www/mailman-install/node33.html new file mode 100644 index 00000000..7b5e8bf7 --- /dev/null +++ b/admin/www/mailman-install/node33.html @@ -0,0 +1,115 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> +<html> +<head> +<link rel="STYLESHEET" href="mailman-install.css" type='text/css' /> +<link rel="first" href="mailman-install.html" title='GNU Mailman - Installation Manual' /> +<link rel='last' href='about.html' title='About this document...' /> +<link rel='help' href='about.html' title='About this document...' /> +<link rel="next" href="node34.html" /> +<link rel="prev" href="node32.html" /> +<link rel="parent" href="node31.html" /> +<link rel="next" href="node34.html" /> +<meta name='aesop' content='information' /> +<title>6.3.2 Integrating Sendmail and Mailman</title> +</head> +<body> +<DIV CLASS="navigation"> +<div id='top-navigation-panel' xml:id='top-navigation-panel'> +<table align="center" width="100%" cellpadding="0" cellspacing="2"> +<tr> +<td class='online-navigation'><a rel="prev" title="6.3.1 Sendmail ``smrsh'' compatibility" + href="node32.html"><img src='previous.png' + border='0' height='32' alt='Previous Page' width='32' /></A></td> +<td class='online-navigation'><a rel="parent" title="6.3 Using the Sendmail" + href="node31.html"><img src='up.png' + border='0' height='32' alt='Up One Level' width='32' /></A></td> +<td class='online-navigation'><a rel="next" title="6.3.3 Performance notes" + href="node34.html"><img src='next.png' + border='0' height='32' alt='Next Page' width='32' /></A></td> +<td align="center" width="100%">GNU Mailman - Installation Manual</td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +</tr></table> +<div class='online-navigation'> +<b class="navlabel">Previous:</b> +<a class="sectref" rel="prev" href="node32.html">6.3.1 Sendmail ``smrsh'' compatibility</A> +<b class="navlabel">Up:</b> +<a class="sectref" rel="parent" href="node31.html">6.3 Using the Sendmail</A> +<b class="navlabel">Next:</b> +<a class="sectref" rel="next" href="node34.html">6.3.3 Performance notes</A> +</div> +<hr /></div> +</DIV> +<!--End of Navigation Panel--> + +<H3><A NAME="SECTION001632000000000000000"> +6.3.2 Integrating Sendmail and Mailman</A> +</H3> + +<P> +David Champion has contributed a recipe for more closely integrating Sendmail +and Mailman, such that Sendmail will automatically recognize and deliver to +new mailing lists as they are created, without having to manually edit alias +tables. + +<P> +In the <span class="file">contrib</span> directory of Mailman's source distribution, you will +find four files: + +<P> + +<UL> +<LI><span class="file">mm-handler.readme</span> - an explanation of how to set everything up +</LI> +<LI><span class="file">mm-handler</span> - the mail delivery agent (MDA) +</LI> +<LI><span class="file">mailman.mc</span> - a toy configuration file sample +</LI> +<LI><span class="file">virtusertable</span> - a sample for RFC 2142 address exceptions +</LI> +</UL> + +<P> + +<DIV CLASS="navigation"> +<div class='online-navigation'> +<p></p><hr /> +<table align="center" width="100%" cellpadding="0" cellspacing="2"> +<tr> +<td class='online-navigation'><a rel="prev" title="6.3.1 Sendmail ``smrsh'' compatibility" + href="node32.html"><img src='previous.png' + border='0' height='32' alt='Previous Page' width='32' /></A></td> +<td class='online-navigation'><a rel="parent" title="6.3 Using the Sendmail" + href="node31.html"><img src='up.png' + border='0' height='32' alt='Up One Level' width='32' /></A></td> +<td class='online-navigation'><a rel="next" title="6.3.3 Performance notes" + href="node34.html"><img src='next.png' + border='0' height='32' alt='Next Page' width='32' /></A></td> +<td align="center" width="100%">GNU Mailman - Installation Manual</td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +</tr></table> +<div class='online-navigation'> +<b class="navlabel">Previous:</b> +<a class="sectref" rel="prev" href="node32.html">6.3.1 Sendmail ``smrsh'' compatibility</A> +<b class="navlabel">Up:</b> +<a class="sectref" rel="parent" href="node31.html">6.3 Using the Sendmail</A> +<b class="navlabel">Next:</b> +<a class="sectref" rel="next" href="node34.html">6.3.3 Performance notes</A> +</div> +</div> +<hr /> +<span class="release-info">Release 2.1, documentation updated on December 13, 2004.</span> +</DIV> +<!--End of Navigation Panel--> + +</BODY> +</HTML> diff --git a/admin/www/mailman-install/node34.html b/admin/www/mailman-install/node34.html new file mode 100644 index 00000000..a49632b5 --- /dev/null +++ b/admin/www/mailman-install/node34.html @@ -0,0 +1,100 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> +<html> +<head> +<link rel="STYLESHEET" href="mailman-install.css" type='text/css' /> +<link rel="first" href="mailman-install.html" title='GNU Mailman - Installation Manual' /> +<link rel='last' href='about.html' title='About this document...' /> +<link rel='help' href='about.html' title='About this document...' /> +<link rel="prev" href="node33.html" /> +<link rel="parent" href="node31.html" /> +<link rel="next" href="qmail-issues.html" /> +<meta name='aesop' content='information' /> +<title>6.3.3 Performance notes</title> +</head> +<body> +<DIV CLASS="navigation"> +<div id='top-navigation-panel' xml:id='top-navigation-panel'> +<table align="center" width="100%" cellpadding="0" cellspacing="2"> +<tr> +<td class='online-navigation'><a rel="prev" title="6.3.2 Integrating Sendmail and" + href="node33.html"><img src='previous.png' + border='0' height='32' alt='Previous Page' width='32' /></A></td> +<td class='online-navigation'><a rel="parent" title="6.3 Using the Sendmail" + href="node31.html"><img src='up.png' + border='0' height='32' alt='Up One Level' width='32' /></A></td> +<td class='online-navigation'><a rel="next" title="6.4 Using the Qmail" + href="qmail-issues.html"><img src='next.png' + border='0' height='32' alt='Next Page' width='32' /></A></td> +<td align="center" width="100%">GNU Mailman - Installation Manual</td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +</tr></table> +<div class='online-navigation'> +<b class="navlabel">Previous:</b> +<a class="sectref" rel="prev" href="node33.html">6.3.2 Integrating Sendmail and</A> +<b class="navlabel">Up:</b> +<a class="sectref" rel="parent" href="node31.html">6.3 Using the Sendmail</A> +<b class="navlabel">Next:</b> +<a class="sectref" rel="next" href="qmail-issues.html">6.4 Using the Qmail</A> +</div> +<hr /></div> +</DIV> +<!--End of Navigation Panel--> + +<H3><A NAME="SECTION001633000000000000000"> +6.3.3 Performance notes</A> +</H3> + +<P> +One of the surest performance killers for Sendmail users is when Sendmail is +configured to synchronously verify the recipient's host via DNS. If it does +this for messages posted to it from Mailman, you will get horrible +performance. Since Mailman usually connects via <code>localhost</code> +(i.e. 127.0.0.1) to the SMTP port of Sendmail, you should be sure to configure +Sendmail to <strong>not</strong> do DNS verification synchronously for localhost +connections. + +<P> + +<DIV CLASS="navigation"> +<div class='online-navigation'> +<p></p><hr /> +<table align="center" width="100%" cellpadding="0" cellspacing="2"> +<tr> +<td class='online-navigation'><a rel="prev" title="6.3.2 Integrating Sendmail and" + href="node33.html"><img src='previous.png' + border='0' height='32' alt='Previous Page' width='32' /></A></td> +<td class='online-navigation'><a rel="parent" title="6.3 Using the Sendmail" + href="node31.html"><img src='up.png' + border='0' height='32' alt='Up One Level' width='32' /></A></td> +<td class='online-navigation'><a rel="next" title="6.4 Using the Qmail" + href="qmail-issues.html"><img src='next.png' + border='0' height='32' alt='Next Page' width='32' /></A></td> +<td align="center" width="100%">GNU Mailman - Installation Manual</td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +</tr></table> +<div class='online-navigation'> +<b class="navlabel">Previous:</b> +<a class="sectref" rel="prev" href="node33.html">6.3.2 Integrating Sendmail and</A> +<b class="navlabel">Up:</b> +<a class="sectref" rel="parent" href="node31.html">6.3 Using the Sendmail</A> +<b class="navlabel">Next:</b> +<a class="sectref" rel="next" href="qmail-issues.html">6.4 Using the Qmail</A> +</div> +</div> +<hr /> +<span class="release-info">Release 2.1, documentation updated on December 13, 2004.</span> +</DIV> +<!--End of Navigation Panel--> + +</BODY> +</HTML> diff --git a/admin/www/mailman-install/node36.html b/admin/www/mailman-install/node36.html new file mode 100644 index 00000000..b4ae4f9d --- /dev/null +++ b/admin/www/mailman-install/node36.html @@ -0,0 +1,115 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> +<html> +<head> +<link rel="STYLESHEET" href="mailman-install.css" type='text/css' /> +<link rel="first" href="mailman-install.html" title='GNU Mailman - Installation Manual' /> +<link rel='last' href='about.html' title='About this document...' /> +<link rel='help' href='about.html' title='About this document...' /> +<link rel="next" href="node37.html" /> +<link rel="prev" href="qmail-issues.html" /> +<link rel="parent" href="qmail-issues.html" /> +<link rel="next" href="node37.html" /> +<meta name='aesop' content='information' /> +<title>6.4.1 Information on VERP</title> +</head> +<body> +<DIV CLASS="navigation"> +<div id='top-navigation-panel' xml:id='top-navigation-panel'> +<table align="center" width="100%" cellpadding="0" cellspacing="2"> +<tr> +<td class='online-navigation'><a rel="prev" title="6.4 Using the Qmail" + href="qmail-issues.html"><img src='previous.png' + border='0' height='32' alt='Previous Page' width='32' /></A></td> +<td class='online-navigation'><a rel="parent" title="6.4 Using the Qmail" + href="qmail-issues.html"><img src='up.png' + border='0' height='32' alt='Up One Level' width='32' /></A></td> +<td class='online-navigation'><a rel="next" title="6.4.2 Virtual mail server" + href="node37.html"><img src='next.png' + border='0' height='32' alt='Next Page' width='32' /></A></td> +<td align="center" width="100%">GNU Mailman - Installation Manual</td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +</tr></table> +<div class='online-navigation'> +<b class="navlabel">Previous:</b> +<a class="sectref" rel="prev" href="qmail-issues.html">6.4 Using the Qmail</A> +<b class="navlabel">Up:</b> +<a class="sectref" rel="parent" href="qmail-issues.html">6.4 Using the Qmail</A> +<b class="navlabel">Next:</b> +<a class="sectref" rel="next" href="node37.html">6.4.2 Virtual mail server</A> +</div> +<hr /></div> +</DIV> +<!--End of Navigation Panel--> + +<H3><A NAME="SECTION001641000000000000000"> +6.4.1 Information on VERP</A> +</H3> + +<P> +You will note in the alias generating script for 2.1 above, there is a line +for VERP that has been commented out. If you are interested in VERP there are +two options. The first option is to allow Mailman to do the VERP formatting. +To activate this, uncomment that line and add the following lines to your +<span class="file">mm_cfg.py</span> file: + +<P> +<div class="verbatim"><pre> + VERP_FORMAT = '%(bounces)s-+%(mailbox)s=%(host)s' + VERP_REGEXP = r'^(?P<bounces>.*?)-\+(?P<mailbox>[^=]+)=(?P<host>[^@]+)@.*$' +</pre></div> + +<P> +The second option is a patch on SourceForge located at: + +<P> +<a class="url" href="http://sourceforge.net/tracker/?func=detail&atid=300103&aid=645513&group_id=103">http://sourceforge.net/tracker/?func=detail&atid=300103&aid=645513&group_id=103</a> +<P> +This patch currently needs more testing and might best be suitable for +developers or people well familiar with qmail. Having said that, this patch +is the more qmail-friendly approach resulting in large performance gains. + +<P> + +<DIV CLASS="navigation"> +<div class='online-navigation'> +<p></p><hr /> +<table align="center" width="100%" cellpadding="0" cellspacing="2"> +<tr> +<td class='online-navigation'><a rel="prev" title="6.4 Using the Qmail" + href="qmail-issues.html"><img src='previous.png' + border='0' height='32' alt='Previous Page' width='32' /></A></td> +<td class='online-navigation'><a rel="parent" title="6.4 Using the Qmail" + href="qmail-issues.html"><img src='up.png' + border='0' height='32' alt='Up One Level' width='32' /></A></td> +<td class='online-navigation'><a rel="next" title="6.4.2 Virtual mail server" + href="node37.html"><img src='next.png' + border='0' height='32' alt='Next Page' width='32' /></A></td> +<td align="center" width="100%">GNU Mailman - Installation Manual</td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +</tr></table> +<div class='online-navigation'> +<b class="navlabel">Previous:</b> +<a class="sectref" rel="prev" href="qmail-issues.html">6.4 Using the Qmail</A> +<b class="navlabel">Up:</b> +<a class="sectref" rel="parent" href="qmail-issues.html">6.4 Using the Qmail</A> +<b class="navlabel">Next:</b> +<a class="sectref" rel="next" href="node37.html">6.4.2 Virtual mail server</A> +</div> +</div> +<hr /> +<span class="release-info">Release 2.1, documentation updated on December 13, 2004.</span> +</DIV> +<!--End of Navigation Panel--> + +</BODY> +</HTML> diff --git a/admin/www/mailman-install/node37.html b/admin/www/mailman-install/node37.html new file mode 100644 index 00000000..c90f58da --- /dev/null +++ b/admin/www/mailman-install/node37.html @@ -0,0 +1,101 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> +<html> +<head> +<link rel="STYLESHEET" href="mailman-install.css" type='text/css' /> +<link rel="first" href="mailman-install.html" title='GNU Mailman - Installation Manual' /> +<link rel='last' href='about.html' title='About this document...' /> +<link rel='help' href='about.html' title='About this document...' /> +<link rel="next" href="node38.html" /> +<link rel="prev" href="node36.html" /> +<link rel="parent" href="qmail-issues.html" /> +<link rel="next" href="node38.html" /> +<meta name='aesop' content='information' /> +<title>6.4.2 Virtual mail server</title> +</head> +<body> +<DIV CLASS="navigation"> +<div id='top-navigation-panel' xml:id='top-navigation-panel'> +<table align="center" width="100%" cellpadding="0" cellspacing="2"> +<tr> +<td class='online-navigation'><a rel="prev" title="6.4.1 Information on VERP" + href="node36.html"><img src='previous.png' + border='0' height='32' alt='Previous Page' width='32' /></A></td> +<td class='online-navigation'><a rel="parent" title="6.4 Using the Qmail" + href="qmail-issues.html"><img src='up.png' + border='0' height='32' alt='Up One Level' width='32' /></A></td> +<td class='online-navigation'><a rel="next" title="6.4.3 More information" + href="node38.html"><img src='next.png' + border='0' height='32' alt='Next Page' width='32' /></A></td> +<td align="center" width="100%">GNU Mailman - Installation Manual</td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +</tr></table> +<div class='online-navigation'> +<b class="navlabel">Previous:</b> +<a class="sectref" rel="prev" href="node36.html">6.4.1 Information on VERP</A> +<b class="navlabel">Up:</b> +<a class="sectref" rel="parent" href="qmail-issues.html">6.4 Using the Qmail</A> +<b class="navlabel">Next:</b> +<a class="sectref" rel="next" href="node38.html">6.4.3 More information</A> +</div> +<hr /></div> +</DIV> +<!--End of Navigation Panel--> + +<H3><A NAME="SECTION001642000000000000000"> +6.4.2 Virtual mail server</A> +</H3> + +<P> +As mentioned in the <A href="qmail-issues.html#qmail-issues">6.4</A> section for a virtual mail server, a +patch under testing is located at: + +<P> +<a class="url" href="http://sf.net/tracker/index.php?func=detail&aid=621257&group_id=103&atid=300103">http://sf.net/tracker/index.php?func=detail&aid=621257&group_id=103&atid=300103</a> +<P> +Again, this patch is for people familiar with their qmail installation. + +<P> + +<DIV CLASS="navigation"> +<div class='online-navigation'> +<p></p><hr /> +<table align="center" width="100%" cellpadding="0" cellspacing="2"> +<tr> +<td class='online-navigation'><a rel="prev" title="6.4.1 Information on VERP" + href="node36.html"><img src='previous.png' + border='0' height='32' alt='Previous Page' width='32' /></A></td> +<td class='online-navigation'><a rel="parent" title="6.4 Using the Qmail" + href="qmail-issues.html"><img src='up.png' + border='0' height='32' alt='Up One Level' width='32' /></A></td> +<td class='online-navigation'><a rel="next" title="6.4.3 More information" + href="node38.html"><img src='next.png' + border='0' height='32' alt='Next Page' width='32' /></A></td> +<td align="center" width="100%">GNU Mailman - Installation Manual</td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +</tr></table> +<div class='online-navigation'> +<b class="navlabel">Previous:</b> +<a class="sectref" rel="prev" href="node36.html">6.4.1 Information on VERP</A> +<b class="navlabel">Up:</b> +<a class="sectref" rel="parent" href="qmail-issues.html">6.4 Using the Qmail</A> +<b class="navlabel">Next:</b> +<a class="sectref" rel="next" href="node38.html">6.4.3 More information</A> +</div> +</div> +<hr /> +<span class="release-info">Release 2.1, documentation updated on December 13, 2004.</span> +</DIV> +<!--End of Navigation Panel--> + +</BODY> +</HTML> diff --git a/admin/www/mailman-install/node38.html b/admin/www/mailman-install/node38.html new file mode 100644 index 00000000..15fe4fad --- /dev/null +++ b/admin/www/mailman-install/node38.html @@ -0,0 +1,97 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> +<html> +<head> +<link rel="STYLESHEET" href="mailman-install.css" type='text/css' /> +<link rel="first" href="mailman-install.html" title='GNU Mailman - Installation Manual' /> +<link rel='last' href='about.html' title='About this document...' /> +<link rel='help' href='about.html' title='About this document...' /> +<link rel="prev" href="node37.html" /> +<link rel="parent" href="qmail-issues.html" /> +<link rel="next" href="node39.html" /> +<meta name='aesop' content='information' /> +<title>6.4.3 More information</title> +</head> +<body> +<DIV CLASS="navigation"> +<div id='top-navigation-panel' xml:id='top-navigation-panel'> +<table align="center" width="100%" cellpadding="0" cellspacing="2"> +<tr> +<td class='online-navigation'><a rel="prev" title="6.4.2 Virtual mail server" + href="node37.html"><img src='previous.png' + border='0' height='32' alt='Previous Page' width='32' /></A></td> +<td class='online-navigation'><a rel="parent" title="6.4 Using the Qmail" + href="qmail-issues.html"><img src='up.png' + border='0' height='32' alt='Up One Level' width='32' /></A></td> +<td class='online-navigation'><a rel="next" title="7 Create a site-wide" + href="node39.html"><img src='next.png' + border='0' height='32' alt='Next Page' width='32' /></A></td> +<td align="center" width="100%">GNU Mailman - Installation Manual</td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +</tr></table> +<div class='online-navigation'> +<b class="navlabel">Previous:</b> +<a class="sectref" rel="prev" href="node37.html">6.4.2 Virtual mail server</A> +<b class="navlabel">Up:</b> +<a class="sectref" rel="parent" href="qmail-issues.html">6.4 Using the Qmail</A> +<b class="navlabel">Next:</b> +<a class="sectref" rel="next" href="node39.html">7 Create a site-wide</A> +</div> +<hr /></div> +</DIV> +<!--End of Navigation Panel--> + +<H3><A NAME="SECTION001643000000000000000"> +6.4.3 More information</A> +</H3> + +<P> +You might be interested in some information on modifying footers that Norbert +Bollow has written about Mailman and qmail, available here: + +<P> +<a class="url" href="http://mailman.cis.to/qmail-verh/">http://mailman.cis.to/qmail-verh/</a> +<P> + +<DIV CLASS="navigation"> +<div class='online-navigation'> +<p></p><hr /> +<table align="center" width="100%" cellpadding="0" cellspacing="2"> +<tr> +<td class='online-navigation'><a rel="prev" title="6.4.2 Virtual mail server" + href="node37.html"><img src='previous.png' + border='0' height='32' alt='Previous Page' width='32' /></A></td> +<td class='online-navigation'><a rel="parent" title="6.4 Using the Qmail" + href="qmail-issues.html"><img src='up.png' + border='0' height='32' alt='Up One Level' width='32' /></A></td> +<td class='online-navigation'><a rel="next" title="7 Create a site-wide" + href="node39.html"><img src='next.png' + border='0' height='32' alt='Next Page' width='32' /></A></td> +<td align="center" width="100%">GNU Mailman - Installation Manual</td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +</tr></table> +<div class='online-navigation'> +<b class="navlabel">Previous:</b> +<a class="sectref" rel="prev" href="node37.html">6.4.2 Virtual mail server</A> +<b class="navlabel">Up:</b> +<a class="sectref" rel="parent" href="qmail-issues.html">6.4 Using the Qmail</A> +<b class="navlabel">Next:</b> +<a class="sectref" rel="next" href="node39.html">7 Create a site-wide</A> +</div> +</div> +<hr /> +<span class="release-info">Release 2.1, documentation updated on December 13, 2004.</span> +</DIV> +<!--End of Navigation Panel--> + +</BODY> +</HTML> diff --git a/admin/www/mailman-install/node39.html b/admin/www/mailman-install/node39.html new file mode 100644 index 00000000..f6b4338f --- /dev/null +++ b/admin/www/mailman-install/node39.html @@ -0,0 +1,129 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> +<html> +<head> +<link rel="STYLESHEET" href="mailman-install.css" type='text/css' /> +<link rel="first" href="mailman-install.html" title='GNU Mailman - Installation Manual' /> +<link rel='last' href='about.html' title='About this document...' /> +<link rel='help' href='about.html' title='About this document...' /> +<link rel="next" href="node40.html" /> +<link rel="prev" href="mail-server.html" /> +<link rel="parent" href="front.html" /> +<link rel="next" href="node40.html" /> +<meta name='aesop' content='information' /> +<title>7 Create a site-wide mailing list</title> +</head> +<body> +<DIV CLASS="navigation"> +<div id='top-navigation-panel' xml:id='top-navigation-panel'> +<table align="center" width="100%" cellpadding="0" cellspacing="2"> +<tr> +<td class='online-navigation'><a rel="prev" title="6.4.3 More information" + href="node38.html"><img src='previous.png' + border='0' height='32' alt='Previous Page' width='32' /></A></td> +<td class='online-navigation'><a rel="parent" title="Front Matter" + href="front.html"><img src='up.png' + border='0' height='32' alt='Up One Level' width='32' /></A></td> +<td class='online-navigation'><a rel="next" title="8 Set up cron" + href="node40.html"><img src='next.png' + border='0' height='32' alt='Next Page' width='32' /></A></td> +<td align="center" width="100%">GNU Mailman - Installation Manual</td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +</tr></table> +<div class='online-navigation'> +<b class="navlabel">Previous:</b> +<a class="sectref" rel="prev" href="node38.html">6.4.3 More information</A> +<b class="navlabel">Up:</b> +<a class="sectref" rel="parent" href="front.html">Front Matter</A> +<b class="navlabel">Next:</b> +<a class="sectref" rel="next" href="node40.html">8 Set up cron</A> +</div> +<hr /></div> +</DIV> +<!--End of Navigation Panel--> + +<H1><A NAME="SECTION001700000000000000000"> +7 Create a site-wide mailing list</A> +</H1> + +<P> +After you have completed the integration of Mailman and your mail server, you +need to create a ``site-wide'' mailing list. This is the one that password +reminders will appear to come from, and it is required for proper Mailman +operation. Usually this should be a list called <code>mailman</code>, but if you +need to change this, be sure to change the <var>MAILMAN_SITE_LIST</var> variable in +<span class="file">mm_cfg.py</span>. You can create the site list with this command, following +the prompts: + +<P> +<div class="verbatim"><pre> + % bin/newlist mailman +</pre></div> + +<P> +Now configure your site list. There is a convenient template for a generic +site list in the installation directory, under <span class="file">data/sitelist.cfg</span> which +can help you with this. You should review the configuration options in the +template, but note that any options not named in the <span class="file">sitelist.cfg</span> file +won't be changed. + +<P> +The template can be applied to your site list by +running: + +<P> +<div class="verbatim"><pre> + % bin/config_list -i data/sitelist.cfg mailman +</pre></div> + +<P> +After applying the <span class="file">sitelist.cfg</span> options, be sure you review the +site list's configuration via the admin pages. + +<P> +You should also subscribe yourself to the site list. + +<P> + +<DIV CLASS="navigation"> +<div class='online-navigation'> +<p></p><hr /> +<table align="center" width="100%" cellpadding="0" cellspacing="2"> +<tr> +<td class='online-navigation'><a rel="prev" title="6.4.3 More information" + href="node38.html"><img src='previous.png' + border='0' height='32' alt='Previous Page' width='32' /></A></td> +<td class='online-navigation'><a rel="parent" title="Front Matter" + href="front.html"><img src='up.png' + border='0' height='32' alt='Up One Level' width='32' /></A></td> +<td class='online-navigation'><a rel="next" title="8 Set up cron" + href="node40.html"><img src='next.png' + border='0' height='32' alt='Next Page' width='32' /></A></td> +<td align="center" width="100%">GNU Mailman - Installation Manual</td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +</tr></table> +<div class='online-navigation'> +<b class="navlabel">Previous:</b> +<a class="sectref" rel="prev" href="node38.html">6.4.3 More information</A> +<b class="navlabel">Up:</b> +<a class="sectref" rel="parent" href="front.html">Front Matter</A> +<b class="navlabel">Next:</b> +<a class="sectref" rel="next" href="node40.html">8 Set up cron</A> +</div> +</div> +<hr /> +<span class="release-info">Release 2.1, documentation updated on December 13, 2004.</span> +</DIV> +<!--End of Navigation Panel--> + +</BODY> +</HTML> diff --git a/admin/www/mailman-install/node4.html b/admin/www/mailman-install/node4.html new file mode 100644 index 00000000..bae31de6 --- /dev/null +++ b/admin/www/mailman-install/node4.html @@ -0,0 +1,129 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> +<html> +<head> +<link rel="STYLESHEET" href="mailman-install.css" type='text/css' /> +<link rel="first" href="mailman-install.html" title='GNU Mailman - Installation Manual' /> +<link rel='last' href='about.html' title='About this document...' /> +<link rel='help' href='about.html' title='About this document...' /> +<link rel="next" href="create-install-dir.html" /> +<link rel="prev" href="node3.html" /> +<link rel="parent" href="node3.html" /> +<link rel="next" href="create-install-dir.html" /> +<meta name='aesop' content='information' /> +<title>2.1 Add the group and user</title> +</head> +<body> +<DIV CLASS="navigation"> +<div id='top-navigation-panel' xml:id='top-navigation-panel'> +<table align="center" width="100%" cellpadding="0" cellspacing="2"> +<tr> +<td class='online-navigation'><a rel="prev" title="2 Set up your" + href="node3.html"><img src='previous.png' + border='0' height='32' alt='Previous Page' width='32' /></A></td> +<td class='online-navigation'><a rel="parent" title="2 Set up your" + href="node3.html"><img src='up.png' + border='0' height='32' alt='Up One Level' width='32' /></A></td> +<td class='online-navigation'><a rel="next" title="2.2 Create the installation" + href="create-install-dir.html"><img src='next.png' + border='0' height='32' alt='Next Page' width='32' /></A></td> +<td align="center" width="100%">GNU Mailman - Installation Manual</td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +</tr></table> +<div class='online-navigation'> +<b class="navlabel">Previous:</b> +<a class="sectref" rel="prev" href="node3.html">2 Set up your</A> +<b class="navlabel">Up:</b> +<a class="sectref" rel="parent" href="node3.html">2 Set up your</A> +<b class="navlabel">Next:</b> +<a class="sectref" rel="next" href="create-install-dir.html">2.2 Create the installation</A> +</div> +<hr /></div> +</DIV> +<!--End of Navigation Panel--> + +<H2><A NAME="SECTION001210000000000000000"> +2.1 Add the group and user</A> +</H2> + +<P> +Mailman requires a unique user and group name which will own its files, and +under which its processes will run. Mailman's basic security is based on +group ownership permissions, so it's important to get this step +right<A NAME="tex2html1" + HREF="#foot33"><SUP>1</SUP></A>. Typically, you will add a new user and a new +group, both called <code>mailman</code>. The <code>mailman</code> user must be a member +of the <code>mailman</code> group. Mailman will be installed under the +<code>mailman</code> user and group, with the set-group-id (setgid) bit enabled. + +<P> +If these names are already in use, you can choose different user and group +names, as long as you remember these when you run <b class="program">configure</b>. If you +choose a different unique user name, you will have to specify this with +<b class="program">configure</b>'s <b class="programopt">--with-username</b> option, and if you choose +a different group name, you will have to specify this with +<b class="program">configure</b>'s <b class="programopt">--with-groupname</b> option. + +<P> +On Linux systems, you can use the following commands to create these +accounts. Check your system's manual pages for details: + +<P> +<div class="verbatim"><pre> + % groupadd mailman + % useradd -c''GNU Mailman'' -s /no/shell -d /no/home -g mailman mailman +</pre></div> + +<P> +<BR><HR><H4>Footnotes</H4> +<DL> +<DT><A NAME="foot33">... +right</A><A + HREF="node4.html#tex2html1"><SUP>1</SUP></A></DT> +<DD>You will be able to check and repair your permissions after +installation is complete. + +</DD> +</DL> +<DIV CLASS="navigation"> +<div class='online-navigation'> +<p></p><hr /> +<table align="center" width="100%" cellpadding="0" cellspacing="2"> +<tr> +<td class='online-navigation'><a rel="prev" title="2 Set up your" + href="node3.html"><img src='previous.png' + border='0' height='32' alt='Previous Page' width='32' /></A></td> +<td class='online-navigation'><a rel="parent" title="2 Set up your" + href="node3.html"><img src='up.png' + border='0' height='32' alt='Up One Level' width='32' /></A></td> +<td class='online-navigation'><a rel="next" title="2.2 Create the installation" + href="create-install-dir.html"><img src='next.png' + border='0' height='32' alt='Next Page' width='32' /></A></td> +<td align="center" width="100%">GNU Mailman - Installation Manual</td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +</tr></table> +<div class='online-navigation'> +<b class="navlabel">Previous:</b> +<a class="sectref" rel="prev" href="node3.html">2 Set up your</A> +<b class="navlabel">Up:</b> +<a class="sectref" rel="parent" href="node3.html">2 Set up your</A> +<b class="navlabel">Next:</b> +<a class="sectref" rel="next" href="create-install-dir.html">2.2 Create the installation</A> +</div> +</div> +<hr /> +<span class="release-info">Release 2.1, documentation updated on December 13, 2004.</span> +</DIV> +<!--End of Navigation Panel--> + +</BODY> +</HTML> diff --git a/admin/www/mailman-install/node40.html b/admin/www/mailman-install/node40.html new file mode 100644 index 00000000..54352cce --- /dev/null +++ b/admin/www/mailman-install/node40.html @@ -0,0 +1,131 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> +<html> +<head> +<link rel="STYLESHEET" href="mailman-install.css" type='text/css' /> +<link rel="first" href="mailman-install.html" title='GNU Mailman - Installation Manual' /> +<link rel='last' href='about.html' title='About this document...' /> +<link rel='help' href='about.html' title='About this document...' /> +<link rel="next" href="node41.html" /> +<link rel="prev" href="node39.html" /> +<link rel="parent" href="front.html" /> +<link rel="next" href="node41.html" /> +<meta name='aesop' content='information' /> +<title>8 Set up cron</title> +</head> +<body> +<DIV CLASS="navigation"> +<div id='top-navigation-panel' xml:id='top-navigation-panel'> +<table align="center" width="100%" cellpadding="0" cellspacing="2"> +<tr> +<td class='online-navigation'><a rel="prev" title="7 Create a site-wide" + href="node39.html"><img src='previous.png' + border='0' height='32' alt='Previous Page' width='32' /></A></td> +<td class='online-navigation'><a rel="parent" title="Front Matter" + href="front.html"><img src='up.png' + border='0' height='32' alt='Up One Level' width='32' /></A></td> +<td class='online-navigation'><a rel="next" title="9 Start the Mailman" + href="node41.html"><img src='next.png' + border='0' height='32' alt='Next Page' width='32' /></A></td> +<td align="center" width="100%">GNU Mailman - Installation Manual</td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +</tr></table> +<div class='online-navigation'> +<b class="navlabel">Previous:</b> +<a class="sectref" rel="prev" href="node39.html">7 Create a site-wide</A> +<b class="navlabel">Up:</b> +<a class="sectref" rel="parent" href="front.html">Front Matter</A> +<b class="navlabel">Next:</b> +<a class="sectref" rel="next" href="node41.html">9 Start the Mailman</A> +</div> +<hr /></div> +</DIV> +<!--End of Navigation Panel--> + +<H1><A NAME="SECTION001800000000000000000"> +8 Set up cron</A> +</H1> + +<P> +Several Mailman features occur on a regular schedule, so you must set up +<b class="program">cron</b> to run the right programs at the right time<A NAME="tex2html5" + HREF="#foot520"><SUP>5</SUP></A>. + +<P> +If your version of crontab supports the <b class="programopt">-u</b> option, you must be +root to do this next step. Add <span class="file"><var>$prefix</var>/cron/crontab.in</span> as a +crontab entry by executing these commands: + +<P> +<div class="verbatim"><pre> + % cd $prefix/cron + % crontab -u mailman crontab.in +</pre></div> + +<P> +If you used the <b class="programopt">--with-username</b> option, use that user name +instead of <code>mailman</code> for the <b class="programopt">-u</b> argument value. If your +crontab does not support the <b class="programopt">-u</b> option, try these commands: + +<P> +<div class="verbatim"><pre> + % cd $prefix/cron + % su - mailman + % crontab crontab.in +</pre></div> + +<P> +<BR><HR><H4>Footnotes</H4> +<DL> +<DT><A NAME="foot520">... time</A><A + HREF="node40.html#tex2html5"><SUP>5</SUP></A></DT> +<DD>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. + +</DD> +</DL> +<DIV CLASS="navigation"> +<div class='online-navigation'> +<p></p><hr /> +<table align="center" width="100%" cellpadding="0" cellspacing="2"> +<tr> +<td class='online-navigation'><a rel="prev" title="7 Create a site-wide" + href="node39.html"><img src='previous.png' + border='0' height='32' alt='Previous Page' width='32' /></A></td> +<td class='online-navigation'><a rel="parent" title="Front Matter" + href="front.html"><img src='up.png' + border='0' height='32' alt='Up One Level' width='32' /></A></td> +<td class='online-navigation'><a rel="next" title="9 Start the Mailman" + href="node41.html"><img src='next.png' + border='0' height='32' alt='Next Page' width='32' /></A></td> +<td align="center" width="100%">GNU Mailman - Installation Manual</td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +</tr></table> +<div class='online-navigation'> +<b class="navlabel">Previous:</b> +<a class="sectref" rel="prev" href="node39.html">7 Create a site-wide</A> +<b class="navlabel">Up:</b> +<a class="sectref" rel="parent" href="front.html">Front Matter</A> +<b class="navlabel">Next:</b> +<a class="sectref" rel="next" href="node41.html">9 Start the Mailman</A> +</div> +</div> +<hr /> +<span class="release-info">Release 2.1, documentation updated on December 13, 2004.</span> +</DIV> +<!--End of Navigation Panel--> + +</BODY> +</HTML> diff --git a/admin/www/mailman-install/node41.html b/admin/www/mailman-install/node41.html new file mode 100644 index 00000000..fceac309 --- /dev/null +++ b/admin/www/mailman-install/node41.html @@ -0,0 +1,158 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> +<html> +<head> +<link rel="STYLESHEET" href="mailman-install.css" type='text/css' /> +<link rel="first" href="mailman-install.html" title='GNU Mailman - Installation Manual' /> +<link rel='last' href='about.html' title='About this document...' /> +<link rel='help' href='about.html' title='About this document...' /> +<link rel="next" href="node42.html" /> +<link rel="prev" href="node40.html" /> +<link rel="parent" href="front.html" /> +<link rel="next" href="node42.html" /> +<meta name='aesop' content='information' /> +<title>9 Start the Mailman qrunner</title> +</head> +<body> +<DIV CLASS="navigation"> +<div id='top-navigation-panel' xml:id='top-navigation-panel'> +<table align="center" width="100%" cellpadding="0" cellspacing="2"> +<tr> +<td class='online-navigation'><a rel="prev" title="8 Set up cron" + href="node40.html"><img src='previous.png' + border='0' height='32' alt='Previous Page' width='32' /></A></td> +<td class='online-navigation'><a rel="parent" title="Front Matter" + href="front.html"><img src='up.png' + border='0' height='32' alt='Up One Level' width='32' /></A></td> +<td class='online-navigation'><a rel="next" title="10 Check the hostname" + href="node42.html"><img src='next.png' + border='0' height='32' alt='Next Page' width='32' /></A></td> +<td align="center" width="100%">GNU Mailman - Installation Manual</td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +</tr></table> +<div class='online-navigation'> +<b class="navlabel">Previous:</b> +<a class="sectref" rel="prev" href="node40.html">8 Set up cron</A> +<b class="navlabel">Up:</b> +<a class="sectref" rel="parent" href="front.html">Front Matter</A> +<b class="navlabel">Next:</b> +<a class="sectref" rel="next" href="node42.html">10 Check the hostname</A> +</div> +<hr /></div> +</DIV> +<!--End of Navigation Panel--> + +<H1><A NAME="SECTION001900000000000000000"> +9 Start the Mailman qrunner</A> +</H1> + +<P> +Mailman depends on a process called the ``qrunner'' to delivery all +email messages it sees. You must start the qrunner by executing the following +command from the <var>$prefix</var> directory: + +<P> +<div class="verbatim"><pre> + % bin/mailmanctl start +</pre></div> + +<P> +You probably want to start Mailman every time you reboot your system. Exactly +how to do this depends on your operating system. If your OS supports the +<b class="program">chkconfig</b> command (e.g. RedHat and Mandrake Linuxes) you can +do the following (as root, from the Mailman install directory): + +<P> +<div class="verbatim"><pre> + % cp scripts/mailman /etc/init.d/mailman + % chkconfig --add mailman +</pre></div> + +<P> +Note that <span class="file">/etc/init.d</span> may be <span class="file">/etc/rc.d/init.d</span> on some systems. + +<P> +On Gentoo Linux, you can do the following: + +<P> +<div class="verbatim"><pre> + % cp scripts/mailman /etc/init.d/mailman + % rc-update add mailman default +</pre></div> + +<P> +On Debian, you probably want to use: + +<P> +<div class="verbatim"><pre> + % update-rc.d mailman defaults +</pre></div> + +<P> +For <span class="Unix">Unix</span>es that don't support <b class="program">chkconfig</b>, you might try the +following set of commands: + +<P> +<div class="verbatim"><pre> + % cp scripts/mailman /etc/init.d/mailman + % cp misc/mailman /etc/init.d + % cd /etc/rc.d/rc0.d + % ln -s ../init.d/mailman K12mailman + % cd ../rc1.d + % ln -s ../init.d/mailman K12mailman + % cd ../rc2.d + % ln -s ../init.d/mailman S98mailman + % cd ../rc3.d + % ln -s ../init.d/mailman S98mailman + % cd ../rc4.d + % ln -s ../init.d/mailman S98mailman + % cd ../rc5.d + % ln -s ../init.d/mailman S98mailman + % cd ../rc6.d + % ln -s ../init.d/mailman K12mailman +</pre></div> + +<P> + +<DIV CLASS="navigation"> +<div class='online-navigation'> +<p></p><hr /> +<table align="center" width="100%" cellpadding="0" cellspacing="2"> +<tr> +<td class='online-navigation'><a rel="prev" title="8 Set up cron" + href="node40.html"><img src='previous.png' + border='0' height='32' alt='Previous Page' width='32' /></A></td> +<td class='online-navigation'><a rel="parent" title="Front Matter" + href="front.html"><img src='up.png' + border='0' height='32' alt='Up One Level' width='32' /></A></td> +<td class='online-navigation'><a rel="next" title="10 Check the hostname" + href="node42.html"><img src='next.png' + border='0' height='32' alt='Next Page' width='32' /></A></td> +<td align="center" width="100%">GNU Mailman - Installation Manual</td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +</tr></table> +<div class='online-navigation'> +<b class="navlabel">Previous:</b> +<a class="sectref" rel="prev" href="node40.html">8 Set up cron</A> +<b class="navlabel">Up:</b> +<a class="sectref" rel="parent" href="front.html">Front Matter</A> +<b class="navlabel">Next:</b> +<a class="sectref" rel="next" href="node42.html">10 Check the hostname</A> +</div> +</div> +<hr /> +<span class="release-info">Release 2.1, documentation updated on December 13, 2004.</span> +</DIV> +<!--End of Navigation Panel--> + +</BODY> +</HTML> diff --git a/admin/www/mailman-install/node42.html b/admin/www/mailman-install/node42.html new file mode 100644 index 00000000..69fb16ad --- /dev/null +++ b/admin/www/mailman-install/node42.html @@ -0,0 +1,108 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> +<html> +<head> +<link rel="STYLESHEET" href="mailman-install.css" type='text/css' /> +<link rel="first" href="mailman-install.html" title='GNU Mailman - Installation Manual' /> +<link rel='last' href='about.html' title='About this document...' /> +<link rel='help' href='about.html' title='About this document...' /> +<link rel="next" href="customizing.html" /> +<link rel="prev" href="node41.html" /> +<link rel="parent" href="front.html" /> +<link rel="next" href="customizing.html" /> +<meta name='aesop' content='information' /> +<title>10 Check the hostname settings</title> +</head> +<body> +<DIV CLASS="navigation"> +<div id='top-navigation-panel' xml:id='top-navigation-panel'> +<table align="center" width="100%" cellpadding="0" cellspacing="2"> +<tr> +<td class='online-navigation'><a rel="prev" title="9 Start the Mailman" + href="node41.html"><img src='previous.png' + border='0' height='32' alt='Previous Page' width='32' /></A></td> +<td class='online-navigation'><a rel="parent" title="Front Matter" + href="front.html"><img src='up.png' + border='0' height='32' alt='Up One Level' width='32' /></A></td> +<td class='online-navigation'><a rel="next" title="11 Customize Mailman" + href="customizing.html"><img src='next.png' + border='0' height='32' alt='Next Page' width='32' /></A></td> +<td align="center" width="100%">GNU Mailman - Installation Manual</td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +</tr></table> +<div class='online-navigation'> +<b class="navlabel">Previous:</b> +<a class="sectref" rel="prev" href="node41.html">9 Start the Mailman</A> +<b class="navlabel">Up:</b> +<a class="sectref" rel="parent" href="front.html">Front Matter</A> +<b class="navlabel">Next:</b> +<a class="sectref" rel="next" href="customizing.html">11 Customize Mailman</A> +</div> +<hr /></div> +</DIV> +<!--End of Navigation Panel--> + +<H1><A NAME="SECTION0011000000000000000000"> +10 Check the hostname settings</A> +</H1> + +<P> +You should check the values for <var>DEFAULT_EMAIL_HOST</var> and +<var>DEFAULT_URL_HOST</var> in <span class="file">Defaults.py</span>. Make any necessary changes in +the <span class="file">mm_cfg.py</span> file, <strong>not</strong> in the <span class="file">mm_cfg.py</span> file. If you +change either of these two values, you'll want to add the following afterwards +in the <span class="file">mm_cfg.py</span> file: + +<P> +<div class="verbatim"><pre> + add_virtualhost(DEFAULT_URL_HOST, DEFAULT_EMAIL_HOST) +</pre></div> + +<P> +You will want to run the <b class="program">bin/fix_url.py</b> to change the domain of any +existing lists. + +<P> + +<DIV CLASS="navigation"> +<div class='online-navigation'> +<p></p><hr /> +<table align="center" width="100%" cellpadding="0" cellspacing="2"> +<tr> +<td class='online-navigation'><a rel="prev" title="9 Start the Mailman" + href="node41.html"><img src='previous.png' + border='0' height='32' alt='Previous Page' width='32' /></A></td> +<td class='online-navigation'><a rel="parent" title="Front Matter" + href="front.html"><img src='up.png' + border='0' height='32' alt='Up One Level' width='32' /></A></td> +<td class='online-navigation'><a rel="next" title="11 Customize Mailman" + href="customizing.html"><img src='next.png' + border='0' height='32' alt='Next Page' width='32' /></A></td> +<td align="center" width="100%">GNU Mailman - Installation Manual</td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +</tr></table> +<div class='online-navigation'> +<b class="navlabel">Previous:</b> +<a class="sectref" rel="prev" href="node41.html">9 Start the Mailman</A> +<b class="navlabel">Up:</b> +<a class="sectref" rel="parent" href="front.html">Front Matter</A> +<b class="navlabel">Next:</b> +<a class="sectref" rel="next" href="customizing.html">11 Customize Mailman</A> +</div> +</div> +<hr /> +<span class="release-info">Release 2.1, documentation updated on December 13, 2004.</span> +</DIV> +<!--End of Navigation Panel--> + +</BODY> +</HTML> diff --git a/admin/www/mailman-install/node44.html b/admin/www/mailman-install/node44.html new file mode 100644 index 00000000..f9e164ba --- /dev/null +++ b/admin/www/mailman-install/node44.html @@ -0,0 +1,153 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> +<html> +<head> +<link rel="STYLESHEET" href="mailman-install.css" type='text/css' /> +<link rel="first" href="mailman-install.html" title='GNU Mailman - Installation Manual' /> +<link rel='last' href='about.html' title='About this document...' /> +<link rel='help' href='about.html' title='About this document...' /> +<link rel="next" href="troubleshooting.html" /> +<link rel="prev" href="customizing.html" /> +<link rel="parent" href="front.html" /> +<link rel="next" href="troubleshooting.html" /> +<meta name='aesop' content='information' /> +<title>12 Create your first mailing list</title> +</head> +<body> +<DIV CLASS="navigation"> +<div id='top-navigation-panel' xml:id='top-navigation-panel'> +<table align="center" width="100%" cellpadding="0" cellspacing="2"> +<tr> +<td class='online-navigation'><a rel="prev" title="11 Customize Mailman" + href="customizing.html"><img src='previous.png' + border='0' height='32' alt='Previous Page' width='32' /></A></td> +<td class='online-navigation'><a rel="parent" title="Front Matter" + href="front.html"><img src='up.png' + border='0' height='32' alt='Up One Level' width='32' /></A></td> +<td class='online-navigation'><a rel="next" title="13 Troubleshooting" + href="troubleshooting.html"><img src='next.png' + border='0' height='32' alt='Next Page' width='32' /></A></td> +<td align="center" width="100%">GNU Mailman - Installation Manual</td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +</tr></table> +<div class='online-navigation'> +<b class="navlabel">Previous:</b> +<a class="sectref" rel="prev" href="customizing.html">11 Customize Mailman</A> +<b class="navlabel">Up:</b> +<a class="sectref" rel="parent" href="front.html">Front Matter</A> +<b class="navlabel">Next:</b> +<a class="sectref" rel="next" href="troubleshooting.html">13 Troubleshooting</A> +</div> +<hr /></div> +</DIV> +<!--End of Navigation Panel--> + +<H1><A NAME="SECTION0011200000000000000000"> +12 Create your first mailing list</A> +</H1> + +<P> +For more detailed information about using Mailman, including creating and +configuring mailing lists, see the Mailman List Adminstration Manual. These +instructions provide a quick guide to creating your first mailing list via the +web interface: + +<P> + +<UL> +<LI>Start by visiting the url <code>http://my.dom.ain/mailman/create</code>. + +<P> +</LI> +<LI>Fill out the form as described in the on-screen instructions, and in the + ``List creator's password'' field, type the password you entered in + section <A href="customizing.html#customizing">11</A>. Type your own email address for the + ``Initial list owner address'', and select ``Yes'' to notify the list + administrator. + +<P> +</LI> +<LI>Click on the ``Create List'' button. + +<P> +</LI> +<LI>Check your email for a message from Mailman informing you that your new + mailing list was created. + +<P> +</LI> +<LI>Now visit the list's administration page, either by following the link + on the confirmation web page or clicking on the link from the email + Mailman just sent you. Typically the url will be something like + <code>http://my.dom.ain/mailman/admin/mylist</code>. + +<P> +</LI> +<LI>Type in the list's password and click on ``Let me in...'' + +<P> +</LI> +<LI>Click on ``Membership Management'' and then on ``Mass Subscription''. + +<P> +</LI> +<LI>Enter your email address in the big text field, and click on ``Submit + Your Changes''. + +<P> +</LI> +<LI>Now go to your email and send a message to <code>mylist@my.dom.ain</code>. + Within a minute or two you should see your message reflected back to you + via Mailman. +</LI> +</UL> + +<P> +Congratulations! You've just set up and tested your first Mailman mailing +list. If you had any problems along the way, please see the +<A href="troubleshooting.html#troubleshooting">13</A> section. + +<P> + +<DIV CLASS="navigation"> +<div class='online-navigation'> +<p></p><hr /> +<table align="center" width="100%" cellpadding="0" cellspacing="2"> +<tr> +<td class='online-navigation'><a rel="prev" title="11 Customize Mailman" + href="customizing.html"><img src='previous.png' + border='0' height='32' alt='Previous Page' width='32' /></A></td> +<td class='online-navigation'><a rel="parent" title="Front Matter" + href="front.html"><img src='up.png' + border='0' height='32' alt='Up One Level' width='32' /></A></td> +<td class='online-navigation'><a rel="next" title="13 Troubleshooting" + href="troubleshooting.html"><img src='next.png' + border='0' height='32' alt='Next Page' width='32' /></A></td> +<td align="center" width="100%">GNU Mailman - Installation Manual</td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +</tr></table> +<div class='online-navigation'> +<b class="navlabel">Previous:</b> +<a class="sectref" rel="prev" href="customizing.html">11 Customize Mailman</A> +<b class="navlabel">Up:</b> +<a class="sectref" rel="parent" href="front.html">Front Matter</A> +<b class="navlabel">Next:</b> +<a class="sectref" rel="next" href="troubleshooting.html">13 Troubleshooting</A> +</div> +</div> +<hr /> +<span class="release-info">Release 2.1, documentation updated on December 13, 2004.</span> +</DIV> +<!--End of Navigation Panel--> + +</BODY> +</HTML> diff --git a/admin/www/mailman-install/node46.html b/admin/www/mailman-install/node46.html new file mode 100644 index 00000000..1ae12493 --- /dev/null +++ b/admin/www/mailman-install/node46.html @@ -0,0 +1,112 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> +<html> +<head> +<link rel="STYLESHEET" href="mailman-install.css" type='text/css' /> +<link rel="first" href="mailman-install.html" title='GNU Mailman - Installation Manual' /> +<link rel='last' href='about.html' title='About this document...' /> +<link rel='help' href='about.html' title='About this document...' /> +<link rel="prev" href="troubleshooting.html" /> +<link rel="parent" href="front.html" /> +<link rel="next" href="node47.html" /> +<meta name='aesop' content='information' /> +<title>14 Platform and operating system notes</title> +</head> +<body> +<DIV CLASS="navigation"> +<div id='top-navigation-panel' xml:id='top-navigation-panel'> +<table align="center" width="100%" cellpadding="0" cellspacing="2"> +<tr> +<td class='online-navigation'><a rel="prev" title="13 Troubleshooting" + href="troubleshooting.html"><img src='previous.png' + border='0' height='32' alt='Previous Page' width='32' /></A></td> +<td class='online-navigation'><a rel="parent" title="Front Matter" + href="front.html"><img src='up.png' + border='0' height='32' alt='Up One Level' width='32' /></A></td> +<td class='online-navigation'><a rel="next" title="14.1 GNU/Linux issues" + href="node47.html"><img src='next.png' + border='0' height='32' alt='Next Page' width='32' /></A></td> +<td align="center" width="100%">GNU Mailman - Installation Manual</td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +</tr></table> +<div class='online-navigation'> +<b class="navlabel">Previous:</b> +<a class="sectref" rel="prev" href="troubleshooting.html">13 Troubleshooting</A> +<b class="navlabel">Up:</b> +<a class="sectref" rel="parent" href="front.html">Front Matter</A> +<b class="navlabel">Next:</b> +<a class="sectref" rel="next" href="node47.html">14.1 GNU/Linux issues</A> +</div> +<hr /></div> +</DIV> +<!--End of Navigation Panel--> + +<H1><A NAME="SECTION0011400000000000000000"> +14 Platform and operating system notes</A> +</H1> + +<P> +Generally, Mailman runs on any POSIX-based system, such as Solaris, the +various BSD variants, Linux systems, MacOSX, and other generic <span class="Unix">Unix</span> +systems. It doesn't run on Windows. For the most part, the generic +instructions given in this document should be sufficient to get Mailman +working on any supported platform. Some operating systems have additional +recommended installation or configuration instructions. + +<P> + +<p><br /></p><hr class='online-navigation' /> +<div class='online-navigation'> +<!--Table of Child-Links--> +<A NAME="CHILD_LINKS"><STRONG>Subsections</STRONG></a> + +<UL CLASS="ChildLinks"> +<LI><A href="node47.html">14.1 GNU/Linux issues</a> +<LI><A href="bsd-issues.html">14.2 BSD issues</a> +<LI><A href="node49.html">14.3 MacOSX issues</a> +</ul> +<!--End of Table of Child-Links--> +</div> + +<DIV CLASS="navigation"> +<div class='online-navigation'> +<p></p><hr /> +<table align="center" width="100%" cellpadding="0" cellspacing="2"> +<tr> +<td class='online-navigation'><a rel="prev" title="13 Troubleshooting" + href="troubleshooting.html"><img src='previous.png' + border='0' height='32' alt='Previous Page' width='32' /></A></td> +<td class='online-navigation'><a rel="parent" title="Front Matter" + href="front.html"><img src='up.png' + border='0' height='32' alt='Up One Level' width='32' /></A></td> +<td class='online-navigation'><a rel="next" title="14.1 GNU/Linux issues" + href="node47.html"><img src='next.png' + border='0' height='32' alt='Next Page' width='32' /></A></td> +<td align="center" width="100%">GNU Mailman - Installation Manual</td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +</tr></table> +<div class='online-navigation'> +<b class="navlabel">Previous:</b> +<a class="sectref" rel="prev" href="troubleshooting.html">13 Troubleshooting</A> +<b class="navlabel">Up:</b> +<a class="sectref" rel="parent" href="front.html">Front Matter</A> +<b class="navlabel">Next:</b> +<a class="sectref" rel="next" href="node47.html">14.1 GNU/Linux issues</A> +</div> +</div> +<hr /> +<span class="release-info">Release 2.1, documentation updated on December 13, 2004.</span> +</DIV> +<!--End of Navigation Panel--> + +</BODY> +</HTML> diff --git a/admin/www/mailman-install/node47.html b/admin/www/mailman-install/node47.html new file mode 100644 index 00000000..ad1ad67d --- /dev/null +++ b/admin/www/mailman-install/node47.html @@ -0,0 +1,154 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> +<html> +<head> +<link rel="STYLESHEET" href="mailman-install.css" type='text/css' /> +<link rel="first" href="mailman-install.html" title='GNU Mailman - Installation Manual' /> +<link rel='last' href='about.html' title='About this document...' /> +<link rel='help' href='about.html' title='About this document...' /> +<link rel="next" href="bsd-issues.html" /> +<link rel="prev" href="node46.html" /> +<link rel="parent" href="node46.html" /> +<link rel="next" href="bsd-issues.html" /> +<meta name='aesop' content='information' /> +<title>14.1 GNU/Linux issues</title> +</head> +<body> +<DIV CLASS="navigation"> +<div id='top-navigation-panel' xml:id='top-navigation-panel'> +<table align="center" width="100%" cellpadding="0" cellspacing="2"> +<tr> +<td class='online-navigation'><a rel="prev" title="14 Platform and operating" + href="node46.html"><img src='previous.png' + border='0' height='32' alt='Previous Page' width='32' /></A></td> +<td class='online-navigation'><a rel="parent" title="14 Platform and operating" + href="node46.html"><img src='up.png' + border='0' height='32' alt='Up One Level' width='32' /></A></td> +<td class='online-navigation'><a rel="next" title="14.2 BSD issues" + href="bsd-issues.html"><img src='next.png' + border='0' height='32' alt='Next Page' width='32' /></A></td> +<td align="center" width="100%">GNU Mailman - Installation Manual</td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +</tr></table> +<div class='online-navigation'> +<b class="navlabel">Previous:</b> +<a class="sectref" rel="prev" href="node46.html">14 Platform and operating</A> +<b class="navlabel">Up:</b> +<a class="sectref" rel="parent" href="node46.html">14 Platform and operating</A> +<b class="navlabel">Next:</b> +<a class="sectref" rel="next" href="bsd-issues.html">14.2 BSD issues</A> +</div> +<hr /></div> +</DIV> +<!--End of Navigation Panel--> + +<H2><A NAME="SECTION0011410000000000000000"> +14.1 GNU/Linux issues</A> +</H2> + +<P> +Linux seems to be the most popular platform for running Mailman. Here are +some hints on getting Mailman to run on Linux: + +<P> + +<UL> +<LI>If you are getting errors with hard link creations and/or you are using + a special secure kernel (securelinux/openwall/grsecurity), see the file + <span class="file">contrib/README.check_perms_grsecurity</span> in the Mailman source + distribution. + +<P> +Note that if you are using Linux Mandrake in secure mode, you are + probably concerned by this. + +<P> +</LI> +<LI>Apparently Mandrake 9.0 changed the permissions on gcc, so if you build + as the <code>mailman</code> user, you need to be sure <code>mailman</code> is in the + <code>cctools</code> group. + +<P> +</LI> +<LI>If you installed Python from your Linux distribution's package manager + (e.g. .rpms for Redhat-derived systems or .deb for Debian), you must + install the ``development'' package of Python, or you may not get + everything you need. + +<P> +For example, using Python 2.2 on Debian, you will need to install the + <code>python2.2-dev</code> package. On Redhat, you probably need the + <code>python2-devel</code> package. + +<P> +If you install Python from source, you should be fine. + +<P> +One symptom of this problem, although for unknown reasons, is that you + might get an error such as this during your install: + +<P> +<div class="verbatim"><pre> + Traceback (most recent call last): + File "bin/update", line 44, in ? + import paths + ImportError: No module named paths + make: *** [update] Error 1 +</pre></div> + +<P> +If this happens, install the Python development package and try + <b class="program">configure</b> and <b class="program">make install</b> again. Or install the + latest version of Python from source, available from + <a class="url" href="http://www.python.org">http://www.python.org</a>. + +<P> +This problem can manifest itself in other Linux distributions in + different ways, although usually it appears as <code>ImportErrors</code>. +</LI> +</UL> + +<P> + +<DIV CLASS="navigation"> +<div class='online-navigation'> +<p></p><hr /> +<table align="center" width="100%" cellpadding="0" cellspacing="2"> +<tr> +<td class='online-navigation'><a rel="prev" title="14 Platform and operating" + href="node46.html"><img src='previous.png' + border='0' height='32' alt='Previous Page' width='32' /></A></td> +<td class='online-navigation'><a rel="parent" title="14 Platform and operating" + href="node46.html"><img src='up.png' + border='0' height='32' alt='Up One Level' width='32' /></A></td> +<td class='online-navigation'><a rel="next" title="14.2 BSD issues" + href="bsd-issues.html"><img src='next.png' + border='0' height='32' alt='Next Page' width='32' /></A></td> +<td align="center" width="100%">GNU Mailman - Installation Manual</td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +</tr></table> +<div class='online-navigation'> +<b class="navlabel">Previous:</b> +<a class="sectref" rel="prev" href="node46.html">14 Platform and operating</A> +<b class="navlabel">Up:</b> +<a class="sectref" rel="parent" href="node46.html">14 Platform and operating</A> +<b class="navlabel">Next:</b> +<a class="sectref" rel="next" href="bsd-issues.html">14.2 BSD issues</A> +</div> +</div> +<hr /> +<span class="release-info">Release 2.1, documentation updated on December 13, 2004.</span> +</DIV> +<!--End of Navigation Panel--> + +</BODY> +</HTML> diff --git a/admin/www/mailman-install/node49.html b/admin/www/mailman-install/node49.html new file mode 100644 index 00000000..48878a14 --- /dev/null +++ b/admin/www/mailman-install/node49.html @@ -0,0 +1,127 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> +<html> +<head> +<link rel="STYLESHEET" href="mailman-install.css" type='text/css' /> +<link rel="first" href="mailman-install.html" title='GNU Mailman - Installation Manual' /> +<link rel='last' href='about.html' title='About this document...' /> +<link rel='help' href='about.html' title='About this document...' /> +<link rel="prev" href="bsd-issues.html" /> +<link rel="parent" href="node46.html" /> +<link rel="next" href="about.html" /> +<meta name='aesop' content='information' /> +<title>14.3 MacOSX issues</title> +</head> +<body> +<DIV CLASS="navigation"> +<div id='top-navigation-panel' xml:id='top-navigation-panel'> +<table align="center" width="100%" cellpadding="0" cellspacing="2"> +<tr> +<td class='online-navigation'><a rel="prev" title="14.2 BSD issues" + href="bsd-issues.html"><img src='previous.png' + border='0' height='32' alt='Previous Page' width='32' /></A></td> +<td class='online-navigation'><a rel="parent" title="14 Platform and operating" + href="node46.html"><img src='up.png' + border='0' height='32' alt='Up One Level' width='32' /></A></td> +<td class='online-navigation'><a rel="next" title="About this document ..." + href="about.html"><img src='next.png' + border='0' height='32' alt='Next Page' width='32' /></A></td> +<td align="center" width="100%">GNU Mailman - Installation Manual</td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +</tr></table> +<div class='online-navigation'> +<b class="navlabel">Previous:</b> +<a class="sectref" rel="prev" href="bsd-issues.html">14.2 BSD issues</A> +<b class="navlabel">Up:</b> +<a class="sectref" rel="parent" href="node46.html">14 Platform and operating</A> +<b class="navlabel">Next:</b> +<a class="sectref" rel="next" href="about.html">About this document ...</A> +</div> +<hr /></div> +</DIV> +<!--End of Navigation Panel--> + +<H2><A NAME="SECTION0011430000000000000000"> +14.3 MacOSX issues</A> +</H2> + +<P> +Many people run Mailman on MacOSX. Here are some pointers that have been +collected on getting Mailman to run on MacOSX. + +<P> + +<UL> +<LI>Jaguar (MacOSX 10.2) comes with Python 2.2. While this isn't the very + latest stable version of Python, it ought to be sufficient to run + Mailman 2.1. + +<P> +</LI> +<LI>David B. O'Donnell has a web page describing his configuration of + Mailman 2.0.13 and Postfix on MacOSX Server. + +<P> +<a class="url" href="http://www.afp548.com/Articles/mail/python-mailman.html">http://www.afp548.com/Articles/mail/python-mailman.html</a> +<P> +</LI> +<LI>Kathleen Webb posted her experiences in getting Mailman running on + Jaguar using Sendmail. + +<P> +<a class="url" href="http://mail.python.org/pipermail/mailman-users/2002-October/022944.html">http://mail.python.org/pipermail/mailman-users/2002-October/022944.html</a> +<P> +</LI> +<LI>Panther server (MacOSX 10.3) comes with Mailman; Apple has a tech + document about a problem you might encounter running Mailman on Mac OS X + Server 10.3: + +<P> +<a class="url" href="http://docs.info.apple.com/article.html?artnum=107889">http://docs.info.apple.com/article.html?artnum=107889</a> +</LI> +</UL> + +<P> + +<DIV CLASS="navigation"> +<div class='online-navigation'> +<p></p><hr /> +<table align="center" width="100%" cellpadding="0" cellspacing="2"> +<tr> +<td class='online-navigation'><a rel="prev" title="14.2 BSD issues" + href="bsd-issues.html"><img src='previous.png' + border='0' height='32' alt='Previous Page' width='32' /></A></td> +<td class='online-navigation'><a rel="parent" title="14 Platform and operating" + href="node46.html"><img src='up.png' + border='0' height='32' alt='Up One Level' width='32' /></A></td> +<td class='online-navigation'><a rel="next" title="About this document ..." + href="about.html"><img src='next.png' + border='0' height='32' alt='Next Page' width='32' /></A></td> +<td align="center" width="100%">GNU Mailman - Installation Manual</td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +</tr></table> +<div class='online-navigation'> +<b class="navlabel">Previous:</b> +<a class="sectref" rel="prev" href="bsd-issues.html">14.2 BSD issues</A> +<b class="navlabel">Up:</b> +<a class="sectref" rel="parent" href="node46.html">14 Platform and operating</A> +<b class="navlabel">Next:</b> +<a class="sectref" rel="next" href="about.html">About this document ...</A> +</div> +</div> +<hr /> +<span class="release-info">Release 2.1, documentation updated on December 13, 2004.</span> +</DIV> +<!--End of Navigation Panel--> + +</BODY> +</HTML> diff --git a/admin/www/mailman-install/node6.html b/admin/www/mailman-install/node6.html new file mode 100644 index 00000000..de202700 --- /dev/null +++ b/admin/www/mailman-install/node6.html @@ -0,0 +1,105 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> +<html> +<head> +<link rel="STYLESHEET" href="mailman-install.css" type='text/css' /> +<link rel="first" href="mailman-install.html" title='GNU Mailman - Installation Manual' /> +<link rel='last' href='about.html' title='About this document...' /> +<link rel='help' href='about.html' title='About this document...' /> +<link rel="next" href="node9.html" /> +<link rel="prev" href="node3.html" /> +<link rel="parent" href="front.html" /> +<link rel="next" href="node7.html" /> +<meta name='aesop' content='information' /> +<title>3 Build and install Mailman</title> +</head> +<body> +<DIV CLASS="navigation"> +<div id='top-navigation-panel' xml:id='top-navigation-panel'> +<table align="center" width="100%" cellpadding="0" cellspacing="2"> +<tr> +<td class='online-navigation'><a rel="prev" title="2.2 Create the installation" + href="create-install-dir.html"><img src='previous.png' + border='0' height='32' alt='Previous Page' width='32' /></A></td> +<td class='online-navigation'><a rel="parent" title="Front Matter" + href="front.html"><img src='up.png' + border='0' height='32' alt='Up One Level' width='32' /></A></td> +<td class='online-navigation'><a rel="next" title="3.1 Run configure" + href="node7.html"><img src='next.png' + border='0' height='32' alt='Next Page' width='32' /></A></td> +<td align="center" width="100%">GNU Mailman - Installation Manual</td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +</tr></table> +<div class='online-navigation'> +<b class="navlabel">Previous:</b> +<a class="sectref" rel="prev" href="create-install-dir.html">2.2 Create the installation</A> +<b class="navlabel">Up:</b> +<a class="sectref" rel="parent" href="front.html">Front Matter</A> +<b class="navlabel">Next:</b> +<a class="sectref" rel="next" href="node7.html">3.1 Run configure</A> +</div> +<hr /></div> +</DIV> +<!--End of Navigation Panel--> + +<H1><A NAME="SECTION001300000000000000000"></A><A NAME="building"></A> +<BR> +3 Build and install Mailman +</H1> + +<P> + +<p><br /></p><hr class='online-navigation' /> +<div class='online-navigation'> +<!--Table of Child-Links--> +<A NAME="CHILD_LINKS"><STRONG>Subsections</STRONG></a> + +<UL CLASS="ChildLinks"> +<LI><A href="node7.html">3.1 Run <b class="program">configure</b></a> +<LI><A href="node8.html">3.2 Make and install</a> +</ul> +<!--End of Table of Child-Links--> +</div> + +<DIV CLASS="navigation"> +<div class='online-navigation'> +<p></p><hr /> +<table align="center" width="100%" cellpadding="0" cellspacing="2"> +<tr> +<td class='online-navigation'><a rel="prev" title="2.2 Create the installation" + href="create-install-dir.html"><img src='previous.png' + border='0' height='32' alt='Previous Page' width='32' /></A></td> +<td class='online-navigation'><a rel="parent" title="Front Matter" + href="front.html"><img src='up.png' + border='0' height='32' alt='Up One Level' width='32' /></A></td> +<td class='online-navigation'><a rel="next" title="3.1 Run configure" + href="node7.html"><img src='next.png' + border='0' height='32' alt='Next Page' width='32' /></A></td> +<td align="center" width="100%">GNU Mailman - Installation Manual</td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +</tr></table> +<div class='online-navigation'> +<b class="navlabel">Previous:</b> +<a class="sectref" rel="prev" href="create-install-dir.html">2.2 Create the installation</A> +<b class="navlabel">Up:</b> +<a class="sectref" rel="parent" href="front.html">Front Matter</A> +<b class="navlabel">Next:</b> +<a class="sectref" rel="next" href="node7.html">3.1 Run configure</A> +</div> +</div> +<hr /> +<span class="release-info">Release 2.1, documentation updated on December 13, 2004.</span> +</DIV> +<!--End of Navigation Panel--> + +</BODY> +</HTML> diff --git a/admin/www/mailman-install/node7.html b/admin/www/mailman-install/node7.html new file mode 100644 index 00000000..3406d5a5 --- /dev/null +++ b/admin/www/mailman-install/node7.html @@ -0,0 +1,250 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> +<html> +<head> +<link rel="STYLESHEET" href="mailman-install.css" type='text/css' /> +<link rel="first" href="mailman-install.html" title='GNU Mailman - Installation Manual' /> +<link rel='last' href='about.html' title='About this document...' /> +<link rel='help' href='about.html' title='About this document...' /> +<link rel="next" href="node8.html" /> +<link rel="prev" href="node6.html" /> +<link rel="parent" href="node6.html" /> +<link rel="next" href="node8.html" /> +<meta name='aesop' content='information' /> +<title>3.1 Run configure</title> +</head> +<body> +<DIV CLASS="navigation"> +<div id='top-navigation-panel' xml:id='top-navigation-panel'> +<table align="center" width="100%" cellpadding="0" cellspacing="2"> +<tr> +<td class='online-navigation'><a rel="prev" title="3 Build and install" + href="node6.html"><img src='previous.png' + border='0' height='32' alt='Previous Page' width='32' /></A></td> +<td class='online-navigation'><a rel="parent" title="3 Build and install" + href="node6.html"><img src='up.png' + border='0' height='32' alt='Up One Level' width='32' /></A></td> +<td class='online-navigation'><a rel="next" title="3.2 Make and install" + href="node8.html"><img src='next.png' + border='0' height='32' alt='Next Page' width='32' /></A></td> +<td align="center" width="100%">GNU Mailman - Installation Manual</td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +</tr></table> +<div class='online-navigation'> +<b class="navlabel">Previous:</b> +<a class="sectref" rel="prev" href="node6.html">3 Build and install</A> +<b class="navlabel">Up:</b> +<a class="sectref" rel="parent" href="node6.html">3 Build and install</A> +<b class="navlabel">Next:</b> +<a class="sectref" rel="next" href="node8.html">3.2 Make and install</A> +</div> +<hr /></div> +</DIV> +<!--End of Navigation Panel--> + +<H2><A NAME="SECTION001310000000000000000"> +3.1 Run <b class="program">configure</b></A> +</H2> + +<P> +Before you can install Mailman, you must run <b class="program">configure</b> to set +various installation options your system might need. + +<P> +<div class="note"><b class="label">Note:</b> + +Take special note of the <b class="programopt">--with-mail-gid</b> and +<b class="programopt">--with-cgi-gid</b> options below. You will probably need to use +these. +</div> + +<P> +You should <strong>not</strong> be root while performing the steps in this section. +Do them under your own login, or whatever account you typically use to install +software. You do not need to do these steps as user <code>mailman</code>, but you +could. However, make sure that the login used is a member of the +<code>mailman</code> group as that that group has write permissions to the +<var>$prefix</var> directory made in the previous step. You must also have +permission to create a setgid file in the file system where it resides (NFS +and other mounts can be configured to inhibit setgid settings). + +<P> +If you've installed other GNU software, you should be familiar with the +<b class="program">configure</b> script. Usually you can just <b class="program">cd</b> to the +directory you unpacked the Mailman source tarball into, and run +<b class="program">configure</b> with no arguments: + +<P> +<div class="verbatim"><pre> + % cd mailman-<version> + % ./configure + % make install +</pre></div> + +<P> +The following options allow you to customize your Mailman +installation. + +<P> +<DL> +<DT><STRONG><b class="programopt">--prefix</b>=<var>dir</var></STRONG></DT> +<DD>Standard GNU configure option which changes the base directory that + Mailman is installed into. By default <var>$prefix</var> is + <span class="file">/usr/local/mailman</span>. This directory must already exist, and be set + up as described in <A href="create-install-dir.html#create-install-dir">2.2</A>. + +<P> +</DD> +<DT><STRONG><b class="programopt">--exec-prefix</b>=<var>dir</var></STRONG></DT> +<DD>Standard GNU configure option which lets you specify a different + installation directory for architecture dependent binaries. + +<P> +</DD> +<DT><STRONG><b class="programopt">--with-var-prefix</b>=<var>dir</var></STRONG></DT> +<DD>Store mutable data under <var>dir</var> instead of under the <var>$prefix</var> or + <var>$exec_prefix</var>. Examples of such data include the list archives and + list settings database. + +<P> +</DD> +<DT><STRONG><b class="programopt">--with-python</b>=<span class="file">/path/to/python</span></STRONG></DT> +<DD>Specify an alternative Python interpreter to use for the wrapper programs. + The default is to use the interpreter found first on your shell's + <var>$PATH</var>. + +<P> +</DD> +<DT><STRONG><b class="programopt">--with-username</b>=<var>username-or-uid</var></STRONG></DT> +<DD>Specify a different username than <code>mailman</code>. The value of this + option can be an integer user id or a user name. Be sure your + <var>$prefix</var> directory is owned by this user. + +<P> +</DD> +<DT><STRONG><b class="programopt">--with-groupname</b>=<var>groupname-or-gid</var></STRONG></DT> +<DD>Specify a different groupname than <code>mailman</code>. The value of this + option can be an integer group id or a group name. Be sure your + <var>$prefix</var> directory is group-owned by this group. + +<P> +</DD> +<DT><STRONG><b class="programopt">--with-mail-gid</b>=<var>group-or-groups</var></STRONG></DT> +<DD>Specify an alternative group for running scripts via the mail wrapper. + <var>group-or-groups</var> can be a list of one or more integer group ids or + symbolic group names. The first value in the list that resolves to an + existing group is used. By default, the value is the list <code>mailman</code>, + <code>other</code>, <code>mail</code>, and <code>daemon</code>. + +<P> +<div class="note"><b class="label">Note:</b> + + This is highly system dependent and you must get this right, because the + group id is compiled into the mail wrapper program for added security. On + systems using <b class="program">sendmail</b>, the <span class="file">sendmail.cf</span> configuration + file designates the group id of <b class="program">sendmail</b> processes using the + <var>DefaultUser</var> option. (If commented out, it still may be indicating + the default...) + </div> + +<P> +Check your mail server's documentation and configuration files to find the + right value for this switch. + +<P> +</DD> +<DT><STRONG><b class="programopt">--with-cgi-gid</b>=<var>group-or-groups</var></STRONG></DT> +<DD>Specify an alternative group for running scripts via the CGI wrapper. + <var>group-or-groups</var> can be a list of one or more integer group ids or + symbolic group names. The first value in the list that resolves to an + existing group is used. By default, the value is the the list + <code>www</code>, <code>www-data</code>, and <code>nobody</code>. + +<P> +<div class="note"><b class="label">Note:</b> + + The proper value for this is dependent on your web server configuration. + You must get this right, because the group id is compiled into the CGI + wrapper program for added security, and no Mailman CGI scripts will run if + this is incorrect. + </div> + +<P> +If you're using Apache, check the values for the <var>Group</var> option in + your <span class="file">httpd.conf</span> file. + +<P> +</DD> +<DT><STRONG><b class="programopt">--with-cgi-ext</b>=<var>extension</var></STRONG></DT> +<DD>Specify an extension for cgi-bin programs. The CGI wrappers placed in + <span class="file"><var>$prefix</var>/cgi-bin</span> will have this extension (some web servers + require an extension). <var>extension</var> must include the leading dot. + +<P> +</DD> +<DT><STRONG><b class="programopt">--with-mailhost</b>=<var>hostname</var></STRONG></DT> +<DD>Specify the fully qualified host name part for outgoing email. After the + installation is complete, this value can be overriden in + <span class="file"><var>$prefix</var>/Mailman/mm_cfg.py</span>. + +<P> +</DD> +<DT><STRONG><b class="programopt">--with-urlhost</b>=<var>hostname</var></STRONG></DT> +<DD>Specify the fully qualified host name part of urls. After the + installation is complete, this value can be overriden in + <span class="file"><var>$prefix</var>/Mailman/mm_cfg.py</span>. + +<P> +</DD> +<DT><STRONG><b class="programopt">--with-gcc</b>=no</STRONG></DT> +<DD>Don't use gcc, even if it is found. In this case, <b class="program">cc</b> must be + found on your <var>$PATH</var>. + +<P> +</DD> +</DL> + +<P> + +<DIV CLASS="navigation"> +<div class='online-navigation'> +<p></p><hr /> +<table align="center" width="100%" cellpadding="0" cellspacing="2"> +<tr> +<td class='online-navigation'><a rel="prev" title="3 Build and install" + href="node6.html"><img src='previous.png' + border='0' height='32' alt='Previous Page' width='32' /></A></td> +<td class='online-navigation'><a rel="parent" title="3 Build and install" + href="node6.html"><img src='up.png' + border='0' height='32' alt='Up One Level' width='32' /></A></td> +<td class='online-navigation'><a rel="next" title="3.2 Make and install" + href="node8.html"><img src='next.png' + border='0' height='32' alt='Next Page' width='32' /></A></td> +<td align="center" width="100%">GNU Mailman - Installation Manual</td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +</tr></table> +<div class='online-navigation'> +<b class="navlabel">Previous:</b> +<a class="sectref" rel="prev" href="node6.html">3 Build and install</A> +<b class="navlabel">Up:</b> +<a class="sectref" rel="parent" href="node6.html">3 Build and install</A> +<b class="navlabel">Next:</b> +<a class="sectref" rel="next" href="node8.html">3.2 Make and install</A> +</div> +</div> +<hr /> +<span class="release-info">Release 2.1, documentation updated on December 13, 2004.</span> +</DIV> +<!--End of Navigation Panel--> + +</BODY> +</HTML> diff --git a/admin/www/mailman-install/node8.html b/admin/www/mailman-install/node8.html new file mode 100644 index 00000000..914b7352 --- /dev/null +++ b/admin/www/mailman-install/node8.html @@ -0,0 +1,95 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> +<html> +<head> +<link rel="STYLESHEET" href="mailman-install.css" type='text/css' /> +<link rel="first" href="mailman-install.html" title='GNU Mailman - Installation Manual' /> +<link rel='last' href='about.html' title='About this document...' /> +<link rel='help' href='about.html' title='About this document...' /> +<link rel="prev" href="node7.html" /> +<link rel="parent" href="node6.html" /> +<link rel="next" href="node9.html" /> +<meta name='aesop' content='information' /> +<title>3.2 Make and install</title> +</head> +<body> +<DIV CLASS="navigation"> +<div id='top-navigation-panel' xml:id='top-navigation-panel'> +<table align="center" width="100%" cellpadding="0" cellspacing="2"> +<tr> +<td class='online-navigation'><a rel="prev" title="3.1 Run configure" + href="node7.html"><img src='previous.png' + border='0' height='32' alt='Previous Page' width='32' /></A></td> +<td class='online-navigation'><a rel="parent" title="3 Build and install" + href="node6.html"><img src='up.png' + border='0' height='32' alt='Up One Level' width='32' /></A></td> +<td class='online-navigation'><a rel="next" title="4 Check your installation" + href="node9.html"><img src='next.png' + border='0' height='32' alt='Next Page' width='32' /></A></td> +<td align="center" width="100%">GNU Mailman - Installation Manual</td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +</tr></table> +<div class='online-navigation'> +<b class="navlabel">Previous:</b> +<a class="sectref" rel="prev" href="node7.html">3.1 Run configure</A> +<b class="navlabel">Up:</b> +<a class="sectref" rel="parent" href="node6.html">3 Build and install</A> +<b class="navlabel">Next:</b> +<a class="sectref" rel="next" href="node9.html">4 Check your installation</A> +</div> +<hr /></div> +</DIV> +<!--End of Navigation Panel--> + +<H2><A NAME="SECTION001320000000000000000"> +3.2 Make and install</A> +</H2> + +<P> +Once you've run <b class="program">configure</b>, you can simply run <b class="program">make</b>, then +<b class="program">make install</b> to build and install Mailman. + +<P> + +<DIV CLASS="navigation"> +<div class='online-navigation'> +<p></p><hr /> +<table align="center" width="100%" cellpadding="0" cellspacing="2"> +<tr> +<td class='online-navigation'><a rel="prev" title="3.1 Run configure" + href="node7.html"><img src='previous.png' + border='0' height='32' alt='Previous Page' width='32' /></A></td> +<td class='online-navigation'><a rel="parent" title="3 Build and install" + href="node6.html"><img src='up.png' + border='0' height='32' alt='Up One Level' width='32' /></A></td> +<td class='online-navigation'><a rel="next" title="4 Check your installation" + href="node9.html"><img src='next.png' + border='0' height='32' alt='Next Page' width='32' /></A></td> +<td align="center" width="100%">GNU Mailman - Installation Manual</td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +</tr></table> +<div class='online-navigation'> +<b class="navlabel">Previous:</b> +<a class="sectref" rel="prev" href="node7.html">3.1 Run configure</A> +<b class="navlabel">Up:</b> +<a class="sectref" rel="parent" href="node6.html">3 Build and install</A> +<b class="navlabel">Next:</b> +<a class="sectref" rel="next" href="node9.html">4 Check your installation</A> +</div> +</div> +<hr /> +<span class="release-info">Release 2.1, documentation updated on December 13, 2004.</span> +</DIV> +<!--End of Navigation Panel--> + +</BODY> +</HTML> diff --git a/admin/www/mailman-install/node9.html b/admin/www/mailman-install/node9.html new file mode 100644 index 00000000..793df48b --- /dev/null +++ b/admin/www/mailman-install/node9.html @@ -0,0 +1,122 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> +<html> +<head> +<link rel="STYLESHEET" href="mailman-install.css" type='text/css' /> +<link rel="first" href="mailman-install.html" title='GNU Mailman - Installation Manual' /> +<link rel='last' href='about.html' title='About this document...' /> +<link rel='help' href='about.html' title='About this document...' /> +<link rel="next" href="node10.html" /> +<link rel="prev" href="node6.html" /> +<link rel="parent" href="front.html" /> +<link rel="next" href="node10.html" /> +<meta name='aesop' content='information' /> +<title>4 Check your installation</title> +</head> +<body> +<DIV CLASS="navigation"> +<div id='top-navigation-panel' xml:id='top-navigation-panel'> +<table align="center" width="100%" cellpadding="0" cellspacing="2"> +<tr> +<td class='online-navigation'><a rel="prev" title="3.2 Make and install" + href="node8.html"><img src='previous.png' + border='0' height='32' alt='Previous Page' width='32' /></A></td> +<td class='online-navigation'><a rel="parent" title="Front Matter" + href="front.html"><img src='up.png' + border='0' height='32' alt='Up One Level' width='32' /></A></td> +<td class='online-navigation'><a rel="next" title="5 Set up your" + href="node10.html"><img src='next.png' + border='0' height='32' alt='Next Page' width='32' /></A></td> +<td align="center" width="100%">GNU Mailman - Installation Manual</td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +</tr></table> +<div class='online-navigation'> +<b class="navlabel">Previous:</b> +<a class="sectref" rel="prev" href="node8.html">3.2 Make and install</A> +<b class="navlabel">Up:</b> +<a class="sectref" rel="parent" href="front.html">Front Matter</A> +<b class="navlabel">Next:</b> +<a class="sectref" rel="next" href="node10.html">5 Set up your</A> +</div> +<hr /></div> +</DIV> +<!--End of Navigation Panel--> + +<H1><A NAME="SECTION001400000000000000000"> +4 Check your installation</A> +</H1> + +<P> +After you've run <b class="program">make install</b>, you should check that your +installation has all the correct permissions and group ownerships by running +the <b class="program">check_perms</b> script. First change to the installation +(i.e. <var>$prefix</var>) directory, then run the <b class="program">bin/check_perms</b> +program. Don't try to run bin/check_perms from the source directory; it will +only run from the installation directory. + +<P> +If this reports no problems, then it's very likely <wink> that your +installation is set up correctly. If it reports problems, then you can either +fix them manually, re-run the installation, or use <b class="program">bin/check_perms</b> +to fix the problems (probably the easiest solution): + +<P> + +<UL> +<LI>You need to become the user that did the installation, and that owns all + the files in <var>$prefix</var>, or root. + +<P> +</LI> +<LI>Run <b class="program">bin/check_perms -f</b> + +<P> +</LI> +<LI>Repeat previous step until no more errors are reported! +</LI> +</UL> + +<P> + +<DIV CLASS="navigation"> +<div class='online-navigation'> +<p></p><hr /> +<table align="center" width="100%" cellpadding="0" cellspacing="2"> +<tr> +<td class='online-navigation'><a rel="prev" title="3.2 Make and install" + href="node8.html"><img src='previous.png' + border='0' height='32' alt='Previous Page' width='32' /></A></td> +<td class='online-navigation'><a rel="parent" title="Front Matter" + href="front.html"><img src='up.png' + border='0' height='32' alt='Up One Level' width='32' /></A></td> +<td class='online-navigation'><a rel="next" title="5 Set up your" + href="node10.html"><img src='next.png' + border='0' height='32' alt='Next Page' width='32' /></A></td> +<td align="center" width="100%">GNU Mailman - Installation Manual</td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +</tr></table> +<div class='online-navigation'> +<b class="navlabel">Previous:</b> +<a class="sectref" rel="prev" href="node8.html">3.2 Make and install</A> +<b class="navlabel">Up:</b> +<a class="sectref" rel="parent" href="front.html">Front Matter</A> +<b class="navlabel">Next:</b> +<a class="sectref" rel="next" href="node10.html">5 Set up your</A> +</div> +</div> +<hr /> +<span class="release-info">Release 2.1, documentation updated on December 13, 2004.</span> +</DIV> +<!--End of Navigation Panel--> + +</BODY> +</HTML> diff --git a/admin/www/mailman-install/postfix-virtual.html b/admin/www/mailman-install/postfix-virtual.html new file mode 100644 index 00000000..7d7a137e --- /dev/null +++ b/admin/www/mailman-install/postfix-virtual.html @@ -0,0 +1,196 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> +<html> +<head> +<link rel="STYLESHEET" href="mailman-install.css" type='text/css' /> +<link rel="first" href="mailman-install.html" title='GNU Mailman - Installation Manual' /> +<link rel='last' href='about.html' title='About this document...' /> +<link rel='help' href='about.html' title='About this document...' /> +<link rel="next" href="node15.html" /> +<link rel="prev" href="node13.html" /> +<link rel="parent" href="node12.html" /> +<link rel="next" href="node15.html" /> +<meta name='aesop' content='information' /> +<title>6.1.2 Virtual domains</title> +</head> +<body> +<DIV CLASS="navigation"> +<div id='top-navigation-panel' xml:id='top-navigation-panel'> +<table align="center" width="100%" cellpadding="0" cellspacing="2"> +<tr> +<td class='online-navigation'><a rel="prev" title="6.1.1 Integrating Postfix and" + href="node13.html"><img src='previous.png' + border='0' height='32' alt='Previous Page' width='32' /></A></td> +<td class='online-navigation'><a rel="parent" title="6.1 Using the Postfix" + href="node12.html"><img src='up.png' + border='0' height='32' alt='Up One Level' width='32' /></A></td> +<td class='online-navigation'><a rel="next" title="6.1.3 An alternative approach" + href="node15.html"><img src='next.png' + border='0' height='32' alt='Next Page' width='32' /></A></td> +<td align="center" width="100%">GNU Mailman - Installation Manual</td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +</tr></table> +<div class='online-navigation'> +<b class="navlabel">Previous:</b> +<a class="sectref" rel="prev" href="node13.html">6.1.1 Integrating Postfix and</A> +<b class="navlabel">Up:</b> +<a class="sectref" rel="parent" href="node12.html">6.1 Using the Postfix</A> +<b class="navlabel">Next:</b> +<a class="sectref" rel="next" href="node15.html">6.1.3 An alternative approach</A> +</div> +<hr /></div> +</DIV> +<!--End of Navigation Panel--> + +<H3><A NAME="SECTION001612000000000000000"></A><A NAME="postfix-virtual"></A> +<BR> +6.1.2 Virtual domains +</H3> + +<P> +Postfix 2.0 supports ``virtual alias domains'', essentially what used to be +called ``Postfix-style virtual domains'' in earlier Postfix versions. To make +virtual alias domains work with Mailman, you need to do some setup in both +Postfix and Mailman. Mailman will write all virtual alias mappings to a file +called, by default, <span class="file">/usr/local/mailman/data/virtual-mailman</span>. It will +also use <b class="program">postmap</b> to create the <b class="program">virtual-mailman.db</b> file +that Postfix will actually use. + +<P> +First, you need to set up the Postfix virtual alias domains as described in +the Postfix documentation (see Postfix's <code>virtual(5)</code> manpage). Note +that it's your responsibility to include the <code>virtual-alias.domain +anything</code> line as described manpage; Mailman will not include this line in +<span class="file">virtual-mailman</span>. You are highly encouraged to make sure your virtual +alias domains are working properly before integrating with Mailman. + +<P> +Next, add a path to Postfix's <var>virtual_alias_maps</var> variable, pointing to +the virtual-mailman file, e.g.: + +<P> +<div class="verbatim"><pre> + virtual_alias_maps = <your normal virtual alias files>, + hash:/usr/local/mailman/data/virtual-mailman +</pre></div> + +<P> +assuming you've installed Mailman in the default location. If you're using an +older version of Postfix which doesn't have the <var>virtual_alias_maps</var> +variable, use the <var>virtual_maps</var> variable instead. + +<P> +Next, in your <span class="file">mm_cfg.py</span> file, you will want to set the variable +<var>POSTFIX_STYLE_VIRTUAL_DOMAINS</var> to the list of virtual domains that Mailman +should update. This may not be all of the virtual alias domains that your +Postfix installation supports! The values in this list will be matched +against the <var>host_name</var> attribute of mailing lists objects, and must be an +exact match. + +<P> +Here's an example. Say that Postfix is configured to handle the virtual +domains <code>dom1.ain</code>, <code>dom2.ain</code>, and <code>dom3.ain</code>, and further +that in your <span class="file">main.cf</span> file you've got the following settings: + +<P> +<div class="verbatim"><pre> + myhostname = mail.dom1.ain + mydomain = dom1.ain + mydestination = $myhostname, localhost.$mydomain + virtual_alias_maps = + hash:/some/path/to/virtual-dom1, + hash:/some/path/to/virtual-dom2, + hash:/some/path/to/virtual-dom2 +</pre></div> + +<P> +If in your <span class="file">virtual-dom1</span> file, you've got the following lines: + +<P> +<div class="verbatim"><pre> + dom1.ain IGNORE + @dom1.ain @mail.dom1.ain +</pre></div> + +<P> +this tells Postfix to deliver anything addressed to <code>dom1.ain</code> to the +same mailbox at <code>mail.dom1.com</code>, its default destination. + +<P> +In this case you would not include <code>dom1.ain</code> in +<var>POSTFIX_STYLE_VIRTUAL_DOMAINS</var> because otherwise Mailman will write +entries for mailing lists in the dom1.ain domain as + +<P> +<div class="verbatim"><pre> + mylist@dom1.ain mylist + mylist-request@dom1.ain mylist-request + # and so on... +</pre></div> + +<P> +The more specific entries trump your more general entries, thus breaking the +delivery of any <code>dom1.ain</code> mailing list. + +<P> +However, you would include <code>dom2.ain</code> and <code>dom3.ain</code> in +<span class="file">mm_cfg.py</span>: + +<P> +<div class="verbatim"><pre> + POSTFIX_STYLE_VIRTUAL_DOMAINS = ['dom2.ain', 'dom3.ain'] +</pre></div> + +<P> +Now, any list that Mailman creates in either of those two domains, will have +the correct entries written to <span class="file">/usr/local/mailman/data/virtual-mailman</span>. + +<P> +As above with the <span class="file">data/aliases*</span> files, you want to make sure that both +<span class="file">data/virtual-mailman</span> and <span class="file">data/virtual-mailman.db</span> are user and +group owned by <code>mailman</code>. + +<P> + +<DIV CLASS="navigation"> +<div class='online-navigation'> +<p></p><hr /> +<table align="center" width="100%" cellpadding="0" cellspacing="2"> +<tr> +<td class='online-navigation'><a rel="prev" title="6.1.1 Integrating Postfix and" + href="node13.html"><img src='previous.png' + border='0' height='32' alt='Previous Page' width='32' /></A></td> +<td class='online-navigation'><a rel="parent" title="6.1 Using the Postfix" + href="node12.html"><img src='up.png' + border='0' height='32' alt='Up One Level' width='32' /></A></td> +<td class='online-navigation'><a rel="next" title="6.1.3 An alternative approach" + href="node15.html"><img src='next.png' + border='0' height='32' alt='Next Page' width='32' /></A></td> +<td align="center" width="100%">GNU Mailman - Installation Manual</td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +</tr></table> +<div class='online-navigation'> +<b class="navlabel">Previous:</b> +<a class="sectref" rel="prev" href="node13.html">6.1.1 Integrating Postfix and</A> +<b class="navlabel">Up:</b> +<a class="sectref" rel="parent" href="node12.html">6.1 Using the Postfix</A> +<b class="navlabel">Next:</b> +<a class="sectref" rel="next" href="node15.html">6.1.3 An alternative approach</A> +</div> +</div> +<hr /> +<span class="release-info">Release 2.1, documentation updated on December 13, 2004.</span> +</DIV> +<!--End of Navigation Panel--> + +</BODY> +</HTML> diff --git a/admin/www/mailman-install/previous.png b/admin/www/mailman-install/previous.png Binary files differnew file mode 100644 index 00000000..497def42 --- /dev/null +++ b/admin/www/mailman-install/previous.png diff --git a/admin/www/mailman-install/qmail-issues.html b/admin/www/mailman-install/qmail-issues.html new file mode 100644 index 00000000..7c3c7955 --- /dev/null +++ b/admin/www/mailman-install/qmail-issues.html @@ -0,0 +1,308 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> +<html> +<head> +<link rel="STYLESHEET" href="mailman-install.css" type='text/css' /> +<link rel="first" href="mailman-install.html" title='GNU Mailman - Installation Manual' /> +<link rel='last' href='about.html' title='About this document...' /> +<link rel='help' href='about.html' title='About this document...' /> +<link rel="prev" href="node31.html" /> +<link rel="parent" href="mail-server.html" /> +<link rel="next" href="node36.html" /> +<meta name='aesop' content='information' /> +<title>6.4 Using the Qmail mail server</title> +</head> +<body> +<DIV CLASS="navigation"> +<div id='top-navigation-panel' xml:id='top-navigation-panel'> +<table align="center" width="100%" cellpadding="0" cellspacing="2"> +<tr> +<td class='online-navigation'><a rel="prev" title="6.3.3 Performance notes" + href="node34.html"><img src='previous.png' + border='0' height='32' alt='Previous Page' width='32' /></A></td> +<td class='online-navigation'><a rel="parent" title="6 Set up your" + href="mail-server.html"><img src='up.png' + border='0' height='32' alt='Up One Level' width='32' /></A></td> +<td class='online-navigation'><a rel="next" title="6.4.1 Information on VERP" + href="node36.html"><img src='next.png' + border='0' height='32' alt='Next Page' width='32' /></A></td> +<td align="center" width="100%">GNU Mailman - Installation Manual</td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +</tr></table> +<div class='online-navigation'> +<b class="navlabel">Previous:</b> +<a class="sectref" rel="prev" href="node34.html">6.3.3 Performance notes</A> +<b class="navlabel">Up:</b> +<a class="sectref" rel="parent" href="mail-server.html">6 Set up your</A> +<b class="navlabel">Next:</b> +<a class="sectref" rel="next" href="node36.html">6.4.1 Information on VERP</A> +</div> +<hr /></div> +</DIV> +<!--End of Navigation Panel--> + +<H2><A NAME="SECTION001640000000000000000"></A><A NAME="qmail-issues"></A> +<BR> +6.4 Using the Qmail mail server +</H2> + +<P> +There are some issues that users of the qmail mail transport agent have +encountered. None of the core maintainers use qmail, so all of this +information has been contributed by the Mailman user community, especially +Martin Preishuber and Christian Tismer, with notes by Balazs Nagy (BN) and +Norbert Bollow (NB). + +<P> + +<UL> +<LI>You might need to set the mail-gid user to either <code>qmail</code>, + <code>mailman</code>, or <code>nofiles</code> by using the + <b class="programopt">--with-mail-gid</b> <b class="program">configure</b> option. + +<P> +<em>BN:</em> it highly depends on your mail storing policy. For example + if you use the simple <span class="file"> alias/.qmail-*</span> files, you can use + <b class="program">`id -g alias`</b>. But if you use <span class="file">/var/qmail/users</span>, the + specified mail gid can be used. + +<P> +If you are going to be directing virtual domains directly to the + <code>mailman</code> user (using ``virtualdomains'' on a list-only domain, for + example), you will have to use <b class="programopt">--with-mail-gid</b>=<var>gid + of mailman user's group</var>. This is incompatible with having list aliases + in <span class="file"> alias</span>, unless that alias simply forwards to + <code>mailman-listname*</code>. + +<P> +</LI> +<LI>If there is a user <code>mailman</code> on your system, the alias + <code>mailman-owner</code> will work only in <span class="file"> mailman</span>. You have to do + a <b class="program">touch .qmail-owner</b> in <span class="file"> mailman</span> directory to create + this alias. + +<P> +<em>NB:</em> An alternative, IMHO better solution is to <b class="program">chown + root mailman</b>, that will stop qmail from considering <code>mailman</code> to + be a user to whom mail can be delivered. (See ``man 8 qmail-getpw''.) + +<P> +</LI> +<LI>In a related issue, if you have any users with the same name as one of + your mailing lists, you will have problems if list names contain + "<tt class="samp">-</tt>" in them. Putting <span class="file">.qmail</span> redirections into the user's + home directory doesn't work because the Mailman wrappers will not get + spawned with the proper GID. The solution is to put the following lines + in the <span class="file">/var/qmail/users/assign</span> file: + +<P> +<div class="verbatim"><pre> + +zope-:alias:112:11:/var/qmail/alias:-:zope-: + . +</pre></div> + +<P> +where in this case the listname is e.g. <code>zope-users</code>. + +<P> +<em>NB:</em> Alternatively, you could host the lists on a virtual domain, + and use the <span class="file">/var/qmail/control/virtualdomains</span> file to put the + <code>mailman</code> user in charge of this virtual domain. + +<P> +</LI> +<LI><em>BN:</em>If inbound messages are delivered by another user than + <code>mailman</code>, it's necessary to allow it to access <span class="file"> mailman</span>. + Be sure that <span class="file"> mailman</span> has group writing access and setgid bit is + set. Then put the delivering user to <code>mailman</code> group, and you can + deny access to <span class="file"> mailman</span> to others. Be sure that you can do the + same with the WWW service. + +<P> +By the way the best thing is to make a virtual mail server to handle all + of the mail. <em>NB:</em> E.g. make an additional "A" DNS record for the + virtual mailserver pointing to your IP address, add the line + <code>lists.kva.hu:mailman</code> to <span class="file">/var/qmail/control/virtualdomains</span> + and a <code>lists.kva.hu</code> line to <span class="file">/var/qmail/control/rcpthosts</span> + file. Don't forget to HUP the qmail-send after modifying + ``virtualdomains''. Then every mail to lists.kva.hu will arrive to + mail.kva.hu's mailman user. + +<P> +Then make your aliases: + +<P> +<div class="verbatim"><pre> + .qmail => mailman@...'s letters + .qmail-owner => mailman-owner's letters +</pre></div> + +<P> +For list aliases, you can either create them manually: + +<P> +<div class="verbatim"><pre> + .qmail-list => posts to the 'list' list + .qmail-list-admin => posts to the 'list's owner + .qmail-list-request => requests to 'list' + etc +</pre></div> + +<P> +or for automatic list alias handling (when using the lists.kva.hu + virtual as above), see <span class="file">contrib/qmail-to-mailman.py</span> in the Mailman + source distribution. Modify the <span class="file"> mailman/.qmail-default</span> to + include: + +<P> +<div class="verbatim"><pre> + |/path/to/python /path/to/qmail-to-mailman.py +</pre></div> + +<P> +and new lists will automatically be picked up. + +<P> +</LI> +<LI>You have to make sure that the localhost can relay. If you start qmail + via inetd and tcpenv, you need some line the following in your + <span class="file">/etc/hosts.allow</span> file: + +<P> +<div class="verbatim"><pre> + tcp-env: 127. 10.205.200 : setenv RELAYCLIENT +</pre></div> + +<P> +where 10.205.200. is your IP address block. If you use tcpserver, then + you need something like the following in your <span class="file">/etc/tcp.smtp</span> file: + +<P> +<div class="verbatim"><pre> + 10.205.200.:allow,RELAYCLIENT="" + 127.:allow,RELAYCLIENT="" +</pre></div> + +<P> +</LI> +<LI><em>BN:</em> Bigger <span class="file">/var/qmail/control/concurrencyremote</span> values + work better sending outbound messages, within reason. Unless you know + your system can handle it (many if not most cannot) this should not be + set to a value greater than 120. + +<P> +</LI> +<LI>More information about setting up qmail and relaying can be found in the + qmail documentation. +</LI> +</UL> + +<P> +<em>BN:</em> Last but not least, here's a little script to generate aliases to +your lists (if for some reason you can/will not have them automatically picked +up using <span class="file">contrib/qmail-to-mailman.py</span>): + +<P> +This script is for the Mailman 2.0 series: + +<P> +<div class="verbatim"><pre> +#!/bin/sh +if [ $# = 1 ]; then + i=$1 + echo Making links to $i in the current directory... + echo "|preline /home/mailman/mail/mailman post $i" > .qmail-$i + echo "|preline /home/mailman/mail/mailman mailowner $i" > .qmail-$i-admin + echo "|preline /home/mailman/mail/mailman mailowner $i" > .qmail-$i-owner + echo "|preline /home/mailman/mail/mailman mailowner $i" > .qmail-owner-$i + echo "|preline /home/mailman/mail/mailman mailcmd $i" > .qmail-$i-request +fi +</pre></div> + +<P> +<div class="note"><b class="label">Note:</b> + +This is for a new Mailman 2.1 installation. Users upgrading from +Mailman 2.0 would most likely change <span class="file">/usr/local/mailman</span> to +<span class="file">/home/mailman</span>. If in doubt, refer to the <b class="programopt">--prefix</b> +option passed to <b class="program">configure</b> during compile time. +</div> + +<P> +<div class="verbatim"><pre> +#!/bin/sh +if [ $# = 1 ]; then + i=$1 + echo Making links to $i in the current directory... + echo "|preline /usr/local/mailman/mail/mailman post $i" > .qmail-$i + echo "|preline /usr/local/mailman/mail/mailman admin $i" > .qmail-$i-admin + echo "|preline /usr/local/mailman/mail/mailman bounces $i" > .qmail-$i-bounces + # The following line is for VERP + # echo "|preline /usr/local/mailman/mail/mailman bounces $i" > .qmail-$i-bounces-default + echo "|preline /usr/local/mailman/mail/mailman confirm $i" > .qmail-$i-confirm + echo "|preline /usr/local/mailman/mail/mailman join $i" > .qmail-$i-join + echo "|preline /usr/local/mailman/mail/mailman leave $i" > .qmail-$i-leave + echo "|preline /usr/local/mailman/mail/mailman owner $i" > .qmail-$i-owner + echo "|preline /usr/local/mailman/mail/mailman request $i" > .qmail-$i-request + echo "|preline /usr/local/mailman/mail/mailman subscribe $i" > .qmail-$i-subscribe + echo "|preline /usr/local/mailman/mail/mailman unsubscribe $i" > .qmail-$i-unsubscribe +fi +</pre></div> + +<P> + +<p><br /></p><hr class='online-navigation' /> +<div class='online-navigation'> +<!--Table of Child-Links--> +<A NAME="CHILD_LINKS"><STRONG>Subsections</STRONG></a> + +<UL CLASS="ChildLinks"> +<LI><A href="node36.html">6.4.1 Information on VERP</a> +<LI><A href="node37.html">6.4.2 Virtual mail server</a> +<LI><A href="node38.html">6.4.3 More information</a> +</ul> +<!--End of Table of Child-Links--> +</div> + +<DIV CLASS="navigation"> +<div class='online-navigation'> +<p></p><hr /> +<table align="center" width="100%" cellpadding="0" cellspacing="2"> +<tr> +<td class='online-navigation'><a rel="prev" title="6.3.3 Performance notes" + href="node34.html"><img src='previous.png' + border='0' height='32' alt='Previous Page' width='32' /></A></td> +<td class='online-navigation'><a rel="parent" title="6 Set up your" + href="mail-server.html"><img src='up.png' + border='0' height='32' alt='Up One Level' width='32' /></A></td> +<td class='online-navigation'><a rel="next" title="6.4.1 Information on VERP" + href="node36.html"><img src='next.png' + border='0' height='32' alt='Next Page' width='32' /></A></td> +<td align="center" width="100%">GNU Mailman - Installation Manual</td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +</tr></table> +<div class='online-navigation'> +<b class="navlabel">Previous:</b> +<a class="sectref" rel="prev" href="node34.html">6.3.3 Performance notes</A> +<b class="navlabel">Up:</b> +<a class="sectref" rel="parent" href="mail-server.html">6 Set up your</A> +<b class="navlabel">Next:</b> +<a class="sectref" rel="next" href="node36.html">6.4.1 Information on VERP</A> +</div> +</div> +<hr /> +<span class="release-info">Release 2.1, documentation updated on December 13, 2004.</span> +</DIV> +<!--End of Navigation Panel--> + +</BODY> +</HTML> diff --git a/admin/www/mailman-install/troubleshooting.html b/admin/www/mailman-install/troubleshooting.html new file mode 100644 index 00000000..20980a3f --- /dev/null +++ b/admin/www/mailman-install/troubleshooting.html @@ -0,0 +1,259 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> +<html> +<head> +<link rel="STYLESHEET" href="mailman-install.css" type='text/css' /> +<link rel="first" href="mailman-install.html" title='GNU Mailman - Installation Manual' /> +<link rel='last' href='about.html' title='About this document...' /> +<link rel='help' href='about.html' title='About this document...' /> +<link rel="next" href="node46.html" /> +<link rel="prev" href="node44.html" /> +<link rel="parent" href="front.html" /> +<link rel="next" href="node46.html" /> +<meta name='aesop' content='information' /> +<title>13 Troubleshooting</title> +</head> +<body> +<DIV CLASS="navigation"> +<div id='top-navigation-panel' xml:id='top-navigation-panel'> +<table align="center" width="100%" cellpadding="0" cellspacing="2"> +<tr> +<td class='online-navigation'><a rel="prev" title="12 Create your first" + href="node44.html"><img src='previous.png' + border='0' height='32' alt='Previous Page' width='32' /></A></td> +<td class='online-navigation'><a rel="parent" title="Front Matter" + href="front.html"><img src='up.png' + border='0' height='32' alt='Up One Level' width='32' /></A></td> +<td class='online-navigation'><a rel="next" title="14 Platform and operating" + href="node46.html"><img src='next.png' + border='0' height='32' alt='Next Page' width='32' /></A></td> +<td align="center" width="100%">GNU Mailman - Installation Manual</td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +</tr></table> +<div class='online-navigation'> +<b class="navlabel">Previous:</b> +<a class="sectref" rel="prev" href="node44.html">12 Create your first</A> +<b class="navlabel">Up:</b> +<a class="sectref" rel="parent" href="front.html">Front Matter</A> +<b class="navlabel">Next:</b> +<a class="sectref" rel="next" href="node46.html">14 Platform and operating</A> +</div> +<hr /></div> +</DIV> +<!--End of Navigation Panel--> + +<H1><A NAME="SECTION0011300000000000000000"></A><A NAME="troubleshooting"></A> +<BR> +13 Troubleshooting +</H1> + +<P> +If you encounter problems with running Mailman, first check the question and +answer section below. If your problem is not covered there, check the +<a class="ulink" href="http://www.list.org/help.html" + >online help</a>, including the +<a class="ulink" href="http://www.list.org/faq.html" + >FAQ</a> and the +<a class="ulink" href="http://www.python.org/cgi-bin/faqw-mm.py" + >interactive FAQ wizard</a>. + +<P> +Also check for errors in your syslog files, your mail and web server log files +and in Mailman's <span class="file"><var>$prefix</var>/logs/error</span> file. If you're still +having problems, you should send a message to the +<span class="email">mailman-users@python.org</span> mailing list<A NAME="tex2html6" + HREF="#foot598"><SUP>6</SUP></A>; see +<a class="url" href="http://mail.python.org/mailman/listinfo/mailman-users">http://mail.python.org/mailman/listinfo/mailman-users</a> for more +information. + +<P> +Be sure to including information on your operating system, which version of +Python you're using, and which version of Mailman you're installing. + +<P> +Here is a list of some common questions and answers: + +<P> + +<UL> +<LI><strong>Problem:</strong> All Mailman web pages give a 404 File not found + error. + +<P> +<strong>Solution:</strong> Your web server has not been set up properly for + handling Mailman's CGI programs. Make sure you have: + +<P> + +<OL> +<LI>configured the web server to give permissions to + <span class="file"><var>$prefix</var>/cgi-bin</span> + +<P> +</LI> +<LI>restarted the web server properly. + +</LI> +</OL> + +<P> +Consult your web server's documentation for instructions on how to do + check these issues. + +<P> +</LI> +<LI><strong>Problem:</strong> All Mailman web pages give an "Internal Server + Error". + +<P> +<strong>Solution:</strong> The likely problem is that you are using the wrong + user or group for the CGI scripts. Check your web server's log files. + If you see a line like + +<P> +<div class="verbatim"><pre> + Attempt to exec script with invalid gid 51, expected 99 +</pre></div> + +<P> +you will need to reinstall Mailman, specifying the proper CGI group id, + as described in the <A NAME="building"></A> section. + +<P> +</LI> +<LI><strong>Problem:</strong> I send mail to the list, and get back mail saying the + list is not found! + +<P> +<strong>Solution:</strong> You probably didn't add the necessary aliases to the + system alias database, or you didn't properly integration Mailman with + your mail server. Perhaps you didn't update the alias database, or your + system requires you to run <b class="program">newaliases</b> explicitly. Refer to + your server specific instructions in the <A href="mail-server.html#mail-server">6</A> section. + +<P> +</LI> +<LI><strong>Problem:</strong> I send mail to the list, and get back mail saying, + ``unknown mailer error''. + +<P> +<strong>Solution:</strong> The likely problem is that you are using the wrong + user or group id for the mail wrappers. Check your mail server's log + files; if you see a line like + +<P> +<div class="verbatim"><pre> + Attempt to exec script with invalid gid 51, expected 99 +</pre></div> + +<P> +you will need to reinstall Mailman, specifying the proper mail group id + as described in the <A NAME="building"></A> section. + +<P> +</LI> +<LI><strong>Problem:</strong> I use Postfix as my mail server and the mail wrapper + programs are logging complaints about the wrong GID. + +<P> +<strong>Solution:</strong> Make sure the <span class="file"><var>$prefix</var>/data/aliases.db</span> + file is user owned by <code>mailman</code> (or whatever user name you used + in the <b class="program">configure</b> command). If this file is not user owned by + <code>mailman</code>, Postfix will not run the mail programs as the correct + user. + +<P> +</LI> +<LI><strong>Problem:</strong> I use Sendmail as my mail server, and when I send mail + to the list, I get back mail saying, ``sh: mailman not available for + sendmail programs''. + +<P> +<strong>Solution:</strong> Your system uses the Sendmail restricted shell + (smrsh). You need to configure smrsh by creating a symbolic link from + the mail wrapper (<span class="file"><var>$prefix</var>/mail/mailman</span>) to the directory + identifying executables allowed to run under smrsh. + +<P> +Some common names for this directory are <span class="file">/var/admin/sm.bin</span>, + <span class="file">/usr/admin/sm.bin</span> or <span class="file">/etc/smrsh</span>. + +<P> +Note that on Debian Linux, the system makes <span class="file">/usr/lib/sm.bin</span>, + which is wrong, you will need to create the directory + <span class="file">/usr/admin/sm.bin</span> and add the link there. Note further any + aliases <b class="program">newaliases</b> spits out will need to be adjusted to point + to the secure link to the wrapper. + +<P> +</LI> +<LI><strong>Problem:</strong> I messed up when I called <b class="program">configure</b>. How + do I clean things up and re-install? + +<P> +<strong>Solution:</strong> + +<P> +<div class="verbatim"><pre> + % make clean + % ./configure --with-the-right-options + % make install + </pre></div> + +<P> +</LI> +</UL> + +<P> +<BR><HR><H4>Footnotes</H4> +<DL> +<DT><A NAME="foot598">... list</A><A + href="troubleshooting.html#tex2html6"><SUP>6</SUP></A></DT> +<DD>You must subscribe to +this mailing list in order to post to it, but the mailing list's archives are +publicly visible. + +</DD> +</DL> +<DIV CLASS="navigation"> +<div class='online-navigation'> +<p></p><hr /> +<table align="center" width="100%" cellpadding="0" cellspacing="2"> +<tr> +<td class='online-navigation'><a rel="prev" title="12 Create your first" + href="node44.html"><img src='previous.png' + border='0' height='32' alt='Previous Page' width='32' /></A></td> +<td class='online-navigation'><a rel="parent" title="Front Matter" + href="front.html"><img src='up.png' + border='0' height='32' alt='Up One Level' width='32' /></A></td> +<td class='online-navigation'><a rel="next" title="14 Platform and operating" + href="node46.html"><img src='next.png' + border='0' height='32' alt='Next Page' width='32' /></A></td> +<td align="center" width="100%">GNU Mailman - Installation Manual</td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +</tr></table> +<div class='online-navigation'> +<b class="navlabel">Previous:</b> +<a class="sectref" rel="prev" href="node44.html">12 Create your first</A> +<b class="navlabel">Up:</b> +<a class="sectref" rel="parent" href="front.html">Front Matter</A> +<b class="navlabel">Next:</b> +<a class="sectref" rel="next" href="node46.html">14 Platform and operating</A> +</div> +</div> +<hr /> +<span class="release-info">Release 2.1, documentation updated on December 13, 2004.</span> +</DIV> +<!--End of Navigation Panel--> + +</BODY> +</HTML> diff --git a/admin/www/mailman-install/up.png b/admin/www/mailman-install/up.png Binary files differnew file mode 100644 index 00000000..a90e0284 --- /dev/null +++ b/admin/www/mailman-install/up.png |
