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 e34b956edf937e1852533ac5c347b7863bb6f9fa..508a654faad1f0ab8788bd4c526b3570decf957d 100644 (file)
--- 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.
        </para>
+       
+       <para>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:
+       <varname>POSTGIS_GDAL_ENABLED_DRIVERS</varname> and <varname>POSTGIS_ENABLE_OUTDB_RASTERS</varname> in the server environment.</para>
+       
+       <para>If you want to enable offline raster:</para>
+       <programlisting>POSTGIS_ENABLE_OUTDB_RASTERS=1</programlisting>
+       <para>Any other setting or no setting at all will disable out of db rasters.</para>
+       <para>In order to enable all GDAL drivers available in your GDAL install, set this environment variable as follows</para>
+       <programlisting>POSTGIS_GDAL_ENABLED_DRIVERS=ENABLE_ALL</programlisting>
+       <para>If you want to only enable specific drivers, set your environment variable as follows:</para>
+       <programlisting>POSTGIS_GDAL_ENABLED_DRIVERS="GTiff PNG JPEG GIF XYZ"</programlisting>
+       
+       <note><para>If you are on windows, do not quote the driver list</para></note>
+       
+       <para>Setting environment variables varies depending on OS.  For PostgreSQL installed on Ubuntu or Debian via apt-postgresql, the preferred way is to
+       edit <filename>/etc/postgresql/<replaceable>9.3</replaceable>/<replaceable>main</replaceable>/environment</filename> where 9.3 refers to version of PostgreSQL and main refers to the cluster.</para>
+       
+       <para>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-&gt;Properties Advanced System Settings or in explorer navigating to <varname>Control Panel\All Control Panel Items\System</varname>. 
+       Then clicking <emphasis>Advanced System Settings -&gt;Advanced->Environment Variables</emphasis> and adding new system variables.</para>
+       <para>After you set the environment variables, you'll need to restart your PostgreSQL service for the changes to take effect.</para>
   </sect1>
 
   <sect1 id="install_requirements">
@@ -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 <code>CREATE EXTENSION postgis</code> 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.
                </para>
+               <para>Also make sure to enable the drivers you want to use as described in <xref linkend="install_short_version" />.</para>
          </listitem>   
          <listitem>
                <para>