Changes between Version 3 and Version 4 of Email2tracInstallation/Windows


Ignore:
Timestamp:
03/21/08 23:51:06 (15 years ago)
Author:
nicole.swan@…
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • Email2tracInstallation/Windows

    v3 v4  
    77 == Email component ==
    88
    9 This will vary depending on whether the email server and Trac are on the same server.  If they are not on the same server, a way to gather the email is necessary.  Two common options are to install the built-in SMTP server or to using an email gathering tool such as Fetchmail.
     9This will vary depending on whether the email server and Trac are on the same server.  If they are not on the same server, a way to gather the email is necessary.  Two common options are to install the built-in SMTP server or to use an email gathering tool such as Fetchmail.
    1010
    1111 === Built-in Windows SMTP server ===
     
    4545 == Email2trac Script Setup ==
    4646
    47 Obtain a copy of the script, either by downloading the [ftp://ftp.sara.nl/pub/outgoing/email2trac.tar.gz latest stable source] or getting the latest [https://subtrac.sara.nl/oss/email2trac/browser/trunk trunk] or [https://subtrac.sara.nl/oss/email2trac/browser/tags/0.13 tagged] version.  Unlike in a *nix environment, email2trac on Windows does not have to be built or packaged to work.  The following files are needed:
     47Obtain a copy of the script, either by downloading the [ftp://ftp.sara.nl/pub/outgoing/email2trac.tar.gz latest stable source] or getting the latest [https://subtrac.sara.nl/oss/email2trac/browser/trunk trunk] or [https://subtrac.sara.nl/oss/email2trac/browser/tags/0.13 tagged] version.  Unlike in a *nix environment, email2trac on Windows does not have to be built or packaged to work.  Only the following files are needed:
    4848
    4949 * email2trac.py.in
     
    5151 * email2trac.conf
    5252
    53 Put these files in the directory of your choice, e.g. C:/projects/email2trac.  Rename email2trac.py.in to email2trac.py and delete_spam.py.in to delete_spam.py.in.  A few edits are necessary for email2trac.py to work in the Windows environment.
     53Put these files in the directory of your choice, e.g. C:/projects/email2trac.  Rename email2trac.py.in to email2trac.py and delete_spam.py.in to delete_spam.py.in.  A couple edits are necessary for email2trac.py to work in the Windows environment.
    5454
    55  1. (For versions prior to 0.13 only) Comment out the syslog import (approximately line 95 in version 0.10).
     55 1. Specify the email2trac configuration file path (around line 1060 in version 0.13).  The specificity of the path required depends on how you are retrieving emails -- if you are using fetchmail, you will need to specify the complete path (i.e. C:/projects/email2trac/email2trac.conf).
     56{{{
     57 #configfile = '@email2trac_conf@'
     58 configfile = 'email2trac.conf'
     59}}}
     60
     61 2. (For versions prior to 0.13 only) Comment out the syslog import (around line 95 in version 0.10).
    5662{{{ #import syslog }}}
    5763
    58  2. Specify the email2trac configuration file path (around line 1060 in version 0.13).
     64 === Email2trac Configuration ===
     65
     66There are many [https://subtrac.sara.nl/oss/email2trac/wiki/Email2tracConfiguration configuration options] for email2trac, but the following are necessary for email2trac to work properly
    5967{{{
     68 project: C:\projects\trac\environmentname
     69 tmpdir: C:\tmp
     70 ticket_update: 1
     71 python_egg_cache: C:\Python25\Scripts
     72 trac_version: 0.11
     73}}}
     74
     75The tmpdir should already exist.  The trac_version variable is important if you're running trac 0.11 so that you don't receive an error like "str object is not callable".  See [https://subtrac.sara.nl/oss/email2trac/ticket/34] for more information about the background of this one.
    6076 
    6177 == Process Automation ==
    6278
    63 Automation of email processing is dependent upon your email setup. 
     79Automation of email processing is dependent upon your email setup.
     80
     81 === Built-in Windows SMTP server ===
     82
     83 === Fetchmail ===
     84
     85Create a batch file (e.g. email2trac.bat) that calls fetchmail, specifying the path to the fetchmail configuration file and, optionally, a logfile to log the fetchmail process.
     86{{{
     87C:\cygwin\bin\fetchmail -v --fetchmailrc C:/cygwin/path/to/fetchmailrc
     88--logfile c:/projects/email2trac/fetchmail.log
     89}}}
     90
     91Use Windows Scheduled Tasks to run the batch file on an automated basis.
     92
     93Note: This content came from [http://groups.google.com/group/trac-users/browse_thread/thread/6877a04f2d5ff2cb/ a discussion] on the Trac Users Group.  A big thanks to Matthew Carlson for his detailed help.
     94
     95- Nicole Swan (nicole DOT swan AT gmail.com)