comparison INSTALL.txt @ 229:64cd6a115372

Reorganized INSTALL-doc, added chapter for logging
author Stephan Holl <stephan.holl@intevation.de>
date Fri, 29 Jul 2011 07:41:29 +0200
parents 1e3a5019c4ed
children 00a39e8b6eed
comparison
equal deleted inserted replaced
228:1cfb92731f48 229:64cd6a115372
1 .. index:: installation, requirements, apache, UMN MapServer, compile, jar 1 .. index:: installation, requirements, apache, UMN MapServer, compile,
2 jar, logging, ArcSDE
2 3
3 ------------ 4 ------------
4 Requirements 5 Requirements
5 ------------ 6 ------------
6 7
7 The current version of the converter only runs on Windows. This is because 8 The current version of the converter only runs on Windows. This is because
8 the ArcObjects JDK API is not running properly on Linux though. 9 the ArcObjects JDK API is not running properly on Linux though. In theory
10 it should also run on Linux.
9 11
10 To run the converter you need at least the following componentes: 12 To run the converter you need at least the following componentes:
11 13
12 * Sun Java6 SDK to build, JRE to run 14 * Sun Java6 SDK to build, JRE to run
13 * ArcGIS Desktop10.x or ArcEngine10.x with a valid licence enabled 15 * ArcGIS Desktop10.x or ArcEngine10.x with a valid licence enabled
14 * UMN MapServer with Java MapScript-bindings (>=6.0.1 or recent development-version) 16 * UMN MapServer with Java MapScript-bindings (>=6.0.1 or recent development-version)
15 * Apache2 Webserver for displaying the resulting Mapfiles 17 * Optinal: Apache2 Webserver for displaying the resulting Mapfiles
16 * Optional: MapServer compiled with ArcSDE-plugin 18 * Optional: MapServer compiled with ArcSDE-plugin
17 * Optional: GDAL/OGR compiled with ArcSDE-support 19 * Optional: GDAL/OGR compiled with ArcSDE-support
18 * Optional: GDAL/OGR compiled with FileGeodatabase-support 20 * Optional: GDAL/OGR compiled with FileGeodatabase-support
19 * Optional: Other GDAL/OGR-related tools. 21 * Optional: Other GDAL/OGR-related tools
22 * Optional: Sphinx for building the docs
20 23
21 24
22 ------------ 25 ------------
23 Installation 26 Installation
24 ------------ 27 ------------
33 ant jar 36 ant jar
34 37
35 or:: 38 or::
36 39
37 ant jar-norevision 40 ant jar-norevision
38
39 Install Apache Webserver
40 ------------------------
41
42 Install Apache webserver by exedcuting the .msi-file and follow the
43 install-dialogs::
44
45 httpd-2.2.19-win32-x86-openssl-0.9.8r.msi
46
47 Make sure that you install apache as a service so it will be available
48 directly after system bootup.
49
50
51 Install UMN MapServer
52 ---------------------
53
54 The current documentation uses the Windows binary-builds from http://www.gisinternals.com/sdk/
55
56 1. Unzip the ZIP-file at ``c:/ms_6.1-dev``
57
58 #. Configure Apache Webserver to find the cgi-bin-folder::
59
60 ScriptAlias /cgi-bin/ "C:/ms_6.1-dev/bin/"
61
62 <Location "/cgi-bin">
63 Options None
64 Order allow,deny
65 Allow from all
66 </Location>
67
68 #. Copy mapserv.exe from ``c:/ms_6.1-dev/bin/apps/ms`` to ``c:/ms_6.1-dev/bin/``
69
70 41
71 Create run-environment 42 Create run-environment
72 ---------------------- 43 ----------------------
73 44
74 The current version of MXD2map needs a few steps to run properly. 45 The current version of MXD2map needs a few steps to run properly.
138 :exit 109 :exit
139 110
140 The above batch-script ``SDKShell.bat`` needs to be sources before working 111 The above batch-script ``SDKShell.bat`` needs to be sources before working
141 with MXD2map. 112 with MXD2map.
142 113
114
115 Install Apache Webserver
116 ------------------------
117
118 If you will be able to display the resulting mapfiles directly you need to
119 install a webserver like Apache2 and the UMN MapServer CGI-file
120 ``mapserv.exe``.
121
122 Install Apache webserver by exedcuting the .msi-file and follow the
123 install-dialogs::
124
125 httpd-2.2.19-win32-x86-openssl-0.9.8r.msi
126
127 Make sure that you install apache as a service so it will be available
128 directly after system bootup.
129
130
131 Install UMN MapServer
132 ---------------------
133
134 The current documentation uses the Windows binary-builds from http://www.gisinternals.com/sdk/
135
136 1. Unzip the ZIP-file at ``c:/ms_6.1-dev``
137
138 #. Configure Apache Webserver to find the cgi-bin-folder::
139
140 ScriptAlias /cgi-bin/ "C:/ms_6.1-dev/bin/"
141
142 <Location "/cgi-bin">
143 Options None
144 Order allow,deny
145 Allow from all
146 </Location>
147
148 #. Copy mapserv.exe from ``c:/ms_6.1-dev/bin/apps/ms`` to ``c:/ms_6.1-dev/bin/``
149
150
151 Configure Logging
152 -----------------
153
154 Logging is supported on different levels. MXD2map logs with Javas Log4J. A
155 sample configuration could look like this::
156
157 #### Log just errors and warnings to a file.
158 log4j.rootLogger=DEBUG, MXD, Console
159
160 log4j.appender.MXD=org.apache.log4j.RollingFileAppender
161 log4j.appender.MXD.File=./logs/console-client.log
162 log4j.appender.MXD.MaxFileSize=5000KB
163 log4j.appender.MXD.MaxBackupIndex=1
164 log4j.appender.MXD.layout=org.apache.log4j.PatternLayout
165 log4j.appender.MXD.layout.ConversionPattern=%d [%t] %-5p %c - %m%n
166
167 #log4j.rootLogger=WARN, Console
168 log4j.appender.Console=org.apache.log4j.ConsoleAppender
169 log4j.appender.Console.Threshold=INFO
170 log4j.appender.Console.layout=org.apache.log4j.PatternLayout
171 log4j.appender.Console.layout.ConversionPattern=%d [%t] %-5p %c - %m%n
172
173
174 Apache Webserver and UMN MapServer
175 ..................................
176
177 They both support logging. MapServers outout ends up in Apaches logfiles
178 if not configured differently within a providing template. The loglevel
179 can be adjusted at template-level. For further information consult the UMN
180 MapServer manual regarding logging at
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)