annotate INSTALL.txt @ 188:43f1cbdcd597

Modified and beautified the documentation: * INSTALL.txt, doku/Makefile, doku/source/conf.py, doku/source/functionality.txt, doku/source/index.txt, doku/source/restrictions.txt, website/favicon.png, LICENCE.txt: added more details to the content of the documentation. some more configurations. * doku/source/LICENCE.txt: New. Added a licence-text (symlinking into the documentation). * doku/source/_static/favicon.png, doku/source/_static/logo_wide.png, doku/source/_templates/indexsidebar.html, doku/source/_templates/layout.html: Optic-cosmetics.
author Stephan Holl <stephan.holl@intevation.de>
date Wed, 20 Jul 2011 15:53:01 +0200
parents 91e2d46d7968
children 1e3a5019c4ed
rev   line source
188
43f1cbdcd597 Modified and beautified the documentation:
Stephan Holl <stephan.holl@intevation.de>
parents: 182
diff changeset
1 .. index:: installation, requirements, apache, UMN MapServer, compile, jar
43f1cbdcd597 Modified and beautified the documentation:
Stephan Holl <stephan.holl@intevation.de>
parents: 182
diff changeset
2
140
0ebaec057f15 * INSTALL.txt: added a hint how to install the converter and its
Stephan Holl <stephan.holl@intevation.de>
parents:
diff changeset
3 ------------
0ebaec057f15 * INSTALL.txt: added a hint how to install the converter and its
Stephan Holl <stephan.holl@intevation.de>
parents:
diff changeset
4 Requirements
0ebaec057f15 * INSTALL.txt: added a hint how to install the converter and its
Stephan Holl <stephan.holl@intevation.de>
parents:
diff changeset
5 ------------
0ebaec057f15 * INSTALL.txt: added a hint how to install the converter and its
Stephan Holl <stephan.holl@intevation.de>
parents:
diff changeset
6
0ebaec057f15 * INSTALL.txt: added a hint how to install the converter and its
Stephan Holl <stephan.holl@intevation.de>
parents:
diff changeset
7 The current version of the converter only runs on Windows. This is because
0ebaec057f15 * INSTALL.txt: added a hint how to install the converter and its
Stephan Holl <stephan.holl@intevation.de>
parents:
diff changeset
8 the ArcObjects JDK API is not running properly on Linux though.
0ebaec057f15 * INSTALL.txt: added a hint how to install the converter and its
Stephan Holl <stephan.holl@intevation.de>
parents:
diff changeset
9
0ebaec057f15 * INSTALL.txt: added a hint how to install the converter and its
Stephan Holl <stephan.holl@intevation.de>
parents:
diff changeset
10 To run the converter you need at least the following componentes:
0ebaec057f15 * INSTALL.txt: added a hint how to install the converter and its
Stephan Holl <stephan.holl@intevation.de>
parents:
diff changeset
11
0ebaec057f15 * INSTALL.txt: added a hint how to install the converter and its
Stephan Holl <stephan.holl@intevation.de>
parents:
diff changeset
12 * Sun Java6 SDK to build, JRE to run
0ebaec057f15 * INSTALL.txt: added a hint how to install the converter and its
Stephan Holl <stephan.holl@intevation.de>
parents:
diff changeset
13 * ArcGIS Desktop10.x or ArcEngine10.x with a valid licence enabled
0ebaec057f15 * INSTALL.txt: added a hint how to install the converter and its
Stephan Holl <stephan.holl@intevation.de>
parents:
diff changeset
14 * UMN MapServer with Java MapScript-bindings (recent development-version)
0ebaec057f15 * INSTALL.txt: added a hint how to install the converter and its
Stephan Holl <stephan.holl@intevation.de>
parents:
diff changeset
15 * Apache Webserver for displaying the resulting Mapfiles
0ebaec057f15 * INSTALL.txt: added a hint how to install the converter and its
Stephan Holl <stephan.holl@intevation.de>
parents:
diff changeset
16 * Optional: MapServer compiled with ArcSDE-plugin
0ebaec057f15 * INSTALL.txt: added a hint how to install the converter and its
Stephan Holl <stephan.holl@intevation.de>
parents:
diff changeset
17 * Optional: GDAL/OGR compiled with ArcSDE-support
0ebaec057f15 * INSTALL.txt: added a hint how to install the converter and its
Stephan Holl <stephan.holl@intevation.de>
parents:
diff changeset
18 * Optional: GDAL/OGR compiled with FileGeodatabase-support
0ebaec057f15 * INSTALL.txt: added a hint how to install the converter and its
Stephan Holl <stephan.holl@intevation.de>
parents:
diff changeset
19
0ebaec057f15 * INSTALL.txt: added a hint how to install the converter and its
Stephan Holl <stephan.holl@intevation.de>
parents:
diff changeset
20
0ebaec057f15 * INSTALL.txt: added a hint how to install the converter and its
Stephan Holl <stephan.holl@intevation.de>
parents:
diff changeset
21
0ebaec057f15 * INSTALL.txt: added a hint how to install the converter and its
Stephan Holl <stephan.holl@intevation.de>
parents:
diff changeset
22 ------------
0ebaec057f15 * INSTALL.txt: added a hint how to install the converter and its
Stephan Holl <stephan.holl@intevation.de>
parents:
diff changeset
23 Installation
0ebaec057f15 * INSTALL.txt: added a hint how to install the converter and its
Stephan Holl <stephan.holl@intevation.de>
parents:
diff changeset
24 ------------
0ebaec057f15 * INSTALL.txt: added a hint how to install the converter and its
Stephan Holl <stephan.holl@intevation.de>
parents:
diff changeset
25
0ebaec057f15 * INSTALL.txt: added a hint how to install the converter and its
Stephan Holl <stephan.holl@intevation.de>
parents:
diff changeset
26 Compile the converter-sources
0ebaec057f15 * INSTALL.txt: added a hint how to install the converter and its
Stephan Holl <stephan.holl@intevation.de>
parents:
diff changeset
27 -----------------------------
0ebaec057f15 * INSTALL.txt: added a hint how to install the converter and its
Stephan Holl <stephan.holl@intevation.de>
parents:
diff changeset
28
0ebaec057f15 * INSTALL.txt: added a hint how to install the converter and its
Stephan Holl <stephan.holl@intevation.de>
parents:
diff changeset
29 To compile the sources you need to have a properly configured
0ebaec057f15 * INSTALL.txt: added a hint how to install the converter and its
Stephan Holl <stephan.holl@intevation.de>
parents:
diff changeset
30 ant-environmet available. ArcGIS SDK provides an ant-installation which
0ebaec057f15 * INSTALL.txt: added a hint how to install the converter and its
Stephan Holl <stephan.holl@intevation.de>
parents:
diff changeset
31 suffices::
0ebaec057f15 * INSTALL.txt: added a hint how to install the converter and its
Stephan Holl <stephan.holl@intevation.de>
parents:
diff changeset
32
0ebaec057f15 * INSTALL.txt: added a hint how to install the converter and its
Stephan Holl <stephan.holl@intevation.de>
parents:
diff changeset
33 ant jar
0ebaec057f15 * INSTALL.txt: added a hint how to install the converter and its
Stephan Holl <stephan.holl@intevation.de>
parents:
diff changeset
34
182
91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents: 140
diff changeset
35 or::
91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents: 140
diff changeset
36
91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents: 140
diff changeset
37 ant jar-norevision
91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents: 140
diff changeset
38
140
0ebaec057f15 * INSTALL.txt: added a hint how to install the converter and its
Stephan Holl <stephan.holl@intevation.de>
parents:
diff changeset
39 Install Apache Webserver
0ebaec057f15 * INSTALL.txt: added a hint how to install the converter and its
Stephan Holl <stephan.holl@intevation.de>
parents:
diff changeset
40 ------------------------
0ebaec057f15 * INSTALL.txt: added a hint how to install the converter and its
Stephan Holl <stephan.holl@intevation.de>
parents:
diff changeset
41
0ebaec057f15 * INSTALL.txt: added a hint how to install the converter and its
Stephan Holl <stephan.holl@intevation.de>
parents:
diff changeset
42 Install Apache webserver by exedcuting the .msi-file and follow the
0ebaec057f15 * INSTALL.txt: added a hint how to install the converter and its
Stephan Holl <stephan.holl@intevation.de>
parents:
diff changeset
43 install-dialogs::
0ebaec057f15 * INSTALL.txt: added a hint how to install the converter and its
Stephan Holl <stephan.holl@intevation.de>
parents:
diff changeset
44
0ebaec057f15 * INSTALL.txt: added a hint how to install the converter and its
Stephan Holl <stephan.holl@intevation.de>
parents:
diff changeset
45 httpd-2.2.19-win32-x86-openssl-0.9.8r.msi
0ebaec057f15 * INSTALL.txt: added a hint how to install the converter and its
Stephan Holl <stephan.holl@intevation.de>
parents:
diff changeset
46
0ebaec057f15 * INSTALL.txt: added a hint how to install the converter and its
Stephan Holl <stephan.holl@intevation.de>
parents:
diff changeset
47 Make sure that you install apache as a service so it will be available
0ebaec057f15 * INSTALL.txt: added a hint how to install the converter and its
Stephan Holl <stephan.holl@intevation.de>
parents:
diff changeset
48 directly after system bootup.
0ebaec057f15 * INSTALL.txt: added a hint how to install the converter and its
Stephan Holl <stephan.holl@intevation.de>
parents:
diff changeset
49
0ebaec057f15 * INSTALL.txt: added a hint how to install the converter and its
Stephan Holl <stephan.holl@intevation.de>
parents:
diff changeset
50
0ebaec057f15 * INSTALL.txt: added a hint how to install the converter and its
Stephan Holl <stephan.holl@intevation.de>
parents:
diff changeset
51 Install UMN MapServer
0ebaec057f15 * INSTALL.txt: added a hint how to install the converter and its
Stephan Holl <stephan.holl@intevation.de>
parents:
diff changeset
52 ---------------------
0ebaec057f15 * INSTALL.txt: added a hint how to install the converter and its
Stephan Holl <stephan.holl@intevation.de>
parents:
diff changeset
53
0ebaec057f15 * INSTALL.txt: added a hint how to install the converter and its
Stephan Holl <stephan.holl@intevation.de>
parents:
diff changeset
54 The current documentation uses the Windows binary-builds from http://www.gisinternals.com/sdk/
0ebaec057f15 * INSTALL.txt: added a hint how to install the converter and its
Stephan Holl <stephan.holl@intevation.de>
parents:
diff changeset
55
0ebaec057f15 * INSTALL.txt: added a hint how to install the converter and its
Stephan Holl <stephan.holl@intevation.de>
parents:
diff changeset
56 1. Unzip the ZIP-file at c:/ms_6.1-dev
0ebaec057f15 * INSTALL.txt: added a hint how to install the converter and its
Stephan Holl <stephan.holl@intevation.de>
parents:
diff changeset
57
0ebaec057f15 * INSTALL.txt: added a hint how to install the converter and its
Stephan Holl <stephan.holl@intevation.de>
parents:
diff changeset
58 #. Configure Apache Webserver to find the cgi-bin-folder::
0ebaec057f15 * INSTALL.txt: added a hint how to install the converter and its
Stephan Holl <stephan.holl@intevation.de>
parents:
diff changeset
59
0ebaec057f15 * INSTALL.txt: added a hint how to install the converter and its
Stephan Holl <stephan.holl@intevation.de>
parents:
diff changeset
60 ScriptAlias /cgi-bin/ "C:/ms_6.1-dev/bin/"
0ebaec057f15 * INSTALL.txt: added a hint how to install the converter and its
Stephan Holl <stephan.holl@intevation.de>
parents:
diff changeset
61
0ebaec057f15 * INSTALL.txt: added a hint how to install the converter and its
Stephan Holl <stephan.holl@intevation.de>
parents:
diff changeset
62 <Location "/cgi-bin">
0ebaec057f15 * INSTALL.txt: added a hint how to install the converter and its
Stephan Holl <stephan.holl@intevation.de>
parents:
diff changeset
63 Options None
0ebaec057f15 * INSTALL.txt: added a hint how to install the converter and its
Stephan Holl <stephan.holl@intevation.de>
parents:
diff changeset
64 Order allow,deny
0ebaec057f15 * INSTALL.txt: added a hint how to install the converter and its
Stephan Holl <stephan.holl@intevation.de>
parents:
diff changeset
65 Allow from all
0ebaec057f15 * INSTALL.txt: added a hint how to install the converter and its
Stephan Holl <stephan.holl@intevation.de>
parents:
diff changeset
66 </Location>
0ebaec057f15 * INSTALL.txt: added a hint how to install the converter and its
Stephan Holl <stephan.holl@intevation.de>
parents:
diff changeset
67
0ebaec057f15 * INSTALL.txt: added a hint how to install the converter and its
Stephan Holl <stephan.holl@intevation.de>
parents:
diff changeset
68 #. Copy mapserv.exe from c:/ms_6.1-dev/bin/apps/ms to c:/ms_6.1-dev/bin/
0ebaec057f15 * INSTALL.txt: added a hint how to install the converter and its
Stephan Holl <stephan.holl@intevation.de>
parents:
diff changeset
69
182
91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents: 140
diff changeset
70
140
0ebaec057f15 * INSTALL.txt: added a hint how to install the converter and its
Stephan Holl <stephan.holl@intevation.de>
parents:
diff changeset
71 Create run-environment
0ebaec057f15 * INSTALL.txt: added a hint how to install the converter and its
Stephan Holl <stephan.holl@intevation.de>
parents:
diff changeset
72 ----------------------
0ebaec057f15 * INSTALL.txt: added a hint how to install the converter and its
Stephan Holl <stephan.holl@intevation.de>
parents:
diff changeset
73
182
91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents: 140
diff changeset
74 The current version of MXD2map needs a few steps to run properly.
91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents: 140
diff changeset
75 The following steps assume the runtime folder to be c:/mxd2map/. This path can
91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents: 140
diff changeset
76 be changed.
140
0ebaec057f15 * INSTALL.txt: added a hint how to install the converter and its
Stephan Holl <stephan.holl@intevation.de>
parents:
diff changeset
77
182
91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents: 140
diff changeset
78 1. Copy mxd2map.jar to c:/mxd2map/.
140
0ebaec057f15 * INSTALL.txt: added a hint how to install the converter and its
Stephan Holl <stephan.holl@intevation.de>
parents:
diff changeset
79
182
91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents: 140
diff changeset
80 #. Copy folder "conf" from repository to c:/mxd2map/
91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents: 140
diff changeset
81
91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents: 140
diff changeset
82 #. Create folder c:/mxd2map/lib/
91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents: 140
diff changeset
83
91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents: 140
diff changeset
84 #. Get log4j from http://logging.apache.org/log4j/1.2/download.html
91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents: 140
diff changeset
85
91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents: 140
diff changeset
86 #. Get jargs http://jargs.sourceforge.net/ (Version 1.0)
91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents: 140
diff changeset
87
91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents: 140
diff changeset
88 #. Build the libraries and copy the resulting jar-files to c:/mxd2map/lib/
91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents: 140
diff changeset
89
91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents: 140
diff changeset
90 #. Copy mapscript.jar and mapscript.dll to c:/mxd2map/lib/
91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents: 140
diff changeset
91
91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents: 140
diff changeset
92 #. Create a folder c:/mxd2map/logs/
91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents: 140
diff changeset
93
91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents: 140
diff changeset
94 #. Create or copy a converter.properties file to c:/mxd2map/
91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents: 140
diff changeset
95
This site is hosted by Intevation GmbH (Datenschutzerklärung und Impressum | Privacy Policy and Imprint)