diff options
Diffstat (limited to 'doc/mailman-install')
66 files changed, 7799 insertions, 0 deletions
diff --git a/doc/mailman-install/about.html b/doc/mailman-install/about.html new file mode 100644 index 00000000..04ba5851 --- /dev/null +++ b/doc/mailman-install/about.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="prev" href="front.html" /> +<link rel="parent" href="mailman-install.html" /> +<meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> +<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="15.3 macosx issues" + href="node50.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="node50.html">15.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 5, 2007, 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="15.3 macosx issues" + href="node50.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="node50.html">15.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 5, 2007.</span> +</div> +<!--End of Navigation Panel--> + +</body> +</html> diff --git a/doc/mailman-install/blank.png b/doc/mailman-install/blank.png Binary files differnew file mode 100644 index 00000000..2af5639b --- /dev/null +++ b/doc/mailman-install/blank.png diff --git a/doc/mailman-install/bsd-issues.html b/doc/mailman-install/bsd-issues.html new file mode 100644 index 00000000..932283e2 --- /dev/null +++ b/doc/mailman-install/bsd-issues.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="node50.html" /> +<link rel="prev" href="node48.html" /> +<link rel="parent" href="node47.html" /> +<link rel="next" href="node50.html" /> +<meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> +<meta name='aesop' content='information' /> +<title>15.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="15.1 GNU/Linux issues" + href="node48.html"><img src='previous.png' + border='0' height='32' alt='Previous Page' width='32' /></a></td> +<td class='online-navigation'><a rel="parent" title="15 platform and operating" + href="node47.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="15.3 macosx issues" + href="node50.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="node48.html">15.1 GNU/Linux issues</a> +<b class="navlabel">Up:</b> +<a class="sectref" rel="parent" href="node47.html">15 Platform and operating</a> +<b class="navlabel">Next:</b> +<a class="sectref" rel="next" href="node50.html">15.3 MacOSX issues</a> +</div> +<hr /></div> +</div> +<!--End of Navigation Panel--> + +<h2><a name="SECTION0011520000000000000000"></a><a name="bsd-issues"></a> +<br> +15.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="15.1 GNU/Linux issues" + href="node48.html"><img src='previous.png' + border='0' height='32' alt='Previous Page' width='32' /></a></td> +<td class='online-navigation'><a rel="parent" title="15 platform and operating" + href="node47.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="15.3 macosx issues" + href="node50.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="node48.html">15.1 GNU/Linux issues</a> +<b class="navlabel">Up:</b> +<a class="sectref" rel="parent" href="node47.html">15 Platform and operating</a> +<b class="navlabel">Next:</b> +<a class="sectref" rel="next" href="node50.html">15.3 MacOSX issues</a> +</div> +</div> +<hr /> +<span class="release-info">Release 2.1, documentation updated on December 5, 2007.</span> +</div> +<!--End of Navigation Panel--> + +</body> +</html> diff --git a/doc/mailman-install/contents.png b/doc/mailman-install/contents.png Binary files differnew file mode 100644 index 00000000..3429be0c --- /dev/null +++ b/doc/mailman-install/contents.png diff --git a/doc/mailman-install/create-install-dir.html b/doc/mailman-install/create-install-dir.html new file mode 100644 index 00000000..e152c25f --- /dev/null +++ b/doc/mailman-install/create-install-dir.html @@ -0,0 +1,149 @@ +<!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 http-equiv="Content-Type" content="text/html; charset=utf-8" /> +<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="#foot706"><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="#foot707"><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="foot706">.../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="foot707">... 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">15.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 5, 2007.</span> +</div> +<!--End of Navigation Panel--> + +</body> +</html> diff --git a/doc/mailman-install/customizing.html b/doc/mailman-install/customizing.html new file mode 100644 index 00000000..8600d093 --- /dev/null +++ b/doc/mailman-install/customizing.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="node40.html" /> +<link rel="prev" href="mail-server.html" /> +<link rel="parent" href="front.html" /> +<link rel="next" href="node40.html" /> +<meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> +<meta name='aesop' content='information' /> +<title>7 Review your site defaults</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 create a site-wide" + 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 Create a site-wide</a> +</div> +<hr /></div> +</div> +<!--End of Navigation Panel--> + +<h1><a name="SECTION001700000000000000000"></a><a name="customizing"></a> +<br> +7 Review your site defaults +</h1> + +<p> +Mailman has a large number of site-wide configuration options which you should +now review and change according to your needs. Some of the options control +how Mailman interacts with your environment, and other options select defaults +for newly created lists<a name="tex2html5" + href="#foot733"><sup>5</sup></a>. +There are system tuning parameters and integration options. + +<p> +The full set of site-wide defaults lives in the +<span class="file"><var>$prefix</var>/Mailman/Defaults.py</span> file, however you should +<strong>never</strong> modify this file! Instead, change the <span class="file">mm_cfg.py</span> file in +that same directory. You only need to add values to <span class="file">mm_cfg.py</span> that are +different than the defaults in <span class="file">Defaults.py</span>, and future Mailman upgrades +are guaranteed never to touch your <span class="file">mm_cfg.py</span> file. + +<p> +The <span class="file">Defaults.py</span> file is documented extensively, so the options are not +described here. The <span class="file">Defaults.py</span> and <span class="file">mm_cfg.py</span> are both +<a class="ulink" href="http://www.python.org" + >Python</a> files so valid Python syntax must be +maintained or your Mailman installation will break. + +<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> + +<p> +You should make any changes to <span class="file">mm_cfg.py</span> using the account you +installed Mailman under in the <a href="troubleshooting.html#building">14</a> section. + +<p> +<br><hr><h4>Footnotes</h4> +<dl> +<dt><a name="foot733">... lists</a><A + href="customizing.html#tex2html5"><sup>5</sup></a></dt> +<dd>In general, changing the list defaults +described in this section will not affect any already created lists. To make +changes after a list has been created, use the web interface or the command +line scripts, such as <b class="program">bin/withlist</b> and <b class="program">bin/config_list</b>. + +</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="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 create a site-wide" + 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 Create a site-wide</a> +</div> +</div> +<hr /> +<span class="release-info">Release 2.1, documentation updated on December 5, 2007.</span> +</div> +<!--End of Navigation Panel--> + +</body> +</html> diff --git a/doc/mailman-install/exim3-transport.html b/doc/mailman-install/exim3-transport.html new file mode 100644 index 00000000..f9e25d1f --- /dev/null +++ b/doc/mailman-install/exim3-transport.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="node20.html" /> +<link rel="prev" href="node18.html" /> +<link rel="parent" href="node16.html" /> +<link rel="next" href="node20.html" /> +<meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> +<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 5, 2007.</span> +</div> +<!--End of Navigation Panel--> + +</body> +</html> diff --git a/doc/mailman-install/front.html b/doc/mailman-install/front.html new file mode 100644 index 00000000..6a068b19 --- /dev/null +++ b/doc/mailman-install/front.html @@ -0,0 +1,182 @@ +<!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 http-equiv="Content-Type" content="text/html; charset=utf-8" /> +<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="customizing.html">7 Review your site defaults</a> +<li><a href="node40.html">8 Create a site-wide mailing list</a> +<li><a href="node41.html">9 Set up cron</a> +<li><a href="node42.html">10 Start the Mailman qrunner</a> +<li><a href="node43.html">11 Check the hostname settings</a> +<li><a href="node44.html">12 Create the site password</a> +<li><a href="node45.html">13 Create your first mailing list</a> +<li><a href="troubleshooting.html">14 Troubleshooting</a> +<li><a href="node47.html">15 Platform and operating system notes</a> +<ul> +<li><a href="node48.html">15.1 GNU/Linux issues</a> +<li><a href="bsd-issues.html">15.2 BSD issues</a> +<li><a href="node50.html">15.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 5, 2007.</span> +</div> +<!--End of Navigation Panel--> + +</body> +</html> diff --git a/doc/mailman-install/index.dat b/doc/mailman-install/index.dat new file mode 100644 index 00000000..e69de29b --- /dev/null +++ b/doc/mailman-install/index.dat diff --git a/doc/mailman-install/index.html b/doc/mailman-install/index.html new file mode 100644 index 00000000..6fd98aca --- /dev/null +++ b/doc/mailman-install/index.html @@ -0,0 +1,135 @@ +<!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 http-equiv="Content-Type" content="text/html; charset=utf-8" /> +<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) list dot org</span></p> +<p><strong>Release 2.1</strong><br /> +<strong>December 5, 2007</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="customizing.html">7 Review your site defaults</a> +<li><a href="node40.html">8 Create a site-wide mailing list</a> +<li><a href="node41.html">9 Set up cron</a> +<li><a href="node42.html">10 Start the Mailman qrunner</a> +<li><a href="node43.html">11 Check the hostname settings</a> +<li><a href="node44.html">12 Create the site password</a> +<li><a href="node45.html">13 Create your first mailing list</a> +<li><a href="troubleshooting.html">14 Troubleshooting</a> +<li><a href="node47.html">15 Platform and operating system notes</a> +<ul> +<li><a href="node48.html">15.1 GNU/Linux issues</a> +<li><a href="bsd-issues.html">15.2 BSD issues</a> +<li><a href="node50.html">15.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 5, 2007.</span> +</div> +<!--End of Navigation Panel--> + +</body> +</html> diff --git a/doc/mailman-install/index.png b/doc/mailman-install/index.png Binary files differnew file mode 100644 index 00000000..cd918afe --- /dev/null +++ b/doc/mailman-install/index.png diff --git a/doc/mailman-install/internals.pl b/doc/mailman-install/internals.pl new file mode 100644 index 00000000..04b8d800 --- /dev/null +++ b/doc/mailman-install/internals.pl @@ -0,0 +1,50 @@ +# LaTeX2HTML 2002-2-1 (1.71) +# Associate internals original text with physical files. + + +$key = q/exim3-transport/; +$ref_files{$key} = "$dir".q|node19.html|; +$noresave{$key} = "$nosave"; + +$key = q/front/; +$ref_files{$key} = "$dir".q|node1.html|; +$noresave{$key} = "$nosave"; + +$key = q/create-install-dir/; +$ref_files{$key} = "$dir".q|node5.html|; +$noresave{$key} = "$nosave"; + +$key = q/mail-server/; +$ref_files{$key} = "$dir".q|node11.html|; +$noresave{$key} = "$nosave"; + +$key = q/qmail-issues/; +$ref_files{$key} = "$dir".q|node35.html|; +$noresave{$key} = "$nosave"; + +$key = q/troubleshooting/; +$ref_files{$key} = "$dir".q|node46.html|; +$noresave{$key} = "$nosave"; + +$key = q/customizing/; +$ref_files{$key} = "$dir".q|node39.html|; +$noresave{$key} = "$nosave"; + +$key = q/building/; +$ref_files{$key} = "$dir".q|node46.html|; +$noresave{$key} = "$nosave"; + +$key = q/about/; +$ref_files{$key} = "$dir".q|node51.html|; +$noresave{$key} = "$nosave"; + +$key = q/postfix-virtual/; +$ref_files{$key} = "$dir".q|node14.html|; +$noresave{$key} = "$nosave"; + +$key = q/bsd-issues/; +$ref_files{$key} = "$dir".q|node49.html|; +$noresave{$key} = "$nosave"; + +1; + diff --git a/doc/mailman-install/intlabels.pl b/doc/mailman-install/intlabels.pl new file mode 100644 index 00000000..44814752 --- /dev/null +++ b/doc/mailman-install/intlabels.pl @@ -0,0 +1,3 @@ +%internal_labels = (); +1; # hack in case there are no entries + diff --git a/doc/mailman-install/labels.pl b/doc/mailman-install/labels.pl new file mode 100644 index 00000000..93c78d96 --- /dev/null +++ b/doc/mailman-install/labels.pl @@ -0,0 +1,93 @@ +# LaTeX2HTML 2002-2-1 (1.71) +# Associate labels original text with physical files. + + +$key = q/exim3-transport/; +$external_labels{$key} = "$URL/" . q|node19.html|; +$noresave{$key} = "$nosave"; + +$key = q/front/; +$external_labels{$key} = "$URL/" . q|node1.html|; +$noresave{$key} = "$nosave"; + +$key = q/create-install-dir/; +$external_labels{$key} = "$URL/" . q|node5.html|; +$noresave{$key} = "$nosave"; + +$key = q/mail-server/; +$external_labels{$key} = "$URL/" . q|node11.html|; +$noresave{$key} = "$nosave"; + +$key = q/qmail-issues/; +$external_labels{$key} = "$URL/" . q|node35.html|; +$noresave{$key} = "$nosave"; + +$key = q/troubleshooting/; +$external_labels{$key} = "$URL/" . q|node46.html|; +$noresave{$key} = "$nosave"; + +$key = q/customizing/; +$external_labels{$key} = "$URL/" . q|node39.html|; +$noresave{$key} = "$nosave"; + +$key = q/building/; +$external_labels{$key} = "$URL/" . q|node46.html|; +$noresave{$key} = "$nosave"; + +$key = q/about/; +$external_labels{$key} = "$URL/" . q|node51.html|; +$noresave{$key} = "$nosave"; + +$key = q/postfix-virtual/; +$external_labels{$key} = "$URL/" . q|node14.html|; +$noresave{$key} = "$nosave"; + +$key = q/bsd-issues/; +$external_labels{$key} = "$URL/" . q|node49.html|; +$noresave{$key} = "$nosave"; + +1; + + +# LaTeX2HTML 2002-2-1 (1.71) +# labels from external_latex_labels array. + + +$key = q/exim3-transport/; +$external_latex_labels{$key} = q|6.2|; +$noresave{$key} = "$nosave"; + +$key = q/create-install-dir/; +$external_latex_labels{$key} = q|2.2|; +$noresave{$key} = "$nosave"; + +$key = q/mail-server/; +$external_latex_labels{$key} = q|6|; +$noresave{$key} = "$nosave"; + +$key = q/qmail-issues/; +$external_latex_labels{$key} = q|6.4|; +$noresave{$key} = "$nosave"; + +$key = q/troubleshooting/; +$external_latex_labels{$key} = q|14|; +$noresave{$key} = "$nosave"; + +$key = q/customizing/; +$external_latex_labels{$key} = q|7|; +$noresave{$key} = "$nosave"; + +$key = q/building/; +$external_latex_labels{$key} = q|14|; +$noresave{$key} = "$nosave"; + +$key = q/postfix-virtual/; +$external_latex_labels{$key} = q|6.1|; +$noresave{$key} = "$nosave"; + +$key = q/bsd-issues/; +$external_latex_labels{$key} = q|15.2|; +$noresave{$key} = "$nosave"; + +1; + diff --git a/doc/mailman-install/mail-server.html b/doc/mailman-install/mail-server.html new file mode 100644 index 00000000..0621792b --- /dev/null +++ b/doc/mailman-install/mail-server.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="customizing.html" /> +<link rel="prev" href="node10.html" /> +<link rel="parent" href="front.html" /> +<link rel="next" href="node12.html" /> +<meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> +<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 5, 2007.</span> +</div> +<!--End of Navigation Panel--> + +</body> +</html> diff --git a/doc/mailman-install/mailman-install.css b/doc/mailman-install/mailman-install.css new file mode 100644 index 00000000..06a613c2 --- /dev/null +++ b/doc/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/doc/mailman-install/mailman-install.html b/doc/mailman-install/mailman-install.html new file mode 100644 index 00000000..6fd98aca --- /dev/null +++ b/doc/mailman-install/mailman-install.html @@ -0,0 +1,135 @@ +<!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 http-equiv="Content-Type" content="text/html; charset=utf-8" /> +<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) list dot org</span></p> +<p><strong>Release 2.1</strong><br /> +<strong>December 5, 2007</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="customizing.html">7 Review your site defaults</a> +<li><a href="node40.html">8 Create a site-wide mailing list</a> +<li><a href="node41.html">9 Set up cron</a> +<li><a href="node42.html">10 Start the Mailman qrunner</a> +<li><a href="node43.html">11 Check the hostname settings</a> +<li><a href="node44.html">12 Create the site password</a> +<li><a href="node45.html">13 Create your first mailing list</a> +<li><a href="troubleshooting.html">14 Troubleshooting</a> +<li><a href="node47.html">15 Platform and operating system notes</a> +<ul> +<li><a href="node48.html">15.1 GNU/Linux issues</a> +<li><a href="bsd-issues.html">15.2 BSD issues</a> +<li><a href="node50.html">15.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 5, 2007.</span> +</div> +<!--End of Navigation Panel--> + +</body> +</html> diff --git a/doc/mailman-install/modules.png b/doc/mailman-install/modules.png Binary files differnew file mode 100644 index 00000000..8fa8b755 --- /dev/null +++ b/doc/mailman-install/modules.png diff --git a/doc/mailman-install/next.png b/doc/mailman-install/next.png Binary files differnew file mode 100644 index 00000000..cfe5e51c --- /dev/null +++ b/doc/mailman-install/next.png diff --git a/doc/mailman-install/node10.html b/doc/mailman-install/node10.html new file mode 100644 index 00000000..ad9dd805 --- /dev/null +++ b/doc/mailman-install/node10.html @@ -0,0 +1,193 @@ +<!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 http-equiv="Content-Type" content="text/html; charset=utf-8" /> +<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 5, 2007.</span> +</div> +<!--End of Navigation Panel--> + +</body> +</html> diff --git a/doc/mailman-install/node12.html b/doc/mailman-install/node12.html new file mode 100644 index 00000000..14461325 --- /dev/null +++ b/doc/mailman-install/node12.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="node16.html" /> +<link rel="prev" href="mail-server.html" /> +<link rel="parent" href="mail-server.html" /> +<link rel="next" href="node13.html" /> +<meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> +<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> +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 5, 2007.</span> +</div> +<!--End of Navigation Panel--> + +</body> +</html> diff --git a/doc/mailman-install/node13.html b/doc/mailman-install/node13.html new file mode 100644 index 00000000..301d090b --- /dev/null +++ b/doc/mailman-install/node13.html @@ -0,0 +1,207 @@ +<!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 http-equiv="Content-Type" content="text/html; charset=utf-8" /> +<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>, that the group owner + for those files is <code>mailman</code>, or whatever user and group you used + in the configure command, and that both files are group writable: + +<p> +<div class="verbatim"><pre> + % su + % chown mailman:mailman data/aliases* + % chmod g+w 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 5, 2007.</span> +</div> +<!--End of Navigation Panel--> + +</body> +</html> diff --git a/doc/mailman-install/node15.html b/doc/mailman-install/node15.html new file mode 100644 index 00000000..e5f597f4 --- /dev/null +++ b/doc/mailman-install/node15.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="prev" href="postfix-virtual.html" /> +<link rel="parent" href="node12.html" /> +<link rel="next" href="node16.html" /> +<meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> +<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 5, 2007.</span> +</div> +<!--End of Navigation Panel--> + +</body> +</html> diff --git a/doc/mailman-install/node16.html b/doc/mailman-install/node16.html new file mode 100644 index 00000000..2349f89d --- /dev/null +++ b/doc/mailman-install/node16.html @@ -0,0 +1,132 @@ +<!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 http-equiv="Content-Type" content="text/html; charset=utf-8" /> +<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 5, 2007.</span> +</div> +<!--End of Navigation Panel--> + +</body> +</html> diff --git a/doc/mailman-install/node17.html b/doc/mailman-install/node17.html new file mode 100644 index 00000000..a133470b --- /dev/null +++ b/doc/mailman-install/node17.html @@ -0,0 +1,152 @@ +<!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 http-equiv="Content-Type" content="text/html; charset=utf-8" /> +<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 5, 2007.</span> +</div> +<!--End of Navigation Panel--> + +</body> +</html> diff --git a/doc/mailman-install/node18.html b/doc/mailman-install/node18.html new file mode 100644 index 00000000..191dea51 --- /dev/null +++ b/doc/mailman-install/node18.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="exim3-transport.html" /> +<link rel="prev" href="node17.html" /> +<link rel="parent" href="node16.html" /> +<link rel="next" href="exim3-transport.html" /> +<meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> +<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 5, 2007.</span> +</div> +<!--End of Navigation Panel--> + +</body> +</html> diff --git a/doc/mailman-install/node2.html b/doc/mailman-install/node2.html new file mode 100644 index 00000000..64be98be --- /dev/null +++ b/doc/mailman-install/node2.html @@ -0,0 +1,130 @@ +<!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 http-equiv="Content-Type" content="text/html; charset=utf-8" /> +<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> +<em>Please note that the information on this page may be out of date.</em> +Check for the +<a class="ulink" href="http://wiki.list.org/x/bAM" + >latest installation information</a> on the +<a class="ulink" href="http://wiki.list.org" + >Mailman wiki</a>. + +<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> works well. + +<p> +You must have the <a class="ulink" href="http://www.python.org" + >Python</a> interpreter installed +somewhere on your system. As of this writing, Python 2.4.4 is recommended, +but see the wiki page above for the latest information. + +<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 5, 2007.</span> +</div> +<!--End of Navigation Panel--> + +</body> +</html> diff --git a/doc/mailman-install/node20.html b/doc/mailman-install/node20.html new file mode 100644 index 00000000..b024c716 --- /dev/null +++ b/doc/mailman-install/node20.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="node21.html" /> +<link rel="prev" href="exim3-transport.html" /> +<link rel="parent" href="node16.html" /> +<link rel="next" href="node21.html" /> +<meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> +<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 5, 2007.</span> +</div> +<!--End of Navigation Panel--> + +</body> +</html> diff --git a/doc/mailman-install/node21.html b/doc/mailman-install/node21.html new file mode 100644 index 00000000..63bd2949 --- /dev/null +++ b/doc/mailman-install/node21.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="node22.html" /> +<link rel="prev" href="node20.html" /> +<link rel="parent" href="node16.html" /> +<link rel="next" href="node22.html" /> +<meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> +<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 5, 2007.</span> +</div> +<!--End of Navigation Panel--> + +</body> +</html> diff --git a/doc/mailman-install/node22.html b/doc/mailman-install/node22.html new file mode 100644 index 00000000..2c4549b5 --- /dev/null +++ b/doc/mailman-install/node22.html @@ -0,0 +1,98 @@ +<!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 http-equiv="Content-Type" content="text/html; charset=utf-8" /> +<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 5, 2007.</span> +</div> +<!--End of Navigation Panel--> + +</body> +</html> diff --git a/doc/mailman-install/node23.html b/doc/mailman-install/node23.html new file mode 100644 index 00000000..582b11cf --- /dev/null +++ b/doc/mailman-install/node23.html @@ -0,0 +1,102 @@ +<!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 http-equiv="Content-Type" content="text/html; charset=utf-8" /> +<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 5, 2007.</span> +</div> +<!--End of Navigation Panel--> + +</body> +</html> diff --git a/doc/mailman-install/node24.html b/doc/mailman-install/node24.html new file mode 100644 index 00000000..fa81b346 --- /dev/null +++ b/doc/mailman-install/node24.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="node25.html" /> +<link rel="prev" href="node23.html" /> +<link rel="parent" href="node16.html" /> +<link rel="next" href="node25.html" /> +<meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> +<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 5, 2007.</span> +</div> +<!--End of Navigation Panel--> + +</body> +</html> diff --git a/doc/mailman-install/node25.html b/doc/mailman-install/node25.html new file mode 100644 index 00000000..ec01107d --- /dev/null +++ b/doc/mailman-install/node25.html @@ -0,0 +1,135 @@ +<!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 http-equiv="Content-Type" content="text/html; charset=utf-8" /> +<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 5, 2007.</span> +</div> +<!--End of Navigation Panel--> + +</body> +</html> diff --git a/doc/mailman-install/node26.html b/doc/mailman-install/node26.html new file mode 100644 index 00000000..5f960845 --- /dev/null +++ b/doc/mailman-install/node26.html @@ -0,0 +1,140 @@ +<!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 http-equiv="Content-Type" content="text/html; charset=utf-8" /> +<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 5, 2007.</span> +</div> +<!--End of Navigation Panel--> + +</body> +</html> diff --git a/doc/mailman-install/node27.html b/doc/mailman-install/node27.html new file mode 100644 index 00000000..fa2cb7fa --- /dev/null +++ b/doc/mailman-install/node27.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="node28.html" /> +<link rel="prev" href="node26.html" /> +<link rel="parent" href="node16.html" /> +<link rel="next" href="node28.html" /> +<meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> +<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/Defaults.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 5, 2007.</span> +</div> +<!--End of Navigation Panel--> + +</body> +</html> diff --git a/doc/mailman-install/node28.html b/doc/mailman-install/node28.html new file mode 100644 index 00000000..6e408a2c --- /dev/null +++ b/doc/mailman-install/node28.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="node29.html" /> +<link rel="prev" href="node27.html" /> +<link rel="parent" href="node16.html" /> +<link rel="next" href="node29.html" /> +<meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> +<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 5, 2007.</span> +</div> +<!--End of Navigation Panel--> + +</body> +</html> diff --git a/doc/mailman-install/node29.html b/doc/mailman-install/node29.html new file mode 100644 index 00000000..d90d55aa --- /dev/null +++ b/doc/mailman-install/node29.html @@ -0,0 +1,124 @@ +<!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 http-equiv="Content-Type" content="text/html; charset=utf-8" /> +<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 5, 2007.</span> +</div> +<!--End of Navigation Panel--> + +</body> +</html> diff --git a/doc/mailman-install/node3.html b/doc/mailman-install/node3.html new file mode 100644 index 00000000..80a6e488 --- /dev/null +++ b/doc/mailman-install/node3.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="node6.html" /> +<link rel="prev" href="node2.html" /> +<link rel="parent" href="front.html" /> +<link rel="next" href="node4.html" /> +<meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> +<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 5, 2007.</span> +</div> +<!--End of Navigation Panel--> + +</body> +</html> diff --git a/doc/mailman-install/node30.html b/doc/mailman-install/node30.html new file mode 100644 index 00000000..d9f17f63 --- /dev/null +++ b/doc/mailman-install/node30.html @@ -0,0 +1,98 @@ +<!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 http-equiv="Content-Type" content="text/html; charset=utf-8" /> +<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 5, 2007.</span> +</div> +<!--End of Navigation Panel--> + +</body> +</html> diff --git a/doc/mailman-install/node31.html b/doc/mailman-install/node31.html new file mode 100644 index 00000000..91efe99c --- /dev/null +++ b/doc/mailman-install/node31.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="qmail-issues.html" /> +<link rel="prev" href="node16.html" /> +<link rel="parent" href="mail-server.html" /> +<link rel="next" href="node32.html" /> +<meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> +<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="#foot402"><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="foot402">... 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 5, 2007.</span> +</div> +<!--End of Navigation Panel--> + +</body> +</html> diff --git a/doc/mailman-install/node32.html b/doc/mailman-install/node32.html new file mode 100644 index 00000000..87298699 --- /dev/null +++ b/doc/mailman-install/node32.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="next" href="node33.html" /> +<link rel="prev" href="node31.html" /> +<link rel="parent" href="node31.html" /> +<link rel="next" href="node33.html" /> +<meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> +<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 5, 2007.</span> +</div> +<!--End of Navigation Panel--> + +</body> +</html> diff --git a/doc/mailman-install/node33.html b/doc/mailman-install/node33.html new file mode 100644 index 00000000..bfc3de5a --- /dev/null +++ b/doc/mailman-install/node33.html @@ -0,0 +1,116 @@ +<!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 http-equiv="Content-Type" content="text/html; charset=utf-8" /> +<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 5, 2007.</span> +</div> +<!--End of Navigation Panel--> + +</body> +</html> diff --git a/doc/mailman-install/node34.html b/doc/mailman-install/node34.html new file mode 100644 index 00000000..84b3b2cd --- /dev/null +++ b/doc/mailman-install/node34.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="prev" href="node33.html" /> +<link rel="parent" href="node31.html" /> +<link rel="next" href="qmail-issues.html" /> +<meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> +<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 5, 2007.</span> +</div> +<!--End of Navigation Panel--> + +</body> +</html> diff --git a/doc/mailman-install/node36.html b/doc/mailman-install/node36.html new file mode 100644 index 00000000..36cdafc6 --- /dev/null +++ b/doc/mailman-install/node36.html @@ -0,0 +1,116 @@ +<!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 http-equiv="Content-Type" content="text/html; charset=utf-8" /> +<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 5, 2007.</span> +</div> +<!--End of Navigation Panel--> + +</body> +</html> diff --git a/doc/mailman-install/node37.html b/doc/mailman-install/node37.html new file mode 100644 index 00000000..ce29c2db --- /dev/null +++ b/doc/mailman-install/node37.html @@ -0,0 +1,102 @@ +<!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 http-equiv="Content-Type" content="text/html; charset=utf-8" /> +<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 5, 2007.</span> +</div> +<!--End of Navigation Panel--> + +</body> +</html> diff --git a/doc/mailman-install/node38.html b/doc/mailman-install/node38.html new file mode 100644 index 00000000..6df2f96c --- /dev/null +++ b/doc/mailman-install/node38.html @@ -0,0 +1,98 @@ +<!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="customizing.html" /> +<meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> +<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 review your site" + 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="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="customizing.html">7 Review your site</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 review your site" + 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="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="customizing.html">7 Review your site</a> +</div> +</div> +<hr /> +<span class="release-info">Release 2.1, documentation updated on December 5, 2007.</span> +</div> +<!--End of Navigation Panel--> + +</body> +</html> diff --git a/doc/mailman-install/node4.html b/doc/mailman-install/node4.html new file mode 100644 index 00000000..a764dca8 --- /dev/null +++ b/doc/mailman-install/node4.html @@ -0,0 +1,130 @@ +<!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 http-equiv="Content-Type" content="text/html; charset=utf-8" /> +<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="#foot38"><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="foot38">... +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 5, 2007.</span> +</div> +<!--End of Navigation Panel--> + +</body> +</html> diff --git a/doc/mailman-install/node40.html b/doc/mailman-install/node40.html new file mode 100644 index 00000000..de4883e2 --- /dev/null +++ b/doc/mailman-install/node40.html @@ -0,0 +1,130 @@ +<!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="customizing.html" /> +<link rel="parent" href="front.html" /> +<link rel="next" href="node41.html" /> +<meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> +<meta name='aesop' content='information' /> +<title>8 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="7 review your site" + 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="9 set up cron" + 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="customizing.html">7 Review your site</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 Set up cron</a> +</div> +<hr /></div> +</div> +<!--End of Navigation Panel--> + +<h1><a name="SECTION001800000000000000000"> +8 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="7 review your site" + 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="9 set up cron" + 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="customizing.html">7 Review your site</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 Set up cron</a> +</div> +</div> +<hr /> +<span class="release-info">Release 2.1, documentation updated on December 5, 2007.</span> +</div> +<!--End of Navigation Panel--> + +</body> +</html> diff --git a/doc/mailman-install/node41.html b/doc/mailman-install/node41.html new file mode 100644 index 00000000..7ffbb5e8 --- /dev/null +++ b/doc/mailman-install/node41.html @@ -0,0 +1,132 @@ +<!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 http-equiv="Content-Type" content="text/html; charset=utf-8" /> +<meta name='aesop' content='information' /> +<title>9 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="8 create a site-wide" + 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 start the Mailman" + 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 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="node42.html">10 Start the Mailman</a> +</div> +<hr /></div> +</div> +<!--End of Navigation Panel--> + +<h1><a name="SECTION001900000000000000000"> +9 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="tex2html6" + href="#foot551"><sup>6</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="foot551">... time</a><A + HREF="node41.html#tex2html6"><sup>6</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="8 create a site-wide" + 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 start the Mailman" + 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 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="node42.html">10 Start the Mailman</a> +</div> +</div> +<hr /> +<span class="release-info">Release 2.1, documentation updated on December 5, 2007.</span> +</div> +<!--End of Navigation Panel--> + +</body> +</html> diff --git a/doc/mailman-install/node42.html b/doc/mailman-install/node42.html new file mode 100644 index 00000000..db06e877 --- /dev/null +++ b/doc/mailman-install/node42.html @@ -0,0 +1,159 @@ +<!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="node43.html" /> +<link rel="prev" href="node41.html" /> +<link rel="parent" href="front.html" /> +<link rel="next" href="node43.html" /> +<meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> +<meta name='aesop' content='information' /> +<title>10 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="9 set up cron" + 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 check the hostname" + href="node43.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 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="node43.html">11 Check the hostname</a> +</div> +<hr /></div> +</div> +<!--End of Navigation Panel--> + +<h1><a name="SECTION0011000000000000000000"> +10 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="9 set up cron" + 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 check the hostname" + href="node43.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 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="node43.html">11 Check the hostname</a> +</div> +</div> +<hr /> +<span class="release-info">Release 2.1, documentation updated on December 5, 2007.</span> +</div> +<!--End of Navigation Panel--> + +</body> +</html> diff --git a/doc/mailman-install/node43.html b/doc/mailman-install/node43.html new file mode 100644 index 00000000..972475c9 --- /dev/null +++ b/doc/mailman-install/node43.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="node44.html" /> +<link rel="prev" href="node42.html" /> +<link rel="parent" href="front.html" /> +<link rel="next" href="node44.html" /> +<meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> +<meta name='aesop' content='information' /> +<title>11 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="10 start the Mailman" + 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 the site" + 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 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="node44.html">12 Create the site</a> +</div> +<hr /></div> +</div> +<!--End of Navigation Panel--> + +<h1><a name="SECTION0011100000000000000000"> +11 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">Defaults.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="10 start the Mailman" + 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 the site" + 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 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="node44.html">12 Create the site</a> +</div> +</div> +<hr /> +<span class="release-info">Release 2.1, documentation updated on December 5, 2007.</span> +</div> +<!--End of Navigation Panel--> + +</body> +</html> diff --git a/doc/mailman-install/node44.html b/doc/mailman-install/node44.html new file mode 100644 index 00000000..2e7793fd --- /dev/null +++ b/doc/mailman-install/node44.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="node45.html" /> +<link rel="prev" href="node43.html" /> +<link rel="parent" href="front.html" /> +<link rel="next" href="node45.html" /> +<meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> +<meta name='aesop' content='information' /> +<title>12 Create the site password</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 check the hostname" + href="node43.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 create your first" + href="node45.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="node43.html">11 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="node45.html">13 Create your first</a> +</div> +<hr /></div> +</div> +<!--End of Navigation Panel--> + +<h1><a name="SECTION0011200000000000000000"> +12 Create the site password</a> +</h1> + +<p> +There are two site-wide passwords that you can create from the command line, +using the <b class="program">bin/mmsitepass</b> script. The first is the ``site password'' +which can be used anywhere a password is required in the system. The site +password will get you into the administration page for any list, and it can be +used to log in as any user. Think <code>root</code> for a Unix system, so pick this +password wisely! + +<p> +The second password is a site-wide ``list creator'' password. You can use +this to delegate the ability to create new mailing lists without providing all +the privileges of the site password. Of course, the owner of the site +password can also create new mailing lists, but the list creator password is +limited to just that special role. + +<p> +To set the site password, use this command: + +<p> +<div class="verbatim"><pre> + % $prefix/bin/mmsitepass <your-site-password> +</pre></div> + +<p> +To set the list creator password, use this command: + +<p> +<div class="verbatim"><pre> + % $prefix/bin/mmsitepass -c <list-creator-password> +</pre></div> + +<p> +It is okay not to set a list creator password, but you probably do want a site +password. + +<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 check the hostname" + href="node43.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 create your first" + href="node45.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="node43.html">11 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="node45.html">13 Create your first</a> +</div> +</div> +<hr /> +<span class="release-info">Release 2.1, documentation updated on December 5, 2007.</span> +</div> +<!--End of Navigation Panel--> + +</body> +</html> diff --git a/doc/mailman-install/node45.html b/doc/mailman-install/node45.html new file mode 100644 index 00000000..c8a8f8c5 --- /dev/null +++ b/doc/mailman-install/node45.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="troubleshooting.html" /> +<link rel="prev" href="node44.html" /> +<link rel="parent" href="front.html" /> +<link rel="next" href="troubleshooting.html" /> +<meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> +<meta name='aesop' content='information' /> +<title>13 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="12 create the site" + 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 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="node44.html">12 Create the site</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">14 Troubleshooting</a> +</div> +<hr /></div> +</div> +<!--End of Navigation Panel--> + +<h1><a name="SECTION0011300000000000000000"> +13 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">7</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">14</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="12 create the site" + 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 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="node44.html">12 Create the site</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">14 Troubleshooting</a> +</div> +</div> +<hr /> +<span class="release-info">Release 2.1, documentation updated on December 5, 2007.</span> +</div> +<!--End of Navigation Panel--> + +</body> +</html> diff --git a/doc/mailman-install/node47.html b/doc/mailman-install/node47.html new file mode 100644 index 00000000..f99bb93b --- /dev/null +++ b/doc/mailman-install/node47.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="prev" href="troubleshooting.html" /> +<link rel="parent" href="front.html" /> +<link rel="next" href="node48.html" /> +<meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> +<meta name='aesop' content='information' /> +<title>15 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="14 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="15.1 GNU/Linux issues" + href="node48.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">14 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="node48.html">15.1 GNU/Linux issues</a> +</div> +<hr /></div> +</div> +<!--End of Navigation Panel--> + +<h1><a name="SECTION0011500000000000000000"> +15 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="node48.html">15.1 GNU/Linux issues</a> +<li><a href="bsd-issues.html">15.2 BSD issues</a> +<li><a href="node50.html">15.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="14 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="15.1 GNU/Linux issues" + href="node48.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">14 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="node48.html">15.1 GNU/Linux issues</a> +</div> +</div> +<hr /> +<span class="release-info">Release 2.1, documentation updated on December 5, 2007.</span> +</div> +<!--End of Navigation Panel--> + +</body> +</html> diff --git a/doc/mailman-install/node48.html b/doc/mailman-install/node48.html new file mode 100644 index 00000000..1412727c --- /dev/null +++ b/doc/mailman-install/node48.html @@ -0,0 +1,155 @@ +<!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="node47.html" /> +<link rel="parent" href="node47.html" /> +<link rel="next" href="bsd-issues.html" /> +<meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> +<meta name='aesop' content='information' /> +<title>15.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="15 platform and operating" + 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="15 platform and operating" + href="node47.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="15.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="node47.html">15 Platform and operating</a> +<b class="navlabel">Up:</b> +<a class="sectref" rel="parent" href="node47.html">15 Platform and operating</a> +<b class="navlabel">Next:</b> +<a class="sectref" rel="next" href="bsd-issues.html">15.2 BSD issues</a> +</div> +<hr /></div> +</div> +<!--End of Navigation Panel--> + +<h2><a name="SECTION0011510000000000000000"> +15.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="15 platform and operating" + 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="15 platform and operating" + href="node47.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="15.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="node47.html">15 Platform and operating</a> +<b class="navlabel">Up:</b> +<a class="sectref" rel="parent" href="node47.html">15 Platform and operating</a> +<b class="navlabel">Next:</b> +<a class="sectref" rel="next" href="bsd-issues.html">15.2 BSD issues</a> +</div> +</div> +<hr /> +<span class="release-info">Release 2.1, documentation updated on December 5, 2007.</span> +</div> +<!--End of Navigation Panel--> + +</body> +</html> diff --git a/doc/mailman-install/node50.html b/doc/mailman-install/node50.html new file mode 100644 index 00000000..e977fa3e --- /dev/null +++ b/doc/mailman-install/node50.html @@ -0,0 +1,229 @@ +<!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="node47.html" /> +<link rel="next" href="about.html" /> +<meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> +<meta name='aesop' content='information' /> +<title>15.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="15.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="15 platform and operating" + href="node47.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">15.2 BSD issues</a> +<b class="navlabel">Up:</b> +<a class="sectref" rel="parent" href="node47.html">15 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="SECTION0011530000000000000000"> +15.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; Your operating system + should contain documentation that will help you, and 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> +Terry Allen provides the following detailed instructions on running Mailman on +the 'client' version of OSX, or in earlier versions of OSX: + +<p> +Mac OSX 10.3 and onwards has the basics for a successful Mailman installation. +Users of earlier versions of Mac OSX contains Sendmail and those users should +look at the Sendmail installation section for tips. You should follow the +basic installation steps as described earlier in this manual, substituting as +appropriate, the steps outlined in this section. + +<p> +By default, Mac OSX 10.3 'client' version does not have a fully functional +version of Postfix. Setting up a working MTA such as Postfix is beyond the +scope of this guide and you should refer to <a class="url" href="http://www.postfix.org">http://www.postfix.org</a> for +tips on getting Postfix running. An easy way to set Postfix up is to install +and run Postfix Enabler, a stand-alone tool for configuring Postfix on Mac +OSX, available from +<a class="url" href="http://www.roadstead.com/weblog/Tutorials/PostfixEnabler.html">http://www.roadstead.com/weblog/Tutorials/PostfixEnabler.html</a>. + +<p> +Likewise, Mac OSX 'client' version from 10.1 onwards includes a working Apache +webserver. This is switched on using the System Preferences control panel +under the 'Sharing tab'. A useful tool for configuring the Apache on Mac OSX +is Webmin, which can be obtained from +<a class="url" href="http://www.webmin.com">http://www.webmin.com</a>. + +<p> +Webmin can also perform configuration for other system tasks, including +Postfix, adding jobs to your crontab, adding user and groups, plus adding +startup and shutdown jobs. + +<p> +In a stock installation of OSX, the requirement for Mailman is to have Python +installed. Python is not installed by default, so it is advised that you +install the developer's tools package, which may have been provided with your +system. It can also be downloaded from the Apple developer site at +<a class="url" href="http://connect.apple.com">http://connect.apple.com</a>. Not only is the developer tools package an +essential requirement for installing Mailman, but it will come in handy at a +later date should you need other tools. The developer's tools are also know +by the name XCode tools. + +<p> +As a minimum, the Python version should be 2.2, but 2.3 is recommended. + +<p> +If you wish to add a user and group using the command line in OSX instead of +via Webmin or another GUI interface, open your terminal application and follow +the commands as indicated below - do not type the comments following the +"<tt class="samp">#</tt>" since they are just notes: + +<p> +<div class="verbatim"><pre> +sudo tcsh +niutil -create / /users/mailman +niutil -createprop / /users/mailman name mailman +# Note that xxx is a free user ID number on your system +niutil -createprop / /users/mailman uid xxx +niutil -createprop / /users/mailman home /usr/local/mailman +mkdir -p /usr/local/mailman +niutil -createprop / /users/mailman shell /bin/tcsh +passwd mailman +# To prevent malicious hacking, supply a secure password here +niutil -create / /groups/mailman +niutil -createprop / /groups/mailman name mailman +# Note that xxx is a free group ID number on your system +niutil -createprop / /groups/mailman gid xxx +niutil -createprop / /groups/mailman passwd '*' +niutil -createprop / /groups/mailman users 'mailman' +chown mailman:mailman /usr/local/mailman +cd /usr/local/mailman +chmod a+rx,g+ws . +exit +su mailman +</pre></div> + +<p> +For setting up Apache on OSX to handle Mailman, the steps are almost identical +and the configuration file on a stock Mac OSX Client version is stored in the +nearly standard location of <span class="file">/etc/httpd/httpd.conf</span>. + +<p> +The <a class="ulink" href="http://www.afp548.com" + >AFP548.com</a> site has a time-saving automated startup item creator for +Mailman, which can be found at +<a class="url" href="http://www.afp548.com/Software/MailmanStartup.tar.gz">http://www.afp548.com/Software/MailmanStartup.tar.gz</a> +<p> +To install it, copy it into your <span class="file">/Library/StartupItems</span> directory. As +the root or superuser, from the terminal, enter the following: + +<p> +<div class="verbatim"><pre> +gunzip MailmanStartup.tar.gz +tar xvf MailmanStartup.tar +</pre></div> + +<p> +It will create the startup item for you so that when you reboot, Mailman will +start up. + +<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="15.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="15 platform and operating" + href="node47.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">15.2 BSD issues</a> +<b class="navlabel">Up:</b> +<a class="sectref" rel="parent" href="node47.html">15 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 5, 2007.</span> +</div> +<!--End of Navigation Panel--> + +</body> +</html> diff --git a/doc/mailman-install/node6.html b/doc/mailman-install/node6.html new file mode 100644 index 00000000..286eacf7 --- /dev/null +++ b/doc/mailman-install/node6.html @@ -0,0 +1,106 @@ +<!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 http-equiv="Content-Type" content="text/html; charset=utf-8" /> +<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 5, 2007.</span> +</div> +<!--End of Navigation Panel--> + +</body> +</html> diff --git a/doc/mailman-install/node7.html b/doc/mailman-install/node7.html new file mode 100644 index 00000000..e4d08890 --- /dev/null +++ b/doc/mailman-install/node7.html @@ -0,0 +1,251 @@ +<!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 http-equiv="Content-Type" content="text/html; charset=utf-8" /> +<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 5, 2007.</span> +</div> +<!--End of Navigation Panel--> + +</body> +</html> diff --git a/doc/mailman-install/node8.html b/doc/mailman-install/node8.html new file mode 100644 index 00000000..1ff3838b --- /dev/null +++ b/doc/mailman-install/node8.html @@ -0,0 +1,96 @@ +<!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 http-equiv="Content-Type" content="text/html; charset=utf-8" /> +<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 5, 2007.</span> +</div> +<!--End of Navigation Panel--> + +</body> +</html> diff --git a/doc/mailman-install/node9.html b/doc/mailman-install/node9.html new file mode 100644 index 00000000..e08e4f38 --- /dev/null +++ b/doc/mailman-install/node9.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="node10.html" /> +<link rel="prev" href="node6.html" /> +<link rel="parent" href="front.html" /> +<link rel="next" href="node10.html" /> +<meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> +<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="warning"><b class="label">Warning:</b> + +If you're running Mailman on a shared multiuser system, and you have mailing +lists with private archives, you may want to hide the private archive +directory from other users on your system. In that case, you should drop the +other execute permission (o-x) from the <span class="file">archives/private</span> directory. +However, the web server process must be able to follow the symbolic link in +public directory, otherwise your public Pipermail archives will not work. To +set this up, become root and run the following commands: + +<p> +<div class="verbatim"><pre> +# cd <prefix>/archives +# chown <web-server-user> private +# chmod o-x private +</pre></div> + +<p> +You need to know what user your web server runs as. It may be <code>www</code>, +<code>apache</code>, <code>httpd</code> or <code>nobody</code>, depending on your server's +configuration. +</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="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 5, 2007.</span> +</div> +<!--End of Navigation Panel--> + +</body> +</html> diff --git a/doc/mailman-install/postfix-virtual.html b/doc/mailman-install/postfix-virtual.html new file mode 100644 index 00000000..4191fe11 --- /dev/null +++ b/doc/mailman-install/postfix-virtual.html @@ -0,0 +1,197 @@ +<!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 http-equiv="Content-Type" content="text/html; charset=utf-8" /> +<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 5, 2007.</span> +</div> +<!--End of Navigation Panel--> + +</body> +</html> diff --git a/doc/mailman-install/previous.png b/doc/mailman-install/previous.png Binary files differnew file mode 100644 index 00000000..497def42 --- /dev/null +++ b/doc/mailman-install/previous.png diff --git a/doc/mailman-install/pyfav.png b/doc/mailman-install/pyfav.png Binary files differnew file mode 100644 index 00000000..d2d8669d --- /dev/null +++ b/doc/mailman-install/pyfav.png diff --git a/doc/mailman-install/qmail-issues.html b/doc/mailman-install/qmail-issues.html new file mode 100644 index 00000000..25948d95 --- /dev/null +++ b/doc/mailman-install/qmail-issues.html @@ -0,0 +1,309 @@ +<!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 http-equiv="Content-Type" content="text/html; charset=utf-8" /> +<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> + |preline /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 5, 2007.</span> +</div> +<!--End of Navigation Panel--> + +</body> +</html> diff --git a/doc/mailman-install/troubleshooting.html b/doc/mailman-install/troubleshooting.html new file mode 100644 index 00000000..6b994ed1 --- /dev/null +++ b/doc/mailman-install/troubleshooting.html @@ -0,0 +1,260 @@ +<!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="node47.html" /> +<link rel="prev" href="node45.html" /> +<link rel="parent" href="front.html" /> +<link rel="next" href="node47.html" /> +<meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> +<meta name='aesop' content='information' /> +<title>14 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="13 create your first" + href="node45.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="15 platform and operating" + 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="node45.html">13 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="node47.html">15 Platform and operating</a> +</div> +<hr /></div> +</div> +<!--End of Navigation Panel--> + +<h1><a name="SECTION0011400000000000000000"></a><a name="troubleshooting"></a> +<br> +14 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="tex2html7" + href="#foot614"><sup>7</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 integrate 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="foot614">... list</a><A + href="troubleshooting.html#tex2html7"><sup>7</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="13 create your first" + href="node45.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="15 platform and operating" + 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="node45.html">13 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="node47.html">15 Platform and operating</a> +</div> +</div> +<hr /> +<span class="release-info">Release 2.1, documentation updated on December 5, 2007.</span> +</div> +<!--End of Navigation Panel--> + +</body> +</html> diff --git a/doc/mailman-install/up.png b/doc/mailman-install/up.png Binary files differnew file mode 100644 index 00000000..a90e0284 --- /dev/null +++ b/doc/mailman-install/up.png |
