From f5fb104c8a30a01d3783f8e2f6dc784e2e672810 Mon Sep 17 00:00:00 2001 From: Edmund von der Burg Date: Thu, 5 Sep 2013 16:42:18 +0100 Subject: Save troubleshooting notes --- notes/trouble_shooting.md | 20 ++++++++++++++++++++ 1 file changed, 20 insertions(+) create mode 100644 notes/trouble_shooting.md (limited to 'notes') diff --git a/notes/trouble_shooting.md b/notes/trouble_shooting.md new file mode 100644 index 000000000..9d8d38f13 --- /dev/null +++ b/notes/trouble_shooting.md @@ -0,0 +1,20 @@ +# Trouble shooting + +## Empty datetime object + + Couldn't render template "index.html: undef error - Can't call method "strftime" without a package or object reference at /var/www/fixmystreet.127.0.0.1.xip.io/fixmystreet/perllib/Utils.pm line 232 + +- You might have a problem with a datefield that has been left empty by one cobrand that another expects to have a value. Inspert the problem table in the database. +- You may have problems being returned by memcached that your database does not have. Restart memcached to rule this out. + +## Wrong cobrand is displaying + +- Make sure that your hostname does not contain anything that another cobrand is matching on. For example if your config is + +``` yaml +ALLOWED_COBRANDS: + - fixmystreet + - zurich +```` + +Then a domain like `zurich.fixmystreet.com` will match `fixmystreet` first and that is the cobrand that will be served. -- cgit v1.2.3 From bf2536092a8f63b1d181696c719f07bca34bbaca Mon Sep 17 00:00:00 2001 From: Edmund von der Burg Date: Fri, 6 Sep 2013 12:48:58 +0100 Subject: Add note about emails not coming through --- notes/trouble_shooting.md | 10 ++++++++++ 1 file changed, 10 insertions(+) (limited to 'notes') diff --git a/notes/trouble_shooting.md b/notes/trouble_shooting.md index 9d8d38f13..f5bfe1f06 100644 --- a/notes/trouble_shooting.md +++ b/notes/trouble_shooting.md @@ -18,3 +18,13 @@ ALLOWED_COBRANDS: ```` Then a domain like `zurich.fixmystreet.com` will match `fixmystreet` first and that is the cobrand that will be served. + +## Account creation emails not arriving + +Your receiving email servers may be rejecting them because: + +* your VM IP address has been blacklisted +* your ISP blocks outgoing connections to port 25 (mobile broadband providers often do this) +* sender verification has failed (applies to `@mysociety.org` servers) - check that your `DO_NOT_REPLY_EMAIL` conf setting passes sender verification (using your own email address works well). + +Perhaps check the entries in `/var/log/mail.log` to check that the message has been sent by the app, and if it has been possible to send them on. -- cgit v1.2.3 From a08ee186f6e9658ac6b0927e012904427729392e Mon Sep 17 00:00:00 2001 From: Edmund von der Burg Date: Fri, 6 Sep 2013 14:59:35 +0100 Subject: Add note about translations not being used --- notes/trouble_shooting.md | 6 ++++++ 1 file changed, 6 insertions(+) (limited to 'notes') diff --git a/notes/trouble_shooting.md b/notes/trouble_shooting.md index f5bfe1f06..d4b6752ae 100644 --- a/notes/trouble_shooting.md +++ b/notes/trouble_shooting.md @@ -28,3 +28,9 @@ Your receiving email servers may be rejecting them because: * sender verification has failed (applies to `@mysociety.org` servers) - check that your `DO_NOT_REPLY_EMAIL` conf setting passes sender verification (using your own email address works well). Perhaps check the entries in `/var/log/mail.log` to check that the message has been sent by the app, and if it has been possible to send them on. + +## Translations not being used + +The locale needs to be installed too or the translations will not be used. Use +`locale -a` to list them all and ensure the one your translation uses is in the +list. -- cgit v1.2.3 From f84f9b04a6364850b5af37a1674309c95b1bac86 Mon Sep 17 00:00:00 2001 From: Edmund von der Burg Date: Mon, 9 Sep 2013 13:23:44 +0100 Subject: Note about running db update script --- notes/trouble_shooting.md | 6 ++++++ 1 file changed, 6 insertions(+) (limited to 'notes') diff --git a/notes/trouble_shooting.md b/notes/trouble_shooting.md index d4b6752ae..7a982ff4b 100644 --- a/notes/trouble_shooting.md +++ b/notes/trouble_shooting.md @@ -34,3 +34,9 @@ Perhaps check the entries in `/var/log/mail.log` to check that the message has b The locale needs to be installed too or the translations will not be used. Use `locale -a` to list them all and ensure the one your translation uses is in the list. + + +## Database connection errors trying to run update-schema + +Make sure that you specify a database host and password in `general.yml`. You +may need to explicitly give your user a password. -- cgit v1.2.3