Mercurial > mxd2map
comparison INSTALL.txt @ 202:1e3a5019c4ed
* INSTALL.txt, LICENCE.txt, doku/source/LICENCE.txt,
doku/source/conf.py, doku/source/functionality.txt,
doku/source/index.txt, doku/source/restrictions.txt: Added some
formatting, a section about the setup of environment vars needed
for runtime, added some more features.
| author | Stephan Holl <stephan.holl@intevation.de> |
|---|---|
| date | Thu, 21 Jul 2011 09:38:44 +0200 |
| parents | 43f1cbdcd597 |
| children | 64cd6a115372 |
comparison
equal
deleted
inserted
replaced
| 201:877be7484245 | 202:1e3a5019c4ed |
|---|---|
| 9 | 9 |
| 10 To run the converter you need at least the following componentes: | 10 To run the converter you need at least the following componentes: |
| 11 | 11 |
| 12 * Sun Java6 SDK to build, JRE to run | 12 * Sun Java6 SDK to build, JRE to run |
| 13 * ArcGIS Desktop10.x or ArcEngine10.x with a valid licence enabled | 13 * ArcGIS Desktop10.x or ArcEngine10.x with a valid licence enabled |
| 14 * UMN MapServer with Java MapScript-bindings (recent development-version) | 14 * UMN MapServer with Java MapScript-bindings (>=6.0.1 or recent development-version) |
| 15 * Apache Webserver for displaying the resulting Mapfiles | 15 * Apache2 Webserver for displaying the resulting Mapfiles |
| 16 * Optional: MapServer compiled with ArcSDE-plugin | 16 * Optional: MapServer compiled with ArcSDE-plugin |
| 17 * Optional: GDAL/OGR compiled with ArcSDE-support | 17 * Optional: GDAL/OGR compiled with ArcSDE-support |
| 18 * Optional: GDAL/OGR compiled with FileGeodatabase-support | 18 * Optional: GDAL/OGR compiled with FileGeodatabase-support |
| 19 | 19 * Optional: Other GDAL/OGR-related tools. |
| 20 | 20 |
| 21 | 21 |
| 22 ------------ | 22 ------------ |
| 23 Installation | 23 Installation |
| 24 ------------ | 24 ------------ |
| 51 Install UMN MapServer | 51 Install UMN MapServer |
| 52 --------------------- | 52 --------------------- |
| 53 | 53 |
| 54 The current documentation uses the Windows binary-builds from http://www.gisinternals.com/sdk/ | 54 The current documentation uses the Windows binary-builds from http://www.gisinternals.com/sdk/ |
| 55 | 55 |
| 56 1. Unzip the ZIP-file at c:/ms_6.1-dev | 56 1. Unzip the ZIP-file at ``c:/ms_6.1-dev`` |
| 57 | 57 |
| 58 #. Configure Apache Webserver to find the cgi-bin-folder:: | 58 #. Configure Apache Webserver to find the cgi-bin-folder:: |
| 59 | 59 |
| 60 ScriptAlias /cgi-bin/ "C:/ms_6.1-dev/bin/" | 60 ScriptAlias /cgi-bin/ "C:/ms_6.1-dev/bin/" |
| 61 | 61 |
| 63 Options None | 63 Options None |
| 64 Order allow,deny | 64 Order allow,deny |
| 65 Allow from all | 65 Allow from all |
| 66 </Location> | 66 </Location> |
| 67 | 67 |
| 68 #. Copy mapserv.exe from c:/ms_6.1-dev/bin/apps/ms to c:/ms_6.1-dev/bin/ | 68 #. Copy mapserv.exe from ``c:/ms_6.1-dev/bin/apps/ms`` to ``c:/ms_6.1-dev/bin/`` |
| 69 | 69 |
| 70 | 70 |
| 71 Create run-environment | 71 Create run-environment |
| 72 ---------------------- | 72 ---------------------- |
| 73 | 73 |
| 74 The current version of MXD2map needs a few steps to run properly. | 74 The current version of MXD2map needs a few steps to run properly. |
| 75 The following steps assume the runtime folder to be c:/mxd2map/. This path can | 75 The following steps assume the runtime folder to be c:/mxd2map/. This path can |
| 76 be changed. | 76 be changed. |
| 77 | 77 |
| 78 1. Copy mxd2map.jar to c:/mxd2map/. | 78 1. Copy ``mxd2map.jar`` to ``c:/mxd2map/``. |
| 79 | 79 |
| 80 #. Copy folder "conf" from repository to c:/mxd2map/ | 80 #. Copy folder "conf" from repository to ``c:/mxd2map/`` |
| 81 | 81 |
| 82 #. Create folder c:/mxd2map/lib/ | 82 #. Create folder ``c:/mxd2map/lib/`` |
| 83 | 83 |
| 84 #. Get log4j from http://logging.apache.org/log4j/1.2/download.html | 84 #. Get log4j from http://logging.apache.org/log4j/1.2/download.html |
| 85 | 85 |
| 86 #. Get jargs http://jargs.sourceforge.net/ (Version 1.0) | 86 #. Get jargs http://jargs.sourceforge.net/ (Version 1.0) |
| 87 | 87 |
| 88 #. Build the libraries and copy the resulting jar-files to c:/mxd2map/lib/ | 88 #. Build the libraries and copy the resulting jar-files to ``c:/mxd2map/lib/`` |
| 89 | 89 |
| 90 #. Copy mapscript.jar and mapscript.dll to c:/mxd2map/lib/ | 90 #. Copy mapscript.jar and mapscript.dll to ``c:/mxd2map/lib/`` |
| 91 | 91 |
| 92 #. Create a folder c:/mxd2map/logs/ | 92 #. Create a folder ``c:/mxd2map/logs/`` |
| 93 | 93 |
| 94 #. Create or copy a converter.properties file to c:/mxd2map/ | 94 #. Create or copy a converter.properties file to ``c:/mxd2map/`` |
| 95 | 95 |
| 96 Setup environment-variables | |
| 97 --------------------------- | |
| 98 | |
| 99 For running the converter it is necessary to set up some environment | |
| 100 variables and adjust the path accordingly. | |
| 101 | |
| 102 The following example shows the minimum env-vars needed:: | |
| 103 | |
| 104 @echo off | |
| 105 if "%1" == "setenv" goto setenv | |
| 106 | |
| 107 %comspec% /k SDKShell.bat setenv %1 | |
| 108 goto exit | |
| 109 | |
| 110 :setenv | |
| 111 @echo Setting environment for using the GDAL and MapServer tools. | |
| 112 | |
| 113 if "%2"=="hideoci" goto hideoci | |
| 114 | |
| 115 set ocipath=0 | |
| 116 set _path="%PATH:;=" "%" | |
| 117 for %%p in (%_path%) do if not "%%~p"=="" if exist %%~p\oci.dll set ocipath=1 | |
| 118 | |
| 119 if "%ocipath%"=="0" goto hideoci | |
| 120 @echo WARNING: If you encounter problems with missing oci libraries then type: | |
| 121 @echo SDKShell hideoci | |
| 122 goto setenv2 | |
| 123 | |
| 124 :hideoci | |
| 125 @echo Hiding the OCI plugin library. | |
| 126 if not exist %CD%\bin\gdal\plugins-optional mkdir %CD%\bin\gdal\plugins-optional | |
| 127 if exist %CD%\bin\gdal\plugins\ogr_OCI.dll move %CD%\bin\gdal\plugins\ogr_OCI.dll %CD%\bin\gdal\plugins-optional\ogr_OCI.dll | |
| 128 if exist %CD%\bin\gdal\plugins\gdal_GEOR.dll move %CD%\bin\gdal\plugins\gdal_GEOR.dll %CD%\bin\gdal\plugins-optional\gdal_GEOR.dll | |
| 129 | |
| 130 :setenv2 | |
| 131 SET PATH=C:\Program Files\ArcGIS\DeveloperKit10.0\java\jre\bin;C:\Program Files\ArcGIS\Engine10.0\bin;%CD%\bin;%CD%\bin;%CD%\bin\gdal\python\osgeo;%CD%\bin\proj\apps;%CD%\bin\gdal\apps;%CD%\bin\ms\apps;%CD%\bin\gdal\csharp;%CD%\bin\ms\csharp;%CD%\bin\curl;%CD%\bin\ms\java;C:\Program Files\Vim\vim71;C:\Program Files\TortoiseHg;%PATH% | |
| 132 SET GDAL_DATA=%CD%\bin\gdal-data | |
| 133 SET GDAL_DRIVER_PATH=%CD%\bin\gdal\plugins | |
| 134 SET PYTHONPATH=%CD%\bin\gdal\python\osgeo | |
| 135 SET PROJ_LIB=%CD%\bin\proj\SHARE | |
| 136 SET CURL_CA_BUNDLE=C:\ms4w\Apache\conf\ca-bundle\cacert.pem | |
| 137 | |
| 138 :exit | |
| 139 | |
| 140 The above batch-script ``SDKShell.bat`` needs to be sources before working | |
| 141 with MXD2map. | |
| 142 |