diff options
| -rw-r--r-- | INSTALL-exim4.txt | 35 | ||||
| -rwxr-xr-x | INSTALL.txt | 39 | ||||
| -rw-r--r-- | app/controllers/application_controller.rb | 2 |
3 files changed, 74 insertions, 2 deletions
diff --git a/INSTALL-exim4.txt b/INSTALL-exim4.txt new file mode 100644 index 000000000..a235d6782 --- /dev/null +++ b/INSTALL-exim4.txt @@ -0,0 +1,35 @@ +As an example of how to set up your MTA, in exim on Ubuntu, you might +add the following to its configuration. + +In /etc/exim4/conf.d/main/04_wdtk_options: + + WDTK_HOME=/path/to/wdtk/software + WDTK_USER=www-data + +In /etc/exim4/conf.d/router/04_wdtk: + + wdtk_request: + debug_print = "R: wdtk for $local_part@$domain" + driver = redirect + data = ${lookup{$local_part}wildlsearch{WDTK_HOME/config/aliases}} + pipe_transport = wdtk_mailin_transport + +In /etc/exim4/conf.d/transport/04_wdtk: + + wdtk_mailin_transport: + driver = pipe + command = $address_pipe ${lc:$local_part} + current_directory = WDTK_HOME + home_directory = WDTK_HOME + user = WDTK_USER + group = WDTK_USER + +And, assuming you set OPTION_INCOMING_EMAIL_PREFIX to "foi+", this in +config/aliases: + + ^foi\+request-.*: |/path/to/wdtk/software/script/mailin + +Finally, make sure you have `dc_use_split_config='true'` in +/etc/exim4/update-exim4.conf.conf, and execute the command +`update-exim4.conf` + diff --git a/INSTALL.txt b/INSTALL.txt index 066199105..e67ae89c9 100755 --- a/INSTALL.txt +++ b/INSTALL.txt @@ -7,7 +7,7 @@ These instructions are based on getting the FOI site up and running on Ubuntu and/or Debian. -It was last run using the Hardy Heron version of Ubuntu and on the +It was last run using the Lucid Lynx version of Ubuntu and on the Parallels debian instance (2.6.18-4-686). Commands are intended to be run via the terminal or over ssh. @@ -144,3 +144,40 @@ level 'super'). behaviour. And send us the patch! +7. Set up configs +----------------- + +copy config/general-example to config/general and edit to your taste. + +8. Mailer setup +--------------- + +When an authority receives an email, its reply-to address is a magic +email which is parsed and consumed by the Rails app. + +Currently, this is done by calling script/mailin and piping in the raw +email. You will need to configure your MTA to accept emails to magic addresses, and to pipe such emails to this script. + +Magic email addresses are of the form: + + <foi+request-3-691c8388@example.com> + +The respective parts of this address are controlled with options in +options/general, thus: + + $OPTION_INCOMING_EMAIL_PREFIX = 'foi+' + $OPTION_INCOMING_EMAIL_DOMAIN = 'example.com' + +INSTALL-exim.txt describes one possible configuration for Exim 1.9. + +When you set up your MTA, note that if there is some error inside +Rails, the email is returned with an exit code 75, which for Exim at +least means the MTA will try again later. Additionally, a stacktrace +is emailed to $OPTION_CONTACT_EMAIL. + +A well-configured installation of this code will separately have had +Exim make a backup copy of the email in a separate mailbox, just in +case. + +This setup isn't very scaleable, as it spawns a new Ruby process for +each email received; patches welcome! diff --git a/app/controllers/application_controller.rb b/app/controllers/application_controller.rb index f6f99573e..8af2af528 100644 --- a/app/controllers/application_controller.rb +++ b/app/controllers/application_controller.rb @@ -213,7 +213,7 @@ class ApplicationController < ActionController::Base # def check_read_only - read_only = MySociety::Config.get('READ_ONLY', nil) + read_only = MySociety::Config.get('READ_ONLY', '') if !read_only.empty? flash[:notice] = "<p>WhatDoTheyKnow is currently in maintenance. You can only view existing requests. You cannot make new ones, add followups or annotations, or otherwise change the database.</p> <p>" + read_only + "</p>" redirect_to frontpage_url |