= WORK IN PROGRESS = = Email2trac on Windows = Using email2trac on Windows requires three components -- A way to receive/gather email, the email2trac script, and a script or batch file that will schedule email2trac to process emails (i.e. automate the process). == Email component == 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. === Built-in Windows SMTP server === Install the SMTP server (NOT the POP server), so that emails are received and left as files in the "drop" folder. This is the way the email server hands off email between the two services. In a way, email2trac performs the distribution functions normally handled by POP. To install the SMTP service via Windows Components: * Open Add/Remove Programs (Start->Control Panel->Add or Remove Programs) * Click Add/Remove Windows Components in the left-hand bar. Use the "Details..." button to drill into Application Server->Internet Information Services (IIS)->SMTP Service. * Check the box next to SMTP Service, click "OK", "OK", "Next", "Finish". If any additional configuration is needed, configuration can be done in the IIS Manager (Start->Control Panel->Admistrative Tools->Internet Information Services (IIS) Manager). Sample configuration of "Default SMTP Virtual Server": * Domain Name: trac-server.domain.com * Type: Local (Default) * Drop folder: C:\Inetpub\mailroot\Drop (.eml files) * Email address: xxx@trac-server.domain.com In this configuration, anything sent to the email address with the trac-server subdomain should be automatically forwarded from the email server to the local SMTP server. If your Trac email address is formatted differently or is not forwarded automatically, you will need to configure your main email server to do so. === Fetchmail === [http://fetchmail.berlios.de/fetchmail-man.html Fetchmail] requires [http://cygwin.com Cygwin], a Linux-emulation layer, to operate on Windows. Cygwin installation is straight forward as is adding the fetchmail package, but [http://lifehacker.com Lifehacker's] [http://lifehacker.com/software/top/geek-to-live--introduction-to-cygwin-part-i-179514.php Introduction to Cygwin] and [http://lifehacker.com/software/gmail/geek-to-live--back-up-gmail-with-fetchmail-235207.php Fetchmail] articles are very helpful tutorials for getting Cygwin installed and adding the fetchmail package. Fetchmail options can be set in the command line or using a .fetchmailrc configuration file, .fetchmailrc. Sample .fetchmailrc file: {{ poll mail.domain.com with proto IMAP, auth ntlm user "trac@domain.com" with password "xxx" is trac here options keep mda "C:/python25/python.exe C:/projects/email2trac/email2trac.py" }} Note that in this setup, email2trac acts as the MDA (or MTA) and automatically processes mail as it is retrieved. == Email2trac Script Setup == == Process Automation == Automation of email processing is dependent upon your email setup.