Difference between revisions of "Qmhandle mail queue manager"

From SME Server
Jump to navigationJump to search
(major rewrite)
 
(17 intermediate revisions by 4 users not shown)
Line 1: Line 1:
 
== qmHandle mail queue manager ==
 
== qmHandle mail queue manager ==
 +
 +
===Maintainer===
 +
[[User:Unnilennium|Unnilennium]]
 +
  
 
===Overview===
 
===Overview===
Line 5: Line 9:
 
The qmHandle rpm will install a Mail queue manager panel in server manager.
 
The qmHandle rpm will install a Mail queue manager panel in server manager.
  
−
The current download location for a sme7.x compatible rpm is
+
=== Version ===
 +
{{ #smeversion: smeserver-qmHandle}}
  
−
http://www.saco-support.de/index.php?_m=downloads&_a=view&parentcategoryid=3&pcid=0&nav=0
+
===Installation===
−
 
 
−
and the current rpm is
 
  
−
smeserver-saco-qmHandle-1.3.1-1.noarch.rpm
 
  
 +
yum install smeserver-qmHandle --enablerepo=smecontribs
  
−
===Installation===
 
−
 
−
Download the rpm and install with the command
 
−
rpm -Uvh smeserver-saco-qmHandle-1.3.1-1.noarch.rpm
 
  
 
The post upgrade event and reboot are not required.
 
The post upgrade event and reboot are not required.
−
 
  
 
===Usage===
 
===Usage===
Line 31: Line 29:
 
You can also control the mail queue using qmHandle at the command prompt with the following parameters:
 
You can also control the mail queue using qmHandle at the command prompt with the following parameters:
 
   
 
   
−
   -a     : try to send all queued messages now (qmail must be running)  
+
   -a       : try to send all queued messages now (qmail must be running)  
−
   -l     : list message queues  
+
   -l       : list message queues  
−
   -L     : list local message queue  
+
   -L       : list local message queue  
−
   -R     : list remote message queue  
+
   -R       : list remote message queue  
−
   -s     : show some statistics  
+
   -s       : show some statistics
−
   -vN    : display message number N  
+
   -mN      : display message number N  
−
   -dN   : delete message number N  
+
   -dN     : delete message number N  
−
   -Stext : delete all messages that have/contain text as Subject  
+
  -fsender : delete message from sender
 +
  -f're'  : delete message from senders matching regular expression re
 +
   -Stext   : delete all messages that have/contain text as Subject  
 +
  -h're'  : delete all messages with headers matching regular expression re (case insensitive)
 +
  -b're'  : delete all messages with body matching regular expression re (case insensitive)
 +
  -H're'  : delete all messages with headers matching regular expression re (case sensitive)
 +
  -B're'  : delete all messages with body matching regular expression re (case sensitive)
 +
  -t're'  : flag messages with recipients in regular expression 're' for earlier retry (note: this lengthens the time message can stay in queue)
 
   -D    : delete all messages in the queue (local & remote)  
 
   -D    : delete all messages in the queue (local & remote)  
 
   -V    : print program version  
 
   -V    : print program version  
Line 46: Line 51:
 
   -N    : list message numbers only  
 
   -N    : list message numbers only  
 
           (to be used either with -l, -L or -R)  
 
           (to be used either with -l, -L or -R)  
 +
  -X    : do the same but for smeserver-altqmail contrib rather than for the stock qmail
  
  
−
An example usage syntax would be
+
Examples of usage syntax would be:
  
−
qmHandle -l
+
To list all the messages in the queue
 +
qmHandle -l
  
 +
To list all the messages in the queue counting the number of messages with the same subject
 +
qmHandle -l|grep Subject|sort| uniq -c|sort -n
  
−
{{Note box|In some cases qmail does not restart after messages have been deleted. You should check the status of qmail after deleting messages.}}
 
  
−
To check status
+
{{Note box|In some cases qmail did not restart after messages have been deleted, in older versions (Saco). The rpm in the repository has been fixed. You should check the status of qmail after deleting messages.}}
 +
 
 +
To check status of qmail
 
  sv s /service/qmail
 
  sv s /service/qmail
  
  
−
{{Warning box|Before deleting messages from the queue, you should stop qmail first. If you delete messages without stopping qmail, then qmail may stop and you will unknowingly be without a operational mail server (ie qmail)}}.
+
{{Warning box|Before deleting messages from the queue, you should stop qmail first in saco version. If you delete messages without stopping qmail, then qmail may stop and you will unknowingly be without a operational mail server (ie qmail). This is not necessary in the newer fixed version available on the smecontribs repo}}.
  
−
To stop
+
To stop qmail
 
  sv d /service/qmail
 
  sv d /service/qmail
−
To start
+
To start qmail
 
  sv u /service/qmail
 
  sv u /service/qmail
−
 
  
 
===Removal===
 
===Removal===
  
 
Remove (uninstall) the rpm with the command
 
Remove (uninstall) the rpm with the command
−
  rpm -e smeserver-saco-qmHandle
+
  yum remove  smeserver-qmHandle
  
  
Line 81: Line 90:
 
http://bugs.contribs.org/show_bug.cgi?id=2020
 
http://bugs.contribs.org/show_bug.cgi?id=2020
  
 +
=== Bugs ===
 +
Please raise bugs under the SME-Contribs section in [http://bugs.contribs.org/enter_bug.cgi bugzilla]
 +
and select the smeserver-qmhandle component or use  {{BugzillaFileBug|product=SME%20Contribs|component=smeserver-qmHandle|title=this link}}.
 +
 +
{{#bugzilla:columns=id,product,version,status,summary |sort=id |order=desc |component=smeserver-qmHandle|noresultsmessage="No open bugs found."}}
 +
 +
===Changelog===
 +
Only released version in smecontrib are listed here.
 +
 +
{{ #smechangelog: smeserver-qmHandle}}
  
 
----
 
----
 
[[Category:Contrib]]
 
[[Category:Contrib]]
 
[[Category:Mail]]
 
[[Category:Mail]]

Latest revision as of 17:02, 31 May 2021

qmHandle mail queue manager

Maintainer

Unnilennium


Overview

The qmHandle rpm will install a Mail queue manager panel in server manager.

Version

Contrib 10:
Contrib 9:
smeserver-qmHandle
The latest version of smeserver-qmHandle is available in the SME repository, click on the version number(s) for more information.


Installation

yum install smeserver-qmHandle --enablerepo=smecontribs


The post upgrade event and reboot are not required.

Usage

Installing the rpm will add a panel to server manager that controls the mail queue.

You should preferably use the server manager panel.


You can also control the mail queue using qmHandle at the command prompt with the following parameters: 

 -a       : try to send all queued messages now (qmail must be running) 
 -l       : list message queues 
 -L       : list local message queue 
 -R       : list remote message queue 
 -s       : show some statistics
 -mN      : display message number N 
 -dN      : delete message number N 
 -fsender : delete message from sender
 -f're'   : delete message from senders matching regular expression re
 -Stext   : delete all messages that have/contain text as Subject 
 -h're'   : delete all messages with headers matching regular expression re (case insensitive)
 -b're'   : delete all messages with body matching regular expression re (case insensitive)
 -H're'   : delete all messages with headers matching regular expression re (case sensitive)
 -B're'   : delete all messages with body matching regular expression re (case sensitive)
 -t're'   : flag messages with recipients in regular expression 're' for earlier retry (note: this lengthens the time message can stay in queue)
 -D     : delete all messages in the queue (local & remote) 
 -V     : print program version

Additional (optional) parameters are: 

 -c     : display colored output 
 -N     : list message numbers only 
          (to be used either with -l, -L or -R) 
 -X     : do the same but for smeserver-altqmail contrib rather than for the stock qmail


Examples of usage syntax would be:

To list all the messages in the queue 

qmHandle -l

To list all the messages in the queue counting the number of messages with the same subject 

qmHandle -l|grep Subject|sort| uniq -c|sort -n


Important.png Note:
In some cases qmail did not restart after messages have been deleted, in older versions (Saco). The rpm in the repository has been fixed. You should check the status of qmail after deleting messages.


To check status of qmail 

sv s /service/qmail


Warning.png Warning:
Before deleting messages from the queue, you should stop qmail first in saco version. If you delete messages without stopping qmail, then qmail may stop and you will unknowingly be without a operational mail server (ie qmail). This is not necessary in the newer fixed version available on the smecontribs repo


.

To stop qmail 

sv d /service/qmail

To start qmail 

sv u /service/qmail

Removal

Remove (uninstall) the rpm with the command 

yum remove  smeserver-qmHandle


References

http://forums.contribs.org/index.php?topic=34164.15

http://forums.contribs.org/index.php?topic=33791.0

http://bugs.contribs.org/show_bug.cgi?id=2020

Bugs

Please raise bugs under the SME-Contribs section in bugzilla and select the smeserver-qmhandle component or use this link .

IDProductVersionStatusSummary (4 tasks) ⇒
12774SME Contribs11.0CONFIRMEDperl-CGI 'startform' and 'endform' are dropped in favor of 'start_form' and 'end_form'
12246SME Contribs10.0CONFIRMEDWhen run under SM2 and AdminLTE theme and dark mode charaters are "displayed" in black type
12192SME Contribs10.0CONFIRMEDsm2 not handling long running delete well
12148SME Contribs10.0RESOLVEDRemoving stuck mail in E-Mail queue management stops email processing.

Changelog

Only released version in smecontrib are listed here.

smeserver-qmHandle Changelog: SME 10 (smecontribs)
2024/03/01 Brian Read 1.4-25.sme
- Edit Menu entry to conform to new arrangements [SME: 12493]
2022/11/11 Jean-Philippe Pialasse 1.4-24.sme
- apply locale 2022-11-11 patch
2022/09/26 Trevor Batley 1.4-23.sme
- add in missing lexicons for bz12160 [SME: 12160]
2022/09/22 bunkobugsy 1.4-22.sme
- fix to put email message in textare [SME: 12147]
2022/09/21 Trevor Batley 1.4-21.sme
- Mojo (sm2) patches to match bugs 12151 and 12147 [SME: 12160]


Retrieved from "https://wiki.koozali.org/index.php?title=Qmhandle_mail_queue_manager&oldid=40241"