innov
/
django1
1
0
Fork 0
Code Issues Pull Requests 1 Projects Releases Wiki Activity

[3.1.x] Fixed #30933 -- Updated instructions for installing GeoDjango on Windows. 

Backport of 7f4db2d82b from master
This commit is contained in:
David Smith 2020-06-10 21:00:15 +01:00 committed by Carlton Gibson
parent 58f7d7c9fd
commit 928f6a90e4
1 changed files with 61 additions and 60 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

121
docs/ref/contrib/gis/install/index.txt
View File

@ -374,39 +374,38 @@ Windows
------- -------
Proceed through the following sections sequentially in order to install Proceed through the following sections sequentially in order to install
GeoDjango on Windows. GeoDjango on Windows. In this tutorial we will install 64 bit versions of each
application.
Python Python
~~~~~~ ~~~~~~
:doc:`Install Python </howto/windows>`. Install a 64 bit version of Python. See :doc:`Install Python </howto/windows>`
for further information.
PostgreSQL PostgreSQL
~~~~~~~~~~ ~~~~~~~~~~
First, download the latest `PostgreSQL 9.x installer`__ from the Download the latest `PostgreSQL 12.x installer`__ from the
`EnterpriseDB`__ website. After downloading, run the installer, follow the `EnterpriseDB`__ website. After downloading, run the installer, follow the
on-screen directions, and keep the default options unless you know the on-screen directions, and keep the default options unless you know the
consequences of changing them. consequences of changing them.
.. note:: .. note::
The PostgreSQL installer creates both a new Windows user to be the The PostgreSQL installer creates a new ``postgres`` database superuser
'postgres service account' and a ``postgres`` database superuser You will be prompted once to set the password -- make sure to remember it!
You will be prompted once to set the password for both accounts --
make sure to remember it!
When the installer completes, it will ask to launch the Application Stack When the installer completes, it will ask to "Launch Stack Builder at exit?" --
Builder (ASB) on exit -- keep this checked, as it is necessary to keep this checked, as it is necessary to install :ref:`postgisasb`.
install :ref:`postgisasb`.
.. note:: .. note::
If installed successfully, the PostgreSQL server will run in the If installed successfully, the PostgreSQL server will run in the background
background each time the system as started as a Windows service. each time the system as started as a Windows service. A
A :menuselection:`PostgreSQL 9.x` start menu group will created :menuselection:`PostgreSQL 12` start menu group will created and contains
and contains shortcuts for the ASB as well as the 'SQL Shell', shortcuts for the Application Stack Builder (ASB) as well as the
which will launch a ``psql`` command window. 'SQL Shell', which will launch a ``psql`` command window.
__ https://www.enterprisedb.com/downloads/postgres-postgresql-downloads __ https://www.enterprisedb.com/downloads/postgres-postgresql-downloads
__ https://www.enterprisedb.com __ https://www.enterprisedb.com
@ -416,85 +415,87 @@ __ https://www.enterprisedb.com
PostGIS PostGIS
~~~~~~~ ~~~~~~~
From within the Application Stack Builder (to run outside of the installer, From within the Stack Builder (to run outside of the installer,
:menuselection:`Start --> Programs --> PostgreSQL 9.x`), select :menuselection:`Start --> PostgreSQL 12 --> Application Stack Builder`), select
:menuselection:`PostgreSQL Database Server 9.x on port 5432` from the drop down :menuselection:`PostgreSQL 12 (x64) on port 5432` from the drop down
menu. Next, expand the :menuselection:`Categories --> Spatial Extensions` menu menu and click next. Expand the
tree and select :menuselection:`PostGIS X.Y for PostgreSQL 9.x`. :menuselection:`Categories --> Spatial Extensions` menu tree and select
:menuselection:`PostGIS X.Y for PostgreSQL 12`.
After clicking next, you will be prompted to select your mirror, PostGIS After clicking next, you will be prompted to confirm the selected package and
will be downloaded, and the PostGIS installer will begin. Select only the "Download directory". Click next again, this will download PostGIS and you will
default options during install (e.g., do not uncheck the option to create a be asked to click next to begin the PostGIS installer. Select the default
default PostGIS database). options during install. The install process includes three Yes/No dialog boxes,
the default option for all three is "No".
.. note::
You will be prompted to enter your ``postgres`` database superuser
password in the 'Database Connection Information' dialog.
psycopg2
~~~~~~~~
The ``psycopg2`` Python module provides the interface between Python and the
PostgreSQL database. Download the latest `Windows installer`__ for your version
of Python and PostgreSQL and run using the default settings. [#]_
__ http://www.stickpeople.com/projects/python/win-psycopg/
.. _osgeo4w: .. _osgeo4w:
OSGeo4W OSGeo4W
~~~~~~~ ~~~~~~~
The `OSGeo4W installer`_ helps to install the PROJ.4, GDAL, and GEOS libraries The `OSGeo4W installer`_ helps to install the PROJ, GDAL, and GEOS libraries
required by GeoDjango. First, download the `OSGeo4W installer`_, and run it. required by GeoDjango. First, download the `OSGeo4W installer`_ (64bit), and
Select :menuselection:`Express Web-GIS Install` and click next. In the 'Select run it. Select :menuselection:`Express Web-GIS Install` and click next. In the
Packages' list, ensure that GDAL is selected; MapServer and Apache are also 'Select Packages' list, ensure that GDAL is selected; MapServer is also enabled
enabled by default, but are not required by GeoDjango and may be unchecked by default, but is not required by GeoDjango and may be unchecked safely. After
safely. After clicking next, the packages will be automatically downloaded and clicking next and accepting the license agreements, the packages will be
installed, after which you may exit the installer. automatically downloaded and installed, after which you may exit the installer.
.. _OSGeo4W installer: https://trac.osgeo.org/osgeo4w/ .. _OSGeo4W installer: https://trac.osgeo.org/osgeo4w/
Modify Windows environment Modify Windows environment
~~~~~~~~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~~~~~~~~~
In order to use GeoDjango, you will need to add your Python and OSGeo4W In order to use GeoDjango, you will need to add your OSGeo4W
directories to your Windows system ``Path``, as well as create ``GDAL_DATA`` directories to your Windows system ``Path``, as well as create ``GDAL_DATA``
and ``PROJ_LIB`` environment variables. The following set of commands, and ``PROJ_LIB`` environment variables. The following set of commands,
executable with ``cmd.exe``, will set this up: executable with ``cmd.exe``, will set this up. Restart your device
once this is complete for new environment variables to be recognized:
.. code-block:: bat .. code-block:: bat
set OSGEO4W_ROOT=C:\OSGeo4W set OSGEO4W_ROOT=C:\OSGeo4W64
set PYTHON_ROOT=C:\Python3X
set GDAL_DATA=%OSGEO4W_ROOT%\share\gdal set GDAL_DATA=%OSGEO4W_ROOT%\share\gdal
set PROJ_LIB=%OSGEO4W_ROOT%\share\proj set PROJ_LIB=%OSGEO4W_ROOT%\share\proj
set PATH=%PATH%;%PYTHON_ROOT%;%OSGEO4W_ROOT%\bin set PATH=%PATH%;%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 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 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%" reg ADD "HKLM\SYSTEM\CurrentControlSet\Control\Session Manager\Environment" /v PROJ_LIB /t REG_EXPAND_SZ /f /d "%PROJ_LIB%"
.. note:: .. note::
Administrator privileges are required to execute these commands. This assumes 64bit version of OSGeo4W is installed. If you have installed
To do this, create a ``bat`` script with the commands, right-click it, and the 32bit version you will need to change the first command to
select :menuselection:`Run as administrator`. You need to log out and log ``set OSGEO4W_ROOT=C:\OSGeo4W``.
back in again for the settings to take effect.
.. note:: .. note::
If you customized the Python or OSGeo4W installation directories, Administrator privileges are required to execute these commands.
then you will need to modify the ``OSGEO4W_ROOT`` and/or ``PYTHON_ROOT`` To do this, run command prompt as administrator and enter the commands
variables accordingly. above. You need to log out and log back in again for the settings to take
effect.
.. note::
If you customized the OSGeo4W installation directories, then you will need
to modify the ``OSGEO4W_ROOT`` variables accordingly.
Install Django and set up database Install Django and set up database
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Finally, :ref:`install Django <installing-official-release>` on your system. :ref:`install Django <installing-official-release>` on your system. It is
recommended that you create a :doc:`virtural environment
<python:tutorial/venv>` for each project you create.
psycopg2
~~~~~~~~
The ``psycopg2`` Python module provides the interface between Python and the
PostgreSQL database. ``psycopg2`` can be installed via pip within your Python
virtual environment::
pip install psycopg2
.. rubric:: Footnotes .. rubric:: Footnotes
.. [#] GeoDjango uses the :func:`~ctypes.util.find_library` routine from .. [#] GeoDjango uses the :func:`~ctypes.util.find_library` routine from
``ctypes.util`` to locate shared libraries. ``ctypes.util`` to locate shared libraries.
.. [#] The ``psycopg2`` Windows installers are packaged and maintained by
`Jason Erickson <http://www.stickpeople.com/projects/python/win-psycopg/>`_.