Qmhandle mail queue manager

From SME Server
Jump to: navigation, search

qmHandle mail queue manager




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


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


yum install smeserver-qmHandle --enablerepo=smecontribs

The post upgrade event and reboot are not required.


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


Remove (uninstall) the rpm with the command

yum remove  smeserver-qmHandle






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

"No open bugs found."


Only released version in smecontrib are listed here.

smeserver-qmHandle Changelog: SME 9 (smecontribs)
2017/10/27 Jean-Philipe Pialasse 1.4-11.sme
- fix changelog [SME: 10449]

2017/07/10 Jean-Philipe Pialasse 1.4-9.sme
- add panel support for altqmail [SME: 10380]

- if altqmail config db key is present the menus are added to control altqmail
2017/07/10 Jean-Philipe Pialasse 1.4-7.sme
- add command line support for alqmail and fix conflict with stopping qmail [SME: 10379]

2016/03/17 JP Pialasse 1.4-6.sme
- fix XML error in german translation [SME: 9041]

- patch fixed and pootle entries
2016/03/09 JP Pialasse 1.4-5.sme
- apply locale 2016-03-09 patch