= Installation and Configuration of email2trac = The email2trac package contains the following utilities: * '''email2trac.py''' : converts an email to ticket. Reads a config file email2trac.conf * '''run_email2trac.c''' : suid program that changes the MTA-user to the TRAC-user so that we can save attachments * '''delete_spam.py''' : small program that deletes the SPAM tickets from the database * '''email2trac.conf''' : read by email2trac.py to set the various options. This are the options: {{{ [DEFAULT] # REQUIRED project_root: /data/trac # REQUIRED if project: doesn't specify a project # full path, else OPTIONAL project: bas # OPTIONAL if project_root: present, # else REQUIRED and MUST specify a project full path debug: 1 # OPTIONAL, if set print some DEBUG info spam_level: 4 # OPTIONAL, if set check for SPAM mail reply_address: 1 # OPTIONAL, if set then fill in ticket CC field umask: 022 # OPTIONAL, Use this umask for saving attachments mailto_link: 1 # OPTIONAL, if set then [mailto:] in description email_header: 1 # OPTIONAL, if set then show TO/CC fields in description trac_version: 0.8 # OPTIONAL, if set use this as trac version (D: 0.9) }}} == Installation and Configuration == First build, install email2trac : * Edit Makefile, adjust the variables (in particular INSTALL_DIR, MTA_USER and TRAC_USER) * make * make install * Define a symlink /etc/email2trac.conf referencing $INSTALL_DIR/email2trac.conf After installatin, edit email2trac.conf for your site. Most important parameters are project_root: and project:. project: defines a default project, when project_root: is specified. == 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 to specify a project other than the default configured inside the configuration file (project must be located below ''project_root'') and option ''--component'' to specify a component other than the default component for the project. Line must have the following format : {{{ tracproj: |/usr/sbin/run_email2trac [--project=] [--component=] }}} * Update your alias database with command ''newaliases'' * Test with a command like : {{{ mail tracproj < test7.eml }}}