Skip to content

Commit

Permalink
Fixed #14133 -- Updated Windows installation instructions for GeoDjan…
Browse files Browse the repository at this point in the history 
…go, now recommend the OSGeo4W installer for spatial libraries.

git-svn-id: http://code.djangoproject.com/svn/django/trunk@15872 bcc190cf-cafb-0310-a4f2-bffc1f526a37
  • Loading branch information
@jbronn
jbronn committed Mar 17, 2011
1 parent 6091f0e commit c70bdad
Show file tree
Hide file tree
Showing 2 changed files with 118 additions and 54 deletions.
8 changes: 8 additions & 0 deletions docs/ref/contrib/gis/geodjango_setup.bat
View file
Original file line number Original file line Diff line number Diff line change
@@ -0,0 +1,8 @@
set OSGEO4W_ROOT=C:\OSGeo4W
set PYTHON_ROOT=C:\Python27
set GDAL_DATA=%OSGEO4W_ROOT%\share\gdal
set PROJ_LIB=%OSGEO4W_ROOT%\share\proj
set PATH=%PATH%;%PYTHON_ROOT%;%OSGEO4W_ROOT%\bin
reg ADD "HKLM\SYSTEM\CurrentControlSet\Control\Session Manager\Environment" /v Path /t REG_EXPAND_SZ /f /d "%PATH%"
reg ADD "HKLM\SYSTEM\CurrentControlSet\Control\Session Manager\Environment" /v GDAL_DATA /t REG_EXPAND_SZ /f /d "%GDAL_DATA%"
reg ADD "HKLM\SYSTEM\CurrentControlSet\Control\Session Manager\Environment" /v PROJ_LIB /t REG_EXPAND_SZ /f /d "%PROJ_LIB%"
164 changes: 110 additions & 54 deletions docs/ref/contrib/gis/install.txt
View file
Original file line number Original file line Diff line number Diff line change
Expand Up @@ -1093,101 +1093,159 @@ Debian 5.0 . Thus when :ref:`spatialdb_template` either:


.. _windows: .. _windows:


Windows XP Windows
---------- -------

Proceed through the following sections sequentially in order to install
GeoDjango on Windows.

.. note::

These instructions assume that you are using 32-bit versions of
all programs. While 64-bit versions of Python and PostgreSQL 9.0
are available, 64-bit versions of spatial libraries, like
GEOS and GDAL, are not yet provided by the :ref:`OSGeo4W` installer.


Python Python
^^^^^^ ^^^^^^


First, download the `Python 2.6 installer`__ from the Python Web site. Next, First, download the latest `Python 2.7 installer`__ from the Python Web site.
execute the installer and use defaults, e.g., keep 'Install for all users' Next, run the installer and keep the defaults -- for example, keep
checked and the installation path set as ``C:\Python26``. 'Install for all users' checked and the installation path set as
``C:\Python27``.


.. note:: .. note::


You may already have a version of Python installed in ``C:\python`` as ESRI You may already have a version of Python installed in ``C:\python`` as ESRI
products sometimes install a copy there. *You should still install a products sometimes install a copy there. *You should still install a
fresh version of Python 2.6.* fresh version of Python 2.7.*


__ http://python.org/ftp/python/2.6.2/python-2.6.2.msi __ http://python.org/download/


PostgreSQL PostgreSQL
^^^^^^^^^^ ^^^^^^^^^^


First, select a mirror and download the latest `PostgreSQL 8.3 installer`__ from First, download the latest `PostgreSQL 9.0 installer`__ from the
the EnterpriseDB Web site. `EnterpriseDB`__ Web site. After downloading, simply run the installer,
follow the on-screen directions, and keep the default options unless
you know the consequences of changing them.


.. note:: .. note::


PostgreSQL 8.3 is required because PostGIS is not available yet for 8.4. The PostgreSQL installer creates both a new Windows user to be the
'postgres service account' and a ``postgres`` database superuser
You will be prompted once to set the password for both accounts --
make sure to remember it!


After downloading, simply click on the installer, follow the When the installer completes, it will ask to launch the Application Stack
on-screen directions, and keep the default options (e.g., keep the installation Builder (ASB) on exit -- keep this checked, as it is necessary to
path as ``C:\Program Files\PostgreSQL\8.3``). install :ref:`postgisasb`.


.. note:: .. note::


This PostgreSQL installation process will create both a new windows user to be the If installed successfully, the PostgreSQL server will run in the
'postgres service account' and a special 'postgres superuser' to own the database background each time the system as started as a Windows service.
cluster. You will be prompted to set a password for both users (make sure to write A :menuselection:`PostgreSQL 9.0` start menu group will created
them down!). To see basic details on the 'service user' account right click on and contains shortcuts for the ASB as well as the 'SQL Shell',
'My Computer' and select 'Manage' or go to: Control Panel -> Administrative Tools -> which will launch a ``psql`` command window.
Computer Management -> System Tools -> Local Users and Groups.


If installed successfully, the PostgreSQL server will run in the background each time __ http://www.enterprisedb.com/products-services-training/pgdownload
the system as started as a Windows service. When finished, the installer should launch __ http://www.enterprisedb.com
the Application Stack Builder (ASB) -- use this to install PostGIS, see instructions
below for more details. A 'PostgreSQL 8.3' start menu group should be created that
contains shortcuts for the ASB and 'Command Prompt', which launches a terminal window
in the PostgreSQL directory.


__ http://www.enterprisedb.com/products/pgdownload.do#windows .. _postgisasb:


PostGIS PostGIS
^^^^^^^ ^^^^^^^


From the Application Stack Builder (Programs -> PostgreSQL 8.3), select From within the Application Stack Builder (to run outside of the installer,
'PostgreSQL Database Server 8.3 on port 5432' from the drop down menu. Next, :menuselection:`Start --> Programs --> PostgreSQL 9.0`), select
select 'PostGIS 1.3.6 for PostgreSQL 8.3' from the 'Spatial Extensions' tree :menuselection:`PostgreSQL Database Server 9.0 on port 5432` from the drop down
in the list. Select only the default options during install (do not uncheck menu. Next, expand the :menuselection:`Categories --> Spatial Extensions` menu
the option to create a default PostGIS database). tree and select :menuselection:`PostGIS 1.5 for PostgreSQL 9.0`.

After clicking next, you will be prompted to select your mirror, PostGIS
will be downloaded, and the PostGIS installer will begin. Select only the
default options during install (e.g., do not uncheck the option to create a
default PostGIS database).


.. note:: .. note::


You will be prompted to enter your 'postgres superuser' password in the You will be prompted to enter your ``postgres`` database superuser
'Database Connection Information' dialog. password in the 'Database Connection Information' dialog.


psycopg2 psycopg2
^^^^^^^^ ^^^^^^^^


The ``psycopg2`` Python module provides the interface between Python and the The ``psycopg2`` Python module provides the interface between Python and the
PostgreSQL database. Download the `Windows installer`__ (v2.0.10) and run PostgreSQL database. Download the latest `Windows installer`__ for your version
using the default settings. [#]_ of Python and PostgreSQL and run using the default settings. [#]_


__ http://www.stickpeople.com/projects/python/win-psycopg/psycopg2-2.0.10.win32-py2.6-pg8.3.7-release.exe __ http://www.stickpeople.com/projects/python/win-psycopg/


GeoDjango Installer .. _osgeo4w:
^^^^^^^^^^^^^^^^^^^


Download the `GeoDjango Installer`__; this was created [#]_ to simplify the rest OSGeo4W
of the process for installing GeoDjango on Windows platforms. The installer ^^^^^^^
automatically installs Django 1.1, GDAL 1.6.0, PROJ 4.6.1 (including datum grid
files), and configures the necessary environment variables. The `OSGeo4W installer`_ makes it simple to install the PROJ.4, GDAL, and GEOS
libraries required by GeoDjango. First, download the `OSGeo4W installer`_,
and run it. Select :menuselection:`Express Web-GIS Install` and click next.
In the 'Select Packages' list, ensure that GDAL is selected; MapServer and
Apache are also enabled by default, but are not required by GeoDjango and
may be unchecked safely. After clicking next, the packages will be
automatically downloaded and installed, after which you may exit the
installer.

.. _OSGeo4W installer: http://trac.osgeo.org/osgeo4w/

Modify Windows Environment
^^^^^^^^^^^^^^^^^^^^^^^^^^

In order to use GeoDjango, you will need to add your Python and OSGeo4W
directories to your Windows system ``Path``, as well as create ``GDAL_DATA``
and ``PROJ_LIB`` environment variables. The following set of commands,
executable with ``cmd.exe``, will set this up::

set OSGEO4W_ROOT=C:\OSGeo4W
set PYTHON_ROOT=C:\Python27
set GDAL_DATA=%OSGEO4W_ROOT%\share\gdal
set PROJ_LIB=%OSGEO4W_ROOT%\share\proj
set PATH=%PATH%;%PYTHON_ROOT%;%OSGEO4W_ROOT%\bin
reg ADD "HKLM\SYSTEM\CurrentControlSet\Control\Session Manager\Environment" /v Path /t REG_EXPAND_SZ /f /d "%PATH%"
reg ADD "HKLM\SYSTEM\CurrentControlSet\Control\Session Manager\Environment" /v GDAL_DATA /t REG_EXPAND_SZ /f /d "%GDAL_DATA%"
reg ADD "HKLM\SYSTEM\CurrentControlSet\Control\Session Manager\Environment" /v PROJ_LIB /t REG_EXPAND_SZ /f /d "%PROJ_LIB%"

For your convenience, these commands are available in the execuatble batch
script, :download:`geodjango_setup.bat`.

.. note::


Once the installer has completed, log out and log back in so that the Administrator privileges are required to execute these commands.
modifications to the system environment variables take effect, and you To do this, right-click on :download:`geodjango_setup.bat` and select
should be good to go. :menuselection:`Run as administrator`. You need to log out and log back in again
for the settings to take effect.


.. note:: .. note::


The installer modifies the system ``Path`` environment variable to If you customized the Python or OSGeo4W installation directories,
include ``C:\Program Files\PostgreSQL\8.3\bin`` and then you will need to modify the ``OSGEO4W_ROOT`` and/or ``PYTHON_ROOT``
``C:\Program Files\GeoDjango\bin``. This is required so that Python variables accordingly.
may find the GEOS DLL provided by PostGIS and the GDAL DLL provided
by the installer. The installer also sets the ``GDAL_DATA`` and Install Django and Setup Database
``PROJ_LIB`` environment variables. ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

Finally, :ref:`install Django <installing-official-release>` on your system.
You do not need to create a spatial database template, as one named
``template_postgis`` is created for you when installing PostGIS.

To administer the database, you can either use the pgAdmin III program
(:menuselection:`Start --> PostgreSQL 9.0 --> pgAdmin III`) or the
SQL Shell (:menuselection:`Start --> PostgreSQL 9.0 --> SQL Shell`).
For example, to create a ``geodjango`` spatial database and user, the following
may be executed from the SQL Shell as the ``postgres`` user::


__ http://geodjango.org/windows/GeoDjango_Installer.exe postgres# CREATE USER geodjango PASSWORD 'my_passwd';
postgres# CREATE DATABASE geodjango OWNER geodjango TEMPLATE template_postgis ENCODING 'utf8';


.. rubric:: Footnotes .. rubric:: Footnotes
.. [#] The datum shifting files are needed for converting data to and from certain projections. .. [#] The datum shifting files are needed for converting data to and from certain projections.
Expand All @@ -1200,5 +1258,3 @@ __ http://geodjango.org/windows/GeoDjango_Installer.exe
routine from ``ctypes.util`` to locate shared libraries. routine from ``ctypes.util`` to locate shared libraries.
.. [#] The ``psycopg2`` Windows installers are packaged and maintained by .. [#] The ``psycopg2`` Windows installers are packaged and maintained by
`Jason Erickson <http://www.stickpeople.com/projects/python/win-psycopg/>`_. `Jason Erickson <http://www.stickpeople.com/projects/python/win-psycopg/>`_.
.. [#] The source code for the installer is available in the `nsis_installer <http://geodjango.org/hg/nsis_installer/>`_
GeoDjango mercurial repository.

0 comments on commit c70bdad

Please sign in to comment.