Enabling GDAL image formats support¶

Ubuntu packages¶

1. Install the following package from the Boundless repository. (See Installing for instructions on how to add the OpenGeo repository):

   apt-get install geoserver-gdal
   

   Note

   You must run this command as root or use sudo.

2. Once the package is installed, restart Tomcat to allow the changes to take effect:

   service tomcat7 restart
   

Continue reading at the Verification section.

CentOS / Red Hat¶

1. Install the following package from the Boundless repository. (See Installing for instructions on how to add the Boundless repository):

   yum install geoserver-gdal
   

   Note

   You must run this command as root or use sudo.

2. Once the package is installed, restart Tomcat to allow the changes to take effect:

   service tomcat7 restart
   

Continue reading at the Verification section.

Windows installer¶

The GDAL image formats can be added during the installation process. On the Components page, check the box for GDAL Image Formats in the section named GeoServer Extensions.

If OpenGeo Suite has already been installed and you wish to install GDAL image formats at a later time, simply run the installer once more and uncheck all other items except for GDAL Image Formats. This will add support to the existing OpenGeo Suite installation.

Windows application server¶

1. Download and install the Visual C++ Redistributable for Visual Studio 2012 Update 4.

2. Navigate to http://data.boundlessgeo.com/gdal_support/.

3. Download the file with a version number that most closely matches the version of OpenGeo Suite.

   Note

   This file requires a 32-bit Java/Tomcat.

4. Extract the file gdal-A.B.C.jar (where A.B.C is a version number) from the archive. Copy into <TOMCAT_HOME>\webapps\geoserver\WEB-INF\lib\, where <TOMCAT_HOME> is the location where Tomcat is installed (such as C:\Program Files\Tomcat\).

5. If Tomcat is installed as a service:

   1. Extract the full contents of the archive to <TOMCAT_HOME>\bin\.
   2. Restart Tomcat.

6. If Tomcat is not installed as a service:

   1. Extract the full contents of the archive to any folder (such as C:\Program Files\GDAL\).

   2. Edit the file <TOMCAT_HOME>\bin\setenv.bat and add the following line:

      set "PATH=C:\Program Files\GDAL\;%PATH%"
      

      replacing C:\Program Files\GDAL\ with the path where the archive was extracted.

   3. Restart Tomcat.

Continue reading at the Verification section.

OS X installer¶

The GDAL image formats extension can be added to OpenGeo Suite by copying the contents of the gdal extension folder (not the folder itself) to the GeoServer library folder. The GeoServer library folder can be found by selecting Open Webapps Directory from the GeoServer menu and then navigating to geoserver/WEB-INF/lib.

Opening the webapps directory from the GeoServer menu

Once copied, GeoServer will need to be restarted to take effect.

OS X application server¶

1. Navigate to: http://data.boundlessgeo.com/gdal_support/

2. Download the file with a version number that most closely matches the version of OpenGeo Suite. For example, the file gdal_osx_suite_40.zip would be appropriate for OpenGeo Suite 4.x.

3. Extract the contents of the archive to a location of your choosing.

4. Create (or edit) a file called setenv.sh located in $TOMCAT_HOME/bin, and add the following line:

   export DYLD_LIBRARY_PATH=<GDAL_PATH>:$DYLD_LIBRARY_PATH
   

   replacing <GDAL_PATH> with the directory the archive was extracted to in the previous step.

5. Extract the file gdal-A.B.C.jar (where A.B.C is a version number) from the archive. Copy into <TOMCAT_HOME>\webapps\geoserver\WEB-INF\lib\, where <TOMCAT_HOME> is the location where Tomcat is installed (such as /opt/tomcat/).

6. Restart Tomcat.

Continue reading at the Verification section.