email2trac utilities

This is a release of the SARA package email2trac that contains utilities that we use to convert emails to trac tickets. The initial setup was made by Daniel Lundin from Edgewall Software. SARA has extend the initial setup, with the following extensions:

• HTML messages
• Attachments
• Use commandline options
• Use config file to change the behaviour of the email2trac.py program
• Some unicode support for special characters in the headers of an email message

Documentation

How to install and make use of this package

• Installation
• Configuration

Bugs/Feature? Requests

Existing bugs and feature requests for EmailtoTracScript? are here.

If you have any issues, create a ​new ticket.

Download

Download the latest stable source from ​ftp://ftp.sara.nl/pub/outgoing/email2trac.tar.gz.

Source

You can check out email2trac from ​here using Subversion, or browse the source​ with Trac.

Usage

It depends on your MTA how the setup is. For Sendmail and Postfix, the procedure is the same :

• Edit your alias definition file (default : /etc/aliases for Postfix, /etc/mail/aliases for Sendmail) and add one line per project/component you want to allow ticket submission from email to. For each alias, you can specify option --project. This option selects a configuration stanza in the config file and --component to specify a component other than the default component for the project. Line must have the following format :

       tracproj: |/usr/bin/run_email2trac [--project=<name>] [--component=<component>]
  

• Update your alias database with command newaliases
• Test with a command like :

       mail tracproj < msg.txt 
  

• if mail fails you can also check if it is an email setup error or a trac-setup error, test it with the following command:

  email2trac --project=tracproj < msg.txt 
  if this is okay then it is an email setup error
  

Note for postfix

run_email2trac is totally unnecessary for Postfix. You can run a delivery command as any user just by placing the aliases in a separate file and chowning that aliases file to the user you want the delivery to run as. Then you run postalias /path/to/aliases, which will create /path/to/aliases.db, and you then just add hash:/path/to/aliases to the alias_maps config variable in main.cf.

The only caveat is that the user who owns the separate aliases file needs to have write perms to the directory that it's stored in (which rules out putting it in /etc/postfix unless you're nuts) -- mpalmer@….

Note for Sendmail

This is a message from emailtotrac tickets archive:

Sendmail limits the executables that can be run via aliases to those in a
special directory, and runs them using a restricted shell called smrsh.
On RH, the default location for the allowed programs is /etc/smrsh.

I tried both a link in that dir to the run_email2trac file and a little
shell script that simply calls run_email2trac and passes the params. Both
should work, but neither did yet. Majordomo works the same way, and it
set up on the machine already so I'll check on that later today.

I found a pretty good walk-through of the problem/solution at
http://archives.free.net.ph/message/20030605.105120.74c3bfa8.html

Well, I was in fact doing the right thing. Here's all the steps to follow
post make install

ln -s /usr/local/bin/run_email2trac /etc/smrsh/run_email2trac

in aliases use:

"|run_email2trac -project=bas"

Note: Include the quotes, they are necessary. That got me past the
sendmail problem. No ticket appeared in the project, but I'll look into
that next. Is there a log generated anywhere?

Author/Contributors?

Author: bas?, Walter de Jong
Contributors: Michel Jouvin, Kilian Cavalotti