Changes between Version 13 and Version 14 of EmailtoTracScript

Timestamp:

Jan 10, 2006, 10:46:19 PM (18 years ago)

Author:

anonymous

Comment:

--

EmailtoTracScript

@@ -41 +41 @@
 You can check out EmailtoTracScript from [http://trac-hacks.swapoff.org/svn/emailtotracscript here] using Subversion, or [source:emailtotracscript browse the source] with Trac.
 
-==  Installation and Configuration of email2trac ==
+==  Installation and Configuration  ==
 
 The email2trac package contains the following utilities:
- email2trac.py::   
+ '''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::
+ '''delete_spam.py'''::
     A small program that deletes the SPAM tickets from the database
- email2trac.conf::
+'''email2trac.conf'''::
     Is read by email2trac.py to set the various options. This are the options:
     {{{
-    [DEFAULT]               # REQUIRED
-    project: /data/trac/bas # REQUIRED
-    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:<CC>] in description
-    email_header: 1         # OPTIONAL, if set then show TO/CC fields in description
-    trac_version: 0.8       # OPTIONAL. if set then use this as version number, default 0.9
+    [DEFAULT]                         # REQUIRED
+    project: /data/trac/jouvin # REQUIRED
+    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:<CC>] in description
+    email_header: 1                # OPTIONAL, if set then show TO/CC fields in description
+    trac_version: 0.8               # OPTIONAL. if set then use this as version number, default 0.9
     }}}
 
-== SETUP ==
+=== 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 installation, edit email2trac.conf for your site. Most important
+parameter is project, see above
+
+== 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/sbin/run_email2trac [--project=<project_name>] [--component=<project_component>]
+}}}
+
+  * Update your alias database with command ''newaliases''
+  * Test with a command like :
+{{{
+     mail tracproj < test7.eml
+}}}   
+
+
+
 It depends on your MTA how the setup is. Below is an example of the SARA setup
 that uses postfix as our MTA.