mirrors/django
1
0
Fork 0
mirror of https://github.com/django/django.git synced 2025-10-31 09:41:08 +00:00
Code Issues 32 Releases Wiki Activity

[4.2.x] Fixed #34367 -- Updated instructions for installing GeoDjango on Windows.

Browse Source 
Thanks David Smith for the review.

Backport of 54aecf95a2 from main
This commit is contained in:
Heath Henley
2023-02-23 19:40:45 -05:00
committed by Mariusz Felisiak
parent fec487f968
commit 125abb7cab
1 changed files with 16 additions and 21 deletions
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 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 `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.
@@ -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 If installed successfully, the PostgreSQL server will run in the background
each time the system as started as a Windows service. A 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 shortcuts for the Application Stack Builder (ASB) as well as the
'SQL Shell', which will launch a ``psql`` command window. '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, From within the Stack Builder (to run outside of the installer,
:menuselection:`Start --> PostgreSQL 12 --> Application Stack Builder`), select :menuselection:`Start --> PostgreSQL 15 --> Application Stack Builder`), select
:menuselection:`PostgreSQL 12 (x64) on port 5432` from the drop down :menuselection:`PostgreSQL 15 (x64) on port 5432` from the drop down
menu and click next. Expand the menu and click next. Expand the
:menuselection:`Categories --> Spatial Extensions` menu tree and select :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 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 "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 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, options during install. The install process includes four Yes/No dialog boxes,
the default option for all three is "No". the default option for all four is "No".
.. _osgeo4w: .. _osgeo4w:
@@ -394,12 +394,13 @@ OSGeo4W
~~~~~~~ ~~~~~~~
The `OSGeo4W installer`_ helps to install the PROJ, GDAL, and GEOS libraries 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 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 'Select Packages' list, ensure that GDAL is selected. If any other packages are
by default, but is not required by GeoDjango and may be unchecked safely. After enabled by default, they are not required by GeoDjango and may be unchecked
clicking next and accepting the license agreements, the packages will be safely. After clicking next and accepting the license agreements, the packages
automatically downloaded and installed, after which you may exit the installer. will be 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/
@@ -414,20 +415,14 @@ once this is complete for new environment variables to be recognized:
.. code-block:: bat .. code-block:: bat
set OSGEO4W_ROOT=C:\OSGeo4W64 set OSGEO4W_ROOT=C:\OSGeo4W
set GDAL_DATA=%OSGEO4W_ROOT%\share\gdal set GDAL_DATA=%OSGEO4W_ROOT%\apps\gdal\share\gdal
set PROJ_LIB=%OSGEO4W_ROOT%\share\proj set PROJ_LIB=%OSGEO4W_ROOT%\share\proj
set PATH=%PATH%;%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::
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:: .. note::
Administrator privileges are required to execute these commands. 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 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 recommended that you create a :doc:`virtual environment
<python:tutorial/venv>` for each project you create. <python:tutorial/venv>` for each project you create.