1.1 --- a/README.txt Thu Oct 22 14:59:59 2015 +0200
1.2 +++ b/README.txt Thu Oct 22 18:40:25 2015 +0200
1.3 @@ -124,11 +124,11 @@
1.4 Such files need adjusting for the deployment environment so that, for example,
1.5 the example.com domain would be replaced with a suitable value.
1.6
1.7 -Where LMTP_SOCKET is employed, a suitable filesystem path is required; see
1.8 -below for a discussion of LMTP and mail delivery.
1.9 -
1.10 -If local SMTP delivery is being used, the conf/postfix/master.cf.items file
1.11 -will need adjusting to use the appropriate system group.
1.12 +If local SMTP delivery is being used, the 30_exim4-config_people file (in
1.13 +conf/exim) or the master.cf.items file (in conf/postfix) will need adjusting.
1.14 +Where LMTP_SOCKET is employed, a suitable filesystem path is required; where
1.15 +the lmtp system group is employed, it may be replaced with a different group.
1.16 +See below for a discussion of LMTP and mail delivery.
1.17
1.18 Configuring Mail Systems for Mail Recipients
1.19 --------------------------------------------
1.20 @@ -138,6 +138,7 @@
1.21 routing or account querying. However, example configuration files are provided
1.22 that demonstrate the use of LDAP to identify mail recipients:
1.23
1.24 +
1.25 For Exim with LDAP (in conf/exim/ldap)...
1.26
1.27 010_exim4-config_ldap_people_outgoing Defines recipients and outgoing
1.28 @@ -146,6 +147,7 @@
1.29 020_exim4-config_ldap_resources ...
1.30 020_exim4-config_ldap_people_outgoing_recipients
1.31
1.32 +
1.33 For Postfix with LDAP (in conf/postfix/ldap)...
1.34
1.35 main.cf.example Defines recipients and outgoing
1.36 @@ -156,9 +158,15 @@
1.37 virtual_alias_maps_people_outgoing.cf mail routing
1.38 virtual_alias_maps_resources.cf ...
1.39
1.40 +
1.41 Since the use of LDAP can be somewhat challenging and also excessive in some
1.42 situations, examples of maintaining recipient information using a simpler
1.43 -approach are provided:
1.44 +approach are provided.
1.45 +
1.46 +In this simpler environment, recipient details must be manually edited in the
1.47 +virtual identity files, but this permits a very transparent way of
1.48 +administering the system.
1.49 +
1.50
1.51 For Exim without LDAP (in conf/exim/simple)...
1.52
1.53 @@ -174,13 +182,17 @@
1.54
1.55 virtual_domains Defines recipient domains
1.56
1.57 -In this simpler environment, recipient details must be manually edited in the
1.58 -virtual files, but this permits a very transparent way of administering the
1.59 -system. To add support for delivery to local mailboxes, the following
1.60 -additional file is provided as an example:
1.61 +To add support for delivery to local mailboxes, the following additional file
1.62 +is provided as an example:
1.63
1.64 virtual_people_local Defines recipients and local users
1.65
1.66 +And to route bounced messages back to the generic calendar address, an
1.67 +addition to the /etc/aliases file is provided:
1.68 +
1.69 + aliases.example Routes calendar to root
1.70 +
1.71 +
1.72 For Postfix without LDAP (in conf/postfix/simple)...
1.73
1.74 main.cf.example Defines recipients and outgoing
1.75 @@ -190,13 +202,12 @@
1.76 virtual_alias_maps Defines recipients and outgoing
1.77 virtual_alias_maps_people_outgoing mail routing
1.78
1.79 -In this simpler environment, recipient details must be manually edited in the
1.80 -virtual alias map files, but this permits a very transparent way of
1.81 -administering the system. To add support for delivery to local mailboxes, the
1.82 -following alternative to virtual_alias_maps is provided as an example:
1.83 +To add support for delivery to local mailboxes, the following alternative to
1.84 +virtual_alias_maps is provided as an example:
1.85
1.86 virtual_alias_maps_local Defines recipients and local users
1.87
1.88 +
1.89 Naturally, the above recipient identification configuration examples can be
1.90 disregarded in favour of other ways of defining mail recipients, subject to
1.91 the needs of any given environment.
1.92 @@ -235,10 +246,21 @@
1.93 ------------------------------------------
1.94
1.95 The agent software assumes that delivery of mail to recipients may be
1.96 -performed using LMTP to a suitable mailbox provider. This is largely beyond
1.97 -the scope of this document, but systems such as Cyrus and Dovecot can be
1.98 -configured to provide a Unix domain socket offering support for LMTP
1.99 -connections.
1.100 +performed either using local SMTP or by using LMTP to a suitable mailbox
1.101 +provider.
1.102 +
1.103 +If employing local SMTP, the burden of routing messages to suitable storage
1.104 +becomes a configuration problem within the mail system itself, but given that
1.105 +routing to local system users is typically supported "out of the box", this
1.106 +can provide a usable solution with minimal effort.
1.107 +
1.108 +By using LMTP from the agent software, the issue of configuring the mail
1.109 +system to integrate with storage solutions is avoided, but then those
1.110 +solutions must expose their LMTP interface appropriately.
1.111 +
1.112 +Although this topic is largely beyond the scope of this document, systems such
1.113 +as Cyrus and Dovecot can be configured to provide a Unix domain socket
1.114 +offering support for LMTP connections.
1.115
1.116 For Cyrus, the following bug report is pertinent:
1.117
1.118 @@ -308,6 +330,11 @@
1.119 Python: python
1.120 pytz: python-tz
1.121
1.122 +To update free/busy details periodically, the following software is
1.123 +recommended:
1.124 +
1.125 + Cron: cron
1.126 +
1.127 The management Web interface requires the following packages:
1.128
1.129 Apache: apache2
3.1 --- a/conf/postfix/simple/main.cf.example Thu Oct 22 14:59:59 2015 +0200
3.2 +++ b/conf/postfix/simple/main.cf.example Thu Oct 22 18:40:25 2015 +0200
3.3 @@ -1,3 +1,7 @@
3.4 +# Uncomment the virtual_alias_maps_local entry to support local user delivery.
3.5 +
3.6 virtual_alias_maps = $alias_maps, hash:/etc/postfix/virtual,
3.7 hash:/etc/postfix/simple/virtual_alias_maps
3.8 + #, hash:/etc/postfix/simple/virtual_alias_maps_local
3.9 +
3.10 sender_bcc_maps = hash:/etc/postfix/simple/virtual_alias_maps_people_outgoing
4.1 --- a/conf/postfix/simple/virtual_alias_maps_local Thu Oct 22 14:59:59 2015 +0200
4.2 +++ b/conf/postfix/simple/virtual_alias_maps_local Thu Oct 22 18:40:25 2015 +0200
4.3 @@ -1,7 +1,2 @@
4.4 -paul.boddie@example.com people+paul.boddie@example.com
4.5 -vincent.vole@example.com people+vincent.vole@example.com
4.6 -resource-car-porsche911@example.com resources+resource-car-porsche911@example.com
4.7 -resource-room-confroom@example.com resources+resource-room-confroom@example.com
4.8 -resource-room-sauna@example.com resources+resource-room-sauna@example.com
4.9 local+paul.boddie@example.com paulb
4.10 local+vincent.vole@example.com vole