This HowTo is from adapted from an e-mail exchange on the Sork mailing list. It is a discussion of setting up Sork's vacation module
for use with an ldap based system, using gnarwl as the server-side vacation program. The software used is:
MTA: postfix
vacation program: gnarwl
LDAP: openldap 2.2.13-4
Horde version: 3.1.3
vacation version: 3.0
(For those who don't want to use gnarwl, a "traditional" vacation program for ldap is available at http://www.etc.msys.ch/sources/ldapvacation/).
Note
- sork's vacation may be replaced by Ingo in the future.
- freebsd user. Downloaded gnarwl package does not support openldap, build from port instead.
First, define a postfix transport map for your specific internal autoreply domain.
If your domain is "example.com" and your autoreply domain is to be "autoreply.example.com", then you would add the following to
/etc/postfix/transport:
autoreply.example.com gnarwl:example.com
Next, create the database files from the above file. The following command should create the appropriate transport.db file:
postmap hash:transport
Next add the transport to the postfix main.cf file in the "TRANSPORT MAPS" section:
<snip> # TRANSPORT MAPS # transport_maps = hash:/etc/postfix/transport </snip>
Now add a new service to the /etc/postfix/master.cf file:
</snip> # gnarwl autoresponder gnarwl unix - n n - - pipe flags=F user=gnarwl argv=/usr/bin/gnarwl -a ${user}@${nexthop} -s ${sender} </snip>
Create an LDAP vacation alias map called ldap-virtual_alias_maps-vacation.cf:
<snip> server_host = ldap://ldap.example.com version = 3 server_port = 389 search_base = ou=mail,... query_filter = (&(objectClass=MailAccount)(objectClass=Vacation)(mail=%s)(accountActive=TRUE)(vacationActive=TRUE)) result_attribute = mail result_filter = %s,%u@autoreply.example.com bind = no </snip>
Of course, the above needs to reflect your ldap environment...
Append the alias map to LDAP's main.cf file (make sure it's the first map listed):
<snip> virtual_alias_maps = ldap:/etc/postfix/ldap-virtual_alias_maps-vacation.cf, ldap:/etc/postfix/ldap-virtual_alias_maps.cf </snip>
after those changes, reload postfix:
postfix reload
Extend your LDAP with the vacation schema and setup a test account. An example ldif follows:
<snip> dn:mail=vacationtest@example.com,... objectClass: top objectClass: Vacation mail: vacationtest@example.com accountActive: TRUE [... other mail specific attributes ...] vacationActive: TRUE vacationInfo:: [vacation message has to be utf-8 encoded and also base64 if necessary] </snip>
After loading the above ldif, test your postfix alias vacation lookup map:
postmap -v -q vacationtest@example.com ldap:/etc/postfix/ldap-virtual_alias_maps-vacation.cf
This should return the following if the vacation has been enabled, otherwise nothing.
<snip> vacationtest@example.com,vacationtest@autoreply.example.com </snip>
If this works so far, configure gnawrl to suit your needs (only the ldap part and the header config is included):
Edit gnarwl.cfg and change the following lines:
<snip> server ldap.example.com protocol 3 base ou=mail... queryfilter (&(objectClass=MailAccount)(objectClass=Vacation)(mail=$recepient)(accountActive=TRUE)(vacationActive=TRUE)) mta /usr/sbin/sendmail $sender charset forceheader /var/lib/gnarwl/header-utf8.txt loglevel 3 </snip>
Create the file /var/lib/gnarwl/header-utf8.txt and add the content shown below:
<snip> From: $fullname <$recepient> To: $sender X-mailer: GNARWL MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8; format=flowed Content-Transfer-Encoding: 8bit Subject: Re: $subject </snip>
Finally you will have to configure the sork vacation app with the ldap driver. This should be an easy task now ;)
Remember, that you have to configure/specify the vacation related attributes.