4 The Administration GUI allows you to do common administration tasks
5 like updating software packages, manage quarantine, view service
6 status and manage mail queues. It also provides server statistics in
7 order to verify server health.
16 image::images/screenshot/pmg-gui-server-status.png[]
18 This page shows server statistics about CPU, memory, disk and network
19 usage. You can select the displayed time span on the upper right.
21 Administrators can open a terminal window using the 'Console'
22 button. It is also possible to trigger a server 'Restart' or
29 image::images/screenshot/pmg-gui-service-status.png[]
31 This panel lists all major services used for mail processing and
32 cluster synchronization. If necessary, you can start, stop or restart
33 them. The 'Syslog' button shows the system log filtered for the
36 Please note that {pmg} uses {systemd} to manage services, so you can
37 also use the standard `systemctl` command line tool to manage or view
38 service status, for example:
41 systemctl status postfix
48 image::images/screenshot/pmg-gui-updates.png[]
50 We release software updates on a regular basis, and it is recommended
51 to always run the latest available version. This page shows the
52 available updates, and administrator can run an upgrade by pressing
55 See section xref:pmg_package_repositories[Package Repositories] for
56 details abaout available package repositories.
62 image::images/screenshot/pmg-gui-syslog.png[]
64 The syslog page gives you a quick real-time log view. Please use the
65 xref:pmg_tracking_center[Tracking Center] to search the logs.
81 User White- and Blacklist
82 ~~~~~~~~~~~~~~~~~~~~~~~~~
86 [[pmg_tracking_center]]
90 image::images/screenshot/pmg-gui-tracking-center.png[]
92 Email processing is a complex task and involves several service
93 daemons. Each daemon logs information to the syslog service. The
94 problem is that a servers analyzes many emails in parallel, so it is
95 usually very hard to find all logs corresponding to a specific mail.
97 Introduced in {pmg} 2.1, the tracking center simplifies the search for
98 emails dramatically. We use highly optimized C-code to search the
99 available syslog data. This is very fast and powerful, and works for
100 sites processing several million emails per day.
102 The result is a list of received mails, including the following data:
106 |Time | Timestamp of first found syslog entry.
107 |From | Envelope 'From' address (the sender).
108 |To | The email receiver address.
109 |Status | Delivery status.
110 |Syslog | The corresponding syslog entries are shown if you double click such
111 entry, or if you press the '+' button on the left.
114 Please notice that you can specify filters, most important you can set
115 a 'Start' and 'End' time. By default the start time is set to one hour
116 ago. If you still get to much result entries, you can try to restrict
117 the search to specific sender or receiver addresses, or search for a
118 specific text in the logs ('Filter' entry).
120 NOTE: Search is faster if you use a short time interval.
122 The 'Status' field summarize what happens with an email. {pmg} is a
123 mail proxy, meaning that the proxy receives mails from outside,
124 process it and finally sends the result to the receiver.
126 The first phase is receiving the mail. The proxy may reject the mail
127 early, or instead accepts the mail and feeds it into the filter. The filter
128 rules can block or accept the mail.
130 In the second phase, accepted mails need to be delivered to the
131 receiver, and this action may also fail or succeed. The status
132 combines the result from the first and second phase:
134 [options="header",cols="2s,1d,5d"]
136 |Status |Phase |Description
137 |rejected |1 | Email rejected (e.g. sender IP is listed on a IP blacklist)
138 |greylisted |1 | Email temporarily rejected by greylisting
139 |queued/deferred |1 | Internal Email was queued, still trying to deliver
140 |queued/bounced |1 | Internal Email was queued but not accepted by the target email server (e. g. user unknown)
141 |quarantine |1 | Email was moved to quanantine
142 |blocked |1 | Email was blocked by filter rules
143 |accepted/deferred |2 | Email accepted, still trying to deliver
144 |accepted/bounced |2 | Email accepted but not accepted by the target email server (e. g. user unknown)
145 |accepted/delivered |2 | Email accepted and deliverd
149 Postfix Queue Administration
150 ----------------------------