# HG changeset patch
# User Stephan Holl <stephan.holl@intevation.de>
# Date 1311918089 -7200
# Node ID 64cd6a115372bf64e7236404f59e70dc271c11e9
# Parent  1cfb92731f482decea1ac5f5a34f5b0e9608d353
Reorganized INSTALL-doc, added chapter for logging

diff -r 1cfb92731f48 -r 64cd6a115372 INSTALL.txt
--- a/INSTALL.txt	Wed Jul 27 13:58:15 2011 +0200
+++ b/INSTALL.txt	Fri Jul 29 07:41:29 2011 +0200
@@ -1,22 +1,25 @@
-.. index:: installation, requirements, apache, UMN MapServer, compile, jar
+.. index:: installation, requirements, apache, UMN MapServer, compile,
+   jar, logging, ArcSDE
 
 ------------
 Requirements
 ------------
 
 The current version of the converter only runs on Windows. This is because
-the ArcObjects JDK API is not running properly on Linux though.
+the ArcObjects JDK API is not running properly on Linux though. In theory
+it should also run on Linux.
 
 To run the converter you need at least the following componentes:
 
  * Sun Java6 SDK to build, JRE to run
  * ArcGIS Desktop10.x or ArcEngine10.x with a valid licence enabled
  * UMN MapServer with Java MapScript-bindings (>=6.0.1 or recent development-version)
- * Apache2 Webserver for displaying the resulting Mapfiles
+ * Optinal: Apache2 Webserver for displaying the resulting Mapfiles
  * Optional: MapServer compiled with ArcSDE-plugin
  * Optional: GDAL/OGR compiled with ArcSDE-support
- * Optional: GDAL/OGR compiled with FileGeodatabase-support 
- * Optional: Other GDAL/OGR-related tools.
+ * Optional: GDAL/OGR compiled with FileGeodatabase-support
+ * Optional: Other GDAL/OGR-related tools
+ * Optional: Sphinx for building the docs
 
 
 ------------
@@ -36,38 +39,6 @@
 
  ant jar-norevision
 
-Install Apache Webserver
-------------------------
-
-Install Apache webserver by exedcuting the .msi-file and follow the
-install-dialogs::
-
- httpd-2.2.19-win32-x86-openssl-0.9.8r.msi
-
-Make sure that you install apache as a service so it will be available
-directly after system bootup.
-
-
-Install UMN MapServer
----------------------
-
-The current documentation uses the Windows binary-builds from http://www.gisinternals.com/sdk/
-
-1. Unzip the ZIP-file at ``c:/ms_6.1-dev``
-
-#. Configure Apache Webserver to find the cgi-bin-folder::
-
-    ScriptAlias /cgi-bin/ "C:/ms_6.1-dev/bin/"
-
-    <Location "/cgi-bin">
-        Options None
-        Order allow,deny
-        Allow from all
-    </Location>
-
-#. Copy mapserv.exe from ``c:/ms_6.1-dev/bin/apps/ms`` to ``c:/ms_6.1-dev/bin/``
-
-
 Create run-environment
 ----------------------
 
@@ -140,3 +111,71 @@
 The above batch-script ``SDKShell.bat`` needs to be sources before working
 with MXD2map.
 
+
+Install Apache Webserver
+------------------------
+
+If you will be able to display the resulting mapfiles directly you need to
+install a webserver like Apache2 and the UMN MapServer CGI-file
+``mapserv.exe``.
+
+Install Apache webserver by exedcuting the .msi-file and follow the
+install-dialogs::
+
+ httpd-2.2.19-win32-x86-openssl-0.9.8r.msi
+
+Make sure that you install apache as a service so it will be available
+directly after system bootup.
+
+
+Install UMN MapServer
+---------------------
+
+The current documentation uses the Windows binary-builds from http://www.gisinternals.com/sdk/
+
+1. Unzip the ZIP-file at ``c:/ms_6.1-dev``
+
+#. Configure Apache Webserver to find the cgi-bin-folder::
+
+    ScriptAlias /cgi-bin/ "C:/ms_6.1-dev/bin/"
+
+    <Location "/cgi-bin">
+        Options None
+        Order allow,deny
+        Allow from all
+    </Location>
+
+#. Copy mapserv.exe from ``c:/ms_6.1-dev/bin/apps/ms`` to ``c:/ms_6.1-dev/bin/``
+
+
+Configure Logging
+-----------------
+
+Logging is supported on different levels. MXD2map logs with Javas Log4J. A
+sample configuration could look like this::
+
+  #### Log just errors and warnings to a file.
+  log4j.rootLogger=DEBUG, MXD, Console
+  
+  log4j.appender.MXD=org.apache.log4j.RollingFileAppender
+  log4j.appender.MXD.File=./logs/console-client.log
+  log4j.appender.MXD.MaxFileSize=5000KB
+  log4j.appender.MXD.MaxBackupIndex=1
+  log4j.appender.MXD.layout=org.apache.log4j.PatternLayout
+  log4j.appender.MXD.layout.ConversionPattern=%d [%t] %-5p %c - %m%n
+  
+  #log4j.rootLogger=WARN, Console
+  log4j.appender.Console=org.apache.log4j.ConsoleAppender
+  log4j.appender.Console.Threshold=INFO
+  log4j.appender.Console.layout=org.apache.log4j.PatternLayout
+  log4j.appender.Console.layout.ConversionPattern=%d [%t] %-5p %c - %m%n
+
+
+Apache Webserver and UMN MapServer
+..................................
+
+They both support logging. MapServers outout ends up in Apaches logfiles
+if not configured differently within a  providing template. The loglevel
+can be adjusted at template-level. For further information consult the UMN
+MapServer manual regarding logging at
+http://mapserver.org/optimization/debugging.html#steps-to-enable-mapserver-debugging.