Add troubleshooting test email delivery (postfix) (#3344)

theforeman · Oct 4, 2024 · 848d8a3 · 848d8a3
1 parent 4575e45
commit 848d8a3
Showing 1 changed file with 17 additions and 0 deletions.
diff --git a/guides/common/modules/proc_testing-email-delivery.adoc b/guides/common/modules/proc_testing-email-delivery.adoc
@@ -17,3 +17,20 @@ Otherwise, you must perform the following diagnostic steps:
 .. Verify the user's email address.
 .. Verify {ProjectServer}'s email configuration.
 .. Examine firewall and mail server logs.
+.. If your {ProjectServer} uses the Postfix service for email delivery, the test email might be held in the queue.
+To verify, enter the `mailq` command to list the current mail queue.
+If the test email is held in the queue, `mailq` displays the following message:
++
+[options="nowrap", subs="+quotes,attributes"]
+----
+postqueue: warning: Mail system is down -- accessing queue directly
+-Queue ID-  --Size-- ----Arrival Time---- -Sender/Recipient-------
+BE68482A783    1922 Thu Oct  3 05:13:36  {project-context}[email protected]
+----
++
+To fix the problem, start the Postfix service on your {ProjectServer}:
++
+[options="nowrap", subs="+quotes,attributes"]
+----
+# systemctl start postfix
+----