[Pkg-mailman-hackers] Pkg-mailman commit - rev 271 - trunk/debian

[Lionel Elie Mamane]

Author: lmamane
Date: 2006-01-29 18:16:27 +0000 (Sun, 29 Jan 2006)
New Revision: 271

Modified:
   trunk/debian/changelog
   trunk/debian/templates
Log:
Bug #268117: The instructions on how to deal with a non-empty queue were
not explicit and detailed enough for certain users. Expand them.


Modified: trunk/debian/changelog
===================================================================
--- trunk/debian/changelog	2006-01-29 17:30:28 UTC (rev 270)
+++ trunk/debian/changelog	2006-01-29 18:16:27 UTC (rev 271)
@@ -13,8 +13,10 @@
       - Mailman loses header spam rules (closes: #309870)
   * Pull fixes from various bugs from upstream CVS
   * Ship documentation source (closes: #346180)
+  * Document queue-is-not-empty upgrade condition better
+    (closes: #268117)
 
- -- Lionel Elie Mamane <lmamane at debian.org>  Sun, 29 Jan 2006 17:31:48 +0100
+ -- Lionel Elie Mamane <lmamane at debian.org>  Sun, 29 Jan 2006 19:14:12 +0100
 
 mailman (2.1.6-2) UNRELEASED; urgency=low
 

Modified: trunk/debian/templates
===================================================================
--- trunk/debian/templates	2006-01-29 17:30:28 UTC (rev 270)
+++ trunk/debian/templates	2006-01-29 18:16:27 UTC (rev 271)
@@ -4,7 +4,7 @@
 Type: multiselect
 __Choices: big5, ca, cs, da, de, en, es, et, eu, fi, fr, hr, hu, it, ja, ko, lt, nl, no, pl, pt, pt_BR, ro, ru, sl, sr, sv, uk
 Default: en
-_Description: Which languages to support?  
+_Description: Which languages to support?
  For each supported language Debian Mailman stores default language
  specific texts in /etc/mailman/LANG/ giving them conffile like
  treatment with the help of ucf.  This means approximately 150kB for
@@ -52,10 +52,30 @@
 Type: note
 _Description: Old queue files present
  The directory /var/lib/mailman/qfiles contains files.  It needs to be
- empty for the upgrade work properly.  Please either flush the queue
- (by way of mailmanctl start, then stopping it and redoing the upgrade
- when it is finished) or remove those files.  Note that removing the
- files will lose some emails sent to lists.
+ empty for the upgrade work properly. If these files are not yet
+ processed, but otherwise fine messages, then you can try to handle
+ them by:
+ - Stopping new messages from coming in the queue (at the MTA level:
+   queue them in the MTA's queue or refuse them with a 4xx code). If
+   your site has a relatively low mailman traffic, you can skip this
+   step.
+ - Start a mailman queue runner: /etc/init.d/mailman start
+ - Let it run until all messages are handled
+   If they don't all get handled in a timely manner, look at the logs
+   to try to understand why and solve the cause.
+ - Stop it: /etc/init.d/mailman stop
+ - Retry the upgrade
+ - Let messages come in again
+ You can also decide to simply remove the files, which will make
+ Mailman forget about (and lose) the corresponding emails; expect
+ angry users.
+ .
+ If these files correspond to shunted messages, you have to either
+ delete them or unshunt them. Shunted messages are messages on which
+ Mailman has already abandoned any further processing because of an
+ error condition, but that are kept for admin review, as they usually
+ originate from Mailman bugs or other abnormal situations that need
+ human inspection.
 
 Template: mailman/update_aliases
 Type: note