add documentation for RAR support

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

diff --git a/pmg-administration.adoc b/pmg-administration.adoc
index 3f6be642b236a9621cecc34de77660d719857971..28e51c385acf98266243ab0c02a7b44860488250 100644 (file)
--- a/pmg-administration.adoc
+++ b/pmg-administration.adoc
@@ -155,10 +155,6 @@ In the second phase, accepted mails need to be delivered to the
 receiver. This action may also fail or succeed. 'Status'
 combines the result from the first and second phase.
 
-When before-queue filtering is enabled, we don't have the same delivery information as
-with after-queue filtering. In this case, if the mail is accepted by the filter,
-the status is shown as 'queued/accepted' instead of 'accepted/<status>'.
-
 [options="header",cols="2s,1d,5d"]
 |====
 |Status |Phase |Description
@@ -166,7 +162,7 @@ the status is shown as 'queued/accepted' instead of 'accepted/<status>'.
 |greylisted           |1 | Email temporarily rejected by greylisting
 |queued/deferred      |1 | Internal Email was queued, still trying to deliver
 |queued/bounced       |1 | Internal Email was queued but not accepted by the target email server (for example user unknown)
-|queued/accepted      |1 | Email was accepted, no delivery information available (before-queue only, replaces accepted/<status>)
+|queued/delivered     |1 | Internal Email was queued and delivered
 |quarantine           |1 | Email was moved to quarantine
 |blocked              |1 | Email was blocked by filter rules
 |accepted/deferred    |2 | Email accepted, still trying to deliver
@@ -174,24 +170,25 @@ the status is shown as 'queued/accepted' instead of 'accepted/<status>'.
 |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:
@@ -204,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.