GDAL Image Formats¶

Windows packages and setup¶

For Windows, gisinternals.com provides complete packages, with Java bindings support, in the release-<version>-GDAL-<version>-mapserver-<version>.zip packages (the GDAL installers at the time of writing provide no Java support).

Unpack the zip file in a suitable location, and then set the following variables before starting up GeoServer:

set PATH=%PATH%;C:\<unzipped_package>\bin;C:\<unzipped_package>\bin\gdal\java
set GDAL_DRIVER_PATH=C:\<unzipped_package>\bin\gdal\plugins
set GDAL_DATA=C:\<unzipped_package>\bin\gdal-data

There are a few optional drivers that you can find in c:\<unzipped_package>\bin\gdal\plugins-extra and c:\<unzipped_package>\bin\gdal\plugins-optional. Adding those paths to GDAL_DRIVER_PATH enables the additional formats.

Note on running GeoServer as a Service on Windows¶

If you downloaded an installed GeoServer as a Windows service you installed the 32 bit version.

Simply deploying the GDAL ImageI/O-Ext native libraries in a location referred by the PATH environment variable (like, as an instance, the JDK/bin folder) won’t allow the GeoServer service to use GDAL. As a result, during the service startup, GeoServer log will likely report the following message:

it.geosolutions.imageio.gdalframework.GDALUtilities loadGDAL
WARNING: Native library load failed.java.lang.UnsatisfiedLinkError: no gdaljni in java.library.path

Taking a look at the wrapper.conf configuration file available inside the GeoServer installation (at bin/wrapper/wrapper.conf), there is this useful entry:

# Java Library Path (location of Wrapper.DLL or libwrapper.so)
wrapper.java.library.path.1=bin/wrapper/lib

To allow the GDAL native DLLs to be loaded, you have two options:

1. Move the native DLLs to the referenced path (bin/wrapper/lib)

2. Add a wrapper.java.library.path.2=path/where/you/deployed/nativelibs entry just after the wrapper.java.library.path1=bin/wrapper/lib line.

Linux packages and setup¶

For common LTS Linux distribution there are packages for GDAL and the associated Java bindings, e.g., on Ubuntu and derivatives you can install them using:

sudo apt-get install gdal-bin libgdal-java

The libraries as installed above are already in the search path, so no extra setup is normally needed. In case setting up the GDAL_DATA is required to handle certain projections, it’s normally found in /usr/share/gdal/<version>, so you can execute the following prior to start GeoServer, e.g:

export GDAL_DATA=/usr/share/gdal/<version>

In case you decide to build from sources instead, remember to run configure with --with-java, and after the main build and install, get into the swig/java and run a build and install there. For more information about building GDAL see:

• General build information

• Specific info to build GDAL Java bindings

After the build and installation, export the following variables to make GeoServer use the GDAL custom build:

export LD_LIBRARY_PATH=/<path_to_gdal_install>/lib
export GDAL_DATA=/<path_to_gdal_install>/share/gdal

In case of version mismatch¶

If you are using a version of GDAL that does not match the one expected by GeoServer, you can go and replace the gdal-2.2.0.jar file with the equivalent java binding jar (typically named either gdal-<version>.jar or imageio-ext-gdal-bindings-*.jar) included with your GDAL version. If your GDAL version does not include a bindings jar, it was probably not compiled with the java bindings and will not work with GeoServer.

Example¶

Suppose you have 3 raster files with the following paths:

• /data/raster/charts/nitf/italy_2015.ntf

• /data/raster/satellite/ecw/orthofoto_2014.ecw

• /data/raster/satellite/landsat/mrsid/N-32-40_2000.sid

They can be represented by this tree:

/data
 \---raster
     +---charts
     |   \---nitf
     |           italy_2015.ntf
     |
     \---satellite
         +---ecw
         |       orthofoto_2014.ecw
         |
         \---landsat
             \---mrsid
                     N-32-40_2000.sid

In order to support external footprints you should

1. Create a /footprints (as an example) directory on disk

2. Set the FOOTPRINTS_DATA_DIR=/footprints variable/property.

3. Replicate the rasters folder hierarchy inside the specified folder, using the full paths.

4. Put the 3 WKT files in the proper locations:

• /footprints/data/raster/charts/nitf/italy_2015.wkt

• /footprints/data/raster/satellite/ecw/orthofoto_2014.wkt

• /footprints/data/raster/satellite/landsat/mrsid/N-32-40_2000.wkt

Which can be represented by this tree:

/footprints
 \---data
     \---raster
         +---charts
         |   \---nitf
         |           italy_2015.wkt
         |
         \---satellite
             +---ecw
             |       orthofoto_2014.wkt
             |
             \---landsat
                 \---mrsid
                         N-32-40_2000.wkt

Such that, in the end, you will have the following folders hierarchy tree:

+---data
|   \---raster
|       +---charts
|       |   \---nitf
|       |           italy_2015.ntf
|       |
|       \---satellite
|           +---ecw
|           |       orthofoto_2014.ecw
|           |
|           \---landsat
|               \---mrsid
|                       N-32-40_2000.sid
|
\---footprints
    \---data
        \---raster
            +---charts
            |   \---nitf
            |           italy_2015.wkt
            |
            \---satellite
                +---ecw
                |       orthofoto_2014.wkt
                |
                \---landsat
                    \---mrsid
                            N-32-40_2000.wkt

Note the parallel mirrored folder hierarchy, with the only differences being a /footprints prefix at the beginning of the path, and the change in suffix.