[cvs] [Wiki] changed: SorkVacationWithGnarwl

[Wiki Guest]

guest [128.83.155.230]  Tue, 05 Sep 2006 11:53:00 -0700

Modified page: http://wiki.horde.org/SorkVacationWithGnarwl
New Revision:  1.3
Change log:  Small tweaks, formatting

@@ -1,28 +1,28 @@
-This HowTo is from an e-mail exchange on the Sork mailing list.
+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:
  
-The server setup is:
-
-MTA: postfix
+MTA:                        postfix
  vacation program: gnarwl
-Horde: 3.1.3
-Vacation: 3.0
-openldap: 2.2.13-4
+LDAP:                      openldap 2.2.13-4
+Horde version:       3.1.3
+vacation version:   3.0
  
  First, define a postfix transport map for your specific internal autoreply domain.
-For example /etc/postfix/transport:
+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>
  
-create the database:
+Next, create the database files from the above file.  The following command should create the appropriate transport.db file:
  
  <code>
-postmap hash:transport # this should create the transport.db file
+postmap hash:transport
  </code>
  
-Add the transport to the postfix main.cf:
+Next add the transport to the postfix main.cf file in the "TRANSPORT MAPS" section:
  
  <code>
  <snip>
  # TRANSPORT MAPS
@@ -30,35 +30,37 @@
  transport_maps = hash:/etc/postfix/transport
  </snip>
  </code>
  
-Add a new service to /etc/postfix/master.cf:
+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>
  
-Add a vacation alias map (ldap-virtual_alias_maps-vacation.cf):
+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))
+query_filter = (&(objectClass=MailAccount)(objectClass=Vacation)(mail=%s)(accountActive=TRUE)(vacationActive=TRUE))
  result_attribute = mail
  result_filter = %s,%s at autoreply.example.com
  bind = no
  </snip>
  </code>
  
  Of course, the above needs to reflect your ldap environment...
  
-Append the alias map to main.cf (make sure it's the first map):
+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,
@@ -66,14 +68,14 @@
  </snip>
  </code>
  
  after those changes, reload postfix:
+
  <code>
  postfix reload
  </code>
  
-Extend your ldap with the vacation schema and setup a test account,
-example ldif:
+Extend your LDAP with the vacation schema and setup a test account. An example ldif follows:
  
  <code>
  <snip>
  dn:mail=vacationtest at example.com,...
@@ -82,10 +84,9 @@
  mail: vacationtest at example.com
  accountActive: TRUE
  [... other mail specific attributes ...]
  vacationActive: TRUE
-vacationInfo:: [vacation message has to be utf-8 encoded and also base64
-if necessary]
+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:
@@ -104,9 +105,10 @@
  </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:
+Edit gnarwl.cfg and change the following lines:
+
  <code>
  <snip>
  server ldap.example.com
  protocol 3
@@ -120,8 +122,9 @@
  </snip>
  </code>
  
  Create the file /var/lib/gnarwl/header-utf8.txt and add the content shown below:
+
  <code>
  <snip>
  From: $fullname <$recepient>
  To: $sender