source: subversion/sites/other/tilesAtHome_tahngo/docs/INSTALL @ 8859

Last change on this file since 8859 was 8859, checked in by spaetz, 12 years ago

finetune install instructions

File size: 3.0 KB
Line 
1PREREQUISITES
2-------------
3python (2.4 works) and django (0.96 works) need to be installed on the host. Depending on the database chosen, a python-mysql or python-sqlite module might be necessary too.
4
5INSTALLATION
6------------
7- Download the main directory and put it in a location of your choice, eg. /usr/local/share.
8- The "Tiles" directory should be moved to the place where you want to store all the tileset files. The setting "base_tile_path" should point to this directory as it will save tileset files here and expect the stock images (blank sea/land/error) here.
9- The "media" directory contains files that should be accessible through the web server and should be moved to a place where the files can be served through apache. I think the setting MEDIA_URL in tah.settings needs to point to one directory below "media".
10- Adapt the settings in tah.settings to your configuration (database choice, url handler, etc)
11- Run "python manage.py syncdb" to create the database
12- Open the /admin interface and add the settings "base_tile_path", "unzipPath","logFile" to the table Settings.
13  In the case of tah.osm.org these settings are "/mnt/agami/openstreetmap/tah/Tiles", "/tmp", and "tah.log" respectively.
14- in tah_intern/serve_tiles.py the base_tile_path is hardcoded for efficiency reasons. Open that file and adapt the path there too.
15- tah_intern/views.py currently contains a hardcoded path to the log file location. Adapt the line:   f = open('/home/spaetz/tah/tah_intern/tah.log', 'rU')
16APACHE CONFIGURATION
17--------------------
18The following snippet was sufficient in the apache vhost configuration to make it work. If the main apache config cannot be modified it worked to have the stuff in a .htaccess file in the corresponding directories too.
19        <Location />
20                SetHandler python-program
21                PythonHandler django.core.handlers.modpython
22                SetEnv DJANGO_SETTINGS_MODULE tah.settings
23                #adapt next line to whatever your install base directory is
24                PythonPath "['/usr/local/share/'] + sys.path"
25                #PythonAutoReload Off
26                PythonDebug Off
27        </Location>
28        <Location /media>
29                SetHandler None
30        </Location>
31        <Location /Tiles>
32                SetHandler python-program
33                #adapt next line to whatever your install base directory is
34                PythonPath "['/usr/local/share/'] + sys.path"
35                PythonHandler  tah.tah_intern.serve_tiles
36                #PythonAutoReload Off
37                PythonDebug Off
38        </Location>
39
40USAGE
41-----
42t@h clients can connect to the server without explicitely creating an account. If clients are configured with their
43OpenStreetMap account email (display user name will not work for account creation, but should work as username afterwards, although there is no reason to prefer that to the email) and regular OSM password, the account will be automatically created.
44Passwords are cached in a hashed form on the t@h server, so subsequent OpenStreetMap Email or Password changes will not be automatically propagate to the t@h server. In case of a wrong password, the server tries to refetch the password from OpenStreetMap, so password changes (should theoretically) be possible.
Note: See TracBrowser for help on using the repository browser.