Changes between Version 13 and Version 14 of EmailtoTracScript


Ignore:
Timestamp:
Jan 10, 2006 11:46:19 PM (9 years ago)
Author:
anonymous
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • EmailtoTracScript

    v13 v14  
    4141You can check out EmailtoTracScript from [http://trac-hacks.swapoff.org/svn/emailtotracscript here] using Subversion, or [source:emailtotracscript browse the source] with Trac. 
    4242 
    43 ==  Installation and Configuration of email2trac == 
     43==  Installation and Configuration == 
    4444 
    4545The email2trac package contains the following utilities: 
    46  email2trac.py::    
     46 '''email2trac.py'''::    
    4747    Converts an email to ticket. Reads a config file email2trac.conf 
    4848 '''run_email2trac.c''':: 
    4949    Suid program that changes the MTA-user to the TRAC-user so that we can 
    5050    save attachments 
    51  delete_spam.py:: 
     51 '''delete_spam.py''':: 
    5252    A small program that deletes the SPAM tickets from the database 
    53  email2trac.conf:: 
     53'''email2trac.conf''':: 
    5454    Is read by email2trac.py to set the various options. This are the options: 
    5555    {{{ 
    56     [DEFAULT]               # REQUIRED 
    57     project: /data/trac/bas # REQUIRED 
    58     debug: 1                # OPTIONAL, if set print some DEBUG info 
    59     spam_level: 4           # OPTIONAL, if set check for SPAM mail 
    60     reply_address: 1        # OPTIONAL, if set then fill in ticket CC field 
    61     umask: 022              # OPTIONAL, Use this umask for saving attachments 
    62     mailto_link: 1          # OPTIONAL, if set then [mailto:<CC>] in description 
    63     email_header: 1         # OPTIONAL, if set then show TO/CC fields in description 
    64     trac_version: 0.8       # OPTIONAL. if set then use this as version number, default 0.9 
     56    [DEFAULT]                         # REQUIRED 
     57    project: /data/trac/jouvin # REQUIRED 
     58    debug: 1                           # OPTIONAL, if set print some DEBUG info 
     59    spam_level: 4                    # OPTIONAL, if set check for SPAM mail 
     60    reply_address: 1                # OPTIONAL, if set then fill in ticket CC field 
     61    umask: 022                       # OPTIONAL, Use this umask for saving attachments 
     62    mailto_link: 1                    # OPTIONAL, if set then [mailto:<CC>] in description 
     63    email_header: 1                # OPTIONAL, if set then show TO/CC fields in description 
     64    trac_version: 0.8               # OPTIONAL. if set then use this as version number, default 0.9 
    6565    }}} 
    6666 
    67 == SETUP == 
     67=== Installation and Configuration === 
    6868   
     69First build, install email2trac : 
     70  * Edit Makefile, adjust the variables (in particular INSTALL_DIR, MTA_USER and TRAC_USER) 
     71  * make 
     72  * make install 
     73  * Define a symlink /etc/email2trac.conf referencing $INSTALL_DIR/email2trac.conf 
     74 
     75After installation, edit email2trac.conf for your site. Most important 
     76parameter is project, see above 
     77 
     78== Usage == 
     79 
     80It depends on your MTA how the setup is. For Sendmail and Postfix, the procedure is the same : 
     81 * Edit your alias definition file (default : /etc/aliases for Postfix, 
     82   /etc/mail/aliases for Sendmail) and add one line per project/component you 
     83   want to allow ticket submission from email to. For each alias, you can 
     84   specify option --project. This option selects a configuration stanza in the 
     85   config file and ''--component'' to specify a component other than the 
     86   default component for the project. Line must have the following format : 
     87{{{ 
     88     tracproj: |/usr/sbin/run_email2trac [--project=<project_name>] [--component=<project_component>] 
     89}}} 
     90 
     91  * Update your alias database with command ''newaliases'' 
     92  * Test with a command like : 
     93{{{ 
     94     mail tracproj < test7.eml 
     95}}}    
     96 
     97 
     98 
    6999It depends on your MTA how the setup is. Below is an example of the SARA setup 
    70100that uses postfix as our MTA.