diff options
Diffstat (limited to 'admin/www/mailman-install')
54 files changed, 1006 insertions, 520 deletions
diff --git a/admin/www/mailman-install/about.html b/admin/www/mailman-install/about.html index 2d88ea62..cc2dd85c 100644 --- a/admin/www/mailman-install/about.html +++ b/admin/www/mailman-install/about.html @@ -15,8 +15,8 @@ <div id='top-navigation-panel' xml:id='top-navigation-panel'> <table align="center" width="100%" cellpadding="0" cellspacing="2"> <tr> -<td class='online-navigation'><a rel="prev" title="14.3 MacOSX issues" - href="node49.html"><img src='previous.png' +<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' @@ -33,7 +33,7 @@ </tr></table> <div class='online-navigation'> <b class="navlabel">Previous:</b> -<a class="sectref" rel="prev" href="node49.html">14.3 MacOSX issues</A> +<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> @@ -45,7 +45,7 @@ About this document ...</A> </H1> <strong>GNU Mailman - Installation Manual</strong>, -December 13, 2004, Release 2.1 +December 22, 2004, Release 2.1 <p> This document was generated using the <a href="http://saftsack.fs.uni-bayreuth.de/~latex2ht/"> <strong>LaTeX</strong>2<tt>HTML</tt></a> translator. @@ -76,8 +76,8 @@ December 13, 2004, Release 2.1 <p></p><hr /> <table align="center" width="100%" cellpadding="0" cellspacing="2"> <tr> -<td class='online-navigation'><a rel="prev" title="14.3 MacOSX issues" - href="node49.html"><img src='previous.png' +<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' @@ -94,13 +94,13 @@ December 13, 2004, Release 2.1 </tr></table> <div class='online-navigation'> <b class="navlabel">Previous:</b> -<a class="sectref" rel="prev" href="node49.html">14.3 MacOSX issues</A> +<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 13, 2004.</span> +<span class="release-info">Release 2.1, documentation updated on December 22, 2004.</span> </DIV> <!--End of Navigation Panel--> diff --git a/admin/www/mailman-install/bsd-issues.html b/admin/www/mailman-install/bsd-issues.html index 88b899d3..85325f33 100644 --- a/admin/www/mailman-install/bsd-issues.html +++ b/admin/www/mailman-install/bsd-issues.html @@ -5,26 +5,26 @@ <link rel="first" href="mailman-install.html" title='GNU Mailman - Installation Manual' /> <link rel='last' href='about.html' title='About this document...' /> <link rel='help' href='about.html' title='About this document...' /> -<link rel="next" href="node49.html" /> -<link rel="prev" href="node47.html" /> -<link rel="parent" href="node46.html" /> -<link rel="next" href="node49.html" /> +<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 name='aesop' content='information' /> -<title>14.2 BSD issues</title> +<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="14.1 GNU/Linux issues" - href="node47.html"><img src='previous.png' +<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="14 Platform and operating" - href="node46.html"><img src='up.png' +<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="14.3 MacOSX issues" - href="node49.html"><img src='next.png' +<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' @@ -36,19 +36,19 @@ </tr></table> <div class='online-navigation'> <b class="navlabel">Previous:</b> -<a class="sectref" rel="prev" href="node47.html">14.1 GNU/Linux issues</A> +<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="node46.html">14 Platform and operating</A> +<a class="sectref" rel="parent" href="node47.html">15 Platform and operating</A> <b class="navlabel">Next:</b> -<a class="sectref" rel="next" href="node49.html">14.3 MacOSX issues</A> +<a class="sectref" rel="next" href="node50.html">15.3 MacOSX issues</A> </div> <hr /></div> </DIV> <!--End of Navigation Panel--> -<H2><A NAME="SECTION0011420000000000000000"></A><A NAME="bsd-issues"></A> +<H2><A NAME="SECTION0011520000000000000000"></A><A NAME="bsd-issues"></A> <BR> -14.2 BSD issues +15.2 BSD issues </H2> <P> @@ -78,14 +78,14 @@ This disables the <b class="program">chmod g+s</b> command on installed director <p></p><hr /> <table align="center" width="100%" cellpadding="0" cellspacing="2"> <tr> -<td class='online-navigation'><a rel="prev" title="14.1 GNU/Linux issues" - href="node47.html"><img src='previous.png' +<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="14 Platform and operating" - href="node46.html"><img src='up.png' +<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="14.3 MacOSX issues" - href="node49.html"><img src='next.png' +<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' @@ -97,15 +97,15 @@ This disables the <b class="program">chmod g+s</b> command on installed director </tr></table> <div class='online-navigation'> <b class="navlabel">Previous:</b> -<a class="sectref" rel="prev" href="node47.html">14.1 GNU/Linux issues</A> +<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="node46.html">14 Platform and operating</A> +<a class="sectref" rel="parent" href="node47.html">15 Platform and operating</A> <b class="navlabel">Next:</b> -<a class="sectref" rel="next" href="node49.html">14.3 MacOSX issues</A> +<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 13, 2004.</span> +<span class="release-info">Release 2.1, documentation updated on December 22, 2004.</span> </DIV> <!--End of Navigation Panel--> diff --git a/admin/www/mailman-install/create-install-dir.html b/admin/www/mailman-install/create-install-dir.html index 026042db..400a8730 100644 --- a/admin/www/mailman-install/create-install-dir.html +++ b/admin/www/mailman-install/create-install-dir.html @@ -58,7 +58,7 @@ available options. <P> The default is to install all of Mailman to <span class="file">/usr/local/mailman</span><A NAME="tex2html2" - HREF="#foot676"><SUP>2</SUP></A>. You can change this base installation directory (referred to here + HREF="#foot683"><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> @@ -77,7 +77,7 @@ Mailman in a location that allows setgid programs. Make sure the installation directory is set to group <code>mailman</code> (or whatever you're going to specify with <b class="programopt">--with-groupname</b>) and has the setgid bit set<A NAME="tex2html3" - HREF="#foot677"><SUP>3</SUP></A>. You probably also want to guarantee that this + HREF="#foot684"><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: @@ -94,16 +94,16 @@ You are now ready to configure and install the Mailman software. <P> <BR><HR><H4>Footnotes</H4> <DL> -<DT><A NAME="foot676">.../usr/local/mailman</A><A +<DT><A NAME="foot683">.../usr/local/mailman</A><A href="create-install-dir.html#tex2html2"><SUP>2</SUP></A></DT> <DD>This is the default for Mailman 2.1. Earlier versions of Mailman installed everything under <span class="file">/home/mailman</span> by default. </DD> -<DT><A NAME="foot677">... set</A><A +<DT><A NAME="foot684">... set</A><A href="create-install-dir.html#tex2html3"><SUP>3</SUP></A></DT> -<DD>BSD users should see the <A href="bsd-issues.html#bsd-issues">14.2</A> section +<DD>BSD users should see the <A href="bsd-issues.html#bsd-issues">15.2</A> section for additional information. </DD> @@ -140,7 +140,7 @@ for additional information. </div> </div> <hr /> -<span class="release-info">Release 2.1, documentation updated on December 13, 2004.</span> +<span class="release-info">Release 2.1, documentation updated on December 22, 2004.</span> </DIV> <!--End of Navigation Panel--> diff --git a/admin/www/mailman-install/customizing.html b/admin/www/mailman-install/customizing.html index a8a39d79..6e5a7cf6 100644 --- a/admin/www/mailman-install/customizing.html +++ b/admin/www/mailman-install/customizing.html @@ -5,26 +5,26 @@ <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="next" href="node40.html" /> +<link rel="prev" href="mail-server.html" /> <link rel="parent" href="front.html" /> -<link rel="next" href="node44.html" /> +<link rel="next" href="node40.html" /> <meta name='aesop' content='information' /> -<title>11 Customize Mailman</title> +<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="10 Check the hostname" - href="node42.html"><img src='previous.png' +<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="12 Create your first" - href="node44.html"><img src='next.png' +<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' @@ -36,88 +36,81 @@ </tr></table> <div class='online-navigation'> <b class="navlabel">Previous:</b> -<a class="sectref" rel="prev" href="node42.html">10 Check the hostname</A> +<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="node44.html">12 Create your first</A> +<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="SECTION0011100000000000000000"></A><A NAME="customizing"></A> +<H1><A NAME="SECTION001700000000000000000"></A><A NAME="customizing"></A> <BR> -11 Customize Mailman +7 Review your site defaults </H1> <P> -Now that Mailman is all set up, there are a few site-wide configurations you -can make before you start creating mailing lists. You should do these steps -using the account you installed Mailman under in the <A href="troubleshooting.html#building">13</A> section. +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="#foot701"><SUP>5</SUP></A>. +There are system tuning parameters and integration options. <P> - -<UL> -<LI>The file <span class="file"><var>$prefix/Mailman/Defaults.py</var></span> contains a number of - defaults for your installation. If any of these are incorrect, override - them in <span class="file"><var>$prefix</var>/Mailman/mm_cfg.py</span>, <strong>not</strong> in the - <span class="file">Defaults.py</span> file! See the comments in <span class="file">Defaults.py</span> for - details. Once a list is created, editing many of these variables will - have no effect. At that point, you'll need to configure your lists - through the web administration interface or through the command line - scripts <b class="program">bin/withlist</b> and <b class="program">bin/config_list</b>. +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 install process will never overwrite an existing <span class="file">mm_cfg.py</span> - file so you can freely make changes to this file. +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> -</LI> -<LI>Create the site password. Use this command: - -<P> -<div class="verbatim"><pre> - % $prefix/bin/mmsitepass <your-site-password> -</pre></div> - -<P> -This password can be used anywhere that individual user or mailing list - administrator passwords are required, giving the mailman site - administrator the ability to adjust these things when necessary. - -<P> -You may also want to create a password for the site-wide ``list creator'' - role. The list creator is someone other than the site administrator who - has privileges to create and remove lists through the web interface. Use - the <b class="programopt">-c</b> option to <b class="program">mmsitepass</b> to set this. +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> -</LI> -</UL> +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="foot701">... 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="10 Check the hostname" - href="node42.html"><img src='previous.png' +<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="12 Create your first" - href="node44.html"><img src='next.png' +<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' @@ -129,15 +122,15 @@ You may also want to create a password for the site-wide ``list creator'' </tr></table> <div class='online-navigation'> <b class="navlabel">Previous:</b> -<a class="sectref" rel="prev" href="node42.html">10 Check the hostname</A> +<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="node44.html">12 Create your first</A> +<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 13, 2004.</span> +<span class="release-info">Release 2.1, documentation updated on December 22, 2004.</span> </DIV> <!--End of Navigation Panel--> diff --git a/admin/www/mailman-install/exim3-transport.html b/admin/www/mailman-install/exim3-transport.html index 2fcb6606..247073be 100644 --- a/admin/www/mailman-install/exim3-transport.html +++ b/admin/www/mailman-install/exim3-transport.html @@ -104,7 +104,7 @@ i.e. somewhere between the first and second ``end'' line: </div> </div> <hr /> -<span class="release-info">Release 2.1, documentation updated on December 13, 2004.</span> +<span class="release-info">Release 2.1, documentation updated on December 22, 2004.</span> </DIV> <!--End of Navigation Panel--> diff --git a/admin/www/mailman-install/front.html b/admin/www/mailman-install/front.html index d3aeb5f4..09f86c1d 100644 --- a/admin/www/mailman-install/front.html +++ b/admin/www/mailman-install/front.html @@ -124,18 +124,19 @@ The GNU Mailman website is at <a class="url" href="http://www.list.org">http://w <LI><A href="node38.html">6.4.3 More information</a> </ul> </ul> -<LI><A href="node39.html">7 Create a site-wide mailing list</a> -<LI><A href="node40.html">8 Set up cron</a> -<LI><A href="node41.html">9 Start the Mailman qrunner</a> -<LI><A href="node42.html">10 Check the hostname settings</a> -<LI><A href="customizing.html">11 Customize Mailman</a> -<LI><A href="node44.html">12 Create your first mailing list</a> -<LI><A href="troubleshooting.html">13 Troubleshooting</a> -<LI><A href="node46.html">14 Platform and operating system notes</a> +<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="node47.html">14.1 GNU/Linux issues</a> -<LI><A href="bsd-issues.html">14.2 BSD issues</a> -<LI><A href="node49.html">14.3 MacOSX issues</a> +<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> @@ -172,7 +173,7 @@ The GNU Mailman website is at <a class="url" href="http://www.list.org">http://w </div> </div> <hr /> -<span class="release-info">Release 2.1, documentation updated on December 13, 2004.</span> +<span class="release-info">Release 2.1, documentation updated on December 22, 2004.</span> </DIV> <!--End of Navigation Panel--> diff --git a/admin/www/mailman-install/index.html b/admin/www/mailman-install/index.html index cb9e0ceb..291f0d97 100644 --- a/admin/www/mailman-install/index.html +++ b/admin/www/mailman-install/index.html @@ -45,7 +45,7 @@ <p><b><font size="+2">Barry Warsaw</font></b></p> <p><span class="email">barry(at)python.org</span></p> <p><strong>Release 2.1</strong><br /> -<strong>December 13, 2004</strong></p> +<strong>December 22, 2004</strong></p> <p></p> </div> </div> @@ -80,18 +80,19 @@ <LI><A href="node31.html">6.3 Using the Sendmail mail server</a> <LI><A href="qmail-issues.html">6.4 Using the Qmail mail server</a> </ul> -<LI><A href="node39.html">7 Create a site-wide mailing list</a> -<LI><A href="node40.html">8 Set up cron</a> -<LI><A href="node41.html">9 Start the Mailman qrunner</a> -<LI><A href="node42.html">10 Check the hostname settings</a> -<LI><A href="customizing.html">11 Customize Mailman</a> -<LI><A href="node44.html">12 Create your first mailing list</a> -<LI><A href="troubleshooting.html">13 Troubleshooting</a> -<LI><A href="node46.html">14 Platform and operating system notes</a> +<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="node47.html">14.1 GNU/Linux issues</a> -<LI><A href="bsd-issues.html">14.2 BSD issues</a> -<LI><A href="node49.html">14.3 MacOSX issues</a> +<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> @@ -125,7 +126,7 @@ </div> </div> <hr /> -<span class="release-info">Release 2.1, documentation updated on December 13, 2004.</span> +<span class="release-info">Release 2.1, documentation updated on December 22, 2004.</span> </DIV> <!--End of Navigation Panel--> diff --git a/admin/www/mailman-install/mail-server.html b/admin/www/mailman-install/mail-server.html index 4353f0b8..28afccbe 100644 --- a/admin/www/mailman-install/mail-server.html +++ b/admin/www/mailman-install/mail-server.html @@ -5,7 +5,7 @@ <link rel="first" href="mailman-install.html" title='GNU Mailman - Installation Manual' /> <link rel='last' href='about.html' title='About this document...' /> <link rel='help' href='about.html' title='About this document...' /> -<link rel="next" href="node39.html" /> +<link rel="next" href="customizing.html" /> <link rel="prev" href="node10.html" /> <link rel="parent" href="front.html" /> <link rel="next" href="node12.html" /> @@ -136,7 +136,7 @@ contributing documentation updates to the Mailman developers. </div> </div> <hr /> -<span class="release-info">Release 2.1, documentation updated on December 13, 2004.</span> +<span class="release-info">Release 2.1, documentation updated on December 22, 2004.</span> </DIV> <!--End of Navigation Panel--> diff --git a/admin/www/mailman-install/mailman-install.html b/admin/www/mailman-install/mailman-install.html index cb9e0ceb..291f0d97 100644 --- a/admin/www/mailman-install/mailman-install.html +++ b/admin/www/mailman-install/mailman-install.html @@ -45,7 +45,7 @@ <p><b><font size="+2">Barry Warsaw</font></b></p> <p><span class="email">barry(at)python.org</span></p> <p><strong>Release 2.1</strong><br /> -<strong>December 13, 2004</strong></p> +<strong>December 22, 2004</strong></p> <p></p> </div> </div> @@ -80,18 +80,19 @@ <LI><A href="node31.html">6.3 Using the Sendmail mail server</a> <LI><A href="qmail-issues.html">6.4 Using the Qmail mail server</a> </ul> -<LI><A href="node39.html">7 Create a site-wide mailing list</a> -<LI><A href="node40.html">8 Set up cron</a> -<LI><A href="node41.html">9 Start the Mailman qrunner</a> -<LI><A href="node42.html">10 Check the hostname settings</a> -<LI><A href="customizing.html">11 Customize Mailman</a> -<LI><A href="node44.html">12 Create your first mailing list</a> -<LI><A href="troubleshooting.html">13 Troubleshooting</a> -<LI><A href="node46.html">14 Platform and operating system notes</a> +<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="node47.html">14.1 GNU/Linux issues</a> -<LI><A href="bsd-issues.html">14.2 BSD issues</a> -<LI><A href="node49.html">14.3 MacOSX issues</a> +<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> @@ -125,7 +126,7 @@ </div> </div> <hr /> -<span class="release-info">Release 2.1, documentation updated on December 13, 2004.</span> +<span class="release-info">Release 2.1, documentation updated on December 22, 2004.</span> </DIV> <!--End of Navigation Panel--> diff --git a/admin/www/mailman-install/node10.html b/admin/www/mailman-install/node10.html index 617b509e..92a34bd0 100644 --- a/admin/www/mailman-install/node10.html +++ b/admin/www/mailman-install/node10.html @@ -184,7 +184,7 @@ Now restart your web server. </div> </div> <hr /> -<span class="release-info">Release 2.1, documentation updated on December 13, 2004.</span> +<span class="release-info">Release 2.1, documentation updated on December 22, 2004.</span> </DIV> <!--End of Navigation Panel--> diff --git a/admin/www/mailman-install/node12.html b/admin/www/mailman-install/node12.html index 1584f476..5c6f8da0 100644 --- a/admin/www/mailman-install/node12.html +++ b/admin/www/mailman-install/node12.html @@ -145,7 +145,7 @@ virtual domain support below. </div> </div> <hr /> -<span class="release-info">Release 2.1, documentation updated on December 13, 2004.</span> +<span class="release-info">Release 2.1, documentation updated on December 22, 2004.</span> </DIV> <!--End of Navigation Panel--> diff --git a/admin/www/mailman-install/node13.html b/admin/www/mailman-install/node13.html index e2fca7b5..97a62020 100644 --- a/admin/www/mailman-install/node13.html +++ b/admin/www/mailman-install/node13.html @@ -197,7 +197,7 @@ tables. </div> </div> <hr /> -<span class="release-info">Release 2.1, documentation updated on December 13, 2004.</span> +<span class="release-info">Release 2.1, documentation updated on December 22, 2004.</span> </DIV> <!--End of Navigation Panel--> diff --git a/admin/www/mailman-install/node15.html b/admin/www/mailman-install/node15.html index b7a7c8d8..2f8ee92c 100644 --- a/admin/www/mailman-install/node15.html +++ b/admin/www/mailman-install/node15.html @@ -102,7 +102,7 @@ instead of <code>mylist@dom.ain</code>. </div> </div> <hr /> -<span class="release-info">Release 2.1, documentation updated on December 13, 2004.</span> +<span class="release-info">Release 2.1, documentation updated on December 22, 2004.</span> </DIV> <!--End of Navigation Panel--> diff --git a/admin/www/mailman-install/node16.html b/admin/www/mailman-install/node16.html index 92e82c8e..b2224852 100644 --- a/admin/www/mailman-install/node16.html +++ b/admin/www/mailman-install/node16.html @@ -123,7 +123,7 @@ those in the config fragments given below. </div> </div> <hr /> -<span class="release-info">Release 2.1, documentation updated on December 13, 2004.</span> +<span class="release-info">Release 2.1, documentation updated on December 22, 2004.</span> </DIV> <!--End of Navigation Panel--> diff --git a/admin/www/mailman-install/node17.html b/admin/www/mailman-install/node17.html index f7cea2f0..d39249cc 100644 --- a/admin/www/mailman-install/node17.html +++ b/admin/www/mailman-install/node17.html @@ -143,7 +143,7 @@ and 2.1 installations, with the proviso that you'll probably want to use </div> </div> <hr /> -<span class="release-info">Release 2.1, documentation updated on December 13, 2004.</span> +<span class="release-info">Release 2.1, documentation updated on December 22, 2004.</span> </DIV> <!--End of Navigation Panel--> diff --git a/admin/www/mailman-install/node18.html b/admin/www/mailman-install/node18.html index eee3fde4..622cd9d7 100644 --- a/admin/www/mailman-install/node18.html +++ b/admin/www/mailman-install/node18.html @@ -102,7 +102,7 @@ you'll need to edit these based on how you configured and installed Mailman. </div> </div> <hr /> -<span class="release-info">Release 2.1, documentation updated on December 13, 2004.</span> +<span class="release-info">Release 2.1, documentation updated on December 22, 2004.</span> </DIV> <!--End of Navigation Panel--> diff --git a/admin/www/mailman-install/node2.html b/admin/www/mailman-install/node2.html index 03cd22ae..019055b1 100644 --- a/admin/www/mailman-install/node2.html +++ b/admin/www/mailman-install/node2.html @@ -114,7 +114,7 @@ Python 2.3 or newer is recommended. </div> </div> <hr /> -<span class="release-info">Release 2.1, documentation updated on December 13, 2004.</span> +<span class="release-info">Release 2.1, documentation updated on December 22, 2004.</span> </DIV> <!--End of Navigation Panel--> diff --git a/admin/www/mailman-install/node20.html b/admin/www/mailman-install/node20.html index ebb49487..49ba8441 100644 --- a/admin/www/mailman-install/node20.html +++ b/admin/www/mailman-install/node20.html @@ -106,7 +106,7 @@ aliasfile director, or vice-versa. </div> </div> <hr /> -<span class="release-info">Release 2.1, documentation updated on December 13, 2004.</span> +<span class="release-info">Release 2.1, documentation updated on December 22, 2004.</span> </DIV> <!--End of Navigation Panel--> diff --git a/admin/www/mailman-install/node21.html b/admin/www/mailman-install/node21.html index 435220f4..b1f76508 100644 --- a/admin/www/mailman-install/node21.html +++ b/admin/www/mailman-install/node21.html @@ -103,7 +103,7 @@ file, and remember that order matters. </div> </div> <hr /> -<span class="release-info">Release 2.1, documentation updated on December 13, 2004.</span> +<span class="release-info">Release 2.1, documentation updated on December 22, 2004.</span> </DIV> <!--End of Navigation Panel--> diff --git a/admin/www/mailman-install/node22.html b/admin/www/mailman-install/node22.html index e3a93a50..8f37e857 100644 --- a/admin/www/mailman-install/node22.html +++ b/admin/www/mailman-install/node22.html @@ -89,7 +89,7 @@ transports'' line of your Exim config file. </div> </div> <hr /> -<span class="release-info">Release 2.1, documentation updated on December 13, 2004.</span> +<span class="release-info">Release 2.1, documentation updated on December 22, 2004.</span> </DIV> <!--End of Navigation Panel--> diff --git a/admin/www/mailman-install/node23.html b/admin/www/mailman-install/node23.html index 249408e0..629e8c79 100644 --- a/admin/www/mailman-install/node23.html +++ b/admin/www/mailman-install/node23.html @@ -93,7 +93,7 @@ mail, unless you like receiving tons of mail when some random host is down. </div> </div> <hr /> -<span class="release-info">Release 2.1, documentation updated on December 13, 2004.</span> +<span class="release-info">Release 2.1, documentation updated on December 22, 2004.</span> </DIV> <!--End of Navigation Panel--> diff --git a/admin/www/mailman-install/node24.html b/admin/www/mailman-install/node24.html index c12a58fb..655710b3 100644 --- a/admin/www/mailman-install/node24.html +++ b/admin/www/mailman-install/node24.html @@ -119,7 +119,7 @@ </div> </div> <hr /> -<span class="release-info">Release 2.1, documentation updated on December 13, 2004.</span> +<span class="release-info">Release 2.1, documentation updated on December 22, 2004.</span> </DIV> <!--End of Navigation Panel--> diff --git a/admin/www/mailman-install/node25.html b/admin/www/mailman-install/node25.html index ad16c524..ddda4c3e 100644 --- a/admin/www/mailman-install/node25.html +++ b/admin/www/mailman-install/node25.html @@ -126,7 +126,7 @@ from non-127.0.0.1 hosts, but it should do the trick for Mailman.) </div> </div> <hr /> -<span class="release-info">Release 2.1, documentation updated on December 13, 2004.</span> +<span class="release-info">Release 2.1, documentation updated on December 22, 2004.</span> </DIV> <!--End of Navigation Panel--> diff --git a/admin/www/mailman-install/node26.html b/admin/www/mailman-install/node26.html index 68ca1212..eff912aa 100644 --- a/admin/www/mailman-install/node26.html +++ b/admin/www/mailman-install/node26.html @@ -131,7 +131,7 @@ this in your <code>DATA</code> ACL: </div> </div> <hr /> -<span class="release-info">Release 2.1, documentation updated on December 13, 2004.</span> +<span class="release-info">Release 2.1, documentation updated on December 22, 2004.</span> </DIV> <!--End of Navigation Panel--> diff --git a/admin/www/mailman-install/node27.html b/admin/www/mailman-install/node27.html index a66dc0fe..3cf633fb 100644 --- a/admin/www/mailman-install/node27.html +++ b/admin/www/mailman-install/node27.html @@ -101,7 +101,7 @@ In a nutshell, all you need to do to enable VERP with Exim is to add these lines </div> </div> <hr /> -<span class="release-info">Release 2.1, documentation updated on December 13, 2004.</span> +<span class="release-info">Release 2.1, documentation updated on December 22, 2004.</span> </DIV> <!--End of Navigation Panel--> diff --git a/admin/www/mailman-install/node28.html b/admin/www/mailman-install/node28.html index 3148a7b0..0183cc57 100644 --- a/admin/www/mailman-install/node28.html +++ b/admin/www/mailman-install/node28.html @@ -113,7 +113,7 @@ and change your transport like this: </div> </div> <hr /> -<span class="release-info">Release 2.1, documentation updated on December 13, 2004.</span> +<span class="release-info">Release 2.1, documentation updated on December 22, 2004.</span> </DIV> <!--End of Navigation Panel--> diff --git a/admin/www/mailman-install/node29.html b/admin/www/mailman-install/node29.html index bcf4d814..d6d937f9 100644 --- a/admin/www/mailman-install/node29.html +++ b/admin/www/mailman-install/node29.html @@ -114,7 +114,7 @@ functioning perfectly, though! </div> </div> <hr /> -<span class="release-info">Release 2.1, documentation updated on December 13, 2004.</span> +<span class="release-info">Release 2.1, documentation updated on December 22, 2004.</span> </DIV> <!--End of Navigation Panel--> diff --git a/admin/www/mailman-install/node3.html b/admin/www/mailman-install/node3.html index 1028abc5..311dea98 100644 --- a/admin/www/mailman-install/node3.html +++ b/admin/www/mailman-install/node3.html @@ -101,7 +101,7 @@ in this section. </div> </div> <hr /> -<span class="release-info">Release 2.1, documentation updated on December 13, 2004.</span> +<span class="release-info">Release 2.1, documentation updated on December 22, 2004.</span> </DIV> <!--End of Navigation Panel--> diff --git a/admin/www/mailman-install/node30.html b/admin/www/mailman-install/node30.html index 60c2d98b..2bd22974 100644 --- a/admin/www/mailman-install/node30.html +++ b/admin/www/mailman-install/node30.html @@ -89,7 +89,7 @@ Overhauled/reformatted/clarified/simplified by Greg Ward </div> </div> <hr /> -<span class="release-info">Release 2.1, documentation updated on December 13, 2004.</span> +<span class="release-info">Release 2.1, documentation updated on December 22, 2004.</span> </DIV> <!--End of Navigation Panel--> diff --git a/admin/www/mailman-install/node31.html b/admin/www/mailman-install/node31.html index 232e027b..df0c0fbc 100644 --- a/admin/www/mailman-install/node31.html +++ b/admin/www/mailman-install/node31.html @@ -120,7 +120,7 @@ what you're doing in order to re-enable it. </div> </div> <hr /> -<span class="release-info">Release 2.1, documentation updated on December 13, 2004.</span> +<span class="release-info">Release 2.1, documentation updated on December 22, 2004.</span> </DIV> <!--End of Navigation Panel--> diff --git a/admin/www/mailman-install/node32.html b/admin/www/mailman-install/node32.html index 4645c551..55537ff8 100644 --- a/admin/www/mailman-install/node32.html +++ b/admin/www/mailman-install/node32.html @@ -139,7 +139,7 @@ One good way of enabling this is: </div> </div> <hr /> -<span class="release-info">Release 2.1, documentation updated on December 13, 2004.</span> +<span class="release-info">Release 2.1, documentation updated on December 22, 2004.</span> </DIV> <!--End of Navigation Panel--> diff --git a/admin/www/mailman-install/node33.html b/admin/www/mailman-install/node33.html index 7b5e8bf7..2179c07a 100644 --- a/admin/www/mailman-install/node33.html +++ b/admin/www/mailman-install/node33.html @@ -107,7 +107,7 @@ find four files: </div> </div> <hr /> -<span class="release-info">Release 2.1, documentation updated on December 13, 2004.</span> +<span class="release-info">Release 2.1, documentation updated on December 22, 2004.</span> </DIV> <!--End of Navigation Panel--> diff --git a/admin/www/mailman-install/node34.html b/admin/www/mailman-install/node34.html index a49632b5..d9b68cb7 100644 --- a/admin/www/mailman-install/node34.html +++ b/admin/www/mailman-install/node34.html @@ -92,7 +92,7 @@ connections. </div> </div> <hr /> -<span class="release-info">Release 2.1, documentation updated on December 13, 2004.</span> +<span class="release-info">Release 2.1, documentation updated on December 22, 2004.</span> </DIV> <!--End of Navigation Panel--> diff --git a/admin/www/mailman-install/node36.html b/admin/www/mailman-install/node36.html index b4ae4f9d..209f089c 100644 --- a/admin/www/mailman-install/node36.html +++ b/admin/www/mailman-install/node36.html @@ -107,7 +107,7 @@ is the more qmail-friendly approach resulting in large performance gains. </div> </div> <hr /> -<span class="release-info">Release 2.1, documentation updated on December 13, 2004.</span> +<span class="release-info">Release 2.1, documentation updated on December 22, 2004.</span> </DIV> <!--End of Navigation Panel--> diff --git a/admin/www/mailman-install/node37.html b/admin/www/mailman-install/node37.html index c90f58da..20db3486 100644 --- a/admin/www/mailman-install/node37.html +++ b/admin/www/mailman-install/node37.html @@ -93,7 +93,7 @@ Again, this patch is for people familiar with their qmail installation. </div> </div> <hr /> -<span class="release-info">Release 2.1, documentation updated on December 13, 2004.</span> +<span class="release-info">Release 2.1, documentation updated on December 22, 2004.</span> </DIV> <!--End of Navigation Panel--> diff --git a/admin/www/mailman-install/node38.html b/admin/www/mailman-install/node38.html index 15fe4fad..38feee5e 100644 --- a/admin/www/mailman-install/node38.html +++ b/admin/www/mailman-install/node38.html @@ -7,7 +7,7 @@ <link rel='help' href='about.html' title='About this document...' /> <link rel="prev" href="node37.html" /> <link rel="parent" href="qmail-issues.html" /> -<link rel="next" href="node39.html" /> +<link rel="next" href="customizing.html" /> <meta name='aesop' content='information' /> <title>6.4.3 More information</title> </head> @@ -22,8 +22,8 @@ <td class='online-navigation'><a rel="parent" title="6.4 Using the Qmail" href="qmail-issues.html"><img src='up.png' border='0' height='32' alt='Up One Level' width='32' /></A></td> -<td class='online-navigation'><a rel="next" title="7 Create a site-wide" - href="node39.html"><img src='next.png' +<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' @@ -39,7 +39,7 @@ <b class="navlabel">Up:</b> <a class="sectref" rel="parent" href="qmail-issues.html">6.4 Using the Qmail</A> <b class="navlabel">Next:</b> -<a class="sectref" rel="next" href="node39.html">7 Create a site-wide</A> +<a class="sectref" rel="next" href="customizing.html">7 Review your site</A> </div> <hr /></div> </DIV> @@ -68,8 +68,8 @@ Bollow has written about Mailman and qmail, available here: <td class='online-navigation'><a rel="parent" title="6.4 Using the Qmail" href="qmail-issues.html"><img src='up.png' border='0' height='32' alt='Up One Level' width='32' /></A></td> -<td class='online-navigation'><a rel="next" title="7 Create a site-wide" - href="node39.html"><img src='next.png' +<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' @@ -85,11 +85,11 @@ Bollow has written about Mailman and qmail, available here: <b class="navlabel">Up:</b> <a class="sectref" rel="parent" href="qmail-issues.html">6.4 Using the Qmail</A> <b class="navlabel">Next:</b> -<a class="sectref" rel="next" href="node39.html">7 Create a site-wide</A> +<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 13, 2004.</span> +<span class="release-info">Release 2.1, documentation updated on December 22, 2004.</span> </DIV> <!--End of Navigation Panel--> diff --git a/admin/www/mailman-install/node39.html b/admin/www/mailman-install/node39.html index f6b4338f..d120751b 100644 --- a/admin/www/mailman-install/node39.html +++ b/admin/www/mailman-install/node39.html @@ -10,7 +10,7 @@ <link rel="parent" href="front.html" /> <link rel="next" href="node40.html" /> <meta name='aesop' content='information' /> -<title>7 Create a site-wide mailing list</title> +<title>7 Review your site defaults</title> </head> <body> <DIV CLASS="navigation"> @@ -23,7 +23,7 @@ <td class='online-navigation'><a rel="parent" title="Front Matter" href="front.html"><img src='up.png' border='0' height='32' alt='Up One Level' width='32' /></A></td> -<td class='online-navigation'><a rel="next" title="8 Set up cron" +<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> @@ -40,55 +40,50 @@ <b class="navlabel">Up:</b> <a class="sectref" rel="parent" href="front.html">Front Matter</A> <b class="navlabel">Next:</b> -<a class="sectref" rel="next" href="node40.html">8 Set up cron</A> +<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"> -7 Create a site-wide mailing list</A> +7 Review your site defaults</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: +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="#foot508"><SUP>5</SUP></A>. There are system tuning parameters and integration options. <P> -<div class="verbatim"><pre> - % bin/newlist mailman -</pre></div> +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> -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. +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> +<BR><HR><H4>Footnotes</H4> +<DL> +<DT><A NAME="foot508">... lists</A><A + HREF="node39.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. +</DD> +</DL> <DIV CLASS="navigation"> <div class='online-navigation'> <p></p><hr /> @@ -100,7 +95,7 @@ You should also subscribe yourself to the site list. <td class='online-navigation'><a rel="parent" title="Front Matter" href="front.html"><img src='up.png' border='0' height='32' alt='Up One Level' width='32' /></A></td> -<td class='online-navigation'><a rel="next" title="8 Set up cron" +<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> @@ -117,11 +112,11 @@ You should also subscribe yourself to the site list. <b class="navlabel">Up:</b> <a class="sectref" rel="parent" href="front.html">Front Matter</A> <b class="navlabel">Next:</b> -<a class="sectref" rel="next" href="node40.html">8 Set up cron</A> +<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 13, 2004.</span> +<span class="release-info">Release 2.1, documentation updated on December 22, 2004.</span> </DIV> <!--End of Navigation Panel--> diff --git a/admin/www/mailman-install/node4.html b/admin/www/mailman-install/node4.html index bae31de6..11ef9b87 100644 --- a/admin/www/mailman-install/node4.html +++ b/admin/www/mailman-install/node4.html @@ -121,7 +121,7 @@ installation is complete. </div> </div> <hr /> -<span class="release-info">Release 2.1, documentation updated on December 13, 2004.</span> +<span class="release-info">Release 2.1, documentation updated on December 22, 2004.</span> </DIV> <!--End of Navigation Panel--> diff --git a/admin/www/mailman-install/node40.html b/admin/www/mailman-install/node40.html index 54352cce..0ee9e8e2 100644 --- a/admin/www/mailman-install/node40.html +++ b/admin/www/mailman-install/node40.html @@ -6,24 +6,24 @@ <link rel='last' href='about.html' title='About this document...' /> <link rel='help' href='about.html' title='About this document...' /> <link rel="next" href="node41.html" /> -<link rel="prev" href="node39.html" /> +<link rel="prev" href="customizing.html" /> <link rel="parent" href="front.html" /> <link rel="next" href="node41.html" /> <meta name='aesop' content='information' /> -<title>8 Set up cron</title> +<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 Create a site-wide" - href="node39.html"><img src='previous.png' +<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 Start the Mailman" +<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> @@ -36,73 +36,71 @@ </tr></table> <div class='online-navigation'> <b class="navlabel">Previous:</b> -<a class="sectref" rel="prev" href="node39.html">7 Create a site-wide</A> +<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 Start the Mailman</A> +<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 Set up cron</A> +8 Create a site-wide mailing list</A> </H1> <P> -Several Mailman features occur on a regular schedule, so you must set up -<b class="program">cron</b> to run the right programs at the right time<A NAME="tex2html5" - HREF="#foot520"><SUP>5</SUP></A>. - -<P> -If your version of crontab supports the <b class="programopt">-u</b> option, you must be -root to do this next step. Add <span class="file"><var>$prefix</var>/cron/crontab.in</span> as a -crontab entry by executing these commands: +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> - % cd $prefix/cron - % crontab -u mailman crontab.in + % bin/newlist mailman </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: +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> - % cd $prefix/cron - % su - mailman - % crontab crontab.in + % bin/config_list -i data/sitelist.cfg mailman </pre></div> <P> -<BR><HR><H4>Footnotes</H4> -<DL> -<DT><A NAME="foot520">... time</A><A - HREF="node40.html#tex2html5"><SUP>5</SUP></A></DT> -<DD>Note that -if you're upgrading from a previous version of Mailman, you'll want to install -the new crontab, but be careful if you're running multiple Mailman -installations on your site! Changing the crontab could mess with other -parallel Mailman installations. +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> -</DD> -</DL> <DIV CLASS="navigation"> <div class='online-navigation'> <p></p><hr /> <table align="center" width="100%" cellpadding="0" cellspacing="2"> <tr> -<td class='online-navigation'><a rel="prev" title="7 Create a site-wide" - href="node39.html"><img src='previous.png' +<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 Start the Mailman" +<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> @@ -115,15 +113,15 @@ parallel Mailman installations. </tr></table> <div class='online-navigation'> <b class="navlabel">Previous:</b> -<a class="sectref" rel="prev" href="node39.html">7 Create a site-wide</A> +<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 Start the Mailman</A> +<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 13, 2004.</span> +<span class="release-info">Release 2.1, documentation updated on December 22, 2004.</span> </DIV> <!--End of Navigation Panel--> diff --git a/admin/www/mailman-install/node41.html b/admin/www/mailman-install/node41.html index fceac309..be718986 100644 --- a/admin/www/mailman-install/node41.html +++ b/admin/www/mailman-install/node41.html @@ -10,20 +10,20 @@ <link rel="parent" href="front.html" /> <link rel="next" href="node42.html" /> <meta name='aesop' content='information' /> -<title>9 Start the Mailman qrunner</title> +<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 Set up cron" +<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 Check the hostname" +<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> @@ -36,100 +36,73 @@ </tr></table> <div class='online-navigation'> <b class="navlabel">Previous:</b> -<a class="sectref" rel="prev" href="node40.html">8 Set up cron</A> +<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 Check the hostname</A> +<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 Start the Mailman qrunner</A> +9 Set up cron</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: +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="#foot542"><SUP>6</SUP></A>. <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: +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> - % update-rc.d mailman defaults + % cd $prefix/cron + % crontab -u mailman crontab.in </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: +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> - % 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 + % cd $prefix/cron + % su - mailman + % crontab crontab.in </pre></div> <P> +<BR><HR><H4>Footnotes</H4> +<DL> +<DT><A NAME="foot542">... 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 Set up cron" +<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 Check the hostname" +<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> @@ -142,15 +115,15 @@ following set of commands: </tr></table> <div class='online-navigation'> <b class="navlabel">Previous:</b> -<a class="sectref" rel="prev" href="node40.html">8 Set up cron</A> +<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 Check the hostname</A> +<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 13, 2004.</span> +<span class="release-info">Release 2.1, documentation updated on December 22, 2004.</span> </DIV> <!--End of Navigation Panel--> diff --git a/admin/www/mailman-install/node42.html b/admin/www/mailman-install/node42.html index 69fb16ad..7f577567 100644 --- a/admin/www/mailman-install/node42.html +++ b/admin/www/mailman-install/node42.html @@ -5,26 +5,26 @@ <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="next" href="node43.html" /> <link rel="prev" href="node41.html" /> <link rel="parent" href="front.html" /> -<link rel="next" href="customizing.html" /> +<link rel="next" href="node43.html" /> <meta name='aesop' content='information' /> -<title>10 Check the hostname settings</title> +<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 Start the Mailman" +<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 Customize Mailman" - href="customizing.html"><img src='next.png' +<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' @@ -36,35 +36,85 @@ </tr></table> <div class='online-navigation'> <b class="navlabel">Previous:</b> -<a class="sectref" rel="prev" href="node41.html">9 Start the Mailman</A> +<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="customizing.html">11 Customize Mailman</A> +<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 Check the hostname settings</A> +10 Start the Mailman qrunner</A> </H1> <P> -You should check the values for <var>DEFAULT_EMAIL_HOST</var> and -<var>DEFAULT_URL_HOST</var> in <span class="file">Defaults.py</span>. Make any necessary changes in -the <span class="file">mm_cfg.py</span> file, <strong>not</strong> in the <span class="file">mm_cfg.py</span> file. If you -change either of these two values, you'll want to add the following afterwards -in the <span class="file">mm_cfg.py</span> file: +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> - add_virtualhost(DEFAULT_URL_HOST, DEFAULT_EMAIL_HOST) + % bin/mailmanctl start </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. +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> @@ -73,14 +123,14 @@ existing lists. <p></p><hr /> <table align="center" width="100%" cellpadding="0" cellspacing="2"> <tr> -<td class='online-navigation'><a rel="prev" title="9 Start the Mailman" +<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 Customize Mailman" - href="customizing.html"><img src='next.png' +<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' @@ -92,15 +142,15 @@ existing lists. </tr></table> <div class='online-navigation'> <b class="navlabel">Previous:</b> -<a class="sectref" rel="prev" href="node41.html">9 Start the Mailman</A> +<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="customizing.html">11 Customize Mailman</A> +<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 13, 2004.</span> +<span class="release-info">Release 2.1, documentation updated on December 22, 2004.</span> </DIV> <!--End of Navigation Panel--> diff --git a/admin/www/mailman-install/node43.html b/admin/www/mailman-install/node43.html new file mode 100644 index 00000000..d30705c4 --- /dev/null +++ b/admin/www/mailman-install/node43.html @@ -0,0 +1,108 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> +<html> +<head> +<link rel="STYLESHEET" href="mailman-install.css" type='text/css' /> +<link rel="first" href="mailman-install.html" title='GNU Mailman - Installation Manual' /> +<link rel='last' href='about.html' title='About this document...' /> +<link rel='help' href='about.html' title='About this document...' /> +<link rel="next" href="node44.html" /> +<link rel="prev" href="node42.html" /> +<link rel="parent" href="front.html" /> +<link rel="next" href="node44.html" /> +<meta name='aesop' content='information' /> +<title>11 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">mm_cfg.py</span> file. If you +change either of these two values, you'll want to add the following afterwards +in the <span class="file">mm_cfg.py</span> file: + +<P> +<div class="verbatim"><pre> + add_virtualhost(DEFAULT_URL_HOST, DEFAULT_EMAIL_HOST) +</pre></div> + +<P> +You will want to run the <b class="program">bin/fix_url.py</b> to change the domain of any +existing lists. + +<P> + +<DIV CLASS="navigation"> +<div class='online-navigation'> +<p></p><hr /> +<table align="center" width="100%" cellpadding="0" cellspacing="2"> +<tr> +<td class='online-navigation'><a rel="prev" title="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 22, 2004.</span> +</DIV> +<!--End of Navigation Panel--> + +</BODY> +</HTML> diff --git a/admin/www/mailman-install/node44.html b/admin/www/mailman-install/node44.html index f9e164ba..d52bfcc4 100644 --- a/admin/www/mailman-install/node44.html +++ b/admin/www/mailman-install/node44.html @@ -5,26 +5,26 @@ <link rel="first" href="mailman-install.html" title='GNU Mailman - Installation Manual' /> <link rel='last' href='about.html' title='About this document...' /> <link rel='help' href='about.html' title='About this document...' /> -<link rel="next" href="troubleshooting.html" /> -<link rel="prev" href="customizing.html" /> +<link rel="next" href="node45.html" /> +<link rel="prev" href="node43.html" /> <link rel="parent" href="front.html" /> -<link rel="next" href="troubleshooting.html" /> +<link rel="next" href="node45.html" /> <meta name='aesop' content='information' /> -<title>12 Create your first mailing list</title> +<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 Customize Mailman" - href="customizing.html"><img src='previous.png' +<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 Troubleshooting" - href="troubleshooting.html"><img src='next.png' +<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' @@ -36,80 +36,54 @@ </tr></table> <div class='online-navigation'> <b class="navlabel">Previous:</b> -<a class="sectref" rel="prev" href="customizing.html">11 Customize Mailman</A> +<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="troubleshooting.html">13 Troubleshooting</A> +<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 your first mailing list</A> +12 Create the site password</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: +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> - -<UL> -<LI>Start by visiting the url <code>http://my.dom.ain/mailman/create</code>. - -<P> -</LI> -<LI>Fill out the form as described in the on-screen instructions, and in the - ``List creator's password'' field, type the password you entered in - section <A href="customizing.html#customizing">11</A>. Type your own email address for the - ``Initial list owner address'', and select ``Yes'' to notify the list - administrator. - -<P> -</LI> -<LI>Click on the ``Create List'' button. - -<P> -</LI> -<LI>Check your email for a message from Mailman informing you that your new - mailing list was created. - -<P> -</LI> -<LI>Now visit the list's administration page, either by following the link - on the confirmation web page or clicking on the link from the email - Mailman just sent you. Typically the url will be something like - <code>http://my.dom.ain/mailman/admin/mylist</code>. +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> -</LI> -<LI>Type in the list's password and click on ``Let me in...'' +To set the site password, use this command: <P> -</LI> -<LI>Click on ``Membership Management'' and then on ``Mass Subscription''. +<div class="verbatim"><pre> + % $prefix/bin/mmsitepass <your-site-password> +</pre></div> <P> -</LI> -<LI>Enter your email address in the big text field, and click on ``Submit - Your Changes''. +To set the list creator password, use this command: <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> +<div class="verbatim"><pre> + % $prefix/bin/mmsitepass -c <list-creator-password> +</pre></div> <P> -Congratulations! You've just set up and tested your first Mailman mailing -list. If you had any problems along the way, please see the -<A href="troubleshooting.html#troubleshooting">13</A> section. +It is okay not to set a list creator password, but you probably do want a site +password. <P> @@ -118,14 +92,14 @@ list. If you had any problems along the way, please see the <p></p><hr /> <table align="center" width="100%" cellpadding="0" cellspacing="2"> <tr> -<td class='online-navigation'><a rel="prev" title="11 Customize Mailman" - href="customizing.html"><img src='previous.png' +<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 Troubleshooting" - href="troubleshooting.html"><img src='next.png' +<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' @@ -137,15 +111,15 @@ list. If you had any problems along the way, please see the </tr></table> <div class='online-navigation'> <b class="navlabel">Previous:</b> -<a class="sectref" rel="prev" href="customizing.html">11 Customize Mailman</A> +<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="troubleshooting.html">13 Troubleshooting</A> +<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 13, 2004.</span> +<span class="release-info">Release 2.1, documentation updated on December 22, 2004.</span> </DIV> <!--End of Navigation Panel--> diff --git a/admin/www/mailman-install/node45.html b/admin/www/mailman-install/node45.html new file mode 100644 index 00000000..ca9233ce --- /dev/null +++ b/admin/www/mailman-install/node45.html @@ -0,0 +1,153 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> +<html> +<head> +<link rel="STYLESHEET" href="mailman-install.css" type='text/css' /> +<link rel="first" href="mailman-install.html" title='GNU Mailman - Installation Manual' /> +<link rel='last' href='about.html' title='About this document...' /> +<link rel='help' href='about.html' title='About this document...' /> +<link rel="next" href="troubleshooting.html" /> +<link rel="prev" href="node44.html" /> +<link rel="parent" href="front.html" /> +<link rel="next" href="troubleshooting.html" /> +<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 22, 2004.</span> +</DIV> +<!--End of Navigation Panel--> + +</BODY> +</HTML> diff --git a/admin/www/mailman-install/node47.html b/admin/www/mailman-install/node47.html index ad1ad67d..60b857ca 100644 --- a/admin/www/mailman-install/node47.html +++ b/admin/www/mailman-install/node47.html @@ -5,26 +5,25 @@ <link rel="first" href="mailman-install.html" title='GNU Mailman - Installation Manual' /> <link rel='last' href='about.html' title='About this document...' /> <link rel='help' href='about.html' title='About this document...' /> -<link rel="next" href="bsd-issues.html" /> -<link rel="prev" href="node46.html" /> -<link rel="parent" href="node46.html" /> -<link rel="next" href="bsd-issues.html" /> +<link rel="prev" href="troubleshooting.html" /> +<link rel="parent" href="front.html" /> +<link rel="next" href="node48.html" /> <meta name='aesop' content='information' /> -<title>14.1 GNU/Linux issues</title> +<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 Platform and operating" - href="node46.html"><img src='previous.png' +<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="14 Platform and operating" - href="node46.html"><img src='up.png' +<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.2 BSD issues" - href="bsd-issues.html"><img src='next.png' +<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' @@ -36,97 +35,56 @@ </tr></table> <div class='online-navigation'> <b class="navlabel">Previous:</b> -<a class="sectref" rel="prev" href="node46.html">14 Platform and operating</A> +<a class="sectref" rel="prev" href="troubleshooting.html">14 Troubleshooting</A> <b class="navlabel">Up:</b> -<a class="sectref" rel="parent" href="node46.html">14 Platform and operating</A> +<a class="sectref" rel="parent" href="front.html">Front Matter</A> <b class="navlabel">Next:</b> -<a class="sectref" rel="next" href="bsd-issues.html">14.2 BSD issues</A> +<a class="sectref" rel="next" href="node48.html">15.1 GNU/Linux issues</A> </div> <hr /></div> </DIV> <!--End of Navigation Panel--> -<H2><A NAME="SECTION0011410000000000000000"> -14.1 GNU/Linux issues</A> -</H2> +<H1><A NAME="SECTION0011500000000000000000"> +15 Platform and operating system notes</A> +</H1> <P> -Linux seems to be the most popular platform for running Mailman. Here are -some hints on getting Mailman to run on Linux: +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> -<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> +<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 Platform and operating" - href="node46.html"><img src='previous.png' +<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="14 Platform and operating" - href="node46.html"><img src='up.png' +<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.2 BSD issues" - href="bsd-issues.html"><img src='next.png' +<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' @@ -138,15 +96,15 @@ This problem can manifest itself in other Linux distributions in </tr></table> <div class='online-navigation'> <b class="navlabel">Previous:</b> -<a class="sectref" rel="prev" href="node46.html">14 Platform and operating</A> +<a class="sectref" rel="prev" href="troubleshooting.html">14 Troubleshooting</A> <b class="navlabel">Up:</b> -<a class="sectref" rel="parent" href="node46.html">14 Platform and operating</A> +<a class="sectref" rel="parent" href="front.html">Front Matter</A> <b class="navlabel">Next:</b> -<a class="sectref" rel="next" href="bsd-issues.html">14.2 BSD issues</A> +<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 13, 2004.</span> +<span class="release-info">Release 2.1, documentation updated on December 22, 2004.</span> </DIV> <!--End of Navigation Panel--> diff --git a/admin/www/mailman-install/node48.html b/admin/www/mailman-install/node48.html new file mode 100644 index 00000000..9767a5a0 --- /dev/null +++ b/admin/www/mailman-install/node48.html @@ -0,0 +1,154 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> +<html> +<head> +<link rel="STYLESHEET" href="mailman-install.css" type='text/css' /> +<link rel="first" href="mailman-install.html" title='GNU Mailman - Installation Manual' /> +<link rel='last' href='about.html' title='About this document...' /> +<link rel='help' href='about.html' title='About this document...' /> +<link rel="next" href="bsd-issues.html" /> +<link rel="prev" href="node47.html" /> +<link rel="parent" href="node47.html" /> +<link rel="next" href="bsd-issues.html" /> +<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 22, 2004.</span> +</DIV> +<!--End of Navigation Panel--> + +</BODY> +</HTML> diff --git a/admin/www/mailman-install/node50.html b/admin/www/mailman-install/node50.html new file mode 100644 index 00000000..6ff32984 --- /dev/null +++ b/admin/www/mailman-install/node50.html @@ -0,0 +1,127 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> +<html> +<head> +<link rel="STYLESHEET" href="mailman-install.css" type='text/css' /> +<link rel="first" href="mailman-install.html" title='GNU Mailman - Installation Manual' /> +<link rel='last' href='about.html' title='About this document...' /> +<link rel='help' href='about.html' title='About this document...' /> +<link rel="prev" href="bsd-issues.html" /> +<link rel="parent" href="node47.html" /> +<link rel="next" href="about.html" /> +<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; Apple has a tech + document about a problem you might encounter running Mailman on Mac OS X + Server 10.3: + +<P> +<a class="url" href="http://docs.info.apple.com/article.html?artnum=107889">http://docs.info.apple.com/article.html?artnum=107889</a> +</LI> +</UL> + +<P> + +<DIV CLASS="navigation"> +<div class='online-navigation'> +<p></p><hr /> +<table align="center" width="100%" cellpadding="0" cellspacing="2"> +<tr> +<td class='online-navigation'><a rel="prev" title="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 22, 2004.</span> +</DIV> +<!--End of Navigation Panel--> + +</BODY> +</HTML> diff --git a/admin/www/mailman-install/node6.html b/admin/www/mailman-install/node6.html index de202700..1a7ad92e 100644 --- a/admin/www/mailman-install/node6.html +++ b/admin/www/mailman-install/node6.html @@ -97,7 +97,7 @@ </div> </div> <hr /> -<span class="release-info">Release 2.1, documentation updated on December 13, 2004.</span> +<span class="release-info">Release 2.1, documentation updated on December 22, 2004.</span> </DIV> <!--End of Navigation Panel--> diff --git a/admin/www/mailman-install/node7.html b/admin/www/mailman-install/node7.html index 3406d5a5..ba2f996f 100644 --- a/admin/www/mailman-install/node7.html +++ b/admin/www/mailman-install/node7.html @@ -242,7 +242,7 @@ If you're using Apache, check the values for the <var>Group</var> option in </div> </div> <hr /> -<span class="release-info">Release 2.1, documentation updated on December 13, 2004.</span> +<span class="release-info">Release 2.1, documentation updated on December 22, 2004.</span> </DIV> <!--End of Navigation Panel--> diff --git a/admin/www/mailman-install/node8.html b/admin/www/mailman-install/node8.html index 914b7352..98f0a186 100644 --- a/admin/www/mailman-install/node8.html +++ b/admin/www/mailman-install/node8.html @@ -87,7 +87,7 @@ Once you've run <b class="program">configure</b>, you can simply run <b class="p </div> </div> <hr /> -<span class="release-info">Release 2.1, documentation updated on December 13, 2004.</span> +<span class="release-info">Release 2.1, documentation updated on December 22, 2004.</span> </DIV> <!--End of Navigation Panel--> diff --git a/admin/www/mailman-install/node9.html b/admin/www/mailman-install/node9.html index 793df48b..2b1ca4a8 100644 --- a/admin/www/mailman-install/node9.html +++ b/admin/www/mailman-install/node9.html @@ -114,7 +114,7 @@ to fix the problems (probably the easiest solution): </div> </div> <hr /> -<span class="release-info">Release 2.1, documentation updated on December 13, 2004.</span> +<span class="release-info">Release 2.1, documentation updated on December 22, 2004.</span> </DIV> <!--End of Navigation Panel--> diff --git a/admin/www/mailman-install/postfix-virtual.html b/admin/www/mailman-install/postfix-virtual.html index 7d7a137e..cdfc060c 100644 --- a/admin/www/mailman-install/postfix-virtual.html +++ b/admin/www/mailman-install/postfix-virtual.html @@ -188,7 +188,7 @@ group owned by <code>mailman</code>. </div> </div> <hr /> -<span class="release-info">Release 2.1, documentation updated on December 13, 2004.</span> +<span class="release-info">Release 2.1, documentation updated on December 22, 2004.</span> </DIV> <!--End of Navigation Panel--> diff --git a/admin/www/mailman-install/qmail-issues.html b/admin/www/mailman-install/qmail-issues.html index 7c3c7955..89c90c75 100644 --- a/admin/www/mailman-install/qmail-issues.html +++ b/admin/www/mailman-install/qmail-issues.html @@ -300,7 +300,7 @@ fi </div> </div> <hr /> -<span class="release-info">Release 2.1, documentation updated on December 13, 2004.</span> +<span class="release-info">Release 2.1, documentation updated on December 22, 2004.</span> </DIV> <!--End of Navigation Panel--> diff --git a/admin/www/mailman-install/troubleshooting.html b/admin/www/mailman-install/troubleshooting.html index 20980a3f..2498a6d9 100644 --- a/admin/www/mailman-install/troubleshooting.html +++ b/admin/www/mailman-install/troubleshooting.html @@ -5,26 +5,26 @@ <link rel="first" href="mailman-install.html" title='GNU Mailman - Installation Manual' /> <link rel='last' href='about.html' title='About this document...' /> <link rel='help' href='about.html' title='About this document...' /> -<link rel="next" href="node46.html" /> -<link rel="prev" href="node44.html" /> +<link rel="next" href="node47.html" /> +<link rel="prev" href="node45.html" /> <link rel="parent" href="front.html" /> -<link rel="next" href="node46.html" /> +<link rel="next" href="node47.html" /> <meta name='aesop' content='information' /> -<title>13 Troubleshooting</title> +<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="12 Create your first" - href="node44.html"><img src='previous.png' +<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="14 Platform and operating" - href="node46.html"><img src='next.png' +<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' @@ -36,19 +36,19 @@ </tr></table> <div class='online-navigation'> <b class="navlabel">Previous:</b> -<a class="sectref" rel="prev" href="node44.html">12 Create your first</A> +<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="node46.html">14 Platform and operating</A> +<a class="sectref" rel="next" href="node47.html">15 Platform and operating</A> </div> <hr /></div> </DIV> <!--End of Navigation Panel--> -<H1><A NAME="SECTION0011300000000000000000"></A><A NAME="troubleshooting"></A> +<H1><A NAME="SECTION0011400000000000000000"></A><A NAME="troubleshooting"></A> <BR> -13 Troubleshooting +14 Troubleshooting </H1> <P> @@ -65,8 +65,8 @@ answer section below. If your problem is not covered there, check the Also check for errors in your syslog files, your mail and web server log files and in Mailman's <span class="file"><var>$prefix</var>/logs/error</span> file. If you're still having problems, you should send a message to the -<span class="email">mailman-users@python.org</span> mailing list<A NAME="tex2html6" - HREF="#foot598"><SUP>6</SUP></A>; see +<span class="email">mailman-users@python.org</span> mailing list<A NAME="tex2html7" + HREF="#foot605"><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. @@ -211,8 +211,8 @@ Note that on Debian Linux, the system makes <span class="file">/usr/lib/sm.bin</ <P> <BR><HR><H4>Footnotes</H4> <DL> -<DT><A NAME="foot598">... list</A><A - href="troubleshooting.html#tex2html6"><SUP>6</SUP></A></DT> +<DT><A NAME="foot605">... 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. @@ -224,14 +224,14 @@ publicly visible. <p></p><hr /> <table align="center" width="100%" cellpadding="0" cellspacing="2"> <tr> -<td class='online-navigation'><a rel="prev" title="12 Create your first" - href="node44.html"><img src='previous.png' +<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="14 Platform and operating" - href="node46.html"><img src='next.png' +<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' @@ -243,15 +243,15 @@ publicly visible. </tr></table> <div class='online-navigation'> <b class="navlabel">Previous:</b> -<a class="sectref" rel="prev" href="node44.html">12 Create your first</A> +<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="node46.html">14 Platform and operating</A> +<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 13, 2004.</span> +<span class="release-info">Release 2.1, documentation updated on December 22, 2004.</span> </DIV> <!--End of Navigation Panel--> |