From: Regina Obe Date: Sat, 2 May 2015 06:56:12 +0000 (+0000) Subject: Put back raster security details that are in 2.1 but weren't upported to 2.2 X-Git-Tag: 2.2.0rc1~536 X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=7a9eccce0061f69a52b689b2ff51cd91511365b8;p=postgis Put back raster security details that are in 2.1 but weren't upported to 2.2 git-svn-id: http://svn.osgeo.org/postgis/trunk@13463 b70326c6-7e19-0410-871a-916f4a2858ee --- diff --git a/doc/installation.xml b/doc/installation.xml index e34b956ed..508a654fa 100644 --- a/doc/installation.xml +++ b/doc/installation.xml @@ -48,6 +48,26 @@ psql -d yourdatabase -f sfcgal_comments.sql The rest of this chapter goes into detail each of the above installation steps. + + As of PostGIS 2.1.3, out-of-db rasters and all raster drivers are disabled by default. In order to re-enable these, you need to set the following environment variables: + POSTGIS_GDAL_ENABLED_DRIVERS and POSTGIS_ENABLE_OUTDB_RASTERS in the server environment. + + If you want to enable offline raster: + POSTGIS_ENABLE_OUTDB_RASTERS=1 + Any other setting or no setting at all will disable out of db rasters. + In order to enable all GDAL drivers available in your GDAL install, set this environment variable as follows + POSTGIS_GDAL_ENABLED_DRIVERS=ENABLE_ALL + If you want to only enable specific drivers, set your environment variable as follows: + POSTGIS_GDAL_ENABLED_DRIVERS="GTiff PNG JPEG GIF XYZ" + + If you are on windows, do not quote the driver list + + Setting environment variables varies depending on OS. For PostgreSQL installed on Ubuntu or Debian via apt-postgresql, the preferred way is to + edit /etc/postgresql/9.3/main/environment where 9.3 refers to version of PostgreSQL and main refers to the cluster. + + On windows, if you are running as a service, you can set via System variables which for Windows 7 you can get to by right-clicking on Computer->Properties Advanced System Settings or in explorer navigating to Control Panel\All Control Panel Items\System. + Then clicking Advanced System Settings ->Advanced->Environment Variables and adding new system variables. + After you set the environment variables, you'll need to restart your PostgreSQL service for the changes to take effect. @@ -150,6 +170,7 @@ psql -d yourdatabase -f sfcgal_comments.sql GDAL (pseudo optional) only if you don't want raster and don't care about installing with CREATE EXTENSION postgis can you leave it out. Keep in mind other extensions may have a requires postgis extension which will prevent you from installing them unless you install postgis as an extension. So it is highly recommended you compile with GDAL support. + Also make sure to enable the drivers you want to use as described in .