Difference between revisions of "Qmhandle mail queue manager"

From SME Server
Jump to navigationJump to search
(qmhandle brief Howto install added)
 
(major rewrite)
Line 1: Line 1:
−
== qmhandle mail queue manager ==
+
== qmHandle mail queue manager ==
  
−
This is a brief pointer to the qmhandle rpm which will install a Mail queue manager panel in server manager.
+
===Overview===
 +
 
 +
The qmHandle rpm will install a Mail queue manager panel in server manager.
  
 
The current download location for a sme7.x compatible rpm is
 
The current download location for a sme7.x compatible rpm is
  
−
http://www.saco-support.de/index.php?_m=downloads&_a=view&parentcategoryid=3&pcid=0&nav=0
+
http://www.saco-support.de/index.php?_m=downloads&_a=view&parentcategoryid=3&pcid=0&nav=0
  
 
and the current rpm is
 
and the current rpm is
Line 12: Line 14:
  
  
−
Installing the above rpm will add a panel to server manager that controls the mail queue.
+
===Installation===
 +
 
 +
Download the rpm and install with the command
 +
rpm -Uvh smeserver-saco-qmHandle-1.3.1-1.noarch.rpm
  
−
You can also control the mail queue using qmhandle at the Linux command prompt.
+
The post upgrade event and reboot are not required.
  
  
−
Download the rpm and install with the command
+
===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
 +
  -vN    : display message number N
 +
  -dN    : delete message number N
 +
  -Stext : delete all messages that have/contain text as Subject
 +
  -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)
 +
 
 +
 
 +
An example usage syntax would be
 +
 
 +
qmHandle -l
 +
 
 +
 
 +
{{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
 +
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)}}.
 +
 
 +
To stop
 +
sv d /service/qmail
 +
To start
 +
sv u /service/qmail
 +
 
 +
 
 +
===Removal===
 +
 
 +
Remove (uninstall) the rpm with the command
 +
rpm -e smeserver-saco-qmHandle
 +
 
 +
 
 +
===References===
  
−
rpm -Uvh smeserver-saco-qmHandle-1.3.1-1.noarch.rpm
+
http://forums.contribs.org/index.php?topic=34164.15
  
−
The post upgrade event and reboot are not required.
+
http://forums.contribs.org/index.php?topic=33791.0
  
 +
http://bugs.contribs.org/show_bug.cgi?id=2020
  
−
I will revise this document & add more information when time permits.
 
  
 
----
 
----
 
[[Category:Contrib]]
 
[[Category:Contrib]]
 
[[Category:Mail]]
 
[[Category:Mail]]

Revision as of 01:58, 24 March 2008

qmHandle mail queue manager

Overview

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

The current download location for a sme7.x compatible rpm is 

http://www.saco-support.de/index.php?_m=downloads&_a=view&parentcategoryid=3&pcid=0&nav=0

and the current rpm is

smeserver-saco-qmHandle-1.3.1-1.noarch.rpm


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.


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 
 -vN    : display message number N 
 -dN    : delete message number N 
 -Stext : delete all messages that have/contain text as Subject 
 -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)


An example usage syntax would be

qmHandle -l


Important.png Note:
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 

sv s /service/qmail


Warning.png Warning:
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)


.

To stop 

sv d /service/qmail

To start 

sv u /service/qmail


Removal

Remove (uninstall) the rpm with the command 

rpm -e smeserver-saco-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


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