comparison doc/config-manual/general_settings.tex @ 1138:2c00570ab3bd

merged doc
author Thomas Arendsen Hein <thomas@intevation.de>
date Fri, 28 Sep 2012 12:14:02 +0200
parents 411b09d348ca
children
comparison
equal deleted inserted replaced
1129:ccfa07b88476 1138:2c00570ab3bd
1 \section{Configuring the GNV-Server}
2
3 The configuration of the artifact- and mapserver is been done in the
4 central configuration directory at {\tt artifact-server/conf/}. The
5 central entry point is the file {\tt conf.xml}. All components of the
6 configuration are linked from this document.
7
8 {\bf Within the configuration the key
9 {\verb+${artifacts.config.dir}+} can be used to reference the central
10 configuration directory of the artifact-server instance, e.g.
11 \texttt{/opt/artifact-server/conf}.}
12
13 The following structure gives an overview of the entire structure
14 starting from {\tt conf/}:
15
16 %% tree /opt/artifact-server/
17 \begin{lstlisting}
18 conf/
19 |-- arcsdeconnectionpool.properties # database connection
20 |-- charttemplate.xml # general properties for chart generation
21 |-- conf.xml # central configuration
22 |-- ehcache.xml # configuration of caching system
23 |-- log4j.properties # logging of server
24 |-- maptemplates # style defintions for rendering maps
25 | `-- *.vm
26 |-- meshwidth.xml # buffer-size for querying different FIS on
27 # meshes
28 |-- palette # styling for 2D charts
29 | `-- *.xml
30 |-- products # configuration of steps in workflows
31 | |-- horizontalcrosssection
32 | | `-- *.xml
33 | |-- horizontalprofile
34 | | `-- *.xml
35 | |-- layer
36 | | `-- *.xml
37 | |-- timeseries
38 | | |-- *.xml
39 | | `-- timegap_definition.xml # definition of a gaps as defines in MEDIAN Coded Value Domains section TSIntervalTypes. The meaning of the defined gaps are detailed explained in the file itself.
40 | |-- verticalcrosssection
41 | | `-- *.xml
42 | `-- verticalprofile
43 | `-- *.xml
44 `-- queries.properties # SQL configuration according to products
45 \end{lstlisting}
46
47
48 The central config-file {\tt conf/conf.xml} is XML-based and contains the
49 following main elements:
50
51 \begin{lstlisting}
52 artifact-database
53 |-- geo-backend # pointing to database connection, SQL configuration
54 |-- rest-server # port, listen addresses
55 |-- database # internal database storing artifacts
56 |-- ehcache # pointing to cache configuration
57 |-- cleaner # time of cleanups FIXME
58 |-- export-secret # signing project files
59 |-- factories # list of expert information systems
60 |-- artifacts # list of products
61 |-- gnv # charts, palettes, interpolation parameters
62 |-- mapserver # integration of mapserver
63 `-- velocity # templating language used in maptemplates
64 \end{lstlisting}
65
66 The documentation of the configuration will be split up in 4 sections
67 addressing different tasks:
68 \begin{enumerate}
69 \item "Configuring and Running Artifact-Server" covering the main elements
70 \texttt{
71 geo-backend, rest-server, database, ehcache, cleaner, export-secret}
72 \item "Generating Charts -- Background and Configuration" covering
73 the main element {\tt gnv}
74 \item "Generating Maps -- Background and Configuration" covering the
75 main elements {\tt mapserver, velocity}
76 \item "Configuring FIS, Products, States, Transitions and
77 SQL-Statements" covering the main elements {\tt factories,
78 artifacts}
79 \end{enumerate}
80

http://dive4elements.wald.intevation.org