diff options
Diffstat (limited to 'admin/www/mailman-install/troubleshooting.html')
-rw-r--r-- | admin/www/mailman-install/troubleshooting.html | 259 |
1 files changed, 259 insertions, 0 deletions
diff --git a/admin/www/mailman-install/troubleshooting.html b/admin/www/mailman-install/troubleshooting.html new file mode 100644 index 00000000..20980a3f --- /dev/null +++ b/admin/www/mailman-install/troubleshooting.html @@ -0,0 +1,259 @@ +<!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="node46.html" /> +<link rel="prev" href="node44.html" /> +<link rel="parent" href="front.html" /> +<link rel="next" href="node46.html" /> +<meta name='aesop' content='information' /> +<title>13 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' + 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' + 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 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> +</div> +<hr /></div> +</DIV> +<!--End of Navigation Panel--> + +<H1><A NAME="SECTION0011300000000000000000"></A><A NAME="troubleshooting"></A> +<BR> +13 Troubleshooting +</H1> + +<P> +If you encounter problems with running Mailman, first check the question and +answer section below. If your problem is not covered there, check the +<a class="ulink" href="http://www.list.org/help.html" + >online help</a>, including the +<a class="ulink" href="http://www.list.org/faq.html" + >FAQ</a> and the +<a class="ulink" href="http://www.python.org/cgi-bin/faqw-mm.py" + >interactive FAQ wizard</a>. + +<P> +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 +<a class="url" href="http://mail.python.org/mailman/listinfo/mailman-users">http://mail.python.org/mailman/listinfo/mailman-users</a> for more +information. + +<P> +Be sure to including information on your operating system, which version of +Python you're using, and which version of Mailman you're installing. + +<P> +Here is a list of some common questions and answers: + +<P> + +<UL> +<LI><strong>Problem:</strong> All Mailman web pages give a 404 File not found + error. + +<P> +<strong>Solution:</strong> Your web server has not been set up properly for + handling Mailman's CGI programs. Make sure you have: + +<P> + +<OL> +<LI>configured the web server to give permissions to + <span class="file"><var>$prefix</var>/cgi-bin</span> + +<P> +</LI> +<LI>restarted the web server properly. + +</LI> +</OL> + +<P> +Consult your web server's documentation for instructions on how to do + check these issues. + +<P> +</LI> +<LI><strong>Problem:</strong> All Mailman web pages give an "Internal Server + Error". + +<P> +<strong>Solution:</strong> The likely problem is that you are using the wrong + user or group for the CGI scripts. Check your web server's log files. + If you see a line like + +<P> +<div class="verbatim"><pre> + Attempt to exec script with invalid gid 51, expected 99 +</pre></div> + +<P> +you will need to reinstall Mailman, specifying the proper CGI group id, + as described in the <A NAME="building"></A> section. + +<P> +</LI> +<LI><strong>Problem:</strong> I send mail to the list, and get back mail saying the + list is not found! + +<P> +<strong>Solution:</strong> You probably didn't add the necessary aliases to the + system alias database, or you didn't properly integration Mailman with + your mail server. Perhaps you didn't update the alias database, or your + system requires you to run <b class="program">newaliases</b> explicitly. Refer to + your server specific instructions in the <A href="mail-server.html#mail-server">6</A> section. + +<P> +</LI> +<LI><strong>Problem:</strong> I send mail to the list, and get back mail saying, + ``unknown mailer error''. + +<P> +<strong>Solution:</strong> The likely problem is that you are using the wrong + user or group id for the mail wrappers. Check your mail server's log + files; if you see a line like + +<P> +<div class="verbatim"><pre> + Attempt to exec script with invalid gid 51, expected 99 +</pre></div> + +<P> +you will need to reinstall Mailman, specifying the proper mail group id + as described in the <A NAME="building"></A> section. + +<P> +</LI> +<LI><strong>Problem:</strong> I use Postfix as my mail server and the mail wrapper + programs are logging complaints about the wrong GID. + +<P> +<strong>Solution:</strong> Make sure the <span class="file"><var>$prefix</var>/data/aliases.db</span> + file is user owned by <code>mailman</code> (or whatever user name you used + in the <b class="program">configure</b> command). If this file is not user owned by + <code>mailman</code>, Postfix will not run the mail programs as the correct + user. + +<P> +</LI> +<LI><strong>Problem:</strong> I use Sendmail as my mail server, and when I send mail + to the list, I get back mail saying, ``sh: mailman not available for + sendmail programs''. + +<P> +<strong>Solution:</strong> Your system uses the Sendmail restricted shell + (smrsh). You need to configure smrsh by creating a symbolic link from + the mail wrapper (<span class="file"><var>$prefix</var>/mail/mailman</span>) to the directory + identifying executables allowed to run under smrsh. + +<P> +Some common names for this directory are <span class="file">/var/admin/sm.bin</span>, + <span class="file">/usr/admin/sm.bin</span> or <span class="file">/etc/smrsh</span>. + +<P> +Note that on Debian Linux, the system makes <span class="file">/usr/lib/sm.bin</span>, + which is wrong, you will need to create the directory + <span class="file">/usr/admin/sm.bin</span> and add the link there. Note further any + aliases <b class="program">newaliases</b> spits out will need to be adjusted to point + to the secure link to the wrapper. + +<P> +</LI> +<LI><strong>Problem:</strong> I messed up when I called <b class="program">configure</b>. How + do I clean things up and re-install? + +<P> +<strong>Solution:</strong> + +<P> +<div class="verbatim"><pre> + % make clean + % ./configure --with-the-right-options + % make install + </pre></div> + +<P> +</LI> +</UL> + +<P> +<BR><HR><H4>Footnotes</H4> +<DL> +<DT><A NAME="foot598">... list</A><A + href="troubleshooting.html#tex2html6"><SUP>6</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. + +</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="12 Create your first" + 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 Platform and operating" + href="node46.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 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> +</div> +</div> +<hr /> +<span class="release-info">Release 2.1, documentation updated on December 13, 2004.</span> +</DIV> +<!--End of Navigation Panel--> + +</BODY> +</HTML> |