imip-agent

Annotated docs/wiki/MailIntegration--Transports

1024:48b37822d2a0
2016-01-29 Paul Boddie Moved common test initialisation into a separate script.
paul@955 1
= Mail Transports and Invoking Agent Programs =
paul@955 2
paul@955 3
The essential aspect of mail system configuration involves mail transports and
paul@955 4
the integration of agent programs into the mail processing pipeline. A number of
paul@955 5
example files are provided here.
paul@955 6
paul@955 7
Such files need adjusting for the deployment environment so that, for example,
paul@955 8
the `example.com` domain would be replaced with a suitable value.
paul@955 9
paul@955 10
If LMTP is being used, instances of `LMTP_SOCKET` in the example configuration
paul@955 11
files will need to be replaced with a suitable filesystem path. Where the `lmtp`
paul@955 12
system group is employed, it may be replaced with a different group. See the
paul@955 13
[[../LMTP|LMTP guide]] for a discussion of LMTP and mail delivery.
paul@955 14
paul@955 15
== Transports in Exim ==
paul@955 16
paul@955 17
Example configuration files for Exim are distributed in `conf/exim`:
paul@955 18
paul@955 19
{{{#!table
paul@955 20
'''File''' || '''Purpose'''
paul@955 21
==
paul@955 22
`30_exim4-config_people`
paul@955 23
||<rowspan="3"> Integration of agent programs
paul@955 24
==
paul@955 25
`30_exim4-config_people_outgoing`
paul@955 26
==
paul@955 27
`30_exim4-config_resources`
paul@955 28
}}}
paul@955 29
paul@955 30
These files can be incorporated into the Exim configuration. On Debian
paul@955 31
systems, they can be copied into `/etc/exim4/conf.d/transport`.
paul@955 32
paul@955 33
If local SMTP delivery is being used, the `30_exim4-config_people` file (in
paul@955 34
`conf/exim`) will need adjusting.
paul@955 35
paul@955 36
== Transports in Postfix ==
paul@955 37
paul@955 38
Example configuration files for Postfix are distributed in `conf/postfix`:
paul@955 39
paul@955 40
{{{#!table
paul@955 41
'''File''' || '''Purpose'''
paul@955 42
==
paul@955 43
`master.cf.items`
paul@955 44
|| Integration of agent programs (for inclusion in `master.cf`)
paul@955 45
==
paul@955 46
`transport`
paul@955 47
|| Configuration of agent transports
paul@955 48
==
paul@955 49
`virtual`
paul@955 50
|| Configuration of outgoing mail routing
paul@955 51
}}}
paul@955 52
paul@955 53
These files can be incorporated into the Postfix configuration. On Debian
paul@955 54
systems, `master.cf.items` can be merged into `/etc/postfix/master.cf`,
paul@955 55
whereas the remaining files would be installed into `/etc/postfix`.
paul@955 56
paul@955 57
If local SMTP delivery is being used, the `master.cf.items` file (in
paul@955 58
`conf/postfix`) will need adjusting.