diff options
Diffstat (limited to '')
| -rw-r--r-- | admin/www/mailman-install/customizing.html | 111 |
1 files changed, 52 insertions, 59 deletions
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--> |