blob: 2ebbd17cce041d97e743b03f0079998fb8216bb0 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
|
=head1 NAME
FixMyStreet
=head1 ABOUT
FixMyStreet is a project that allows anyone to report an issue such as potholes,
broken street lights, severe littering, water leaks. These issues are then
routed to the correct body who can arrange to have them fixed. By default it
supports routing problems via email or using an Open311 WebService.
It's written in Perl and uses the Catalyst web framework.
=head1 QUICKSTART
=over
=item *
Install PostgreSQL and the PostGIS extension
=item *
Create a new PostGIS enabled database
=item *
Download latest version from [THIS BIT TODO]
=item *
Untar this in the vhost location [TODO - more detail here]
=item *
Run db/schema.sql and the db/alert_types.sql
=item *
Run ./bin/cron-wrapper ./perl-external/bin/module-manage.pl setup
=item *
Create a new Apache vhost based on conf/httpd-conf.example
=item *
Copy conf/general-example to conf/general and update accordingly [FIXME!]
=item *
Restart apache
=back
=head1 DOWNLOADING
Download from [URL GOES HERE]
or get the latest version from github: http://github.com/mysociety/fixmystreet
=head1 REQUIREMENTS
On the server you are installing FixMyStreet on you will need the following things:
=over
=item *
PostgreSQL and the PostGis extension
=item *
Perl 5.8+
=item *
ImageMagick and the perl bindings
=item *
A webserver that supports FastCGI
=back
For most uses of FixMyStreet you'll also need access to a MaPit server with
data for the types of bodies you are reporting issues to. For more details on
how to install MaPit see [TODO: MaPit URL GOES HERE]
=head1 DETAILED INSTALLATION INSTRUCTIONS
=head2 Creating the database
Notes about PostGIS templates go here
=head2 Unpacking the Code
Create directory for vhost, unpack there.
=head2 Set up the database
Run db/schema.sql and the db/alert_types.sql
=head2 Install Perl modules
There are many CPAN dependencies that should be dealt with using
module-manage.pl which takes care of fetching specific versions of packages
from CPAN and building them. To install all the CPAN packages needed:
eval `./setenv.pl`
module-manage.pl setup
Look in the perl-external directory for details. Notably the following are important:
=over
=item urls.txt
url to the specific packages to fetch
=item modules.txt
list of all modules that need to be built
=item minicpan/
local subset of cpan - used as source for all packages
=item local-lib
where the cpan modules get built to
=item lib
some initial modules needed for bootstrap
=item bin
scripts to make it all work
=back
Read the perl-external/bin/module-manage.pl code to see how it all works. It is
basically a wrapper around cpanm (which builds the packages) and dpan (which
helps maintain the fake cpan subset).
If you need to add a module do it using:
module-manage.pl add Module::To::Add
and it will update all the relevant bits.
=head2 Set up Webserver
It is recommended that you run FixMyStreet using FastCGI. It should also be
possible to run it using Plack/PSGI.
There is an example Apache vhost configuration file on conf/httpd.conf-example
which you can copy and update the paths in if you are running FixMyStreet under
FastCGI.
=head1 SETTINGS
The settings for FixMyStreet are in conf/general which is actually a PHP file.
There are some defaults in conf/general-example which you should copy to
conf/general.
The bare minimum of settings you will need to fill in or update are:
=over
=item OPTION_BCI_DB_PASS
This is the password for the database.
=item OPTION_BASE_URL
The URL for the homepage of your FixMyStreet install.
=item OPTION_EMAIL_DOMAIN
The email domain that emails will be sent from
=item OPTION_CONTACT_EMAIL
The email address to be used on the site for the contact us form.
=item OPTION_STAGING_SITE
If this is 1 then all email ( alerts and reports ) will be sent to the
contact email address. Use this for development sites.
=item OPTION_UPLOAD_CACHE
This is the location where imaged will be stored as they are being uploaded.
It should be accessible by and writeable by the FixMyStreet process.
=item OPTION_GEO_CACHE
This is the location where Geolocation data will be cached.
It should be accessible by and writeable by the FixMyStreet process.
If you are using Bing or Google maps you should also set one of
OPTION_BING_MAPS_API_KEY or OPTION_GOOGLE_MAPS_API_KEY.
If you are using a MaPit install you should update OPTION_MAPIT_URL.
=head1 COMMON PROBLEMS
=head2 CPAN MODULE PROBLEMS
Currently, you probably need to add EncodedColumn manually:
module-manage.pl add DBIx::Class::EncodedColumn
...because it's explicitly overridden in the code, which is fooling the installer.
If a module won't build (Test::WWW::Mechanize and HTTP::Server::Simple fail
tests for me but the failures are not pertinent) then the module-manage script
will bail out. Look in ~/.cpanm/build_log to see what went wrong. You can force
an install if the test failures are not important by running cpanm directly:
cpanm \
--mirror /absolute/path/to/perl-external/minicpan \
--mirror-only \
--force \
Test::WWW::Mechanize
|