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
This site is hosted by Intevation GmbH (Datenschutzerklärung und Impressum | Privacy Policy and Imprint)