annotate INSTALL.txt @ 234:d20477c1a7f8

Fixed link to commits-archive
author Stephan Holl <stephan.holl@intevation.de>
date Fri, 05 Aug 2011 08:41:42 +0200
parents 64cd6a115372
children 00a39e8b6eed
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
64cd6a115372 Reorganized INSTALL-doc, added chapter for logging
Stephan Holl <stephan.holl@intevation.de>
parents: 202
diff changeset
150
64cd6a115372 Reorganized INSTALL-doc, added chapter for logging
Stephan Holl <stephan.holl@intevation.de>
parents: 202
diff changeset
151 Configure Logging
64cd6a115372 Reorganized INSTALL-doc, added chapter for logging
Stephan Holl <stephan.holl@intevation.de>
parents: 202
diff changeset
152 -----------------
64cd6a115372 Reorganized INSTALL-doc, added chapter for logging
Stephan Holl <stephan.holl@intevation.de>
parents: 202
diff changeset
153
64cd6a115372 Reorganized INSTALL-doc, added chapter for logging
Stephan Holl <stephan.holl@intevation.de>
parents: 202
diff changeset
154 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
155 sample configuration could look like this::
64cd6a115372 Reorganized INSTALL-doc, added chapter for logging
Stephan Holl <stephan.holl@intevation.de>
parents: 202
diff changeset
156
64cd6a115372 Reorganized INSTALL-doc, added chapter for logging
Stephan Holl <stephan.holl@intevation.de>
parents: 202
diff changeset
157 #### 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
158 log4j.rootLogger=DEBUG, MXD, Console
64cd6a115372 Reorganized INSTALL-doc, added chapter for logging
Stephan Holl <stephan.holl@intevation.de>
parents: 202
diff changeset
159
64cd6a115372 Reorganized INSTALL-doc, added chapter for logging
Stephan Holl <stephan.holl@intevation.de>
parents: 202
diff changeset
160 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
161 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
162 log4j.appender.MXD.MaxFileSize=5000KB
64cd6a115372 Reorganized INSTALL-doc, added chapter for logging
Stephan Holl <stephan.holl@intevation.de>
parents: 202
diff changeset
163 log4j.appender.MXD.MaxBackupIndex=1
64cd6a115372 Reorganized INSTALL-doc, added chapter for logging
Stephan Holl <stephan.holl@intevation.de>
parents: 202
diff changeset
164 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
165 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
166
64cd6a115372 Reorganized INSTALL-doc, added chapter for logging
Stephan Holl <stephan.holl@intevation.de>
parents: 202
diff changeset
167 #log4j.rootLogger=WARN, Console
64cd6a115372 Reorganized INSTALL-doc, added chapter for logging
Stephan Holl <stephan.holl@intevation.de>
parents: 202
diff changeset
168 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
169 log4j.appender.Console.Threshold=INFO
64cd6a115372 Reorganized INSTALL-doc, added chapter for logging
Stephan Holl <stephan.holl@intevation.de>
parents: 202
diff changeset
170 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
171 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
172
64cd6a115372 Reorganized INSTALL-doc, added chapter for logging
Stephan Holl <stephan.holl@intevation.de>
parents: 202
diff changeset
173
64cd6a115372 Reorganized INSTALL-doc, added chapter for logging
Stephan Holl <stephan.holl@intevation.de>
parents: 202
diff changeset
174 Apache Webserver and UMN MapServer
64cd6a115372 Reorganized INSTALL-doc, added chapter for logging
Stephan Holl <stephan.holl@intevation.de>
parents: 202
diff changeset
175 ..................................
64cd6a115372 Reorganized INSTALL-doc, added chapter for logging
Stephan Holl <stephan.holl@intevation.de>
parents: 202
diff changeset
176
64cd6a115372 Reorganized INSTALL-doc, added chapter for logging
Stephan Holl <stephan.holl@intevation.de>
parents: 202
diff changeset
177 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
178 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
179 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
180 MapServer manual regarding logging at
64cd6a115372 Reorganized INSTALL-doc, added chapter for logging
Stephan Holl <stephan.holl@intevation.de>
parents: 202
diff changeset
181 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)