# HG changeset patch
# User Paul Boddie <paul@boddie.org.uk>
# Date 1461164557 -7200
# Node ID ba4b2c8fbc358bea3fdf478a2e519afc6409b2aa
# Parent  939457b7a88672f643c08171911d89bcb8cb6201
Added notes about MTA troubleshooting and about testing the software.

diff -r 939457b7a886 -r ba4b2c8fbc35 docs/wiki/MailIntegration--MTA
--- a/docs/wiki/MailIntegration--MTA	Wed Apr 20 16:13:29 2016 +0200
+++ b/docs/wiki/MailIntegration--MTA	Wed Apr 20 17:02:37 2016 +0200
@@ -77,3 +77,32 @@
 mailserver:example.com
 }}}
 }}}}
+
+== Useful Commands ==
+
+The following commands prove useful when troubleshooting and appear to be
+available as shown within a Debian environment.
+
+{{{#!table
+'''Task''' || '''Exim''' || '''Postfix'''
+==
+Check the mail queue
+||<colspan="2"> `mailq`
+==
+Process the mail queue
+|| `sendmail -q` (or `exim -q` or `runq`)
+|| `sendmail -q` (or `postqueue`)
+==
+Flush the mail queue
+|| `exim -qff`
+|| `postqueue -f`
+==
+Deliver a specific message
+|| `exim -M <identifier>`
+|| `postqueue -i <identifier>`
+==
+Test delivery for an address
+||<colspan="2"> `sendmail -bt <address>` (see also `sendmail -v -bv <address>` and `sendmail -v -bvs <address>`)
+}}}
+
+See [[http://bradthemad.org/tech/notes/exim_cheatsheet.php|Exim Cheatsheet]] and [[http://www.postfix.org/DEBUG_README.html|Postfix Debugging Howto]] for more guidance.
diff -r 939457b7a886 -r ba4b2c8fbc35 docs/wiki/Testing
--- a/docs/wiki/Testing	Wed Apr 20 16:13:29 2016 +0200
+++ b/docs/wiki/Testing	Wed Apr 20 17:02:37 2016 +0200
@@ -94,6 +94,9 @@
 ./test_all.sh
 }}}
 
+The test suite by default (or by indicating `file` as the data store type),
+records test information in subdirectories of `/tmp`.
+
 To run all tests against a different data store, such as a
 [[../DatabaseStore|database store]] instead of the [[../FileStore|file store]],
 the `STORE_TYPE` environment variable can be specified as in the following
@@ -103,6 +106,11 @@
 STORE_TYPE=postgresql ./test_all.sh
 }}}
 
+The test suite records `postgresql` tests in a specially-created database
+called `imip_agent_test` that the system user running the tests must be allowed
+to create and drop. This may require the granting of administrative rights
+within PostgreSQL for the system user concerned.
+
 Individual tests may also be run directly from the topmost level of the
 source code distribution. For example: