mirror of
https://git.osgeo.org/gitea/postgis/postgis
synced 2024-10-24 17:12:35 +00:00
681d72664b
- reStructuredText Markup, 80 column text - Rewrite several paragraphs - Add requirements section - Make it clear that --with-raster is required, and that postgis also includes the raster support Patch by Mike Toews git-svn-id: http://svn.osgeo.org/postgis/trunk@9555 b70326c6-7e19-0410-871a-916f4a2858ee
65 lines
1.9 KiB
Plaintext
65 lines
1.9 KiB
Plaintext
PostGIS Extension for PostgreSQL
|
|
================================
|
|
|
|
PostgreSQL 9.1 (and up) supports PostGIS extensions. A database can easily be
|
|
extended to use PostGIS using the syntax::
|
|
|
|
CREATE EXTENSION postgis; -- Includes raster
|
|
CREATE EXTENSION postgis_topology; -- Depends on postgis
|
|
|
|
Requirements
|
|
------------
|
|
* PostgreSQL 9.1 or later
|
|
* PostGIS must be configured and built ``--with-raster``
|
|
|
|
Building and installing
|
|
-----------------------
|
|
First, make sure you follow the regular configuration and installation steps,
|
|
completing these steps::
|
|
|
|
make
|
|
make install
|
|
|
|
If you are building from the source SVN repository, it is also recommended to
|
|
make the comments, since the function descriptions will be included::
|
|
|
|
make comments
|
|
|
|
Making the comments is not necessary if you are building from the tar.gz source
|
|
distributions, since these include pre-built ``postgis_comments.sql``,
|
|
``topology_comments.sql``, and ``raster_comments.sql`` files.
|
|
|
|
Then, to build and install the extensions::
|
|
|
|
cd extensions
|
|
make
|
|
make install
|
|
|
|
The extensions are installed in `SHAREDIR/extension`. (If you're uncertain
|
|
where `SHAREDIR` is, run ``pg_config --sharedir``.)
|
|
|
|
Then in your PostgreSQL database run::
|
|
|
|
CREATE EXTENSION postgis;
|
|
CREATE EXTENSION postgis_topology;
|
|
|
|
The dependency logic should warn if you try to install ``postgis_topology``
|
|
without ``postgis`` or try to drop ``postgis`` without first dropping
|
|
``postgis_topology``.
|
|
|
|
You will also not be able to drop any PostGIS functions installed by the
|
|
extension.
|
|
|
|
Manual extension installation
|
|
-----------------------------
|
|
If you want to manually install the extensions from one server to another,
|
|
just copy over the following files to the `SHAREDIR/extension` directory:
|
|
|
|
* PostGIS (including raster); from ``extensions/postgis``:
|
|
``postgis.control``
|
|
``sql/*``
|
|
|
|
* Topology extension; from ``extensions/postgis_topolology``:
|
|
``postgis_topology.control``
|
|
``sql/*``
|