diff options
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> |