stephan@140: ------------
stephan@140: Requirements
stephan@140: ------------
stephan@140: 
stephan@140: The current version of the converter only runs on Windows. This is because
stephan@140: the ArcObjects JDK API is not running properly on Linux though.
stephan@140: 
stephan@140: To run the converter you need at least the following componentes:
stephan@140: 
stephan@140:  * Sun Java6 SDK to build, JRE to run
stephan@140:  * ArcGIS Desktop10.x or ArcEngine10.x with a valid licence enabled
stephan@140:  * UMN MapServer with Java MapScript-bindings (recent development-version)
stephan@140:  * Apache Webserver for displaying the resulting Mapfiles
stephan@140:  * Optional: MapServer compiled with ArcSDE-plugin
stephan@140:  * Optional: GDAL/OGR compiled with ArcSDE-support
stephan@140:  * Optional: GDAL/OGR compiled with FileGeodatabase-support 
stephan@140: 
stephan@140: 
stephan@140: 
stephan@140: ------------
stephan@140: Installation
stephan@140: ------------
stephan@140: 
stephan@140: Compile the converter-sources
stephan@140: -----------------------------
stephan@140: 
stephan@140: To compile the sources you need to have a properly configured
stephan@140: ant-environmet available. ArcGIS SDK provides an ant-installation which
stephan@140: suffices::
stephan@140: 
stephan@140:  ant jar
stephan@140: 
rrenkert@182: or::
rrenkert@182: 
rrenkert@182:  ant jar-norevision
rrenkert@182: 
stephan@140: Install Apache Webserver
stephan@140: ------------------------
stephan@140: 
stephan@140: Install Apache webserver by exedcuting the .msi-file and follow the
stephan@140: install-dialogs::
stephan@140: 
stephan@140:  httpd-2.2.19-win32-x86-openssl-0.9.8r.msi
stephan@140: 
stephan@140: Make sure that you install apache as a service so it will be available
stephan@140: directly after system bootup.
stephan@140: 
stephan@140: 
stephan@140: Install UMN MapServer
stephan@140: ---------------------
stephan@140: 
stephan@140: The current documentation uses the Windows binary-builds from http://www.gisinternals.com/sdk/
stephan@140: 
stephan@140: 1. Unzip the ZIP-file at c:/ms_6.1-dev
stephan@140: 
stephan@140: #. Configure Apache Webserver to find the cgi-bin-folder::
stephan@140: 
stephan@140:     ScriptAlias /cgi-bin/ "C:/ms_6.1-dev/bin/"
stephan@140: 
stephan@140:     <Location "/cgi-bin">
stephan@140:         Options None
stephan@140:         Order allow,deny
stephan@140:         Allow from all
stephan@140:     </Location>
stephan@140: 
stephan@140: #. Copy mapserv.exe from c:/ms_6.1-dev/bin/apps/ms to c:/ms_6.1-dev/bin/
stephan@140: 
rrenkert@182: 
stephan@140: Create run-environment
stephan@140: ----------------------
stephan@140: 
rrenkert@182: The current version of MXD2map needs a few steps to run properly.
rrenkert@182: The following steps assume the runtime folder to be c:/mxd2map/. This path can
rrenkert@182: be changed.
stephan@140: 
rrenkert@182: 1. Copy mxd2map.jar to c:/mxd2map/.
stephan@140: 
rrenkert@182: #. Copy folder "conf" from repository to c:/mxd2map/
rrenkert@182: 
rrenkert@182: #. Create folder c:/mxd2map/lib/
rrenkert@182: 
rrenkert@182: #. Get log4j from http://logging.apache.org/log4j/1.2/download.html
rrenkert@182: 
rrenkert@182: #. Get jargs http://jargs.sourceforge.net/ (Version 1.0)
rrenkert@182: 
rrenkert@182: #. Build the libraries and copy the resulting jar-files to c:/mxd2map/lib/
rrenkert@182: 
rrenkert@182: #. Copy mapscript.jar and mapscript.dll to c:/mxd2map/lib/
rrenkert@182: 
rrenkert@182: #. Create a folder c:/mxd2map/logs/
rrenkert@182: 
rrenkert@182: #. Create or copy a converter.properties file to c:/mxd2map/
rrenkert@182: