| 37 | | |
| 38 | | == Installation and Configuration == |
| 39 | | |
| 40 | | The email2trac package contains the following utilities: |
| 41 | | '''email2trac.py''':: |
| 42 | | Converts an email to ticket. Reads a config file email2trac.conf |
| 43 | | '''run_email2trac.c''':: |
| 44 | | Suid program that changes the MTA-user to the TRAC-user so that we can |
| 45 | | save attachments |
| 46 | | '''delete_spam.py''':: |
| 47 | | A small program that deletes the SPAM tickets from the database |
| 48 | | '''email2trac.conf''':: |
| 49 | | Is read by email2trac.py to set the various options. This are the options: |
| 50 | | |
| 51 | | || NAME || VALUE || Explanation || |
| 52 | | || [!DEFAULT] || || REQUIRED || |
| 53 | | || project: || /data/trac/jouvin || REQUIRED || |
| 54 | | || debug: || 1 || OPTIONAL, if set print some DEBUG info || |
| 55 | | || spam_level: || 4 || OPTIONAL, if set check for SPAM mail || |
| 56 | | || drop_spam: || 0 || OPTIONAL:, if set then reject mail marked as SPAM || |
| 57 | | || reply_all: || 1 || OPTIONAL, if set then put all CC-addresses in ticket CC-field || |
| 58 | | || umask: || 022 || OPTIONAL, Use this umask for saving attachments || |
| 59 | | || mailto_link: || 1 || OPTIONAL, if set then {{{[mailto:CC]}}} in description || |
| 60 | | || mailto_cc: || ticket@test.nl || OPTIONAL, Use ths address as CC in mailto line || |
| 61 | | || ticket_update: || 1 || OPTIONAL, if set then check if this is an update for a ticket || |
| 62 | | || email_header: || 1 || OPTIONAL, if set then show TO/CC fields in description|| |
| 63 | | || trac_version: || 0.9 || OPTIONAL. if set then use this as version number, default 0.9 |
| 64 | | || alternate_notify_template || a_ticket.css || OPTIONAL if set then use this style sheet for notify || |
| 65 | | || enable_syslog || 1 || OPTIONAL, if set log errors to syslog, note they are ''not'' mailed back to the reporter || |
| 66 | | |
| 67 | | || || || |
| 68 | | || || || |
| 69 | | || [bas] || || OPTIONAL project declaration, also set project and use --project option || |
| 70 | | || project:|| /data/trac/bas || || |
| 71 | | || spam_level:|| 2 || Override DEFAULT spam_level, can also be done for other options || |
| 72 | | |
| 73 | | |
| 74 | | === Installation and Configuration === |
| 75 | | |
| 76 | | After installation, edit email2trac.conf for your site. Most important |
| 77 | | parameter is project, see above |
| 78 | | |
| 79 | | If you have enabled 'ticket_update' in email2trac.conf then you have |
| 80 | | to choose one of this options to make it work: |
| 81 | | * Configure trac notification, eg: |
| 82 | | {{{ |
| 83 | | (ticket address: ticket@test.nl) |
| 84 | | [notification] |
| 85 | | smtp_enabled = true |
| 86 | | smtp_always_cc = test@test.nl |
| 87 | | smtp_server = localhost |
| 88 | | smtp_from = ticket@test.nl |
| 89 | | always_notify_reporter = true |
| 90 | | }}} |
| 91 | | * Use the mailto_cc in email2trac.conf if you want to send an email to the ticket email address. |
| 92 | | |
