\documentclass{article}
\usepackage{ulem}
\pagestyle{headings}
\begin{document}
This HowTo\footnote{http://example.com/index.php?page=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\newline
for use with an ldap based system, using gnarwl as the server-side vacation program.  The software used is:

MTA:                        postfix\newline
vacation program: gnarwl\newline
LDAP:                      openldap 2.2.13-4\newline
Horde version:       3.1.3\newline
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/\footnote{http://www.etc.msys.ch/sources/ldapvacation/}).

Note\newline
- sork's vacation may be replaced by Ingo in the future.\newline
- 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.\newline
If your domain is "example.com" and your autoreply domain is to be "autoreply.example.com", then you would add the following to\newline
/etc/postfix/transport:

\begin{verbatim}

autoreply.example.com    gnarwl:example.com
\end{verbatim}

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

\begin{verbatim}

postmap hash:transport
\end{verbatim}

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

\begin{verbatim}

<snip>
# TRANSPORT MAPS
#
transport_maps = hash:/etc/postfix/transport
</snip>
\end{verbatim}

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

\begin{verbatim}

</snip>
# gnarwl autoresponder
gnarwl    unix  -       n       n       -       -       pipe
  flags=F  user=gnarwl argv=/usr/bin/gnarwl -a ${user}@${nexthop} -s ${sender}
</snip>
\end{verbatim}

Create an LDAP vacation alias map called ldap-virtual\_alias\_maps-vacation.cf:

\begin{verbatim}

<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>
\end{verbatim}

Of course, the above needs to reflect your ldap environment\ldots

Append the alias map to LDAP's main.cf file (make sure it's the first map listed):

\begin{verbatim}

<snip>
virtual_alias_maps =
ldap:/etc/postfix/ldap-virtual_alias_maps-vacation.cf,
ldap:/etc/postfix/ldap-virtual_alias_maps.cf
</snip>
\end{verbatim}

after those changes, reload postfix:

\begin{verbatim}

postfix reload
\end{verbatim}

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

\begin{verbatim}

<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>
\end{verbatim}

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

\begin{verbatim}

postmap -v -q vacationtest@example.com
ldap:/etc/postfix/ldap-virtual_alias_maps-vacation.cf
\end{verbatim}

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

\begin{verbatim}

<snip>
vacationtest@example.com,vacationtest@autoreply.example.com
</snip>
\end{verbatim}

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:

\begin{verbatim}

<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>
\end{verbatim}

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

\begin{verbatim}

<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>
\end{verbatim}

Finally you will have to configure the sork vacation app with the ldap driver. This should be an easy task now ;)\newline
Remember, that you have to configure/specify the vacation related attributes.

\end{document}
