annotate INSTALL.txt @ 244:276f63c86f1c

Refactored group layer handling and "wms_title" metadata.
author raimund renkert <raimund.renkert@intevation.de>
date Tue, 09 Aug 2011 17:27:18 +0200
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.
This site is hosted by Intevation GmbH (Datenschutzerklärung und Impressum | Privacy Policy and Imprint)