mxd2map: INSTALL.txt annotate

annotate INSTALL.txt @ 287:584bc79cf4ad

changed copyright to Intevation as stated in all src-files

author	Stephan Holl <stephan.holl@intevation.de>
date	Mon, 28 Nov 2011 14:31:51 +0100
parents	00a39e8b6eed
children	e6e5eaf431ac

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 ------------
0ebaec057f15 * INSTALL.txt: added a hint how to install the converter and its Stephan Holl <stephan.holl@intevation.de> parents: diff changeset	5 Requirements
0ebaec057f15 * INSTALL.txt: added a hint how to install the converter and its Stephan Holl <stephan.holl@intevation.de> parents: diff changeset	6 ------------
0ebaec057f15 * INSTALL.txt: added a hint how to install the converter and its Stephan Holl <stephan.holl@intevation.de> parents: diff changeset	7
0ebaec057f15 * INSTALL.txt: added a hint how to install the converter and its Stephan Holl <stephan.holl@intevation.de> parents: diff changeset	8 The current version of the converter only runs on Windows. This is because
229 64cd6a115372 Reorganized INSTALL-doc, added chapter for logging Stephan Holl <stephan.holl@intevation.de> parents: 202 diff changeset	9 the ArcObjects JDK API is not running properly on Linux though. In theory
64cd6a115372 Reorganized INSTALL-doc, added chapter for logging Stephan Holl <stephan.holl@intevation.de> parents: 202 diff changeset	10 it should also run on Linux.
140 0ebaec057f15 * INSTALL.txt: added a hint how to install the converter and its Stephan Holl <stephan.holl@intevation.de> parents: diff changeset	11
0ebaec057f15 * INSTALL.txt: added a hint how to install the converter and its Stephan Holl <stephan.holl@intevation.de> parents: diff changeset	12 To run the converter you need at least the following componentes:
0ebaec057f15 * INSTALL.txt: added a hint how to install the converter and its Stephan Holl <stephan.holl@intevation.de> parents: diff changeset	13
0ebaec057f15 * INSTALL.txt: added a hint how to install the converter and its Stephan Holl <stephan.holl@intevation.de> parents: diff changeset	14 * 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	15 * 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	16 * UMN MapServer with Java MapScript-bindings (>=6.0.1 or recent development-version)
229 64cd6a115372 Reorganized INSTALL-doc, added chapter for logging Stephan Holl <stephan.holl@intevation.de> parents: 202 diff changeset	17 * Optinal: Apache2 Webserver for displaying the resulting Mapfiles
140 0ebaec057f15 * INSTALL.txt: added a hint how to install the converter and its Stephan Holl <stephan.holl@intevation.de> parents: diff changeset	18 * Optional: MapServer compiled with ArcSDE-plugin
0ebaec057f15 * INSTALL.txt: added a hint how to install the converter and its Stephan Holl <stephan.holl@intevation.de> parents: diff changeset	19 * Optional: GDAL/OGR compiled with ArcSDE-support
229 64cd6a115372 Reorganized INSTALL-doc, added chapter for logging Stephan Holl <stephan.holl@intevation.de> parents: 202 diff changeset	20 * Optional: GDAL/OGR compiled with FileGeodatabase-support
64cd6a115372 Reorganized INSTALL-doc, added chapter for logging Stephan Holl <stephan.holl@intevation.de> parents: 202 diff changeset	21 * Optional: Other GDAL/OGR-related tools
64cd6a115372 Reorganized INSTALL-doc, added chapter for logging Stephan Holl <stephan.holl@intevation.de> parents: 202 diff changeset	22 * Optional: Sphinx for building the docs
140 0ebaec057f15 * INSTALL.txt: added a hint how to install the converter and its Stephan Holl <stephan.holl@intevation.de> parents: diff changeset	23
0ebaec057f15 * INSTALL.txt: added a hint how to install the converter and its Stephan Holl <stephan.holl@intevation.de> parents: diff changeset	24
0ebaec057f15 * INSTALL.txt: added a hint how to install the converter and its Stephan Holl <stephan.holl@intevation.de> parents: diff changeset	25 ------------
0ebaec057f15 * INSTALL.txt: added a hint how to install the converter and its Stephan Holl <stephan.holl@intevation.de> parents: diff changeset	26 Installation
0ebaec057f15 * INSTALL.txt: added a hint how to install the converter and its Stephan Holl <stephan.holl@intevation.de> parents: diff changeset	27 ------------
0ebaec057f15 * INSTALL.txt: added a hint how to install the converter and its Stephan Holl <stephan.holl@intevation.de> parents: diff changeset	28
0ebaec057f15 * INSTALL.txt: added a hint how to install the converter and its Stephan Holl <stephan.holl@intevation.de> parents: diff changeset	29 Compile the converter-sources
0ebaec057f15 * INSTALL.txt: added a hint how to install the converter and its Stephan Holl <stephan.holl@intevation.de> parents: diff changeset	30 -----------------------------
0ebaec057f15 * INSTALL.txt: added a hint how to install the converter and its Stephan Holl <stephan.holl@intevation.de> parents: diff changeset	31
0ebaec057f15 * INSTALL.txt: added a hint how to install the converter and its Stephan Holl <stephan.holl@intevation.de> parents: diff changeset	32 To compile the sources you need to have a properly configured
0ebaec057f15 * INSTALL.txt: added a hint how to install the converter and its Stephan Holl <stephan.holl@intevation.de> parents: diff changeset	33 ant-environmet available. ArcGIS SDK provides an ant-installation which
0ebaec057f15 * INSTALL.txt: added a hint how to install the converter and its Stephan Holl <stephan.holl@intevation.de> parents: diff changeset	34 suffices::
0ebaec057f15 * INSTALL.txt: added a hint how to install the converter and its Stephan Holl <stephan.holl@intevation.de> parents: diff changeset	35
0ebaec057f15 * INSTALL.txt: added a hint how to install the converter and its Stephan Holl <stephan.holl@intevation.de> parents: diff changeset	36 ant jar
0ebaec057f15 * INSTALL.txt: added a hint how to install the converter and its Stephan Holl <stephan.holl@intevation.de> parents: diff changeset	37
182 91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment Raimund Renkert <rrenkert@intevation.de> parents: 140 diff changeset	38 or::
91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment Raimund Renkert <rrenkert@intevation.de> parents: 140 diff changeset	39
91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment Raimund Renkert <rrenkert@intevation.de> parents: 140 diff changeset	40 ant jar-norevision
91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment Raimund Renkert <rrenkert@intevation.de> parents: 140 diff changeset	41
140 0ebaec057f15 * INSTALL.txt: added a hint how to install the converter and its Stephan Holl <stephan.holl@intevation.de> parents: diff changeset	42 Create run-environment
0ebaec057f15 * INSTALL.txt: added a hint how to install the converter and its Stephan Holl <stephan.holl@intevation.de> parents: diff changeset	43 ----------------------
0ebaec057f15 * INSTALL.txt: added a hint how to install the converter and its Stephan Holl <stephan.holl@intevation.de> parents: diff changeset	44
182 91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment Raimund Renkert <rrenkert@intevation.de> parents: 140 diff changeset	45 The current version of MXD2map needs a few steps to run properly.
91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment Raimund Renkert <rrenkert@intevation.de> parents: 140 diff changeset	46 The following steps assume the runtime folder to be c:/mxd2map/. This path can
91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment Raimund Renkert <rrenkert@intevation.de> parents: 140 diff changeset	47 be changed.
140 0ebaec057f15 * INSTALL.txt: added a hint how to install the converter and its Stephan Holl <stephan.holl@intevation.de> parents: diff changeset	48
202 1e3a5019c4ed * INSTALL.txt, LICENCE.txt, doku/source/LICENCE.txt, Stephan Holl <stephan.holl@intevation.de> parents: 188 diff changeset	49 1. Copy ``mxd2map.jar`` to ``c:/mxd2map/``.
140 0ebaec057f15 * INSTALL.txt: added a hint how to install the converter and its Stephan Holl <stephan.holl@intevation.de> parents: diff changeset	50
202 1e3a5019c4ed * INSTALL.txt, LICENCE.txt, doku/source/LICENCE.txt, Stephan Holl <stephan.holl@intevation.de> parents: 188 diff changeset	51 #. Copy folder "conf" from repository to ``c:/mxd2map/``
182 91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment Raimund Renkert <rrenkert@intevation.de> parents: 140 diff changeset	52
202 1e3a5019c4ed * INSTALL.txt, LICENCE.txt, doku/source/LICENCE.txt, Stephan Holl <stephan.holl@intevation.de> parents: 188 diff changeset	53 #. Create folder ``c:/mxd2map/lib/``
182 91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment Raimund Renkert <rrenkert@intevation.de> parents: 140 diff changeset	54
91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment Raimund Renkert <rrenkert@intevation.de> parents: 140 diff changeset	55 #. Get log4j from http://logging.apache.org/log4j/1.2/download.html
91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment Raimund Renkert <rrenkert@intevation.de> parents: 140 diff changeset	56
91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment Raimund Renkert <rrenkert@intevation.de> parents: 140 diff changeset	57 #. Get jargs http://jargs.sourceforge.net/ (Version 1.0)
91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment Raimund Renkert <rrenkert@intevation.de> parents: 140 diff changeset	58
202 1e3a5019c4ed * INSTALL.txt, LICENCE.txt, doku/source/LICENCE.txt, Stephan Holl <stephan.holl@intevation.de> parents: 188 diff changeset	59 #. Build the libraries and copy the resulting jar-files to ``c:/mxd2map/lib/``
182 91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment Raimund Renkert <rrenkert@intevation.de> parents: 140 diff changeset	60
202 1e3a5019c4ed * INSTALL.txt, LICENCE.txt, doku/source/LICENCE.txt, Stephan Holl <stephan.holl@intevation.de> parents: 188 diff changeset	61 #. Copy mapscript.jar and mapscript.dll to ``c:/mxd2map/lib/``
182 91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment Raimund Renkert <rrenkert@intevation.de> parents: 140 diff changeset	62
202 1e3a5019c4ed * INSTALL.txt, LICENCE.txt, doku/source/LICENCE.txt, Stephan Holl <stephan.holl@intevation.de> parents: 188 diff changeset	63 #. Create a folder ``c:/mxd2map/logs/``
182 91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment Raimund Renkert <rrenkert@intevation.de> parents: 140 diff changeset	64
202 1e3a5019c4ed * INSTALL.txt, LICENCE.txt, doku/source/LICENCE.txt, Stephan Holl <stephan.holl@intevation.de> parents: 188 diff changeset	65 #. Create or copy a converter.properties file to ``c:/mxd2map/``
1e3a5019c4ed * INSTALL.txt, LICENCE.txt, doku/source/LICENCE.txt, Stephan Holl <stephan.holl@intevation.de> parents: 188 diff changeset	66
1e3a5019c4ed * INSTALL.txt, LICENCE.txt, doku/source/LICENCE.txt, Stephan Holl <stephan.holl@intevation.de> parents: 188 diff changeset	67 Setup environment-variables
1e3a5019c4ed * INSTALL.txt, LICENCE.txt, doku/source/LICENCE.txt, Stephan Holl <stephan.holl@intevation.de> parents: 188 diff changeset	68 ---------------------------
1e3a5019c4ed * INSTALL.txt, LICENCE.txt, doku/source/LICENCE.txt, Stephan Holl <stephan.holl@intevation.de> parents: 188 diff changeset	69
1e3a5019c4ed * INSTALL.txt, LICENCE.txt, doku/source/LICENCE.txt, Stephan Holl <stephan.holl@intevation.de> parents: 188 diff changeset	70 For running the converter it is necessary to set up some environment
1e3a5019c4ed * INSTALL.txt, LICENCE.txt, doku/source/LICENCE.txt, Stephan Holl <stephan.holl@intevation.de> parents: 188 diff changeset	71 variables and adjust the path accordingly.
1e3a5019c4ed * INSTALL.txt, LICENCE.txt, doku/source/LICENCE.txt, Stephan Holl <stephan.holl@intevation.de> parents: 188 diff changeset	72
1e3a5019c4ed * INSTALL.txt, LICENCE.txt, doku/source/LICENCE.txt, Stephan Holl <stephan.holl@intevation.de> parents: 188 diff changeset	73 The following example shows the minimum env-vars needed::
1e3a5019c4ed * INSTALL.txt, LICENCE.txt, doku/source/LICENCE.txt, Stephan Holl <stephan.holl@intevation.de> parents: 188 diff changeset	74
1e3a5019c4ed * INSTALL.txt, LICENCE.txt, doku/source/LICENCE.txt, Stephan Holl <stephan.holl@intevation.de> parents: 188 diff changeset	75 @echo off
1e3a5019c4ed * INSTALL.txt, LICENCE.txt, doku/source/LICENCE.txt, Stephan Holl <stephan.holl@intevation.de> parents: 188 diff changeset	76 if "%1" == "setenv" goto setenv
1e3a5019c4ed * INSTALL.txt, LICENCE.txt, doku/source/LICENCE.txt, Stephan Holl <stephan.holl@intevation.de> parents: 188 diff changeset	77
1e3a5019c4ed * INSTALL.txt, LICENCE.txt, doku/source/LICENCE.txt, Stephan Holl <stephan.holl@intevation.de> parents: 188 diff changeset	78 %comspec% /k SDKShell.bat setenv %1
1e3a5019c4ed * INSTALL.txt, LICENCE.txt, doku/source/LICENCE.txt, Stephan Holl <stephan.holl@intevation.de> parents: 188 diff changeset	79 goto exit
1e3a5019c4ed * INSTALL.txt, LICENCE.txt, doku/source/LICENCE.txt, Stephan Holl <stephan.holl@intevation.de> parents: 188 diff changeset	80
1e3a5019c4ed * INSTALL.txt, LICENCE.txt, doku/source/LICENCE.txt, Stephan Holl <stephan.holl@intevation.de> parents: 188 diff changeset	81 :setenv
1e3a5019c4ed * INSTALL.txt, LICENCE.txt, doku/source/LICENCE.txt, Stephan Holl <stephan.holl@intevation.de> parents: 188 diff changeset	82 @echo Setting environment for using the GDAL and MapServer tools.
1e3a5019c4ed * INSTALL.txt, LICENCE.txt, doku/source/LICENCE.txt, Stephan Holl <stephan.holl@intevation.de> parents: 188 diff changeset	83
1e3a5019c4ed * INSTALL.txt, LICENCE.txt, doku/source/LICENCE.txt, Stephan Holl <stephan.holl@intevation.de> parents: 188 diff changeset	84 if "%2"=="hideoci" goto hideoci
1e3a5019c4ed * INSTALL.txt, LICENCE.txt, doku/source/LICENCE.txt, Stephan Holl <stephan.holl@intevation.de> parents: 188 diff changeset	85
1e3a5019c4ed * INSTALL.txt, LICENCE.txt, doku/source/LICENCE.txt, Stephan Holl <stephan.holl@intevation.de> parents: 188 diff changeset	86 set ocipath=0
1e3a5019c4ed * INSTALL.txt, LICENCE.txt, doku/source/LICENCE.txt, Stephan Holl <stephan.holl@intevation.de> parents: 188 diff changeset	87 set _path="%PATH:;=" "%"
1e3a5019c4ed * INSTALL.txt, LICENCE.txt, doku/source/LICENCE.txt, Stephan Holl <stephan.holl@intevation.de> parents: 188 diff changeset	88 for %%p in (%_path%) do if not "%%~p"=="" if exist %%~p\oci.dll set ocipath=1
1e3a5019c4ed * INSTALL.txt, LICENCE.txt, doku/source/LICENCE.txt, Stephan Holl <stephan.holl@intevation.de> parents: 188 diff changeset	89
1e3a5019c4ed * INSTALL.txt, LICENCE.txt, doku/source/LICENCE.txt, Stephan Holl <stephan.holl@intevation.de> parents: 188 diff changeset	90 if "%ocipath%"=="0" goto hideoci
1e3a5019c4ed * INSTALL.txt, LICENCE.txt, doku/source/LICENCE.txt, Stephan Holl <stephan.holl@intevation.de> parents: 188 diff changeset	91 @echo WARNING: If you encounter problems with missing oci libraries then type:
1e3a5019c4ed * INSTALL.txt, LICENCE.txt, doku/source/LICENCE.txt, Stephan Holl <stephan.holl@intevation.de> parents: 188 diff changeset	92 @echo SDKShell hideoci
1e3a5019c4ed * INSTALL.txt, LICENCE.txt, doku/source/LICENCE.txt, Stephan Holl <stephan.holl@intevation.de> parents: 188 diff changeset	93 goto setenv2
1e3a5019c4ed * INSTALL.txt, LICENCE.txt, doku/source/LICENCE.txt, Stephan Holl <stephan.holl@intevation.de> parents: 188 diff changeset	94
1e3a5019c4ed * INSTALL.txt, LICENCE.txt, doku/source/LICENCE.txt, Stephan Holl <stephan.holl@intevation.de> parents: 188 diff changeset	95 :hideoci
1e3a5019c4ed * INSTALL.txt, LICENCE.txt, doku/source/LICENCE.txt, Stephan Holl <stephan.holl@intevation.de> parents: 188 diff changeset	96 @echo Hiding the OCI plugin library.
1e3a5019c4ed * INSTALL.txt, LICENCE.txt, doku/source/LICENCE.txt, Stephan Holl <stephan.holl@intevation.de> parents: 188 diff changeset	97 if not exist %CD%\bin\gdal\plugins-optional mkdir %CD%\bin\gdal\plugins-optional
1e3a5019c4ed * INSTALL.txt, LICENCE.txt, doku/source/LICENCE.txt, Stephan Holl <stephan.holl@intevation.de> parents: 188 diff changeset	98 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
1e3a5019c4ed * INSTALL.txt, LICENCE.txt, doku/source/LICENCE.txt, Stephan Holl <stephan.holl@intevation.de> parents: 188 diff changeset	99 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
1e3a5019c4ed * INSTALL.txt, LICENCE.txt, doku/source/LICENCE.txt, Stephan Holl <stephan.holl@intevation.de> parents: 188 diff changeset	100
1e3a5019c4ed * INSTALL.txt, LICENCE.txt, doku/source/LICENCE.txt, Stephan Holl <stephan.holl@intevation.de> parents: 188 diff changeset	101 :setenv2
1e3a5019c4ed * INSTALL.txt, LICENCE.txt, doku/source/LICENCE.txt, Stephan Holl <stephan.holl@intevation.de> parents: 188 diff changeset	102 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%
1e3a5019c4ed * INSTALL.txt, LICENCE.txt, doku/source/LICENCE.txt, Stephan Holl <stephan.holl@intevation.de> parents: 188 diff changeset	103 SET GDAL_DATA=%CD%\bin\gdal-data
1e3a5019c4ed * INSTALL.txt, LICENCE.txt, doku/source/LICENCE.txt, Stephan Holl <stephan.holl@intevation.de> parents: 188 diff changeset	104 SET GDAL_DRIVER_PATH=%CD%\bin\gdal\plugins
1e3a5019c4ed * INSTALL.txt, LICENCE.txt, doku/source/LICENCE.txt, Stephan Holl <stephan.holl@intevation.de> parents: 188 diff changeset	105 SET PYTHONPATH=%CD%\bin\gdal\python\osgeo
1e3a5019c4ed * INSTALL.txt, LICENCE.txt, doku/source/LICENCE.txt, Stephan Holl <stephan.holl@intevation.de> parents: 188 diff changeset	106 SET PROJ_LIB=%CD%\bin\proj\SHARE
1e3a5019c4ed * INSTALL.txt, LICENCE.txt, doku/source/LICENCE.txt, Stephan Holl <stephan.holl@intevation.de> parents: 188 diff changeset	107 SET CURL_CA_BUNDLE=C:\ms4w\Apache\conf\ca-bundle\cacert.pem
1e3a5019c4ed * INSTALL.txt, LICENCE.txt, doku/source/LICENCE.txt, Stephan Holl <stephan.holl@intevation.de> parents: 188 diff changeset	108
1e3a5019c4ed * INSTALL.txt, LICENCE.txt, doku/source/LICENCE.txt, Stephan Holl <stephan.holl@intevation.de> parents: 188 diff changeset	109 :exit
1e3a5019c4ed * INSTALL.txt, LICENCE.txt, doku/source/LICENCE.txt, Stephan Holl <stephan.holl@intevation.de> parents: 188 diff changeset	110
1e3a5019c4ed * INSTALL.txt, LICENCE.txt, doku/source/LICENCE.txt, Stephan Holl <stephan.holl@intevation.de> parents: 188 diff changeset	111 The above batch-script ``SDKShell.bat`` needs to be sources before working
1e3a5019c4ed * INSTALL.txt, LICENCE.txt, doku/source/LICENCE.txt, Stephan Holl <stephan.holl@intevation.de> parents: 188 diff changeset	112 with MXD2map.
1e3a5019c4ed * INSTALL.txt, LICENCE.txt, doku/source/LICENCE.txt, Stephan Holl <stephan.holl@intevation.de> parents: 188 diff changeset	113
229 64cd6a115372 Reorganized INSTALL-doc, added chapter for logging Stephan Holl <stephan.holl@intevation.de> parents: 202 diff changeset	114
64cd6a115372 Reorganized INSTALL-doc, added chapter for logging Stephan Holl <stephan.holl@intevation.de> parents: 202 diff changeset	115 Install Apache Webserver
64cd6a115372 Reorganized INSTALL-doc, added chapter for logging Stephan Holl <stephan.holl@intevation.de> parents: 202 diff changeset	116 ------------------------
64cd6a115372 Reorganized INSTALL-doc, added chapter for logging Stephan Holl <stephan.holl@intevation.de> parents: 202 diff changeset	117
64cd6a115372 Reorganized INSTALL-doc, added chapter for logging Stephan Holl <stephan.holl@intevation.de> parents: 202 diff changeset	118 If you will be able to display the resulting mapfiles directly you need to
64cd6a115372 Reorganized INSTALL-doc, added chapter for logging Stephan Holl <stephan.holl@intevation.de> parents: 202 diff changeset	119 install a webserver like Apache2 and the UMN MapServer CGI-file
64cd6a115372 Reorganized INSTALL-doc, added chapter for logging Stephan Holl <stephan.holl@intevation.de> parents: 202 diff changeset	120 ``mapserv.exe``.
64cd6a115372 Reorganized INSTALL-doc, added chapter for logging Stephan Holl <stephan.holl@intevation.de> parents: 202 diff changeset	121
64cd6a115372 Reorganized INSTALL-doc, added chapter for logging Stephan Holl <stephan.holl@intevation.de> parents: 202 diff changeset	122 Install Apache webserver by exedcuting the .msi-file and follow the
64cd6a115372 Reorganized INSTALL-doc, added chapter for logging Stephan Holl <stephan.holl@intevation.de> parents: 202 diff changeset	123 install-dialogs::
64cd6a115372 Reorganized INSTALL-doc, added chapter for logging Stephan Holl <stephan.holl@intevation.de> parents: 202 diff changeset	124
64cd6a115372 Reorganized INSTALL-doc, added chapter for logging Stephan Holl <stephan.holl@intevation.de> parents: 202 diff changeset	125 httpd-2.2.19-win32-x86-openssl-0.9.8r.msi
64cd6a115372 Reorganized INSTALL-doc, added chapter for logging Stephan Holl <stephan.holl@intevation.de> parents: 202 diff changeset	126
64cd6a115372 Reorganized INSTALL-doc, added chapter for logging Stephan Holl <stephan.holl@intevation.de> parents: 202 diff changeset	127 Make sure that you install apache as a service so it will be available
64cd6a115372 Reorganized INSTALL-doc, added chapter for logging Stephan Holl <stephan.holl@intevation.de> parents: 202 diff changeset	128 directly after system bootup.
64cd6a115372 Reorganized INSTALL-doc, added chapter for logging Stephan Holl <stephan.holl@intevation.de> parents: 202 diff changeset	129
64cd6a115372 Reorganized INSTALL-doc, added chapter for logging Stephan Holl <stephan.holl@intevation.de> parents: 202 diff changeset	130
64cd6a115372 Reorganized INSTALL-doc, added chapter for logging Stephan Holl <stephan.holl@intevation.de> parents: 202 diff changeset	131 Install UMN MapServer
64cd6a115372 Reorganized INSTALL-doc, added chapter for logging Stephan Holl <stephan.holl@intevation.de> parents: 202 diff changeset	132 ---------------------
64cd6a115372 Reorganized INSTALL-doc, added chapter for logging Stephan Holl <stephan.holl@intevation.de> parents: 202 diff changeset	133
64cd6a115372 Reorganized INSTALL-doc, added chapter for logging Stephan Holl <stephan.holl@intevation.de> parents: 202 diff changeset	134 The current documentation uses the Windows binary-builds from http://www.gisinternals.com/sdk/
64cd6a115372 Reorganized INSTALL-doc, added chapter for logging Stephan Holl <stephan.holl@intevation.de> parents: 202 diff changeset	135
64cd6a115372 Reorganized INSTALL-doc, added chapter for logging Stephan Holl <stephan.holl@intevation.de> parents: 202 diff changeset	136 1. Unzip the ZIP-file at ``c:/ms_6.1-dev``
64cd6a115372 Reorganized INSTALL-doc, added chapter for logging Stephan Holl <stephan.holl@intevation.de> parents: 202 diff changeset	137
64cd6a115372 Reorganized INSTALL-doc, added chapter for logging Stephan Holl <stephan.holl@intevation.de> parents: 202 diff changeset	138 #. Configure Apache Webserver to find the cgi-bin-folder::
64cd6a115372 Reorganized INSTALL-doc, added chapter for logging Stephan Holl <stephan.holl@intevation.de> parents: 202 diff changeset	139
64cd6a115372 Reorganized INSTALL-doc, added chapter for logging Stephan Holl <stephan.holl@intevation.de> parents: 202 diff changeset	140 ScriptAlias /cgi-bin/ "C:/ms_6.1-dev/bin/"
64cd6a115372 Reorganized INSTALL-doc, added chapter for logging Stephan Holl <stephan.holl@intevation.de> parents: 202 diff changeset	141
64cd6a115372 Reorganized INSTALL-doc, added chapter for logging Stephan Holl <stephan.holl@intevation.de> parents: 202 diff changeset	142 <Location "/cgi-bin">
64cd6a115372 Reorganized INSTALL-doc, added chapter for logging Stephan Holl <stephan.holl@intevation.de> parents: 202 diff changeset	143 Options None
64cd6a115372 Reorganized INSTALL-doc, added chapter for logging Stephan Holl <stephan.holl@intevation.de> parents: 202 diff changeset	144 Order allow,deny
64cd6a115372 Reorganized INSTALL-doc, added chapter for logging Stephan Holl <stephan.holl@intevation.de> parents: 202 diff changeset	145 Allow from all
64cd6a115372 Reorganized INSTALL-doc, added chapter for logging Stephan Holl <stephan.holl@intevation.de> parents: 202 diff changeset	146 </Location>
64cd6a115372 Reorganized INSTALL-doc, added chapter for logging Stephan Holl <stephan.holl@intevation.de> parents: 202 diff changeset	147
64cd6a115372 Reorganized INSTALL-doc, added chapter for logging Stephan Holl <stephan.holl@intevation.de> parents: 202 diff changeset	148 #. Copy mapserv.exe from ``c:/ms_6.1-dev/bin/apps/ms`` to ``c:/ms_6.1-dev/bin/``
64cd6a115372 Reorganized INSTALL-doc, added chapter for logging Stephan Holl <stephan.holl@intevation.de> parents: 202 diff changeset	149
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	150 #. Add environment-variables to apache in order to have WMS-server available::
00a39e8b6eed * INSTALL.txt: Added a paragraph to make the env-vars available in Apache Stephan Holl <stephan.holl@intevation.de> parents: 229 diff changeset	151
00a39e8b6eed * INSTALL.txt: Added a paragraph to make the env-vars available in Apache Stephan Holl <stephan.holl@intevation.de> parents: 229 diff changeset	152 SetEnv PROJ_LIB "c:/ms_6.1-dev/bin/proj/SHARE"
00a39e8b6eed * INSTALL.txt: Added a paragraph to make the env-vars available in Apache Stephan Holl <stephan.holl@intevation.de> parents: 229 diff changeset	153 SetEnv PATH "c:/ms_6.1-dev/bin"
00a39e8b6eed * INSTALL.txt: Added a paragraph to make the env-vars available in Apache Stephan Holl <stephan.holl@intevation.de> parents: 229 diff changeset	154 SetEnv PATH "c:/ms_6.1-dev/bin/gdal/python/osgeo"
00a39e8b6eed * INSTALL.txt: Added a paragraph to make the env-vars available in Apache Stephan Holl <stephan.holl@intevation.de> parents: 229 diff changeset	155
00a39e8b6eed * INSTALL.txt: Added a paragraph to make the env-vars available in Apache Stephan Holl <stephan.holl@intevation.de> parents: 229 diff changeset	156 # set GDAL_DATA environment variable to location of supporting gdal files
00a39e8b6eed * INSTALL.txt: Added a paragraph to make the env-vars available in Apache Stephan Holl <stephan.holl@intevation.de> parents: 229 diff changeset	157 SetEnv GDAL_DATA "c:/ms_6.1-dev/bin/gdaldata"
00a39e8b6eed * INSTALL.txt: Added a paragraph to make the env-vars available in Apache Stephan Holl <stephan.holl@intevation.de> parents: 229 diff changeset	158
00a39e8b6eed * INSTALL.txt: Added a paragraph to make the env-vars available in Apache Stephan Holl <stephan.holl@intevation.de> parents: 229 diff changeset	159 # set GDAL_DRIVER_PATH environment variable for gdal plugins
00a39e8b6eed * INSTALL.txt: Added a paragraph to make the env-vars available in Apache Stephan Holl <stephan.holl@intevation.de> parents: 229 diff changeset	160 SetEnv GDAL_DRIVER_PATH "c:/ms_6.1-dev/bin/gdal/plugins"
00a39e8b6eed * INSTALL.txt: Added a paragraph to make the env-vars available in Apache Stephan Holl <stephan.holl@intevation.de> parents: 229 diff changeset	161
229 64cd6a115372 Reorganized INSTALL-doc, added chapter for logging Stephan Holl <stephan.holl@intevation.de> parents: 202 diff changeset	162
64cd6a115372 Reorganized INSTALL-doc, added chapter for logging Stephan Holl <stephan.holl@intevation.de> parents: 202 diff changeset	163 Configure Logging
64cd6a115372 Reorganized INSTALL-doc, added chapter for logging Stephan Holl <stephan.holl@intevation.de> parents: 202 diff changeset	164 -----------------
64cd6a115372 Reorganized INSTALL-doc, added chapter for logging Stephan Holl <stephan.holl@intevation.de> parents: 202 diff changeset	165
64cd6a115372 Reorganized INSTALL-doc, added chapter for logging Stephan Holl <stephan.holl@intevation.de> parents: 202 diff changeset	166 Logging is supported on different levels. MXD2map logs with Javas Log4J. A
64cd6a115372 Reorganized INSTALL-doc, added chapter for logging Stephan Holl <stephan.holl@intevation.de> parents: 202 diff changeset	167 sample configuration could look like this::
64cd6a115372 Reorganized INSTALL-doc, added chapter for logging Stephan Holl <stephan.holl@intevation.de> parents: 202 diff changeset	168
64cd6a115372 Reorganized INSTALL-doc, added chapter for logging Stephan Holl <stephan.holl@intevation.de> parents: 202 diff changeset	169 #### 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	170 log4j.rootLogger=DEBUG, MXD, Console
64cd6a115372 Reorganized INSTALL-doc, added chapter for logging Stephan Holl <stephan.holl@intevation.de> parents: 202 diff changeset	171
64cd6a115372 Reorganized INSTALL-doc, added chapter for logging Stephan Holl <stephan.holl@intevation.de> parents: 202 diff changeset	172 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	173 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	174 log4j.appender.MXD.MaxFileSize=5000KB
64cd6a115372 Reorganized INSTALL-doc, added chapter for logging Stephan Holl <stephan.holl@intevation.de> parents: 202 diff changeset	175 log4j.appender.MXD.MaxBackupIndex=1
64cd6a115372 Reorganized INSTALL-doc, added chapter for logging Stephan Holl <stephan.holl@intevation.de> parents: 202 diff changeset	176 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	177 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	178
64cd6a115372 Reorganized INSTALL-doc, added chapter for logging Stephan Holl <stephan.holl@intevation.de> parents: 202 diff changeset	179 #log4j.rootLogger=WARN, Console
64cd6a115372 Reorganized INSTALL-doc, added chapter for logging Stephan Holl <stephan.holl@intevation.de> parents: 202 diff changeset	180 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	181 log4j.appender.Console.Threshold=INFO
64cd6a115372 Reorganized INSTALL-doc, added chapter for logging Stephan Holl <stephan.holl@intevation.de> parents: 202 diff changeset	182 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	183 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	184
64cd6a115372 Reorganized INSTALL-doc, added chapter for logging Stephan Holl <stephan.holl@intevation.de> parents: 202 diff changeset	185
64cd6a115372 Reorganized INSTALL-doc, added chapter for logging Stephan Holl <stephan.holl@intevation.de> parents: 202 diff changeset	186 Apache Webserver and UMN MapServer
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
64cd6a115372 Reorganized INSTALL-doc, added chapter for logging Stephan Holl <stephan.holl@intevation.de> parents: 202 diff changeset	189 They both support logging. MapServers outout ends up in Apaches logfiles
64cd6a115372 Reorganized INSTALL-doc, added chapter for logging Stephan Holl <stephan.holl@intevation.de> parents: 202 diff changeset	190 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	191 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	192 MapServer manual regarding logging at
64cd6a115372 Reorganized INSTALL-doc, added chapter for logging Stephan Holl <stephan.holl@intevation.de> parents: 202 diff changeset	193 http://mapserver.org/optimization/debugging.html#steps-to-enable-mapserver-debugging.

Mercurial > mxd2map

annotate INSTALL.txt @ 287:584bc79cf4ad