[[PageOutline]]
= GDAL Raster Provider for MapGuide 2.6 and 3.0 =

This page provides installation and configuration tips for the !GDAL Raster Provider for MapGuide Open Source 2.6 and 3.0.  This document is a work in progress.  Please post any feedback on this document to the mapguide-users list.

== Introduction ==

The default GDAL FDO provider provided by MapGuide 2.6 and 3.0 is built using the standard driver profile of GDAL 1.10. That is to say of the drivers listed here:

 * http://www.gdal.org/formats_list.html
 * http://gdal.org/ogr_formats.html

The default GDAL FDO provider will only support the drivers where '''Compiled by default''' is unconditionally '''Yes'''

To support additional raster/vector formats, you need to source an alternate binary build of GDAL/OGR. Usually the place to get such alternate GDAL/OGR binaries is at [http://www.gisinternals.com/ GISInternals]

Unfortunately, due to the nature of C++ code (MapGuide, FDO and GDAL all being written in it), you must make sure to download the GDAL/OGR package that is built with the same MSVC compiler used to build MapGuide Open Source 2.6 and 3.0 which is MSVC 2012.

Sadly, GISInternals does not offer a binary of '''GDAL 1.10''' built with '''MSVC 2012''', meaning this option of using custom GDAL binaries not possible.

Fortunately, GISInternals offers a [http://www.gisinternals.com/sdk.php Development Kit] that allows us to build our own custom GDAL binaries using MSVC 2012.

Jackie Ng has made available a custom build of GDAL 1.10 with additional raster and vector format support thanks to the availability of this GISInternals Development Kit:

 * [http://download.osgeo.org/mapguide/releases/3.0.0/Beta1/windows/extras/gdal-1.10-msvc2012-x86.zip GDAL 1.10 for MapGuide Open Source 2.6/3.0 32-bit]
 * [http://download.osgeo.org/mapguide/releases/3.0.0/Beta1/windows/extras/gdal-1.10-msvc2012-x64.zip GDAL 1.10 for MapGuide Open Source 2.6/3.0 64-bit]

The custom build of GDAL 1.10 required some modifications to the DevKit to support compilation against GDAL 1.10. These modifications can be found on [https://github.com/jumpinjackie/gdal4fdo Jackie's GitHub repository]

== Additional Driver Support ==

This custom build of GDAL 1.10 offers support for the following additional raster formats:

{{{
  ECW (rw): ERDAS Compressed Wavelets (SDK 3.x)
  JP2ECW (rw+v): ERDAS JPEG2000 (SDK 3.x)
  FITS (rw+): Flexible Image Transport System
  GMT (rw): GMT NetCDF Grid Format
  netCDF (rw+s): Network Common Data Format
  WCS (rovs): OGC Web Coverage Service
  WMS (rwvs): OGC Web Map Service
  HTTP (ro): HTTP Fetching Wrapper
  Rasterlite (rws): Rasterlite
  PostGISRaster (rws): PostGIS Raster driver
  MBTiles (rov): MBTiles
}}}

And support for the following additional vector formats:

{{{
-> "PostgreSQL" (read/write)
-> "NAS" (readonly)
-> "LIBKML" (read/write)
-> "Interlis 1" (read/write)
-> "Interlis 2" (read/write)
-> "SQLite" (read/write)
-> "VFK" (readonly)
-> "OSM" (readonly)
-> "WFS" (readonly)
-> "GFT" (read/write)
-> "CouchDB" (read/write)
-> "ODS" (read/write)
-> "XLSX" (read/write)
-> "ElasticSearch" (read/write)
-> "PDF" (read/write)
}}}

For more information about these formats, consult the respective [http://www.gdal.org/formats_list.html GDAL] and [http://gdal.org/ogr_formats.html OGR] driver format pages.

'''NOTICE: Due to licensing terms that prohibit redistribution, the raster/vector format support in this custom build of GDAL is not the same as the GDAL binaries made available on GISInternals. In particular, the Development Kit does not contain the libraries needed to build GDAL with support for the following formats:'''

 * Raster
   * MrSID
 * Vector
   * Oracle OCI

'''Also, the Development Kit targets GDAL 1.11 instead of GDAL 1.10. As a result, certain build configuration parameters are not applicable or invalid when using the DevKit to build against GDAL 1.10, meaning support for the following formats have been omitted as well:'''

 * Raster
   * JP2OpenJPEG (GDAL 1.10 requires OpenJPEG 2.0, the DevKit bundles OpenJPEG 2.1 that GDAL 1.11 requires)
 * Vector
   * MySQL (assorted compiler/linker errors when building against GDAL 1.10)

== Licensing ==

'''NOTICE: ECW Technology must be licensed from ERDAS if it used in a server application like !MapGuide.  Please see the following link for information on the licensing.  http://iws.erdas.com/gis/can-i-use-ecw-technology-in-my-third-party-server.aspx'''

'''NOTICE: Additional plugins and libraries included in this distribution may be under radically different licenses, you MUST obtain valid licenses for each of these dependent libraries. License information for such plugins and libraries can be found in RTF format on the GISInternals buildsystem repository on GitHub: https://github.com/gisinternals/buildsystem'''

== Installation ==

Unzip the zip distribution to the FDO directory of your MapGuide installation, which by default is:

{{{
C:\Program Files\OSGeo\MapGuide\Server\FDO
}}}

If prompted, overwrite any existing files.

Then set an environment named {{{GDAL_DRIVER_PATH}}} that points to the new {{{gdalplugins}}} under your FDO directory ('''NOTE: In previous versions of this guide, it told you to have the gdalplugins directory under the MapGuide Server's bin directory. The change of instructions here is to allow both FDO and the included set of GDAL/OGR console applications to be able to load these GDAL/OGR plugins)

Make sure that mapguide is reading the correct co-ordinate system is being read from the source files, override it if necessary.

== Debugging ==

== Configuration ==

The default serverconfig.ini settings set by the installer should be sufficient.  No additional serverconfig.ini modifications are required.

In addition to {{{CPL_DEBUG}}}, GDAL offers many other runtime configuration options via environment variables. [https://trac.osgeo.org/gdal/wiki/ConfigOptions See here for the full list]

== Previous notes ==

 * [wiki:MGOS22GdalProvider GDAL Provider tips for MapGuide 2.2]