← Back to branch summary

~ubuntu-branches/ubuntu/precise/python-django/precise

« back to all changes in this revision

Viewing changes to docs/ref/contrib/gis/deployment.txt

  • Committer: Bazaar Package Importer
  • Author(s): Chris Lamb
  • Date: 2010-05-21 07:52:55 UTC
  • mfrom: (1.1.10 upstream) (4.4.7 sid)
  • Revision ID: james.westby@ubuntu.com-20100521075255-i1zpeyc0k8512pd7
Tags: 1.2-1
New upstream stable release.

Show diffs side-by-side

added added

removed removed

Lines of Context:
docs/ref/contrib/gis/deployment.txt
 
1
===================
 
2
Deploying GeoDjango
 
3
===================
 
4
 
 
5
.. warning::
 
6
 
 
7
    GeoDjango uses the GDAL geospatial library which is
 
8
    not thread safe at this time.  Thus, it is *highly* recommended
 
9
    to not use threading when deploying -- in other words, use a 
 
10
    an appropriate configuration of Apache or the prefork method
 
11
    when using FastCGI through another web server.
 
12
 
 
13
Apache
 
14
======
 
15
In this section there are some example ``VirtualHost`` directives for 
 
16
when deploying using either ``mod_python`` or ``mod_wsgi``.  At this
 
17
time, we recommend ``mod_wsgi``, as it is now officially recommended 
 
18
way to deploy Django applications with Apache.  Moreover, if
 
19
``mod_python`` is used, then a prefork version of Apache must also be
 
20
used.  As long as ``mod_wsgi`` is configured correctly, it does not
 
21
matter whether the version of Apache is prefork or worker.
 
22
 
 
23
.. note::
 
24
 
 
25
    The ``Alias`` and ``Directory`` configurations in the the examples
 
26
    below use an example path to a system-wide installation folder of Django.  
 
27
    Substitute in an appropriate location, if necessary, as it may be
 
28
    different than the path on your system.
 
29
 
 
30
``mod_wsgi``
 
31
------------
 
32
 
 
33
Example::
 
34
 
 
35
    <VirtualHost *:80>
 
36
      WSGIDaemonProcess geodjango user=geo group=geo processes=5 threads=1
 
37
      WSGIProcessGroup geodjango
 
38
      WSGIScriptAlias / /home/geo/geodjango/world.wsgi
 
39
  
 
40
      Alias /media/ "/usr/lib/python2.5/site-packages/django/contrib/admin/media/"
 
41
      <Directory "/usr/lib/python2.5/site-packages/django/contrib/admin/media/">
 
42
        Order allow,deny
 
43
        Options Indexes
 
44
        Allow from all
 
45
        IndexOptions FancyIndexing
 
46
      </Directory>
 
47
    
 
48
    </VirtualHost>
 
49
 
 
50
.. warning::
 
51
 
 
52
    If the ``WSGIDaemonProcess`` attribute ``threads`` is not set to ``1``, then
 
53
    Apache may crash when running your GeoDjango application.  Increase the 
 
54
    number of ``processes`` instead.
 
55
 
 
56
For more information, please consult Django's
 
57
:ref:`mod_wsgi documentation <howto-deployment-modwsgi>`.
 
58
 
 
59
``mod_python``
 
60
--------------
 
61
 
 
62
Example::
 
63
 
 
64
    <VirtualHost *:80>
 
65
    
 
66
      <Location "/">
 
67
        SetHandler mod_python
 
68
        PythonHandler django.core.handlers.modpython
 
69
        SetEnv DJANGO_SETTINGS_MODULE world.settings
 
70
        PythonDebug On
 
71
        PythonPath "['/var/www/apps'] + sys.path"
 
72
      </Location>
 
73
    
 
74
      Alias /media/ "/usr/lib/python2.5/site-packages/django/contrib/admin/media/"
 
75
      <Location "/media">
 
76
        SetHandler None
 
77
      </Location>
 
78
    
 
79
    </VirtualHost>
 
80
 
 
81
.. warning::
 
82
 
 
83
   When using ``mod_python`` you *must* be using a prefork version of Apache, or
 
84
   else your GeoDjango application may crash Apache.
 
85
 
 
86
For more information, please consult Django's
 
87
:ref:`mod_python documentation <howto-deployment-modpython>`.
 
88
 
 
89
Lighttpd
 
90
========
 
91
 
 
92
FastCGI
 
93
-------
 
94
 
 
95
Nginx
 
96
=====
 
97
 
 
98
FastCGI
 
99
-------