====== Exim4 - Test Exim4 ======

===== Check Exim4's configuration file is okay =====

Check that the run time configuration file is syntactically valid by running the following command, which assumes that the Exim binary directory is within your PATH environment variable:

<code bash>
exim -bV
</code>

If there are any errors in the configuration file, Exim outputs error messages.  Otherwise it outputs the version number and build date, the DBM library that is being used, and information about which drivers and other optional code modules are included in the binary.  


===== Verify that Exim4 recognizes a local mailbox =====
 
<code bash>
exim -bt <local username>
</code>

Result

<code>
john@example.com
  router = dovecot_user, transport = dovecot_delivery
</code>


===== Verify that Exim4 recognizes a remote mailbox =====

<code bash>
exim -bt <remote address>
</code>

Result

<code>
R: dnslookup for mail@example.com
mail@example.com
  router = dnslookup, transport = remote_smtp
  host mx00.example.com [123.123.11.12] MX=10
  host mx01.example.com [123.123.11.13] MX=10
</code>


Then try getting it to deliver mail, both locally and remotely.  This can be done by passing messages directly to Exim, without going through a user agent. For example:

<code bash>
exim -v postmaster@example.com
From: user@example.com
To: postmaster@example.com
Subject: Testing Exim

This is a test message.
^D
</code>

The -v option causes Exim to output some verification of what it is doing.  In this case you should see copies of three log lines, one for the message's arrival, one for its delivery, and one containing "Completed".


===== Test malware scanning =====

Admin users can test the malware scanning configuration (in Exim >= 4.73) with the -bmalware option:

<code bash>
exim -bmalware <filename>
</code>

If you encounter problems, look at Exim's log files (mainlog and paniclog) to see if there is any relevant information there.  Another source of information is running Exim with debugging turned on, by specifying the -d option.  If a message is stuck on Exim's spool, you can force a delivery with debugging turned on by a command of the form

<code bash>
exim -d -M <exim-message-id>
</code>

You must be root or an "admin user" in order to do this.  The **-d** option produces rather a lot of output, but you can cut this down to specific areas.  For example, if you use -d-all+route only the debugging information relevant to routing is included.  (See the -d option in chapter 5 for more details.)

One specific problem that has shown up on some sites is the inability to do local deliveries into a shared mailbox directory, because it does not have the "sticky bit" set on it.  By default, Exim tries to create a lock file before writing to a mailbox file, and if it cannot create the lock file, the delivery is deferred.  You can get round this either by setting the "sticky bit" on the directory, or by setting a specific group for local deliveries and allowing that group to create files in the directory (see the comments above the local_delivery transport in the default configuration file).  Another approach is to configure Exim not to use lock files, but just to rely on fcntl() locking instead.  However, you should do this only if all user agents also use fcntl() locking.  For further discussion of locking issues, see [[http://www.exim.org/exim-html-current/doc/html/spec_html/ch-the_appendfile_transport.html|chapter 26]].

One thing that cannot be tested on a system that is already running an MTA is the receipt of incoming SMTP mail on the standard SMTP port.  However, the -oX option can be used to run an Exim daemon that listens on some other port, or inetd can be used to do this.  The -bh option and the exim_checkaccess utility can be used to check out policy controls on incoming SMTP mail.

Testing a  new version on a system that is already running Exim can most easily be done by building a binary with a different CONFIGURE_FILE setting. From within the run time configuration, all other file and directory names that Exim uses can be altered, in order to keep it entirely clear of the production version.

===== References =====

http://www.exim.org/exim-html-current/doc/html/spec_html/ch-building_and_installing_exim.html

http://www.exim.org/exim-html-current/doc/html/spec_html/ch-the_appendfile_transport.html