add documentation for RAR support

[pmg-docs.git] / pmg-administration.adoc

diff --git a/pmg-administration.adoc b/pmg-administration.adoc
index 18650b1e07e0a6238a9cff8dbafaeafea74d3c00..28e51c385acf98266243ab0c02a7b44860488250 100644 (file)
--- a/pmg-administration.adoc
+++ b/pmg-administration.adoc
@@ -170,24 +170,25 @@ combines the result from the first and second phase.
 |accepted/delivered   |2 | Email accepted and delivered
 |====
 
-
+[[postfix_queue_administration]]
 Postfix Queue Administration
 ----------------------------
 
+[thumbnail="pmg-gui-queue-admin-summary.png", big=1]
 
 Mail-queues are one of the central concepts of the SMTP protocol. Once a
 mailserver accepts a mail for further processing it saves it to a queue.
 After the mail is either relayed to another system, stored locally
-or discarded it is deleted from the local mail-queue.
+or discarded, it is deleted from the local mail-queue.
 
 If immediate processing is not possible, for example because a downstream
 mailserver is not reachable, the mail remains on the queue for later
 processing.
 
-The Queue Administration view provides a succinct overview, as generated by
-the 'qshape (1)' utility, about the current state of the postfix mail-queue.
+The 'Queue Administration' panel provides a summary about the current state
+of the postfix mail-queue, similar to the 'qshape (1)' command-line utility.
 
-It shows mails for which domains were not delivered, and how long they have
+It shows domains for which mails were not delivered, and how long they have
 been queued.
 
 The three Action Buttons on top provide the most common queue operations:
@@ -200,12 +201,25 @@ server has become available again.
 'Delete All Messages'::
 
 Delete all currently queued mail, for example if the queue contains only spam.
-Attempt to deliver all currently queued mail.
 
 'Discard address verification database'::
 
 Clear the recipient verification cache.
 
+A sudden increase of queued mails should be checked out closely. It can
+indicate issues connecting to downstream servers.
+This can also mean that one of the servers for which you relay emails sends
+spam itself.
+
+Deferred Mail
+~~~~~~~~~~~~~
+[thumbnail="pmg-gui-queue-admin-deferred.png"]
+
+In the 'Deferred Mail' tab you can examine each deferred email separately.
+Besides providing the contact information about sender and receiver you can
+also check the reason for an email being still queued.
+
+You can view the complete headers and filter by sender or receiver of queued up
+mails.
 
-In the 'Deferred Mail' tab you can filter and examine deferred mail in more
-detail by looking at the headers.
+Here you can also flush or delete each deferred email independently.