diff options
| author | bwarsaw | 2000-11-08 18:43:39 +0000 |
|---|---|---|
| committer | bwarsaw | 2000-11-08 18:43:39 +0000 |
| commit | 9d0b42eb6e44accec416f1c179a6065f3ac3e0cb (patch) | |
| tree | fb616c0ecaa2390dc4dd92c65ff9ca28d4d0dd26 /admin/www/install-final.html | |
| parent | 58b8b1f5f4d005a201c66e7dd48e0db3734fd889 (diff) | |
| download | mailman-9d0b42eb6e44accec416f1c179a6065f3ac3e0cb.tar.gz mailman-9d0b42eb6e44accec416f1c179a6065f3ac3e0cb.tar.zst mailman-9d0b42eb6e44accec416f1c179a6065f3ac3e0cb.zip | |
New Mailman 2.0 documentation. Uses ht2html site generator, with the
MMGenerator style. The ht2html tool isn't included here, but it's
available from
http://www.wooz.org/users/barry/software/pyware.html
It's not completely filled in, but it's better than it was!
Note that we're checking in both the templates and the generated html
files, so distros contain the final documentation.
Diffstat (limited to 'admin/www/install-final.html')
| -rw-r--r-- | admin/www/install-final.html | 317 |
1 files changed, 317 insertions, 0 deletions
diff --git a/admin/www/install-final.html b/admin/www/install-final.html new file mode 100644 index 000000000..9a9135e4e --- /dev/null +++ b/admin/www/install-final.html @@ -0,0 +1,317 @@ +<HTML> +<!-- THIS PAGE IS AUTOMATICALLY GENERATED. DO NOT EDIT. --> +<!-- Wed Nov 8 13:38:28 2000 --> +<!-- USING HT2HTML 1.1 --> +<!-- SEE http://www.python.org/~bwarsaw/software/pyware.html --> +<!-- User-specified headers: +Title: Final system setup + +--> + +<HEAD> +<TITLE>Final system setup</TITLE> + +</HEAD> +<BODY BGCOLOR="#ffffff" TEXT="#000000" + TOPMARGIN="0" LEFTMARGIN="0" MARGINWIDTH="0" MARGINHEIGHT="0" + LINK="#0000bb" VLINK="#551a8b" + ALINK="#ff0000"> +<!-- start of page table --> +<TABLE WIDTH="100%" BORDER=0 CELLSPACING=0 CELLPADDING=0> +<!-- start of banner row --> +<TR> +<!-- start of corner cells --> +<TD WIDTH=150 VALIGN=CENTER BGCOLOR="black"> + +<center> + <a href="./index.html"> + <img border=0 src="./images/logo-70.jpg"></a></center> </TD> +<TD WIDTH=15 BGCOLOR="#99997c"> </TD><!--spacer--> +<!-- end of corner cells --> +<!-- start of banner --> +<TD WIDTH="90%" BGCOLOR="#99997c"> +<!-- start of site links table --> +<TABLE WIDTH="100%" BORDER=0 +CELLSPACING=0 CELLPADDING=0 + COLS=3 ROWS=4 BGCOLOR="#ffffff"> +<TR> + <TD BGCOLOR="#99997c"> +<a href="./index.html">Home</a> + </TD> + <TD BGCOLOR="#99997c"> +<a href="./users.html">Users</a> + </TD> + <TD BGCOLOR="#99997c"> +<a href="http://www.list.org/">List.Org</a> + </TD> +</TR><TR> + <TD BGCOLOR="#99997c"> +<a href="./install-start.html">Installation</a> + </TD> + <TD BGCOLOR="#99997c"> +<a href="./mgrs.html">List Managers</a> + </TD> + <TD BGCOLOR="#99997c"> +<a href="http://www.gnu.org/software/mailman/mailman.html">Mailman at GNU</a> + </TD> +</TR><TR> + <TD BGCOLOR="#99997c"> +<a href="./faq.html">FAQ</a> + </TD> + <TD BGCOLOR="#99997c"> +<a href="./admins.html">Site Administrators</a> + </TD> + <TD BGCOLOR="#99997c"> +<a href="http://www.python.org/">Python.Org</a> + </TD> +</TR><TR> + <TD BGCOLOR="#99997c"> +<a href="./lists.html">Discussion Lists</a> + </TD> + <TD BGCOLOR="#99997c"> +<a href="./devs.html">Developers</a> + </TD> + <TD BGCOLOR="#99997c"> +<a href="http://www.gnu.org/">Gnu.Org</a> + </TD> +</TR> +</TABLE><!-- end of site links table --> + +</TD><!-- end of banner --> +</TR><!-- end of banner row --> +<TR><!-- start of sidebar/body row --> +<!-- start of sidebar cells --> +<TD WIDTH=150 VALIGN=TOP BGCOLOR="#99997c"> +<!-- start of sidebar table --> +<TABLE WIDTH="100%" BORDER=0 CELLSPACING=0 CELLPADDING=3 + BGCOLOR="#ffffff"> +<TR><TD BGCOLOR="#663300"><B><FONT COLOR="#ffffff"> +Overview +</FONT></B></TD></TR> +<TR><TD BGCOLOR="#99997c"> +<A HREF="index.html">Home</A> +</TD></TR> +<TR><TD BGCOLOR="#99997c"> +<A HREF="features.html">Features</A> +</TD></TR> +<TR><TD BGCOLOR="#99997c"> +<A HREF="download.html">Requirements, Download</A> +</TD></TR> +<TR><TD BGCOLOR="#99997c"> +<A HREF="install-start.html">Installation</A> +</TD></TR> +<TR><TD BGCOLOR="#99997c"> +<A HREF="lists.html">Discussion Lists</A> +</TD></TR> +<TR><TD BGCOLOR="#99997c"> +<A HREF="bugs.html">Bugs and Patches</A> +</TD></TR> +<TR><TD BGCOLOR="#99997c"> +<A HREF="faq.html">Frequently Asked Questions</A> +</TD></TR> +<TR><TD BGCOLOR="#99997c"> +<A HREF="inthenews.html">Mailman in Use</A> +</TD></TR> +<TR><TD BGCOLOR="#99997c"> +<A HREF="todo.html">Wishlist!</A> +</TD></TR> +<TR><TD BGCOLOR="#99997c"> +<TR><TD BGCOLOR="#663300"><B><FONT COLOR="#ffffff"> +Installing Mailman +</FONT></B></TD></TR> +<TR><TD BGCOLOR="#99997c"> +<A HREF="install-start.html">Start installing</A> +</TD></TR> +<TR><TD BGCOLOR="#99997c"> +<A HREF="install-system.html">System setup</A> +</TD></TR> +<TR><TD BGCOLOR="#99997c"> +<A HREF="install-config.html">Running configure</A> +</TD></TR> +<TR><TD BGCOLOR="#99997c"> +<A HREF="install-check.html">Check your installation</A> +</TD></TR> +<TR><TD BGCOLOR="#99997c"> +<b>Final system setup</b> +</TD></TR> +<TR><TD BGCOLOR="#99997c"> +<A HREF="install-custom.html">Customize Mailman</A> +</TD></TR> +<TR><TD BGCOLOR="#99997c"> +<A HREF="install-test.html">Create a test list</A> +</TD></TR> +<TR><TD BGCOLOR="#99997c"> +<A HREF="install-trouble.html">Troubleshooting</A> +</TD></TR> +<TR><TD BGCOLOR="#99997c"> +<A HREF="install-faq.html">Common problems FAQ</A> +</TD></TR> +<TR><TD BGCOLOR="#99997c"> +<TR><TD BGCOLOR="#663300"><B><FONT COLOR="#ffffff"> +Email Us +</FONT></B></TD></TR> +<TR><TD BGCOLOR="#99997c"> +<A HREF="mailto:mailman-cabal@python.org">mailman-cabal@python.org</A> +</TD></TR> +<TR><TD BGCOLOR="#99997c"> + +</TD></TR> +<TR><TD BGCOLOR="#99997c"> +<A HREF="http://www.python.org/"> +<center> + <img border=0 src="./images/PythonPoweredSmall.png"></center></A> +</TD></TR> +<TR><TD BGCOLOR="#99997c"> + +</TD></TR> +<TR><TD BGCOLOR="#99997c"> +© 1998,1999,2000 +</TD></TR> +<TR><TD BGCOLOR="#99997c"> +Free Software Foundation, Inc. +</TD></TR> +</TABLE><!-- end of sidebar table --> + +</TD> +<TD WIDTH=15> </TD><!--spacer--> +<!-- end of sidebar cell --> +<!-- start of body cell --> +<TD VALIGN=TOP WIDTH="90%"><BR> +<h3>Final system set-up</h3> + + Congratulations! You've installed the Mailman software. To get + everything running you need to hook Mailman up to both your web + server and your mail system. + + <ul> + <li>If you plan on running your MTA and web server on different + machines, sharing Mailman installations via NFS, be sure that + the clocks on those two machines are synchronized closely. + You might take a look at the file + <code>Mailman/LockFile.py</code>; the constant + <code>CLOCK_SLOP</code> helps the locking mechanism compensate + for clock skew in this type of environment. + + <p><li>Configure your web server to give <code>$prefix/cgi-bin</code> + permission to run CGI scripts. You probably need to be <b>root</b> + to do this. + + <p>The line you should add might look something like one of + the following (with the real absolute directory substituted + for <code>$prefix</code>, of course), depending on your web + server: + +<blockquote> +<pre> +ScriptAlias /mailman/ $prefix/cgi-bin/ +Exec /mailman/* $prefix/cgi-bin/* +</pre> +</blockquote> + + <p>Consult your web server's documentation for details. + + <p><li><b>IMPORTANT:</b> You want to be very sure that the user id + under which your CGI scripts run is <b>not</b> in the + <code>mailman</code> group you created above, otherwise + private archives will be accessible to anyone. + + <p><li>Copy the Mailman, Python, and GNU logos to a location accessible + to your web server. E.g. with Apache, you've usually got an + <code>icons</code> directory that you can drop the images + into. You want to copy + <code>$prefix/icons/mailman.jpg</code>, + <code>$prefix/icons/PythonPowered.png</code>, and + <code>$prefix/icons/gnu-head-tiny.jpg</code> to this + directory. + + <p>You then want to add a line to your + <code>$prefix/Mailman/mm_cfg.py</code> file which sets the + base URL for the logos. For example: + +<blockquote> +<pre> +IMAGE_LOGOS = '/images/' +</pre> +</blockquote> + + <p>The default value for <code>IMAGE_LOGOS</code> is + <code>/icons/</code>. Read the + comment in <code>Defaults.py.in</code> for details. + + <p><li>Configure your web server to point to the Pipermail public + mailing list archives: + + For example, in Apache: + +<blockquote> +<pre> +Alias /pipermail/ $varprefix/archives/public/ +</pre> +</blockquote> + + <p>where <code>$varprefix</code> is usually + <code>$prefix</code> unless you've used the + <code>--with-var-prefix</code> option to configure. + + <p>Consult your web server's documentation for details. Also + be sure to configure your web server to follow symbolic links + in this directory, otherwise public Pipermail archives won't + be accessible. For Apache users, consult the + <em>FollowSymLinks</em> option. + + <p>Now restart your web server. + + <p><li><b>IMPERATIVE! IMPORTANT! DO THIS! YOU'LL BE SORRY IF + YOU DON'T!</b> + + <p>Set up the crontab entries. Mailman runs a number of cron + jobs for its basic functionality. You need to be user + <code>mailman</code> (or whatever you specified as + <code>--with-ownername</code>) to perform this step. Add + <code>$prefix/cron/crontab.in</code> as a crontab entry by + executing these commands: + +<blockquote> +<pre> +% su - mailman +% cd $prefix/cron +% crontab crontab.in +</pre> +</blockquote> + + <p><li>Look to see if there is special instructions about hooking your + MTA up to Mailman. If so, there will be a + README.<em>yourMTA</em> file in the Mailman source directory. + + <p><li>Add aliases for <code>mailman</code> and + <code>mailman-owner</code> to the system's mail alias + database. These aliases should point to whoever is ultimately + responsible for the Mailman installation. Here are + instructions for those running Sendmail: + + <ol> + <li>su to root. + <li>Assuming your email is <code>fred@flintstone.com</code>, + add the following lines to the file + <code>/etc/aliases</code>: + +<blockquote> +<pre> +mailman: fred@flintstone.com +mailman-owner: mailman +</pre> +</blockquote> + + <li>Some versions of sendmail require you to run the program + <code>newaliases</code> explicitly. + </ol> + + <p>If you don't run sendmail, consult the documentation of + your mail transport program for information on adding these + aliases. + </ul> + +</TD><!-- end of body cell --> +</TR><!-- end of sidebar/body row --> +</TABLE><!-- end of page table --> +</BODY></HTML> |