# HG changeset patch # User Paul Boddie # Date 1445532025 -7200 # Node ID 3308aa0462ca2a885faf344b867c7551ba268285 # Parent 2fbf8372142dedc741758aa63de9c37cf3c76299 Tidied up the treatment of local SMTP and LMTP in the documentation. Changed the simple Postfix configuration to have local routing as an additional configuration file, rather than a replacement. Added calendar-to-root aliasing for the Exim simple configuration. diff -r 2fbf8372142d -r 3308aa0462ca README.txt --- a/README.txt Thu Oct 22 14:59:59 2015 +0200 +++ b/README.txt Thu Oct 22 18:40:25 2015 +0200 @@ -124,11 +124,11 @@ Such files need adjusting for the deployment environment so that, for example, the example.com domain would be replaced with a suitable value. -Where LMTP_SOCKET is employed, a suitable filesystem path is required; see -below for a discussion of LMTP and mail delivery. - -If local SMTP delivery is being used, the conf/postfix/master.cf.items file -will need adjusting to use the appropriate system group. +If local SMTP delivery is being used, the 30_exim4-config_people file (in +conf/exim) or the master.cf.items file (in conf/postfix) will need adjusting. +Where LMTP_SOCKET is employed, a suitable filesystem path is required; where +the lmtp system group is employed, it may be replaced with a different group. +See below for a discussion of LMTP and mail delivery. Configuring Mail Systems for Mail Recipients -------------------------------------------- @@ -138,6 +138,7 @@ routing or account querying. However, example configuration files are provided that demonstrate the use of LDAP to identify mail recipients: + For Exim with LDAP (in conf/exim/ldap)... 010_exim4-config_ldap_people_outgoing Defines recipients and outgoing @@ -146,6 +147,7 @@ 020_exim4-config_ldap_resources ... 020_exim4-config_ldap_people_outgoing_recipients + For Postfix with LDAP (in conf/postfix/ldap)... main.cf.example Defines recipients and outgoing @@ -156,9 +158,15 @@ virtual_alias_maps_people_outgoing.cf mail routing virtual_alias_maps_resources.cf ... + Since the use of LDAP can be somewhat challenging and also excessive in some situations, examples of maintaining recipient information using a simpler -approach are provided: +approach are provided. + +In this simpler environment, recipient details must be manually edited in the +virtual identity files, but this permits a very transparent way of +administering the system. + For Exim without LDAP (in conf/exim/simple)... @@ -174,13 +182,17 @@ virtual_domains Defines recipient domains -In this simpler environment, recipient details must be manually edited in the -virtual files, but this permits a very transparent way of administering the -system. To add support for delivery to local mailboxes, the following -additional file is provided as an example: +To add support for delivery to local mailboxes, the following additional file +is provided as an example: virtual_people_local Defines recipients and local users +And to route bounced messages back to the generic calendar address, an +addition to the /etc/aliases file is provided: + + aliases.example Routes calendar to root + + For Postfix without LDAP (in conf/postfix/simple)... main.cf.example Defines recipients and outgoing @@ -190,13 +202,12 @@ virtual_alias_maps Defines recipients and outgoing virtual_alias_maps_people_outgoing mail routing -In this simpler environment, recipient details must be manually edited in the -virtual alias map files, but this permits a very transparent way of -administering the system. To add support for delivery to local mailboxes, the -following alternative to virtual_alias_maps is provided as an example: +To add support for delivery to local mailboxes, the following alternative to +virtual_alias_maps is provided as an example: virtual_alias_maps_local Defines recipients and local users + Naturally, the above recipient identification configuration examples can be disregarded in favour of other ways of defining mail recipients, subject to the needs of any given environment. @@ -235,10 +246,21 @@ ------------------------------------------ The agent software assumes that delivery of mail to recipients may be -performed using LMTP to a suitable mailbox provider. This is largely beyond -the scope of this document, but systems such as Cyrus and Dovecot can be -configured to provide a Unix domain socket offering support for LMTP -connections. +performed either using local SMTP or by using LMTP to a suitable mailbox +provider. + +If employing local SMTP, the burden of routing messages to suitable storage +becomes a configuration problem within the mail system itself, but given that +routing to local system users is typically supported "out of the box", this +can provide a usable solution with minimal effort. + +By using LMTP from the agent software, the issue of configuring the mail +system to integrate with storage solutions is avoided, but then those +solutions must expose their LMTP interface appropriately. + +Although this topic is largely beyond the scope of this document, systems such +as Cyrus and Dovecot can be configured to provide a Unix domain socket +offering support for LMTP connections. For Cyrus, the following bug report is pertinent: @@ -308,6 +330,11 @@ Python: python pytz: python-tz +To update free/busy details periodically, the following software is +recommended: + + Cron: cron + The management Web interface requires the following packages: Apache: apache2 diff -r 2fbf8372142d -r 3308aa0462ca conf/exim/aliases.example --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/conf/exim/aliases.example Thu Oct 22 18:40:25 2015 +0200 @@ -0,0 +1,1 @@ +calendar: root diff -r 2fbf8372142d -r 3308aa0462ca conf/postfix/simple/main.cf.example --- a/conf/postfix/simple/main.cf.example Thu Oct 22 14:59:59 2015 +0200 +++ b/conf/postfix/simple/main.cf.example Thu Oct 22 18:40:25 2015 +0200 @@ -1,3 +1,7 @@ +# Uncomment the virtual_alias_maps_local entry to support local user delivery. + virtual_alias_maps = $alias_maps, hash:/etc/postfix/virtual, hash:/etc/postfix/simple/virtual_alias_maps + #, hash:/etc/postfix/simple/virtual_alias_maps_local + sender_bcc_maps = hash:/etc/postfix/simple/virtual_alias_maps_people_outgoing diff -r 2fbf8372142d -r 3308aa0462ca conf/postfix/simple/virtual_alias_maps_local --- a/conf/postfix/simple/virtual_alias_maps_local Thu Oct 22 14:59:59 2015 +0200 +++ b/conf/postfix/simple/virtual_alias_maps_local Thu Oct 22 18:40:25 2015 +0200 @@ -1,7 +1,2 @@ -paul.boddie@example.com people+paul.boddie@example.com -vincent.vole@example.com people+vincent.vole@example.com -resource-car-porsche911@example.com resources+resource-car-porsche911@example.com -resource-room-confroom@example.com resources+resource-room-confroom@example.com -resource-room-sauna@example.com resources+resource-room-sauna@example.com local+paul.boddie@example.com paulb local+vincent.vole@example.com vole