| 1 | [[PageOutline]] |
| 2 | = MapGuide 2.2 GDAL Raster Provider = |
| 3 | |
| 4 | This page provides installation and configuration tips for the !MapGuide 2.2 GDAL Raster Provider. This document is a work in progress by the community. Please post any feedback on this document to the mapguide-users list. |
| 5 | |
| 6 | == Licensing == |
| 7 | |
| 8 | '''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''' |
| 9 | |
| 10 | == Installation == |
| 11 | |
| 12 | Tamas Szekeres is maintaining binary distributions of the GDAL library with the plugins for the !MapServer project. His distributions work with !MapGuide. The distributions are available here http://vbkto.dyndns.org/sdk/. For !MapGuide 2.2, the follow builds are required: |
| 13 | |
| 14 | * 32 bit Windows: http://vbkto.dyndns.org/sdk/release-1500-gdal-1-6-mapserver-5-6.zip |
| 15 | * 64 bit Windows: http://vbkto.dyndns.org/sdk/release-1500-x64-gdal-1-6-mapserver-5-6.zip |
| 16 | |
| 17 | From the bin and bin/gdal/plugins directories contained in the zip file, copy the following files to the !MapGuide Server: |
| 18 | |
| 19 | {{{ |
| 20 | Server\bin\libecwj2.dll |
| 21 | Server\bin\lti_dsdk_dll.dll |
| 22 | Server\bin\gdalplugins\gdal_ECW_JP2ECW.dll |
| 23 | Server\bin\gdalplugins\gdal_MrSID.dll |
| 24 | Server\Fdo\gdal16.dll |
| 25 | Server\Fdo\geos_c.dll |
| 26 | Server\Fdo\iconv.dll |
| 27 | Server\Fdo\libcurl.dll |
| 28 | Server\Fdo\libexpat.dll |
| 29 | Server\Fdo\libpq.dll |
| 30 | Server\Fdo\libtiff.dll |
| 31 | Server\Fdo\proj.dll |
| 32 | Server\Fdo\spatialite.dll |
| 33 | Server\Fdo\xerces-c_2_8.dll |
| 34 | Server\Fdo\zlib1.dll |
| 35 | }}} |
| 36 | |
| 37 | == Format Support, Performance, and Stability == |
| 38 | |
| 39 | Trevor Wekel has verified the following raster file formats are usable in !MapGuide 2.2: |
| 40 | |
| 41 | * TIFF |
| 42 | * ECW |
| 43 | * MrSID |
| 44 | * JPEG 2000 |
| 45 | |
| 46 | With the default serverconfig.ini configuration, an 8 user load test against a 25 file catalog for each format generated no errors over a 10 hour run. Scalability was limited to approximately 2 cpus and a memory leak of roughly 200 MB was observed over the 10 hour period. |
| 47 | |
| 48 | == Debugging == |
| 49 | Jonathan !McIntyre has supplied some debugging steps for the GDAL Provider which should work for !MapGuide 2.2: |
| 50 | |
| 51 | 1. Starting MG in debug mode |
| 52 | a. Open cmd window |
| 53 | a. Cd to C:\Program Files\OSGeo\!MapGuide\Server\bin |
| 54 | a. Type ‘set cpl_debug=on’ (no quotes needed) |
| 55 | a. Type ‘mgserver run’ (no quotes needed) |
| 56 | a. You should see: |
| 57 | {{{ |
| 58 | (1392) Server starting... |
| 59 | (1392) Mentor Coordinate System Library |
| 60 | (1392) Server started. |
| 61 | }}} |
| 62 | 1. Setting up image in MG site |
| 63 | a. Use Maestro to create Feature Source for image |
| 64 | i. Create New GDAL Feature Source |
| 65 | i. Add file(s) to list-you should see something like the following show up in the console: |
| 66 | {{{ |
| 67 | GDAL: Auto register C:\Program Files\OSGeo\MapGuide\Server\bin\gdalplugins\gdal_ECW.dll using GDALRegister_ECW. |
| 68 | GDAL: Auto register C:\Program Files\OSGeo\MapGuide\Server\bin\gdalplugins\gdal_ECW_JP2ECW.dll using GDALRegister_ECW_JP2ECW. |
| 69 | GDAL: Auto register C:\Program Files\OSGeo\MapGuide\Server\bin\gdalplugins\gdal_MrSID.dll using GDALRegister_MrSID. |
| 70 | GDAL: Auto register C:\Program Files\OSGeo\MapGuide\Server\bin\gdalplugins\gdal_ECW.dll using GDALRegister_ECW. |
| 71 | GDAL: Auto register C:\Program Files\OSGeo\MapGuide\Server\bin\gdalplugins\gdal_ECW_JP2ECW.dll using GDALRegister_ECW_JP2ECW. |
| 72 | GDAL: Auto register C:\Program Files\OSGeo\MapGuide\Server\bin\gdalplugins\gdal_MrSID.dll using GDALRegister_MrSID. |
| 73 | MrSID: Opened zoom level 1 with size 2500x2500. |
| 74 | MrSID: Opened zoom level 2 with size 1250x1250. |
| 75 | MrSID: Opened zoom level 3 with size 625x625. |
| 76 | MrSID: Opened zoom level 4 with size 313x313. |
| 77 | MrSID: Opened zoom level 5 with size 157x157. |
| 78 | MrSID: Opened zoom level 6 with size 79x79. |
| 79 | MrSID: Opened zoom level 7 with size 40x40. |
| 80 | MrSID: Opened zoom level 0 with size 5000x5000. |
| 81 | MrSID: Opened image: width 5000, height 5000, bands 3 |
| 82 | GDAL: GDALOpen(D:\projects\Client\Data\SDF/DO_S03_9608_40.sid, this=0FB15438) succeeds as MrSID. |
| 83 | GDAL: GDALClose(, this=0FB15D18) |
| 84 | GDAL: GDALClose(, this=0FB16088) |
| 85 | GDAL: GDALClose(, this=0FB16410) |
| 86 | GDAL: GDALClose(, this=0FB16798) |
| 87 | GDAL: GDALClose(, this=0FB16B20) |
| 88 | GDAL: GDALClose(, this=0FB16EA8) |
| 89 | GDAL: GDALClose(, this=0FB17230) |
| 90 | GDAL: GDALClose(D:\projects\Client\Data\SDF/DO_S03_9608_40.sid, this=0FB15438 |
| 91 | }}} |
| 92 | |
| 93 | == Configuration == |
| 94 | |
| 95 | The default serverconfig.ini settings set by the installer should be sufficient. No additional serverconfig.ini modifications are required. |
| 96 | |
| 97 | |