# HG changeset patch # User Stephan Holl # Date 1308904184 -7200 # Node ID 0ebaec057f15cf049c3db7a369448504cd504ee1 # Parent 2040463cb4f7236d6892ecacb38135e60c5c3d5b * INSTALL.txt: added a hint how to install the converter and its requirements. * doku/source/conf.py, doku/source/INSTALL.txt, doku/source/index.txt,doku/source/restrictions.txt, doku/source/index.rst,doku/source/restrictions.rst: renamed .rst to .txt, linked INSTALL.txt from root into the docs. diff -r 2040463cb4f7 -r 0ebaec057f15 ChangeLog --- a/ChangeLog Fri Jun 24 09:34:21 2011 +0200 +++ b/ChangeLog Fri Jun 24 10:29:44 2011 +0200 @@ -1,3 +1,12 @@ +2011-06-24 Stephan Holl + + * INSTALL.txt: added a hint how to install the converter and its + requirements. + * doku/source/conf.py, doku/source/INSTALL.txt, + doku/source/index.txt,doku/source/restrictions.txt, + doku/source/index.rst,doku/source/restrictions.rst: renamed .rst to + .txt, linked INSTALL.txt from root into the docs. + 2011-06-24 Stephan Holl * doku/Makefile, doku/source/conf.py, doku/source/index.rst, diff -r 2040463cb4f7 -r 0ebaec057f15 INSTALL.txt --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/INSTALL.txt Fri Jun 24 10:29:44 2011 +0200 @@ -0,0 +1,74 @@ +------------ +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. + +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 (recent development-version) + * Apache 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 + + + +------------ +Installation +------------ + +Compile the converter-sources +----------------------------- + +To compile the sources you need to have a properly configured +ant-environmet available. ArcGIS SDK provides an ant-installation which +suffices:: + + ant jar + +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/" + + + Options None + Order allow,deny + Allow from all + + +#. Copy mapserv.exe from c:/ms_6.1-dev/bin/apps/ms to c:/ms_6.1-dev/bin/ + +Create run-environment +---------------------- + +writeme + + +----- +Usage +----- + +writeme diff -r 2040463cb4f7 -r 0ebaec057f15 doku/source/INSTALL.txt --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/doku/source/INSTALL.txt Fri Jun 24 10:29:44 2011 +0200 @@ -0,0 +1,1 @@ +../../INSTALL.txt \ No newline at end of file diff -r 2040463cb4f7 -r 0ebaec057f15 doku/source/conf.py --- a/doku/source/conf.py Fri Jun 24 09:34:21 2011 +0200 +++ b/doku/source/conf.py Fri Jun 24 10:29:44 2011 +0200 @@ -31,7 +31,7 @@ templates_path = ['_templates'] # The suffix of source filenames. -source_suffix = '.rst' +source_suffix = '.txt' # The encoding of source files. #source_encoding = 'utf-8-sig' diff -r 2040463cb4f7 -r 0ebaec057f15 doku/source/index.rst --- a/doku/source/index.rst Fri Jun 24 09:34:21 2011 +0200 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,22 +0,0 @@ -.. MXD2map documentation master file, created by - sphinx-quickstart on Mon Jun 20 09:48:05 2011. - You can adapt this file completely to your liking, but it should at least - contain the root `toctree` directive. - -Welcome to MXD2map's documentation! -=================================== - -Contents: - -.. toctree:: - :maxdepth: 2 - - restrictions.rst - -Indices and tables -================== - -* :ref:`genindex` -* :ref:`modindex` -* :ref:`search` - diff -r 2040463cb4f7 -r 0ebaec057f15 doku/source/index.txt --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/doku/source/index.txt Fri Jun 24 10:29:44 2011 +0200 @@ -0,0 +1,23 @@ +.. MXD2map documentation master file, created by + sphinx-quickstart on Mon Jun 20 09:48:05 2011. + You can adapt this file completely to your liking, but it should at least + contain the root `toctree` directive. + +Welcome to MXD2map's documentation! +=================================== + +Contents: + +.. toctree:: + :maxdepth: 2 + + INSTALL.txt + restrictions.txt + +Indices and tables +================== + +* :ref:`genindex` +* :ref:`modindex` +* :ref:`search` + diff -r 2040463cb4f7 -r 0ebaec057f15 doku/source/restrictions.rst --- a/doku/source/restrictions.rst Fri Jun 24 09:34:21 2011 +0200 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,13 +0,0 @@ ------------- -Restrictions ------------- - -Currently there are some restrictions in the usage of the converter: - -Supported datasources: - - * ArcSDE-passwords cannot be read since they are encrypted. The converter - exports the string "define me" which needs to be replaced later on in the - resulting mapfile - - * diff -r 2040463cb4f7 -r 0ebaec057f15 doku/source/restrictions.txt --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/doku/source/restrictions.txt Fri Jun 24 10:29:44 2011 +0200 @@ -0,0 +1,13 @@ +------------ +Restrictions +------------ + +Currently there are some restrictions in the usage of the converter: + +Supported datasources: + + * ArcSDE-passwords cannot be read since they are encrypted. The converter + exports the string "define me" which needs to be replaced later on in the + resulting mapfile + + *