test0908
/
django
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity

[1.2.X] Updated GeoDjango installation docs and spatial database template script for latest Ubuntu/Debian packages. 

Backport of r15520 from trunk.

git-svn-id: http://code.djangoproject.com/svn/django/branches/releases/1.2.X@15521 bcc190cf-cafb-0310-a4f2-bffc1f526a37
This commit is contained in:
Justin Bronn 2011-02-13 01:54:31 +00:00
parent cfaac48710
commit 4bcc5012b1
2 changed files with 81 additions and 45 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

45
docs/ref/contrib/gis/create_template_postgis-debian.sh
View File

@ -1,9 +1,38 @@
#!/usr/bin/env bash #!/bin/bash
POSTGIS_SQL_PATH=/usr/share/postgresql-8.3-postgis
createdb -E UTF8 template_postgis # Create the template spatial database. # For Ubuntu 8.x and 9.x releases.
createlang -d template_postgis plpgsql # Adding PLPGSQL language support. if [ -d "/usr/share/postgresql-8.3-postgis" ]
psql -d postgres -c "UPDATE pg_database SET datistemplate='true' WHERE datname='template_postgis';" then
psql -d template_postgis -f $POSTGIS_SQL_PATH/lwpostgis.sql # Loading the PostGIS SQL routines POSTGIS_SQL_PATH=/usr/share/postgresql-8.3-postgis
psql -d template_postgis -f $POSTGIS_SQL_PATH/spatial_ref_sys.sql POSTGIS_SQL=lwpostgis.sql
psql -d template_postgis -c "GRANT ALL ON geometry_columns TO PUBLIC;" # Enabling users to alter spatial tables. fi
# For Ubuntu 10.04
if [ -d "/usr/share/postgresql/8.4/contrib" ]
then
POSTGIS_SQL_PATH=/usr/share/postgresql/8.4/contrib
POSTGIS_SQL=postgis.sql
fi
# For Ubuntu 10.10 (with PostGIS 1.5)
if [ -d "/usr/share/postgresql/8.4/contrib/postgis-1.5" ]
then
POSTGIS_SQL_PATH=/usr/share/postgresql/8.4/contrib/postgis-1.5
POSTGIS_SQL=postgis.sql
GEOGRAPHY=1
else
GEOGRAPHY=0
fi
createdb -E UTF8 template_postgis && \
createlang -d template_postgis plpgsql && \
psql -d postgres -c "UPDATE pg_database SET datistemplate='true' WHERE datname='template_postgis';" && \
psql -d template_postgis -f $POSTGIS_SQL_PATH/$POSTGIS_SQL && \
psql -d template_postgis -f $POSTGIS_SQL_PATH/spatial_ref_sys.sql && \
psql -d template_postgis -c "GRANT ALL ON geometry_columns TO PUBLIC;" && \
psql -d template_postgis -c "GRANT ALL ON spatial_ref_sys TO PUBLIC;" psql -d template_postgis -c "GRANT ALL ON spatial_ref_sys TO PUBLIC;"
if ((GEOGRAPHY))
then
psql -d template_postgis -c "GRANT ALL ON geography_columns TO PUBLIC;"
fi

81
docs/ref/contrib/gis/install.txt
View File

@ -89,7 +89,7 @@ Program Description Required
======================== ==================================== ================================ ========================== ======================== ==================================== ================================ ==========================
:ref:`GEOS <ref-geos>` Geometry Engine Open Source Yes 3.2, 3.1, 3.0 :ref:`GEOS <ref-geos>` Geometry Engine Open Source Yes 3.2, 3.1, 3.0
`PROJ.4`_ Cartographic Projections library Yes (PostgreSQL and SQLite only) 4.7, 4.6, 4.5, 4.4 `PROJ.4`_ Cartographic Projections library Yes (PostgreSQL and SQLite only) 4.7, 4.6, 4.5, 4.4
:ref:`GDAL <ref-gdal>` Geospatial Data Abstraction Library No (but, required for SQLite) 1.7, 1.6, 1.5, 1.4 :ref:`GDAL <ref-gdal>` Geospatial Data Abstraction Library No (but, required for SQLite) 1.8, 1.7, 1.6, 1.5, 1.4
:ref:`GeoIP <ref-geoip>` IP-based geolocation library No 1.4 :ref:`GeoIP <ref-geoip>` IP-based geolocation library No 1.4
`PostGIS`__ Spatial extensions for PostgreSQL Yes (PostgreSQL only) 1.5, 1.4, 1.3 `PostGIS`__ Spatial extensions for PostgreSQL Yes (PostgreSQL only) 1.5, 1.4, 1.3
`SpatiaLite`__ Spatial extensions for SQLite Yes (SQLite only) 2.4, 2.3 `SpatiaLite`__ Spatial extensions for SQLite Yes (SQLite only) 2.4, 2.3
@ -175,7 +175,7 @@ When GeoDjango can't find GEOS, this error is raised::
The most common solution is to properly configure your :ref:`libsettings` *or* set The most common solution is to properly configure your :ref:`libsettings` *or* set
:ref:`geoslibrarypath` in your settings. :ref:`geoslibrarypath` in your settings.
If using a binary package of GEOS (e.g., on Ubuntu 8.10), you may need to :ref:`binutils`. If using a binary package of GEOS (e.g., on Ubuntu), you may need to :ref:`binutils`.
.. _geoslibrarypath: .. _geoslibrarypath:
@ -273,9 +273,9 @@ supports :ref:`GDAL's vector data <ref-gdal>` capabilities [#]_.
First download the latest GDAL release version and untar the archive:: First download the latest GDAL release version and untar the archive::
$ wget http://download.osgeo.org/gdal/gdal-1.7.2.tar.gz $ wget http://download.osgeo.org/gdal/gdal-1.8.0.tar.gz
$ tar xzf gdal-1.7.2.tar.gz $ tar xzf gdal-1.8.0.tar.gz
$ cd gdal-1.7.2 $ cd gdal-1.8.0
Configure, make and install:: Configure, make and install::
@ -517,14 +517,15 @@ user. For example, you can use the following to become the ``postgres`` user::
whereas version 1.4 uses ``<sharedir>/contrib/postgis.sql`` and whereas version 1.4 uses ``<sharedir>/contrib/postgis.sql`` and
version 1.5 uses ``<sharedir>/contrib/postgis-1.5/postgis.sql``. version 1.5 uses ``<sharedir>/contrib/postgis-1.5/postgis.sql``.
To complicate matters, :ref:`ubuntudebian` distributions have their
own separate directory naming system that changes each release.
The example below assumes PostGIS 1.5, thus you may need to modify The example below assumes PostGIS 1.5, thus you may need to modify
``POSTGIS_SQL_PATH`` and the name of the SQL file for the specific ``POSTGIS_SQL_PATH`` and the name of the SQL file for the specific
version of PostGIS you are using. version of PostGIS you are using.
Once you're a database super user, then you may execute the following commands Once you're a database super user, then you may execute the following commands
to create a PostGIS spatial database template. If running Ubuntu :ref:`ibex` to create a PostGIS spatial database template::
or Debian :ref:`lenny`, please refer to their specific documentation for
modifications to these commands::
$ POSTGIS_SQL_PATH=`pg_config --sharedir`/contrib/postgis-1.5 $ POSTGIS_SQL_PATH=`pg_config --sharedir`/contrib/postgis-1.5
# Creating the template spatial database. # Creating the template spatial database.
@ -549,6 +550,7 @@ PostGIS Version Shell Script
1.3 `create_template_postgis-1.3.sh`_ 1.3 `create_template_postgis-1.3.sh`_
1.4 `create_template_postgis-1.4.sh`_ 1.4 `create_template_postgis-1.4.sh`_
1.5 `create_template_postgis-1.5.sh`_ 1.5 `create_template_postgis-1.5.sh`_
Debian/Ubuntu `create_template_postgis-debian.sh`_
=============== ========================================== =============== ==========================================
Afterwards, you may create a spatial database by simply specifying Afterwards, you may create a spatial database by simply specifying
@ -919,22 +921,30 @@ __ http://www.macports.org/
Ubuntu & Debian GNU/Linux Ubuntu & Debian GNU/Linux
------------------------- -------------------------
.. note::
The PostGIS SQL files are not placed the PostgreSQL share directory in the
Debian and Ubuntu packages, and are located instead special directory
depending on the release. Thus, when :ref:`spatialdb_template` use the
`create_template_postgis-debian.sh`_ script instead
.. _ubuntu: .. _ubuntu:
Ubuntu Ubuntu
^^^^^^ ^^^^^^
.. _heron: .. _ubuntu10:
8.04 and lower 10.04 and 10.10
~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~
The 8.04 (and lower) versions of Ubuntu use GEOS v2.2.3 in their binary packages, In Ubuntu 10 PostgreSQL was upgraded to 8.4 and GDAL was upgraded to 1.6.
which is incompatible with GeoDjango. Thus, do *not* use the binary packages Ubuntu 10.04 uses PostGIS 1.4, while Ubuntu 10.10 uses PostGIS 1.5 (with
for GEOS or PostGIS and build some prerequisites from source, per the instructions geography support). The installation commands are::
in this document; however, it is okay to use the PostgreSQL binary packages.
For more details, please see the Debian instructions for :ref:`etch` below. $ sudo apt-get install binutils gdal-bin postgresql-8.4-postgis \
postgresql-server-dev-8.4 python-psycopg2 python-setuptools
$ sudo easy_install Django
.. _ibex: .. _ibex:
@ -943,7 +953,7 @@ For more details, please see the Debian instructions for :ref:`etch` below.
Use the synaptic package manager to install the following packages:: Use the synaptic package manager to install the following packages::
$ sudo apt-get install binutils libgdal1-1.5.0 postgresql-8.3-postgis \ $ sudo apt-get install binutils gdal-bin postgresql-8.3-postgis \
postgresql-server-dev-8.3 python-psycopg2 python-setuptools postgresql-server-dev-8.3 python-psycopg2 python-setuptools
Afterwards, you may install Django with Python's ``easy_install`` script (the Afterwards, you may install Django with Python's ``easy_install`` script (the
@ -970,24 +980,14 @@ Optional packages to consider:
* ``gdal-bin``: for GDAL command line programs like ``ogr2ogr`` * ``gdal-bin``: for GDAL command line programs like ``ogr2ogr``
* ``python-gdal`` for GDAL's own Python bindings -- includes interfaces for raster manipulation * ``python-gdal`` for GDAL's own Python bindings -- includes interfaces for raster manipulation
10.04
~~~~~
In Ubuntu 10.04 LTS PostgreSQL was upgraded to 8.4, as was GDAL, which is now
at version 1.6.0. Because of that, the package installation mentioned above
has to be slightly changed::
$ sudo apt-get install binutils libgdal1-1.6.0 postgresql-8.4-postgis \
postgresql-server-dev-8.4 python-psycopg2 python-setuptools
.. note:: .. note::
The Ubuntu ``proj`` package does not come with the datum shifting files On this version of Ubuntu the ``proj`` package does not come with the
installed, which will cause problems with the geographic admin because datum shifting files installed, which will cause problems with the
the ``null`` datum grid is not available for transforming geometries to the geographic admin because the ``null`` datum grid is not available for
spherical mercator projection. A solution is to download the transforming geometries to the spherical mercator projection. A solution
datum-shifting files, create the grid file, and install it yourself:: is to download the datum-shifting files, create the grid file, and
install it yourself::
$ wget http://download.osgeo.org/proj/proj-datumgrid-1.4.tar.gz $ wget http://download.osgeo.org/proj/proj-datumgrid-1.4.tar.gz
$ mkdir nad $ mkdir nad
@ -1000,11 +1000,17 @@ has to be slightly changed::
do not plan on doing any database transformation of geometries to the do not plan on doing any database transformation of geometries to the
Google projection (900913). Google projection (900913).
.. note:: .. _heron:
The PostGIS SQL files are not placed the PostgreSQL share directory in the 8.04 and lower
Ubuntu packages. Use the `create_template_postgis-debian.sh`_ script ~~~~~~~~~~~~~~
instead when :ref:`spatialdb_template`.
The 8.04 (and lower) versions of Ubuntu use GEOS v2.2.3 in their binary packages,
which is incompatible with GeoDjango. Thus, do *not* use the binary packages
for GEOS or PostGIS and build some prerequisites from source, per the instructions
in this document; however, it is okay to use the PostgreSQL binary packages.
For more details, please see the Debian instructions for :ref:`etch` below.
.. _debian: .. _debian:
@ -1051,6 +1057,7 @@ directions carefully.
5.0 (Lenny) 5.0 (Lenny)
^^^^^^^^^^^ ^^^^^^^^^^^
This version is comparable to Ubuntu :ref:`ibex`, so the command This version is comparable to Ubuntu :ref:`ibex`, so the command
is very similar:: is very similar::