annotate INSTALL.txt @ 343:9d6d3cca688c

Added OUTPUTFORMAT jpeg in example files.
author Bjoern Schilberg <bjoern@intevation.de>
date Wed, 14 Nov 2012 13:15:24 +0100
parents 5e7e6d99f997
children 02d3c1665a46
rev   line source
229
64cd6a115372 Reorganized INSTALL-doc, added chapter for logging
Stephan Holl <stephan.holl@intevation.de>
parents: 202
diff changeset
1 .. index:: installation, requirements, apache, UMN MapServer, compile,
64cd6a115372 Reorganized INSTALL-doc, added chapter for logging
Stephan Holl <stephan.holl@intevation.de>
parents: 202
diff changeset
2 jar, logging, ArcSDE
188
43f1cbdcd597 Modified and beautified the documentation:
Stephan Holl <stephan.holl@intevation.de>
parents: 182
diff changeset
3
140
0ebaec057f15 * INSTALL.txt: added a hint how to install the converter and its
Stephan Holl <stephan.holl@intevation.de>
parents:
diff changeset
4 ------------
292
6e5fce16b495 Update/Rework installation dokumentation
Andre Heinecke <aheinecke@intevation.de>
parents: 290
diff changeset
5 Installation from Source
6e5fce16b495 Update/Rework installation dokumentation
Andre Heinecke <aheinecke@intevation.de>
parents: 290
diff changeset
6 ------------
6e5fce16b495 Update/Rework installation dokumentation
Andre Heinecke <aheinecke@intevation.de>
parents: 290
diff changeset
7 This Documentation describes how you can install MXD2Map from source. If you only
6e5fce16b495 Update/Rework installation dokumentation
Andre Heinecke <aheinecke@intevation.de>
parents: 290
diff changeset
8 want to use MXD2Map it is strongly recommended that you use our convenient binary
6e5fce16b495 Update/Rework installation dokumentation
Andre Heinecke <aheinecke@intevation.de>
parents: 290
diff changeset
9 installer.
6e5fce16b495 Update/Rework installation dokumentation
Andre Heinecke <aheinecke@intevation.de>
parents: 290
diff changeset
10
140
0ebaec057f15 * INSTALL.txt: added a hint how to install the converter and its
Stephan Holl <stephan.holl@intevation.de>
parents:
diff changeset
11 Requirements
0ebaec057f15 * INSTALL.txt: added a hint how to install the converter and its
Stephan Holl <stephan.holl@intevation.de>
parents:
diff changeset
12 ------------
0ebaec057f15 * INSTALL.txt: added a hint how to install the converter and its
Stephan Holl <stephan.holl@intevation.de>
parents:
diff changeset
13
292
6e5fce16b495 Update/Rework installation dokumentation
Andre Heinecke <aheinecke@intevation.de>
parents: 290
diff changeset
14 Currently MXD2Map only runs on Windows, because the ArcObjects JDK API does not
6e5fce16b495 Update/Rework installation dokumentation
Andre Heinecke <aheinecke@intevation.de>
parents: 290
diff changeset
15 work properly on GNU/Linux systems. All Free Software components of MXD2Map can
6e5fce16b495 Update/Rework installation dokumentation
Andre Heinecke <aheinecke@intevation.de>
parents: 290
diff changeset
16 run on GNU/Linux as well as on Windows.
140
0ebaec057f15 * INSTALL.txt: added a hint how to install the converter and its
Stephan Holl <stephan.holl@intevation.de>
parents:
diff changeset
17
292
6e5fce16b495 Update/Rework installation dokumentation
Andre Heinecke <aheinecke@intevation.de>
parents: 290
diff changeset
18 To run the converter you need at least the following components:
140
0ebaec057f15 * INSTALL.txt: added a hint how to install the converter and its
Stephan Holl <stephan.holl@intevation.de>
parents:
diff changeset
19
0ebaec057f15 * INSTALL.txt: added a hint how to install the converter and its
Stephan Holl <stephan.holl@intevation.de>
parents:
diff changeset
20 * Sun Java6 SDK to build, JRE to run
0ebaec057f15 * INSTALL.txt: added a hint how to install the converter and its
Stephan Holl <stephan.holl@intevation.de>
parents:
diff changeset
21 * ArcGIS Desktop10.x or ArcEngine10.x with a valid licence enabled
202
1e3a5019c4ed * INSTALL.txt, LICENCE.txt, doku/source/LICENCE.txt,
Stephan Holl <stephan.holl@intevation.de>
parents: 188
diff changeset
22 * UMN MapServer with Java MapScript-bindings (>=6.0.1 or recent development-version)
182
91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents: 140
diff changeset
23
292
6e5fce16b495 Update/Rework installation dokumentation
Andre Heinecke <aheinecke@intevation.de>
parents: 290
diff changeset
24 Additionally the following components are recommended:
202
1e3a5019c4ed * INSTALL.txt, LICENCE.txt, doku/source/LICENCE.txt,
Stephan Holl <stephan.holl@intevation.de>
parents: 188
diff changeset
25
292
6e5fce16b495 Update/Rework installation dokumentation
Andre Heinecke <aheinecke@intevation.de>
parents: 290
diff changeset
26 * Apache2 Webserver for displaying the resulting Mapfiles
6e5fce16b495 Update/Rework installation dokumentation
Andre Heinecke <aheinecke@intevation.de>
parents: 290
diff changeset
27 * MapServer compiled with ArcSDE-plugin
6e5fce16b495 Update/Rework installation dokumentation
Andre Heinecke <aheinecke@intevation.de>
parents: 290
diff changeset
28 * GDAL/OGR compiled with ArcSDE-support
6e5fce16b495 Update/Rework installation dokumentation
Andre Heinecke <aheinecke@intevation.de>
parents: 290
diff changeset
29 * GDAL/OGR compiled with FileGeodatabase-support
6e5fce16b495 Update/Rework installation dokumentation
Andre Heinecke <aheinecke@intevation.de>
parents: 290
diff changeset
30 * Other GDAL/OGR-related tools
6e5fce16b495 Update/Rework installation dokumentation
Andre Heinecke <aheinecke@intevation.de>
parents: 290
diff changeset
31 * Sphinx for building the docs
229
64cd6a115372 Reorganized INSTALL-doc, added chapter for logging
Stephan Holl <stephan.holl@intevation.de>
parents: 202
diff changeset
32
64cd6a115372 Reorganized INSTALL-doc, added chapter for logging
Stephan Holl <stephan.holl@intevation.de>
parents: 202
diff changeset
33 Install Apache Webserver
64cd6a115372 Reorganized INSTALL-doc, added chapter for logging
Stephan Holl <stephan.holl@intevation.de>
parents: 202
diff changeset
34 ------------------------
292
6e5fce16b495 Update/Rework installation dokumentation
Andre Heinecke <aheinecke@intevation.de>
parents: 290
diff changeset
35 To display the resulting mapfiles directly you need to
6e5fce16b495 Update/Rework installation dokumentation
Andre Heinecke <aheinecke@intevation.de>
parents: 290
diff changeset
36 install a webserver like Apache2 and the UMN MapServer.
229
64cd6a115372 Reorganized INSTALL-doc, added chapter for logging
Stephan Holl <stephan.holl@intevation.de>
parents: 202
diff changeset
37
290
e6e5eaf431ac added some hints about MapServer and SDE-libs
Stephan Holl <stephan.holl@intevation.de>
parents: 235
diff changeset
38 .. important::
292
6e5fce16b495 Update/Rework installation dokumentation
Andre Heinecke <aheinecke@intevation.de>
parents: 290
diff changeset
39 If you are using `MS4W <http://www.maptools.org/ms4w/>`_, the following installation
6e5fce16b495 Update/Rework installation dokumentation
Andre Heinecke <aheinecke@intevation.de>
parents: 290
diff changeset
40 instruction does apply. , although it can be used to preview the `resulting` mapfiles
6e5fce16b495 Update/Rework installation dokumentation
Andre Heinecke <aheinecke@intevation.de>
parents: 290
diff changeset
41 MS4W does not provide the needed version to run MXD2map.
290
e6e5eaf431ac added some hints about MapServer and SDE-libs
Stephan Holl <stephan.holl@intevation.de>
parents: 235
diff changeset
42
292
6e5fce16b495 Update/Rework installation dokumentation
Andre Heinecke <aheinecke@intevation.de>
parents: 290
diff changeset
43 Download Apache from https://httpd.apache.org/download.cgi and install it by
6e5fce16b495 Update/Rework installation dokumentation
Andre Heinecke <aheinecke@intevation.de>
parents: 290
diff changeset
44 executing the .msi-file and following the install-dialogs.
229
64cd6a115372 Reorganized INSTALL-doc, added chapter for logging
Stephan Holl <stephan.holl@intevation.de>
parents: 202
diff changeset
45
292
6e5fce16b495 Update/Rework installation dokumentation
Andre Heinecke <aheinecke@intevation.de>
parents: 290
diff changeset
46 Make sure that you install apache as a service so it is available
6e5fce16b495 Update/Rework installation dokumentation
Andre Heinecke <aheinecke@intevation.de>
parents: 290
diff changeset
47 directly after system startup.
229
64cd6a115372 Reorganized INSTALL-doc, added chapter for logging
Stephan Holl <stephan.holl@intevation.de>
parents: 202
diff changeset
48
64cd6a115372 Reorganized INSTALL-doc, added chapter for logging
Stephan Holl <stephan.holl@intevation.de>
parents: 202
diff changeset
49
64cd6a115372 Reorganized INSTALL-doc, added chapter for logging
Stephan Holl <stephan.holl@intevation.de>
parents: 202
diff changeset
50 Install UMN MapServer
64cd6a115372 Reorganized INSTALL-doc, added chapter for logging
Stephan Holl <stephan.holl@intevation.de>
parents: 202
diff changeset
51 ---------------------
64cd6a115372 Reorganized INSTALL-doc, added chapter for logging
Stephan Holl <stephan.holl@intevation.de>
parents: 202
diff changeset
52
292
6e5fce16b495 Update/Rework installation dokumentation
Andre Heinecke <aheinecke@intevation.de>
parents: 290
diff changeset
53 It is recommended to use the latest binary release version from http://www.gisinternals.com/sdk/
6e5fce16b495 Update/Rework installation dokumentation
Andre Heinecke <aheinecke@intevation.de>
parents: 290
diff changeset
54 as the MapServer for MXD2Map.
229
64cd6a115372 Reorganized INSTALL-doc, added chapter for logging
Stephan Holl <stephan.holl@intevation.de>
parents: 202
diff changeset
55
324
5e7e6d99f997 Make mapserver install location version independent
Andre Heinecke <aheinecke@intevation.de>
parents: 292
diff changeset
56 1. Unzip the MapServer ZIP-file at ``c:\mapserver``
229
64cd6a115372 Reorganized INSTALL-doc, added chapter for logging
Stephan Holl <stephan.holl@intevation.de>
parents: 202
diff changeset
57
292
6e5fce16b495 Update/Rework installation dokumentation
Andre Heinecke <aheinecke@intevation.de>
parents: 290
diff changeset
58 #. Modify the Apache configuration (e.g. ``c:\Program Files\Apache Software Foundation\Apache2.2\conf\httpd.conf``)
6e5fce16b495 Update/Rework installation dokumentation
Andre Heinecke <aheinecke@intevation.de>
parents: 290
diff changeset
59 by adding::
229
64cd6a115372 Reorganized INSTALL-doc, added chapter for logging
Stephan Holl <stephan.holl@intevation.de>
parents: 202
diff changeset
60
324
5e7e6d99f997 Make mapserver install location version independent
Andre Heinecke <aheinecke@intevation.de>
parents: 292
diff changeset
61 ScriptAlias /cgi-bin/ "C:/mapserver/bin/"
229
64cd6a115372 Reorganized INSTALL-doc, added chapter for logging
Stephan Holl <stephan.holl@intevation.de>
parents: 202
diff changeset
62
64cd6a115372 Reorganized INSTALL-doc, added chapter for logging
Stephan Holl <stephan.holl@intevation.de>
parents: 202
diff changeset
63 <Location "/cgi-bin">
64cd6a115372 Reorganized INSTALL-doc, added chapter for logging
Stephan Holl <stephan.holl@intevation.de>
parents: 202
diff changeset
64 Options None
64cd6a115372 Reorganized INSTALL-doc, added chapter for logging
Stephan Holl <stephan.holl@intevation.de>
parents: 202
diff changeset
65 Order allow,deny
64cd6a115372 Reorganized INSTALL-doc, added chapter for logging
Stephan Holl <stephan.holl@intevation.de>
parents: 202
diff changeset
66 Allow from all
64cd6a115372 Reorganized INSTALL-doc, added chapter for logging
Stephan Holl <stephan.holl@intevation.de>
parents: 202
diff changeset
67 </Location>
64cd6a115372 Reorganized INSTALL-doc, added chapter for logging
Stephan Holl <stephan.holl@intevation.de>
parents: 202
diff changeset
68
324
5e7e6d99f997 Make mapserver install location version independent
Andre Heinecke <aheinecke@intevation.de>
parents: 292
diff changeset
69 SetEnv PROJ_LIB "c:/mapserver/bin/proj/SHARE"
5e7e6d99f997 Make mapserver install location version independent
Andre Heinecke <aheinecke@intevation.de>
parents: 292
diff changeset
70 SetEnv PATH "c:/mapserver/bin"
5e7e6d99f997 Make mapserver install location version independent
Andre Heinecke <aheinecke@intevation.de>
parents: 292
diff changeset
71 SetEnv PATH "c:/mapserver/bin/gdal/python/osgeo"
292
6e5fce16b495 Update/Rework installation dokumentation
Andre Heinecke <aheinecke@intevation.de>
parents: 290
diff changeset
72
235
00a39e8b6eed * INSTALL.txt: Added a paragraph to make the env-vars available in Apache
Stephan Holl <stephan.holl@intevation.de>
parents: 229
diff changeset
73 # set GDAL_DATA environment variable to location of supporting gdal files
324
5e7e6d99f997 Make mapserver install location version independent
Andre Heinecke <aheinecke@intevation.de>
parents: 292
diff changeset
74 SetEnv GDAL_DATA "c:/mapserver/bin/gdaldata"
292
6e5fce16b495 Update/Rework installation dokumentation
Andre Heinecke <aheinecke@intevation.de>
parents: 290
diff changeset
75
235
00a39e8b6eed * INSTALL.txt: Added a paragraph to make the env-vars available in Apache
Stephan Holl <stephan.holl@intevation.de>
parents: 229
diff changeset
76 # set GDAL_DRIVER_PATH environment variable for gdal plugins
324
5e7e6d99f997 Make mapserver install location version independent
Andre Heinecke <aheinecke@intevation.de>
parents: 292
diff changeset
77 SetEnv GDAL_DRIVER_PATH "c:/mapserver/bin/gdal/plugins"
235
00a39e8b6eed * INSTALL.txt: Added a paragraph to make the env-vars available in Apache
Stephan Holl <stephan.holl@intevation.de>
parents: 229
diff changeset
78
290
e6e5eaf431ac added some hints about MapServer and SDE-libs
Stephan Holl <stephan.holl@intevation.de>
parents: 235
diff changeset
79
324
5e7e6d99f997 Make mapserver install location version independent
Andre Heinecke <aheinecke@intevation.de>
parents: 292
diff changeset
80 #. Copy mapserv.exe from ``c:\mapserver\bin\ms\apps`` to ``c:\mapserver\bin\``
292
6e5fce16b495 Update/Rework installation dokumentation
Andre Heinecke <aheinecke@intevation.de>
parents: 290
diff changeset
81
324
5e7e6d99f997 Make mapserver install location version independent
Andre Heinecke <aheinecke@intevation.de>
parents: 292
diff changeset
82 #. Optional: Add additional Libraries (DLL's) to ``c:\mapserver\bin`` for Oracle, SDE etc.
292
6e5fce16b495 Update/Rework installation dokumentation
Andre Heinecke <aheinecke@intevation.de>
parents: 290
diff changeset
83
6e5fce16b495 Update/Rework installation dokumentation
Andre Heinecke <aheinecke@intevation.de>
parents: 290
diff changeset
84 Install the Converter
6e5fce16b495 Update/Rework installation dokumentation
Andre Heinecke <aheinecke@intevation.de>
parents: 290
diff changeset
85 ------------
6e5fce16b495 Update/Rework installation dokumentation
Andre Heinecke <aheinecke@intevation.de>
parents: 290
diff changeset
86 The following steps assume the runtime folder to be c:\mxd2map.
6e5fce16b495 Update/Rework installation dokumentation
Andre Heinecke <aheinecke@intevation.de>
parents: 290
diff changeset
87
6e5fce16b495 Update/Rework installation dokumentation
Andre Heinecke <aheinecke@intevation.de>
parents: 290
diff changeset
88 1. Download the Source Package from https://mxd2map.org/download.html
6e5fce16b495 Update/Rework installation dokumentation
Andre Heinecke <aheinecke@intevation.de>
parents: 290
diff changeset
89
6e5fce16b495 Update/Rework installation dokumentation
Andre Heinecke <aheinecke@intevation.de>
parents: 290
diff changeset
90 #. Extract the tarball using 7-Zip (http://7-zip.org) or something similar to ``c:\mxd2map\``.
6e5fce16b495 Update/Rework installation dokumentation
Andre Heinecke <aheinecke@intevation.de>
parents: 290
diff changeset
91
6e5fce16b495 Update/Rework installation dokumentation
Andre Heinecke <aheinecke@intevation.de>
parents: 290
diff changeset
92 #. Create folder ``c:\mxd2map\lib\``
6e5fce16b495 Update/Rework installation dokumentation
Andre Heinecke <aheinecke@intevation.de>
parents: 290
diff changeset
93
6e5fce16b495 Update/Rework installation dokumentation
Andre Heinecke <aheinecke@intevation.de>
parents: 290
diff changeset
94 #. Create folder ``c:\mxd2map\logs\``
6e5fce16b495 Update/Rework installation dokumentation
Andre Heinecke <aheinecke@intevation.de>
parents: 290
diff changeset
95
6e5fce16b495 Update/Rework installation dokumentation
Andre Heinecke <aheinecke@intevation.de>
parents: 290
diff changeset
96 #. Get log4j from http://logging.apache.org/log4j/1.2/download.html
6e5fce16b495 Update/Rework installation dokumentation
Andre Heinecke <aheinecke@intevation.de>
parents: 290
diff changeset
97
6e5fce16b495 Update/Rework installation dokumentation
Andre Heinecke <aheinecke@intevation.de>
parents: 290
diff changeset
98 #. Get jargs http://jargs.sourceforge.net/ (Version 1.0)
6e5fce16b495 Update/Rework installation dokumentation
Andre Heinecke <aheinecke@intevation.de>
parents: 290
diff changeset
99
6e5fce16b495 Update/Rework installation dokumentation
Andre Heinecke <aheinecke@intevation.de>
parents: 290
diff changeset
100 #. Get apache commons codec from https://commons.apache.org/codec/download_codec.cgi
6e5fce16b495 Update/Rework installation dokumentation
Andre Heinecke <aheinecke@intevation.de>
parents: 290
diff changeset
101
6e5fce16b495 Update/Rework installation dokumentation
Andre Heinecke <aheinecke@intevation.de>
parents: 290
diff changeset
102 #. Copy the jar-files of log4j, jargs and commons codec to ``c:\mxd2map\lib\``
6e5fce16b495 Update/Rework installation dokumentation
Andre Heinecke <aheinecke@intevation.de>
parents: 290
diff changeset
103
6e5fce16b495 Update/Rework installation dokumentation
Andre Heinecke <aheinecke@intevation.de>
parents: 290
diff changeset
104 #. Remove the version numbers of the jar file names in lib, or adopt the build.xml accordingly!
6e5fce16b495 Update/Rework installation dokumentation
Andre Heinecke <aheinecke@intevation.de>
parents: 290
diff changeset
105
324
5e7e6d99f997 Make mapserver install location version independent
Andre Heinecke <aheinecke@intevation.de>
parents: 292
diff changeset
106 #. Copy mapscript.jar and mapscript.dll from your MapServer Installation (e.g. ``c:\mapserver\bin\ms\java``) to ``c:\mxd2map\lib\``
292
6e5fce16b495 Update/Rework installation dokumentation
Andre Heinecke <aheinecke@intevation.de>
parents: 290
diff changeset
107
6e5fce16b495 Update/Rework installation dokumentation
Andre Heinecke <aheinecke@intevation.de>
parents: 290
diff changeset
108 #. Copy the converter.properties.sample file to ``c:\mxd2map\converter.properties`` and edit it
6e5fce16b495 Update/Rework installation dokumentation
Andre Heinecke <aheinecke@intevation.de>
parents: 290
diff changeset
109 according to your needs.
6e5fce16b495 Update/Rework installation dokumentation
Andre Heinecke <aheinecke@intevation.de>
parents: 290
diff changeset
110
6e5fce16b495 Update/Rework installation dokumentation
Andre Heinecke <aheinecke@intevation.de>
parents: 290
diff changeset
111 Compile the converter-sources
6e5fce16b495 Update/Rework installation dokumentation
Andre Heinecke <aheinecke@intevation.de>
parents: 290
diff changeset
112 -----------------------------
6e5fce16b495 Update/Rework installation dokumentation
Andre Heinecke <aheinecke@intevation.de>
parents: 290
diff changeset
113
6e5fce16b495 Update/Rework installation dokumentation
Andre Heinecke <aheinecke@intevation.de>
parents: 290
diff changeset
114 To compile the sources you need to have a properly configured
6e5fce16b495 Update/Rework installation dokumentation
Andre Heinecke <aheinecke@intevation.de>
parents: 290
diff changeset
115 ant-environment available. ArcGIS SDK provides an ant-installation which
6e5fce16b495 Update/Rework installation dokumentation
Andre Heinecke <aheinecke@intevation.de>
parents: 290
diff changeset
116 suffices::
6e5fce16b495 Update/Rework installation dokumentation
Andre Heinecke <aheinecke@intevation.de>
parents: 290
diff changeset
117
6e5fce16b495 Update/Rework installation dokumentation
Andre Heinecke <aheinecke@intevation.de>
parents: 290
diff changeset
118 ant jar
6e5fce16b495 Update/Rework installation dokumentation
Andre Heinecke <aheinecke@intevation.de>
parents: 290
diff changeset
119
6e5fce16b495 Update/Rework installation dokumentation
Andre Heinecke <aheinecke@intevation.de>
parents: 290
diff changeset
120 or::
6e5fce16b495 Update/Rework installation dokumentation
Andre Heinecke <aheinecke@intevation.de>
parents: 290
diff changeset
121
6e5fce16b495 Update/Rework installation dokumentation
Andre Heinecke <aheinecke@intevation.de>
parents: 290
diff changeset
122 ant jar-norevision
6e5fce16b495 Update/Rework installation dokumentation
Andre Heinecke <aheinecke@intevation.de>
parents: 290
diff changeset
123
6e5fce16b495 Update/Rework installation dokumentation
Andre Heinecke <aheinecke@intevation.de>
parents: 290
diff changeset
124 Setup environment-variables
6e5fce16b495 Update/Rework installation dokumentation
Andre Heinecke <aheinecke@intevation.de>
parents: 290
diff changeset
125 ---------------------------
6e5fce16b495 Update/Rework installation dokumentation
Andre Heinecke <aheinecke@intevation.de>
parents: 290
diff changeset
126
6e5fce16b495 Update/Rework installation dokumentation
Andre Heinecke <aheinecke@intevation.de>
parents: 290
diff changeset
127 For running the converter it is necessary to set up some environment
6e5fce16b495 Update/Rework installation dokumentation
Andre Heinecke <aheinecke@intevation.de>
parents: 290
diff changeset
128 variables and adjust the path accordingly.
6e5fce16b495 Update/Rework installation dokumentation
Andre Heinecke <aheinecke@intevation.de>
parents: 290
diff changeset
129
6e5fce16b495 Update/Rework installation dokumentation
Andre Heinecke <aheinecke@intevation.de>
parents: 290
diff changeset
130 Adapt the following example script to set the minimum variables needed::
6e5fce16b495 Update/Rework installation dokumentation
Andre Heinecke <aheinecke@intevation.de>
parents: 290
diff changeset
131
6e5fce16b495 Update/Rework installation dokumentation
Andre Heinecke <aheinecke@intevation.de>
parents: 290
diff changeset
132 @echo off
6e5fce16b495 Update/Rework installation dokumentation
Andre Heinecke <aheinecke@intevation.de>
parents: 290
diff changeset
133
6e5fce16b495 Update/Rework installation dokumentation
Andre Heinecke <aheinecke@intevation.de>
parents: 290
diff changeset
134 rem ###########################EDIT HERE#############################
6e5fce16b495 Update/Rework installation dokumentation
Andre Heinecke <aheinecke@intevation.de>
parents: 290
diff changeset
135
6e5fce16b495 Update/Rework installation dokumentation
Andre Heinecke <aheinecke@intevation.de>
parents: 290
diff changeset
136 rem Set the following Path variables according to your installation:
6e5fce16b495 Update/Rework installation dokumentation
Andre Heinecke <aheinecke@intevation.de>
parents: 290
diff changeset
137
6e5fce16b495 Update/Rework installation dokumentation
Andre Heinecke <aheinecke@intevation.de>
parents: 290
diff changeset
138 set MXD2MAP_PATH=c:\mxd2map
324
5e7e6d99f997 Make mapserver install location version independent
Andre Heinecke <aheinecke@intevation.de>
parents: 292
diff changeset
139 set MAPSERVER_PATH=c:\mapserver
292
6e5fce16b495 Update/Rework installation dokumentation
Andre Heinecke <aheinecke@intevation.de>
parents: 290
diff changeset
140 set ARCGISSDK_PATH=c:\Program Files\ArcGIS\DeveloperKit10.0
6e5fce16b495 Update/Rework installation dokumentation
Andre Heinecke <aheinecke@intevation.de>
parents: 290
diff changeset
141 set ARCGISENGINE_PATH=c:\Program Files\ArcGIS\Engine10.0
6e5fce16b495 Update/Rework installation dokumentation
Andre Heinecke <aheinecke@intevation.de>
parents: 290
diff changeset
142
6e5fce16b495 Update/Rework installation dokumentation
Andre Heinecke <aheinecke@intevation.de>
parents: 290
diff changeset
143 rem No editing should be necessary below this line (in an ideal world)
6e5fce16b495 Update/Rework installation dokumentation
Andre Heinecke <aheinecke@intevation.de>
parents: 290
diff changeset
144 rem ##################################################################
6e5fce16b495 Update/Rework installation dokumentation
Andre Heinecke <aheinecke@intevation.de>
parents: 290
diff changeset
145
6e5fce16b495 Update/Rework installation dokumentation
Andre Heinecke <aheinecke@intevation.de>
parents: 290
diff changeset
146 if "%1" == "setenv" goto setenv
6e5fce16b495 Update/Rework installation dokumentation
Andre Heinecke <aheinecke@intevation.de>
parents: 290
diff changeset
147
6e5fce16b495 Update/Rework installation dokumentation
Andre Heinecke <aheinecke@intevation.de>
parents: 290
diff changeset
148 %comspec% /k SDKShell.bat setenv %1
6e5fce16b495 Update/Rework installation dokumentation
Andre Heinecke <aheinecke@intevation.de>
parents: 290
diff changeset
149 goto exit
6e5fce16b495 Update/Rework installation dokumentation
Andre Heinecke <aheinecke@intevation.de>
parents: 290
diff changeset
150
6e5fce16b495 Update/Rework installation dokumentation
Andre Heinecke <aheinecke@intevation.de>
parents: 290
diff changeset
151 :setenv
6e5fce16b495 Update/Rework installation dokumentation
Andre Heinecke <aheinecke@intevation.de>
parents: 290
diff changeset
152 @echo Setting environment for using the GDAL and MapServer tools.
6e5fce16b495 Update/Rework installation dokumentation
Andre Heinecke <aheinecke@intevation.de>
parents: 290
diff changeset
153
6e5fce16b495 Update/Rework installation dokumentation
Andre Heinecke <aheinecke@intevation.de>
parents: 290
diff changeset
154 if "%2"=="hideoci" goto hideoci
6e5fce16b495 Update/Rework installation dokumentation
Andre Heinecke <aheinecke@intevation.de>
parents: 290
diff changeset
155
6e5fce16b495 Update/Rework installation dokumentation
Andre Heinecke <aheinecke@intevation.de>
parents: 290
diff changeset
156 set ocipath=0
6e5fce16b495 Update/Rework installation dokumentation
Andre Heinecke <aheinecke@intevation.de>
parents: 290
diff changeset
157 set _path="%PATH:;=" "%"
6e5fce16b495 Update/Rework installation dokumentation
Andre Heinecke <aheinecke@intevation.de>
parents: 290
diff changeset
158 for %%p in (%_path%) do if not "%%~p"=="" if exist %%~p\oci.dll set ocipath=1
6e5fce16b495 Update/Rework installation dokumentation
Andre Heinecke <aheinecke@intevation.de>
parents: 290
diff changeset
159
6e5fce16b495 Update/Rework installation dokumentation
Andre Heinecke <aheinecke@intevation.de>
parents: 290
diff changeset
160 if "%ocipath%"=="0" goto hideoci
6e5fce16b495 Update/Rework installation dokumentation
Andre Heinecke <aheinecke@intevation.de>
parents: 290
diff changeset
161 @echo WARNING: If you encounter problems with missing oci libraries then type:
6e5fce16b495 Update/Rework installation dokumentation
Andre Heinecke <aheinecke@intevation.de>
parents: 290
diff changeset
162 @echo SDKShell hideoci
6e5fce16b495 Update/Rework installation dokumentation
Andre Heinecke <aheinecke@intevation.de>
parents: 290
diff changeset
163 goto setenv2
6e5fce16b495 Update/Rework installation dokumentation
Andre Heinecke <aheinecke@intevation.de>
parents: 290
diff changeset
164
6e5fce16b495 Update/Rework installation dokumentation
Andre Heinecke <aheinecke@intevation.de>
parents: 290
diff changeset
165 :hideoci
6e5fce16b495 Update/Rework installation dokumentation
Andre Heinecke <aheinecke@intevation.de>
parents: 290
diff changeset
166 @echo Hiding the OCI plugin library.
6e5fce16b495 Update/Rework installation dokumentation
Andre Heinecke <aheinecke@intevation.de>
parents: 290
diff changeset
167 if not exist %GDAL_PATH%\bin\gdal\plugins-optional mkdir %GDAL_PATH%\bin\gdal\plugins-optional
6e5fce16b495 Update/Rework installation dokumentation
Andre Heinecke <aheinecke@intevation.de>
parents: 290
diff changeset
168 if exist %GDAL_PATH%\bin\gdal\plugins\ogr_OCI.dll move %GDAL_PATH%\bin\gdal\plugins\ogr_OCI.dll %GDAL_PATH%\bin\gdal\plugins-optional\ogr_OCI.dll
6e5fce16b495 Update/Rework installation dokumentation
Andre Heinecke <aheinecke@intevation.de>
parents: 290
diff changeset
169 if exist %GDAL_PATH%\bin\gdal\plugins\gdal_GEOR.dll move %GDAL_PATH%\bin\gdal\plugins\gdal_GEOR.dll %GDAL_PATH%\bin\gdal\plugins-optional\gdal_GEOR.dll
6e5fce16b495 Update/Rework installation dokumentation
Andre Heinecke <aheinecke@intevation.de>
parents: 290
diff changeset
170
6e5fce16b495 Update/Rework installation dokumentation
Andre Heinecke <aheinecke@intevation.de>
parents: 290
diff changeset
171 :setenv2
6e5fce16b495 Update/Rework installation dokumentation
Andre Heinecke <aheinecke@intevation.de>
parents: 290
diff changeset
172 SET PATH=%ARCGISSDK_PATH%\java\jre\bin;%ARCGISENGINE_PATH%\bin;%MXD2MAP_PATH%\bin;%MAPSERVER_PATH%\bin\gdal\python\osgeo;%MAPSERVER_PATH%\bin\proj\apps;%MAPSERVER_PATH%\bin\gdal\apps;%MAPSERVER_PATH%\bin\ms\apps;%MAPSERVER_PATH%\bin\gdal\csharp;%MAPSERVER_PATH%\bin\ms\csharp;%MAPSERVER_PATH%\bin\curl;%MAPSERVER_PATH%\bin\ms\java;%PATH%
6e5fce16b495 Update/Rework installation dokumentation
Andre Heinecke <aheinecke@intevation.de>
parents: 290
diff changeset
173 SET GDAL_DATA=%MAPSERVER_PATH%\bin\gdal-data
6e5fce16b495 Update/Rework installation dokumentation
Andre Heinecke <aheinecke@intevation.de>
parents: 290
diff changeset
174 SET GDAL_DRIVER_PATH=%MAPSERVER_PATH%\bin\gdal\plugins
6e5fce16b495 Update/Rework installation dokumentation
Andre Heinecke <aheinecke@intevation.de>
parents: 290
diff changeset
175 SET PYTHONPATH=%MAPSERVER_PATH%\bin\gdal\python\osgeo;%PYTHONPATH%
6e5fce16b495 Update/Rework installation dokumentation
Andre Heinecke <aheinecke@intevation.de>
parents: 290
diff changeset
176 SET PROJ_LIB=%MAPSERVER_PATH%\bin\proj\SHARE
6e5fce16b495 Update/Rework installation dokumentation
Andre Heinecke <aheinecke@intevation.de>
parents: 290
diff changeset
177
6e5fce16b495 Update/Rework installation dokumentation
Andre Heinecke <aheinecke@intevation.de>
parents: 290
diff changeset
178 :exit
6e5fce16b495 Update/Rework installation dokumentation
Andre Heinecke <aheinecke@intevation.de>
parents: 290
diff changeset
179
6e5fce16b495 Update/Rework installation dokumentation
Andre Heinecke <aheinecke@intevation.de>
parents: 290
diff changeset
180 Save the above script as ``c:\mxd2map\SDKShell.bat`` and execute it before working with MXD2map.
229
64cd6a115372 Reorganized INSTALL-doc, added chapter for logging
Stephan Holl <stephan.holl@intevation.de>
parents: 202
diff changeset
181
64cd6a115372 Reorganized INSTALL-doc, added chapter for logging
Stephan Holl <stephan.holl@intevation.de>
parents: 202
diff changeset
182 Configure Logging
64cd6a115372 Reorganized INSTALL-doc, added chapter for logging
Stephan Holl <stephan.holl@intevation.de>
parents: 202
diff changeset
183 -----------------
64cd6a115372 Reorganized INSTALL-doc, added chapter for logging
Stephan Holl <stephan.holl@intevation.de>
parents: 202
diff changeset
184
292
6e5fce16b495 Update/Rework installation dokumentation
Andre Heinecke <aheinecke@intevation.de>
parents: 290
diff changeset
185 Logging is supported on different levels. MXD2map logs with Log4J. A
6e5fce16b495 Update/Rework installation dokumentation
Andre Heinecke <aheinecke@intevation.de>
parents: 290
diff changeset
186 sample configuration for Log4J could look like this::
229
64cd6a115372 Reorganized INSTALL-doc, added chapter for logging
Stephan Holl <stephan.holl@intevation.de>
parents: 202
diff changeset
187
64cd6a115372 Reorganized INSTALL-doc, added chapter for logging
Stephan Holl <stephan.holl@intevation.de>
parents: 202
diff changeset
188 #### Log just errors and warnings to a file.
64cd6a115372 Reorganized INSTALL-doc, added chapter for logging
Stephan Holl <stephan.holl@intevation.de>
parents: 202
diff changeset
189 log4j.rootLogger=DEBUG, MXD, Console
64cd6a115372 Reorganized INSTALL-doc, added chapter for logging
Stephan Holl <stephan.holl@intevation.de>
parents: 202
diff changeset
190
64cd6a115372 Reorganized INSTALL-doc, added chapter for logging
Stephan Holl <stephan.holl@intevation.de>
parents: 202
diff changeset
191 log4j.appender.MXD=org.apache.log4j.RollingFileAppender
64cd6a115372 Reorganized INSTALL-doc, added chapter for logging
Stephan Holl <stephan.holl@intevation.de>
parents: 202
diff changeset
192 log4j.appender.MXD.File=./logs/console-client.log
64cd6a115372 Reorganized INSTALL-doc, added chapter for logging
Stephan Holl <stephan.holl@intevation.de>
parents: 202
diff changeset
193 log4j.appender.MXD.MaxFileSize=5000KB
64cd6a115372 Reorganized INSTALL-doc, added chapter for logging
Stephan Holl <stephan.holl@intevation.de>
parents: 202
diff changeset
194 log4j.appender.MXD.MaxBackupIndex=1
64cd6a115372 Reorganized INSTALL-doc, added chapter for logging
Stephan Holl <stephan.holl@intevation.de>
parents: 202
diff changeset
195 log4j.appender.MXD.layout=org.apache.log4j.PatternLayout
64cd6a115372 Reorganized INSTALL-doc, added chapter for logging
Stephan Holl <stephan.holl@intevation.de>
parents: 202
diff changeset
196 log4j.appender.MXD.layout.ConversionPattern=%d [%t] %-5p %c - %m%n
64cd6a115372 Reorganized INSTALL-doc, added chapter for logging
Stephan Holl <stephan.holl@intevation.de>
parents: 202
diff changeset
197
64cd6a115372 Reorganized INSTALL-doc, added chapter for logging
Stephan Holl <stephan.holl@intevation.de>
parents: 202
diff changeset
198 #log4j.rootLogger=WARN, Console
64cd6a115372 Reorganized INSTALL-doc, added chapter for logging
Stephan Holl <stephan.holl@intevation.de>
parents: 202
diff changeset
199 log4j.appender.Console=org.apache.log4j.ConsoleAppender
64cd6a115372 Reorganized INSTALL-doc, added chapter for logging
Stephan Holl <stephan.holl@intevation.de>
parents: 202
diff changeset
200 log4j.appender.Console.Threshold=INFO
64cd6a115372 Reorganized INSTALL-doc, added chapter for logging
Stephan Holl <stephan.holl@intevation.de>
parents: 202
diff changeset
201 log4j.appender.Console.layout=org.apache.log4j.PatternLayout
64cd6a115372 Reorganized INSTALL-doc, added chapter for logging
Stephan Holl <stephan.holl@intevation.de>
parents: 202
diff changeset
202 log4j.appender.Console.layout.ConversionPattern=%d [%t] %-5p %c - %m%n
64cd6a115372 Reorganized INSTALL-doc, added chapter for logging
Stephan Holl <stephan.holl@intevation.de>
parents: 202
diff changeset
203
64cd6a115372 Reorganized INSTALL-doc, added chapter for logging
Stephan Holl <stephan.holl@intevation.de>
parents: 202
diff changeset
204
64cd6a115372 Reorganized INSTALL-doc, added chapter for logging
Stephan Holl <stephan.holl@intevation.de>
parents: 202
diff changeset
205 Apache Webserver and UMN MapServer
64cd6a115372 Reorganized INSTALL-doc, added chapter for logging
Stephan Holl <stephan.holl@intevation.de>
parents: 202
diff changeset
206 ..................................
64cd6a115372 Reorganized INSTALL-doc, added chapter for logging
Stephan Holl <stephan.holl@intevation.de>
parents: 202
diff changeset
207
292
6e5fce16b495 Update/Rework installation dokumentation
Andre Heinecke <aheinecke@intevation.de>
parents: 290
diff changeset
208 They both support logging. MapServers output ends up in Apaches logfiles
229
64cd6a115372 Reorganized INSTALL-doc, added chapter for logging
Stephan Holl <stephan.holl@intevation.de>
parents: 202
diff changeset
209 if not configured differently within a providing template. The loglevel
64cd6a115372 Reorganized INSTALL-doc, added chapter for logging
Stephan Holl <stephan.holl@intevation.de>
parents: 202
diff changeset
210 can be adjusted at template-level. For further information consult the UMN
64cd6a115372 Reorganized INSTALL-doc, added chapter for logging
Stephan Holl <stephan.holl@intevation.de>
parents: 202
diff changeset
211 MapServer manual regarding logging at
64cd6a115372 Reorganized INSTALL-doc, added chapter for logging
Stephan Holl <stephan.holl@intevation.de>
parents: 202
diff changeset
212 http://mapserver.org/optimization/debugging.html#steps-to-enable-mapserver-debugging.
This site is hosted by Intevation GmbH (Datenschutzerklärung und Impressum | Privacy Policy and Imprint)