p31829507
/
django
mirror of https://github.com/django/django.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity

Fixed #34367 -- Updated instructions for installing GeoDjango on Windows. 

Thanks David Smith for the review.
This commit is contained in:
Heath Henley 2023-02-23 19:40:45 -05:00 committed by Mariusz Felisiak
parent 5933d7033d
commit 54aecf95a2
1 changed files with 16 additions and 21 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

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

@ -346,7 +346,7 @@ for further information.
PostgreSQL
~~~~~~~~~~
Download the latest `PostgreSQL 12.x installer`__ from the
Download the latest `PostgreSQL 15.x installer`__ from the
`EnterpriseDB`__ website. After downloading, run the installer, follow the
on-screen directions, and keep the default options unless you know the
consequences of changing them.
@ -363,7 +363,7 @@ keep this checked, as it is necessary to install :ref:`postgisasb`.
If installed successfully, the PostgreSQL server will run in the background
each time the system as started as a Windows service. A
:menuselection:`PostgreSQL 12` start menu group will created and contains
:menuselection:`PostgreSQL 15` start menu group will created and contains
shortcuts for the Application Stack Builder (ASB) as well as the
'SQL Shell', which will launch a ``psql`` command window.
@ -376,17 +376,17 @@ PostGIS
~~~~~~~
From within the Stack Builder (to run outside of the installer,
:menuselection:`Start --> PostgreSQL 12 --> Application Stack Builder`), select
:menuselection:`PostgreSQL 12 (x64) on port 5432` from the drop down
:menuselection:`Start --> PostgreSQL 15 --> Application Stack Builder`), select
:menuselection:`PostgreSQL 15 (x64) on port 5432` from the drop down
menu and click next. Expand the
:menuselection:`Categories --> Spatial Extensions` menu tree and select
:menuselection:`PostGIS X.Y for PostgreSQL 12`.
:menuselection:`PostGIS X.Y for PostgreSQL 15`.
After clicking next, you will be prompted to confirm the selected package and
"Download directory". Click next again, this will download PostGIS and you will
be asked to click next to begin the PostGIS installer. Select the default
options during install. The install process includes three Yes/No dialog boxes,
the default option for all three is "No".
options during install. The install process includes four Yes/No dialog boxes,
the default option for all four is "No".
.. _osgeo4w:
@ -394,12 +394,13 @@ OSGeo4W
~~~~~~~
The `OSGeo4W installer`_ helps to install the PROJ, GDAL, and GEOS libraries
required by GeoDjango. First, download the `OSGeo4W installer`_ (64bit), and
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 is also enabled
by default, but is not required by GeoDjango and may be unchecked safely. After
clicking next and accepting the license agreements, the packages will be
automatically downloaded and installed, after which you may exit the installer.
'Select Packages' list, ensure that GDAL is selected. If any other packages are
enabled by default, they are not required by GeoDjango and may be unchecked
safely. After clicking next and accepting the license agreements, the packages
will be automatically downloaded and installed, after which you may exit the
installer.
.. _OSGeo4W installer: https://trac.osgeo.org/osgeo4w/
@ -414,20 +415,14 @@ once this is complete for new environment variables to be recognized:
.. code-block:: bat
set OSGEO4W_ROOT=C:\OSGeo4W64
set GDAL_DATA=%OSGEO4W_ROOT%\share\gdal
set OSGEO4W_ROOT=C:\OSGeo4W
set GDAL_DATA=%OSGEO4W_ROOT%\apps\gdal\share\gdal
set PROJ_LIB=%OSGEO4W_ROOT%\share\proj
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 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%"
.. note::
This assumes 64bit version of OSGeo4W is installed. If you have installed
the 32bit version you will need to change the first command to
``set OSGEO4W_ROOT=C:\OSGeo4W``.
.. note::
Administrator privileges are required to execute these commands.
@ -443,7 +438,7 @@ once this is complete for new environment variables to be recognized:
Install Django and set up database
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
:ref:`install Django <installing-official-release>` on your system. It is
:ref:`Install Django <installing-official-release>` on your system. It is
recommended that you create a :doc:`virtual environment
<python:tutorial/venv>` for each project you create.