--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/INSTALL_Linux.txt	Fri Nov 16 17:02:07 2012 +0100
@@ -0,0 +1,197 @@
+------------
+Installation from Source
+------------
+This Documentation describes how you can install MXD2Map from source on GNU/Linux Systems.
+
+Download the Source tarball of mxd2map and extract it into a directory.
+The Path used in this example is ~/mxd2map.
+
+Requirements
+------------
+To run the converter you need at least the following components:
+
+ * Sun Java6 SDK / JRE and ant
+ * ArcEngine10.x with a valid licence enabled
+ * Some additional Java Tools and libraries as documented below
+
+Install ArcGIS SDK
+------------------
+# As root:
+# !!! Deactivate SELINUX !!!
+# ArcGIS fails in many mysterious ways otherwise.
+# write SELINUX=permissive into: /etc/sysconfig/selinux
+ setenforce Permissive
+
+ yum-install compat-libstdc++-33 compat-libstdc++-296 compat-libf2c compat-libgcc-296 \
+             compat-openldap-2.3 cairo compat-libf2c-34 mesa-libGLU compat-gcc-34 freeglut-2.4 gmp glibc gtk2 gtk2-devel \
+             libidn mesa-libGL  mesa-libGLU openldap openmotif-devel openmotif openssl convmv
+ yum-groupinstall "Legacy Software Support"
+ yum-groupinstall "X Window System"
+ yum-groupinstall "Legacy Software Development"
+ yum-groupinstall "X Software Development"
+ yum-groupinstall "Development Tools"
+ useradd mxd2map
+ groupadd arcgis-users
+ usermod -a -G arcgis-users mxd2map
+ mkdir -p /usr/local/share/macrovision/storage
+ chmod g+w /usr/local/share/macrovision/storage
+ chgrp arcgis-users /usr/local/share/macrovision/storage
+
+# Set passwd for user mxd2map and log in as that user
+
+/mnt/ArcGIS-SDK/linux/EngineRT/Setup
+# Click through the dialog leave everything as default
+/mnt/ArcGIS-SDK/linux/ArcObjectsSDKJava/Setup
+# Click through the dialog leave everything as default
+# Register "ArcGIS Engine Runtime and ArcGIS Engine Developer Kit (Single Use)"
+export JAVA_HOME=/usr/lib/jvm/java-1.6.0-openjdk-1.6.0.0
+. ~/arcgis/developerkit10.0/init_devkit.sh
+. ~/arcgis/developerkit10.0/java/tools/setenv_ant.sh
+
+Install additional libraries
+----------------------------
+cd ~/mxd2map
+mkdir lib
+## Jargs
+wget http://sourceforge.net/projects/jargs/files/jargs/1.0/jargs-1.0.tar.bz2/download -O - | \
+tar -xj jargs.jar -O > jargs.jar
+
+## log4j
+wget http://archive.apache.org/dist/logging/log4j/1.2.9/logging-log4j-1.2.9.tar.gz -O - | \
+tar -xz log4j-1.2.9.jar -O > log4j.jar
+
+## Commons codec
+wget http://apache.openmirror.de/commons/codec/binaries/commons-codec-1.7-bin.tar.gz -O - | \
+tar -xz commons-codec-1.7.jar -O > commons-codec.jar
+
+Install Mapserver from Source
+-----------------------------
+This documentation is a log of the steps neccessary to
+build mapserver 6.2.0-rc1 on CentOS 5.
+You might just want to install a binary package for your distribution
+For a real documentation please refer to: http://mapserver.org/installation/unix.html
+
+# Everything is installed into ~/dev
+# As root:
+yum groupinstall "Development Tools"
+yum install freetype-devel libpng-devel zlib-devel curl-devel libtiff-devel libjpeg-devel fontconfig-devel \
+libXpm-devel libxml2-devel expat-devel sqlite-devel  agg-devel giflib-devel libxslt-devel libexslt-devel httpd-devel
+
+# As user:
+# set up some convienance
+export DEVELDIR=~/devel
+export SRCDIR=$DEVELDIR/src
+alias configure="./configure --prefix=$DEVELDIR"
+function cs {
+    mkdir -p "$SRCDIR"
+    if test -n "$1"; then
+            cd "$SRCDIR/$1"
+    else
+        cd "$SRCDIR"
+    fi
+}
+
+cs
+wget http://download.osgeo.org/proj/proj-4.8.0.tar.gz
+tar -xf proj-4.8.0.tar.gz 
+cs proj-4.8.0
+configure && make && make install
+
+cs
+wget https://bitbucket.org/pierrejoye/gd-libgd/get/GD_2_0_33.tar.bz2
+tar -xf GD_2_0_33.tar.bz2
+cs pierrejoye-gd-libgd-5551f61978e3/src
+configure && make && make install
+
+cs
+wget http://download.osgeo.org/geotiff/libgeotiff/libgeotiff-1.4.0.tar.gz
+tar -xf libgeotiff-1.4.0.tar.gz
+cd libgeotiff-1.4.0
+configure --with-proj=$DEVELDIR && make && make install
+
+cs
+wget http://downloads.esri.com/Support/downloads/ao_/FileGDB_API_1_2-32.tar.gz
+tar -xf FileGDB_API_1_2-32.tar.gz
+cs -ri FileGDB_API/include FileGDB_API/lib $DEVELDIR
+export JAVA_HOME=/usr/lib/jvm/java-1.6.0-openjdk-1.6.0.0
+. ~/arcgis/engine10.0/init_engine.sh
+. ~/arcgis/engine10.0/java/tools/init_java.sh
+. ~/arcgis/developerkit10.0/java/tools/setenv_ant.sh
+. ~/arcgis/developerkit10.0/init_devkit.sh
+
+cs
+wget http://download.osgeo.org/gdal/gdal-1.9.2.tar.gz
+tar -xf gdal-1.9.2.tar.gz 
+cs gdal-1.9.2
+configure --enable-shared=no --enable-static=yes --with-fgdb=$DEVELDIR && make && make install
+
+cs
+wget http://download.osgeo.org/mapserver/mapserver-6.2.0-rc1.tar.gz
+tar -xf mapserver-6.2.0-rc1.tar.gz
+cs mapserver-6.2.0-rc1
+configure -with-proj=$DEVELDIR --with-gd=$DEVELDIR \
+    --with-ogr=$DEVELDIR/bin/gdal-config \
+    --with-gdal=$DEVELDIR/bin/gdal-config \
+    --with-wfs --with-wcs --with-wmsclient --with-wfsclient --with-sos \
+    --with-xml2-config=/usr/bin/xml2-config --with-apache-module \
+    --with-apxs=/usr/sbin/apxs --with-exslt=yes --with-xslt=yes
+# in this specific version you also need to apply https://github.com/unicolet/mapserver/commit/8ac6841c4c4857acddd87bdb4dfafb729aea91c3
+# when building on x86 systems
+make && make install
+cd mapscript/java
+make && make install
+cp mapscript.jar ~/mxd2map/lib
+
+Build MXD2map
+-------------
+
+cd ~/mxd2map
+ant jar-norevision
+
+Run MXD2map
+-----------
+ArcGIS needs some weird environment settings. Additionally it provides it's own versions
+of basic libraries like libstdc++. Here is what you have to do (or at least what worked for me):
+
+export JAVA_HOME=/usr/lib/jvm/java-1.6.0-openjdk-1.6.0.0
+. ~/arcgis/engine10.0/init_engine.sh
+. ~/arcgis/engine10.0/java/tools/init_java.sh
+. ~/arcgis/developerkit10.0/java/tools/setenv_ant.sh
+. ~/arcgis/developerkit10.0/init_devkit.sh
+export LD_LIBRARY_PATH=$DEVELDIR/lib:$LD_LIBRARY_PATH
+export LD_PRELOAD=$LD_PRELOAD:/usr/lib/libstdc++.so.6
+export AWT_TOOLKIT=XToolkit
+
+# Set the locale to some utf-8 value like
+export LC_ALL=en_US.UTF-8
+
+# Run it with:
+LD_PRELOAD=$LD_PRELOAD:/usr/lib/libstdc++.so.6 java -Xss2m -jar mxd2map.jar
+
+# Now edit the converter.properties sample so that it points to a valid mxd file
+# together with a valid mapfile template.
+
+# If your files contain special characters in windows encoding
+# convert them with convmv:
+convmv --notest -r -fcp1252 -t utf8 Bereisungen/
+
+Setup Mapserver with Apache
+---------------------------
+vim /etc/httpd/conf/httpd.con
+# Change setting Directory "/var/www/cgi-bin"
+
+<Directory "/var/www/cgi-bin">
+    AllowOverride None
+    Options ExecCGI
+    Order allow,deny
+    Allow from all
+</Directory>
+
+/etc/sysconfig/httpd
+
+# Notes:
+# Generate parameters to include all layers
+export MAPNAME=ausbaustrecken_west && grep wms_title ${MAPNAME}.map  | grep -v \"Layer\" | awk '{printf "&layers=" $2}' | sed s/\"//g | xargs -Ifoo echo "http://giid.polyhedra.intevation.de/cgi-bin/$MAPNAME.cgi?mode=browse&template=openlayers&foo"
+
+# Modify the fonts.txt with fonts according to your installation.
+sed -i 's/C:\/Windows\/Fonts/\/home\/aheinecke\/arcgis\/engine10.0\/fonts/' ttf-fonts/fonts.txt

--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/doku/source/INSTALL_Linux.txt	Fri Nov 16 17:02:07 2012 +0100
@@ -0,0 +1,1 @@
+../../INSTALL_Linux.txt
\ No newline at end of file