6.0.0-git
2021-12-09

Diff for SorkVacationWithGnarwl between 5 and 6

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/).



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:



<code>

autoreply.example.com    gnarwl:

</code>



Next, create the database files from the above file.  The following command should create the appropriate transport.db file:



<code>

postmap hash:transport

</code>



Next add the transport to the postfix main.cf file in the "TRANSPORT MAPS" section:



<code>

<snip>

# TRANSPORT MAPS

#

transport_maps = hash:/etc/postfix/transport

</snip>

</code>



Now add a new service to the /etc/postfix/master.cf file:



<code>

</snip>

# gnarwl autoresponder

gnarwl    unix  -       n       n       -       -       pipe

  flags=F  user=gnarwl argv=/usr/bin/gnarwl -a $user

</snip>

</code>



Create an LDAP vacation alias map called ldap-virtual_alias_maps-vacation.cf:



<code>

<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,%s@autoreply.example.com

bind = no

</snip>

</code>



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):



<code>

<snip>

virtual_alias_maps =

ldap:/etc/postfix/ldap-virtual_alias_maps-vacation.cf,

ldap:/etc/postfix/ldap-virtual_alias_maps.cf

</snip>

</code>



after those changes, reload postfix:



<code>

postfix reload

</code>



Extend your LDAP with the vacation schema and setup a test account. An example ldif follows:



<code>

<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>

</code>



After loading the above ldif, test your postfix alias vacation lookup map:



<code>

postmap -v -q vacationtest@example.com

ldap:/etc/postfix/ldap-virtual_alias_maps-vacation.cf

</code>



This should return the following if the vacation has been enabled, otherwise nothing.



<code>

<snip>

vacationtest@example.com,vacationtest@example.com@autoreply.example.com

</snip>

</code>



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:



<code>

<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>

</code>



Create the file /var/lib/gnarwl/header-utf8.txt and add the content shown below:



<code>

<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>

</code>



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.