diff options
Diffstat (limited to 'admin/www/install-faq.html')
| -rw-r--r-- | admin/www/install-faq.html | 313 |
1 files changed, 313 insertions, 0 deletions
diff --git a/admin/www/install-faq.html b/admin/www/install-faq.html new file mode 100644 index 000000000..07be076e6 --- /dev/null +++ b/admin/www/install-faq.html @@ -0,0 +1,313 @@ +<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: Common problems FAQ + +--> + +<HEAD> +<TITLE>Common problems FAQ</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"> +<A HREF="install-final.html">Final system setup</A> +</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"> +<b>Common problems FAQ</b> +</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>Common Problems FAQ</h3> + + <b>Problem:</b> All Mailman web pages give a <em>404 File not + found</em> error. + + <br><b>Solution:</b> Your web server has not been set up properly + for handling Mailman's cgi commands. Make sure you've: + + <ol><li>Configured the web server to give permissions to + <code>$prefix/cgi-bin</code> + <li>Restarted the web server properly. + </ol> + Consult your web server's documentation for instructions + on how to do these things. + + <p><b>Problem:</b> All Mailman web pages give an <em>Internal + Server Error</em>. + + <br><b>Solution:</b> The likely problem is that you are using the + wrong GID or UID for CGI scripts. Check your syslog. If you + see, for example, a line like: + +<blockquote> +<pre> +Attempt to exec script with invalid gid 51, expected 99 +</pre> +</blockquote> + + You need to reinstall Mailman, and specify + <code>$CGI_GID</code> to be 51, as described in the + installation instructions. + + <p><b>Problem:</b> I send mail to the list, and get back mail saying the + list is not found! + + <br><b>Solution:</b> You probably didn't add the necessary aliases + to the system alias database, given to you when you ran the + <code>newlist</code> command. If you did add them, you likely + did not update the alias database, or your system requires you + to run <code>newaliases</code> explicitly. Refer to section 5 + above for more information. + + + <p><b>Problem:</b> I send mail to the list, and get back mail saying, + <em>unknown mailer error</em>. + + <br><b>Solution:</b> The likely problem is that you are using the + wrong GID or UID for mail. Check your syslog. If you see, for + example, a line like: + +<blockquote> +<pre> +Attempt to exec script with invalid gid 51, expected 99 +</pre> +</blockquote> + + You need to reinstall Mailman, and specify + <code>$MAIL_GID</code> to be 51, as described in the + installation instructions. see notes on Postfix below, as by + default it will create these problems on installation. + + + <p><b>Problem:</b> I use Postfix for my MTA and the mail wrapper programs + are logging complaints about the wrong GID. + + <br><b>Solution:</b> Create a separate aliases file for Postfix in its + <code>main.cf</code> config file under the variable + <em>alias_maps</em>. Put the file somewhere in Mailman's home + directory, or somewhere else where the user + <code>mailman</code> has write access to it; <em>as user + mailman</em> call Postfix's <code>postalias</code> on the + alias file. + +<blockquote> +<pre> +% postalias the-alias-file +</pre> +</blockquote> + + Also as user mailman, run + +<blockquote> +<pre> +% python -c'import os; print os.getgid()' +</pre> +</blockquote> + + <p>This should print out the group id that Mailman should be + configured to expect when the mail wrapper programs are run. + Call it <em>thegid</em>. Rebuild Mailman with + +<blockquote> +<pre> +% ./configure --with-mail-gid=thegid +</pre> +</blockquote> + + <p><b>Problem:</b> I send mail to the list, and get back mail saying, + <em>sh: wrapper not available for sendmail programs</em> + + <br><b>Solution:</b> Your system uses sendmail restricted shell + (smrsh). You need to configure smrsh by creating a symbolic + link from the mail wrapper (<code>$prefix/mail/wrapper</code>) + to the directory identifying executables allowed to run under + smrsh. + + <p>Some common names for this directory are + <code>/var/admin/sm.bin</code>, <code>/usr/admin/sm.bin</code> + or <code>/etc/smrsh</code>. + + <p>Note that on Debian Linux, the system makes + <code>/usr/lib/sm.bin</code>, which is wrong, you will need to + create the directory <code>/usr/admin/sm.bin</code> and add + the link there. Note further that any aliases + <code>newaliases</code> spits out will need to be adjusted to + point to the secure link to the wrapper. + + <p><b>Problem:</b> I messed up when I called configure. How do I clean + things up and re-install? + + <br><b>Solution:</b> + +<blockquote> +<pre> +% make clean +% ./configure --with-the-right-options +% make install +</pre> +</blockquote> + +</TD><!-- end of body cell --> +</TR><!-- end of sidebar/body row --> +</TABLE><!-- end of page table --> +</BODY></HTML> |