[[ShowPath]]
[[PageOutline]]

= Installation =

First get the latest stable source of the package from:
 * ftp://ftp.sara.nl/pub/outgoing/email2trac.tar.gz


== Contains ==
The email2trac package contains the following utilities:

'''email2trac'''::
    Converts an email to ticket. Reads a config file email2trac.conf 
'''run_email2trac'''::
    Suid program that changes the MTA-user to the TRAC-user so that we can save attachments 
'''delete_spam'''::
    A small program that deletes the SPAM tickets from the database 
[wiki:Email2tracConfiguration email2trac.conf]::
    Configuration file to set the behavior for email2trac.


== Build process ==

[[Image(Warning_icon.png)]]  Pay attention to the MTA_USER and TRAC_USER, they are not something you can ignore! 

Unpack the tarball. There are severasl methods to build the package.

=== No package manager ===
The configure script build default is /usr/local
{{{
./configure (see --help)
    default values for:
       prefix=/usr/local        --> --prefix=<path>
       exec_prefix=$prefix/bin  --> --exec_prefix=<path>
       sysconfdir=$prefix/etc   --> --sysconfdir=<path>
       MTA_USER=nobody          --> --with-mta_user=<name>
       TRAC_USER=www-data       --> --with-trac_user=<name>
make
make install
}}}

If you want the python scripts to be included in the buildprocess add {{{ --enable-python }}}

===  Debian package ===
{{{
debian/rules binary
dpkg -i ../email2trac_<version>.deb
NOTE:  It uses the defaults settings for MTA_USER and TRAC_USERS as mentioned above
}}} 

=== RPM package ===
{{{
cp email2trac.tar.gz /usr/src/redhat/SOURCES
rpmbuild -ba email2trac.spec
}}}
 * RPM package instructions seem incomplete. The above didn't work for me, I had to do the following (as root or using sudo). There may be an alternative way of setting TRAC_USER and MTA_USER than the one below but I couldn't find it. It's a shame it doesn't pull it from the config file. - Tolan Blundell slight_ at hotmail dot com.
{{{
tar zxvf email2trac.tar.gz
rm email2trac.tar.gz
// Edit lines 37 and 51 of configure.in to alter the TRAC_USER and MTA_USER variables.
mv  email2trac-0.13  email2trac-0.13.0
tar zcvf email2trac.tar.gz  email2trac-0.13.0
cp -R email2trac-0.13.0/ /usr/src/redhat/SOURCES
cp -R email2trac.tar.gz /usr/src/redhat/SOURCES
cd /usr/src/redhat/SOURCES
rpmbuild -ba email2trac-0.13/email2trac.spec
}}}

=== Windows ===
  * [wiki:Email2tracInstallation/Windows Windows installation]