Committing lots of documentation updates, including linking up to the new

mailman-installation guide, and filling out the other formats that seemed to be missing.
author: bwarsaw <> 2004-12-14 04:27:49 +0000
committer: bwarsaw <> 2004-12-14 04:27:49 +0000
commit: 7fd3afbe2480275fe41fa0169ed72abd1f425048 (patch)
tree: aa1f078e792f2f221b650b9ebb2749df42abb2e8 /admin/www/mailman-install/troubleshooting.html
parent: f7c56e34ea25695bafa11ed28e0384671a309ac3 (diff)
download: mailman2-7fd3afbe2480275fe41fa0169ed72abd1f425048.tar.gz
mailman2-7fd3afbe2480275fe41fa0169ed72abd1f425048.tar.xz
mailman2-7fd3afbe2480275fe41fa0169ed72abd1f425048.zip
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>
author	bwarsaw <>	2004-12-14 04:27:49 +0000
committer	bwarsaw <>	2004-12-14 04:27:49 +0000
commit	7fd3afbe2480275fe41fa0169ed72abd1f425048 (patch)
tree	aa1f078e792f2f221b650b9ebb2749df42abb2e8 /admin/www/mailman-install/troubleshooting.html
parent	f7c56e34ea25695bafa11ed28e0384671a309ac3 (diff)
download	mailman2-7fd3afbe2480275fe41fa0169ed72abd1f425048.tar.gz mailman2-7fd3afbe2480275fe41fa0169ed72abd1f425048.tar.xz mailman2-7fd3afbe2480275fe41fa0169ed72abd1f425048.zip