mxd2map: INSTALL.txt annotate

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.

Mercurial > mxd2map

annotate INSTALL.txt @ 343:9d6d3cca688c