annotate doc/config-manual/general_settings.tex @ 947:9a28846dfb9c

Final QS for V1.0 doc/trunk@1091 c6561f87-3c4e-4783-a992-168aeb5c3f6f
author Hans Plum <hans.plum@intevation.de>
date Wed, 12 May 2010 11:35:25 +0000
parents 491b8d6cd291
children 975bb59bb136
rev   line source
938
2d84fc30ab58 Added more chapters in config-manual
Hans Plum <hans.plum@intevation.de>
parents: 937
diff changeset
1 \section{Configuring the GNV-Server}
2d84fc30ab58 Added more chapters in config-manual
Hans Plum <hans.plum@intevation.de>
parents: 937
diff changeset
2
2d84fc30ab58 Added more chapters in config-manual
Hans Plum <hans.plum@intevation.de>
parents: 937
diff changeset
3 The configuration of the artifact- and mapserver is been done in the
2d84fc30ab58 Added more chapters in config-manual
Hans Plum <hans.plum@intevation.de>
parents: 937
diff changeset
4 central configuration directory at {\tt artifact-server/conf/}. The
2d84fc30ab58 Added more chapters in config-manual
Hans Plum <hans.plum@intevation.de>
parents: 937
diff changeset
5 central entry point is the file {\tt conf.xml}. All components of the
2d84fc30ab58 Added more chapters in config-manual
Hans Plum <hans.plum@intevation.de>
parents: 937
diff changeset
6 configuration are linked from this document.
2d84fc30ab58 Added more chapters in config-manual
Hans Plum <hans.plum@intevation.de>
parents: 937
diff changeset
7
2d84fc30ab58 Added more chapters in config-manual
Hans Plum <hans.plum@intevation.de>
parents: 937
diff changeset
8 {\bf Within the configuration the key
2d84fc30ab58 Added more chapters in config-manual
Hans Plum <hans.plum@intevation.de>
parents: 937
diff changeset
9 {\verb+${artifacts.config.dir}+} can be used to reference the central
2d84fc30ab58 Added more chapters in config-manual
Hans Plum <hans.plum@intevation.de>
parents: 937
diff changeset
10 configuration directory of the artifact-server instance, e.g.
947
9a28846dfb9c Final QS for V1.0
Hans Plum <hans.plum@intevation.de>
parents: 945
diff changeset
11 {\tt /opt/artifact-server/conf}.}
938
2d84fc30ab58 Added more chapters in config-manual
Hans Plum <hans.plum@intevation.de>
parents: 937
diff changeset
12
2d84fc30ab58 Added more chapters in config-manual
Hans Plum <hans.plum@intevation.de>
parents: 937
diff changeset
13 The following structure gives an overview of the entire structure
2d84fc30ab58 Added more chapters in config-manual
Hans Plum <hans.plum@intevation.de>
parents: 937
diff changeset
14 starting from {\tt conf/}:
2d84fc30ab58 Added more chapters in config-manual
Hans Plum <hans.plum@intevation.de>
parents: 937
diff changeset
15
2d84fc30ab58 Added more chapters in config-manual
Hans Plum <hans.plum@intevation.de>
parents: 937
diff changeset
16 %% tree /opt/artifact-server/
2d84fc30ab58 Added more chapters in config-manual
Hans Plum <hans.plum@intevation.de>
parents: 937
diff changeset
17 \begin{lstlisting}
2d84fc30ab58 Added more chapters in config-manual
Hans Plum <hans.plum@intevation.de>
parents: 937
diff changeset
18 conf/
2d84fc30ab58 Added more chapters in config-manual
Hans Plum <hans.plum@intevation.de>
parents: 937
diff changeset
19 |-- arcsdeconnectionpool.properties # database connection
2d84fc30ab58 Added more chapters in config-manual
Hans Plum <hans.plum@intevation.de>
parents: 937
diff changeset
20 |-- charttemplate.xml # general properties for chart generation
2d84fc30ab58 Added more chapters in config-manual
Hans Plum <hans.plum@intevation.de>
parents: 937
diff changeset
21 |-- conf.xml # central configuration
2d84fc30ab58 Added more chapters in config-manual
Hans Plum <hans.plum@intevation.de>
parents: 937
diff changeset
22 |-- ehcache.xml # configuration of caching system
2d84fc30ab58 Added more chapters in config-manual
Hans Plum <hans.plum@intevation.de>
parents: 937
diff changeset
23 |-- log4j.properties # logging of server
2d84fc30ab58 Added more chapters in config-manual
Hans Plum <hans.plum@intevation.de>
parents: 937
diff changeset
24 |-- maptemplates # style defintions for rendering maps
2d84fc30ab58 Added more chapters in config-manual
Hans Plum <hans.plum@intevation.de>
parents: 937
diff changeset
25 | `-- *.vm
2d84fc30ab58 Added more chapters in config-manual
Hans Plum <hans.plum@intevation.de>
parents: 937
diff changeset
26 |-- meshwidth.xml # buffer-size for querying different FIS on
2d84fc30ab58 Added more chapters in config-manual
Hans Plum <hans.plum@intevation.de>
parents: 937
diff changeset
27 # meshes
2d84fc30ab58 Added more chapters in config-manual
Hans Plum <hans.plum@intevation.de>
parents: 937
diff changeset
28 |-- palette # styling for 2D charts
2d84fc30ab58 Added more chapters in config-manual
Hans Plum <hans.plum@intevation.de>
parents: 937
diff changeset
29 | `-- *.xml
2d84fc30ab58 Added more chapters in config-manual
Hans Plum <hans.plum@intevation.de>
parents: 937
diff changeset
30 |-- products # configuration of steps in workflows
2d84fc30ab58 Added more chapters in config-manual
Hans Plum <hans.plum@intevation.de>
parents: 937
diff changeset
31 | |-- horizontalcrosssection
2d84fc30ab58 Added more chapters in config-manual
Hans Plum <hans.plum@intevation.de>
parents: 937
diff changeset
32 | | `-- *.xml
2d84fc30ab58 Added more chapters in config-manual
Hans Plum <hans.plum@intevation.de>
parents: 937
diff changeset
33 | |-- horizontalprofile
2d84fc30ab58 Added more chapters in config-manual
Hans Plum <hans.plum@intevation.de>
parents: 937
diff changeset
34 | | `-- *.xml
2d84fc30ab58 Added more chapters in config-manual
Hans Plum <hans.plum@intevation.de>
parents: 937
diff changeset
35 | |-- layer
2d84fc30ab58 Added more chapters in config-manual
Hans Plum <hans.plum@intevation.de>
parents: 937
diff changeset
36 | | `-- *.xml
2d84fc30ab58 Added more chapters in config-manual
Hans Plum <hans.plum@intevation.de>
parents: 937
diff changeset
37 | |-- timeseries
2d84fc30ab58 Added more chapters in config-manual
Hans Plum <hans.plum@intevation.de>
parents: 937
diff changeset
38 | | |-- *.xml
945
491b8d6cd291 Added content about generating charts
Hans Plum <hans.plum@intevation.de>
parents: 944
diff changeset
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.
938
2d84fc30ab58 Added more chapters in config-manual
Hans Plum <hans.plum@intevation.de>
parents: 937
diff changeset
40 | |-- verticalcrosssection
2d84fc30ab58 Added more chapters in config-manual
Hans Plum <hans.plum@intevation.de>
parents: 937
diff changeset
41 | | `-- *.xml
2d84fc30ab58 Added more chapters in config-manual
Hans Plum <hans.plum@intevation.de>
parents: 937
diff changeset
42 | `-- verticalprofile
2d84fc30ab58 Added more chapters in config-manual
Hans Plum <hans.plum@intevation.de>
parents: 937
diff changeset
43 | `-- *.xml
2d84fc30ab58 Added more chapters in config-manual
Hans Plum <hans.plum@intevation.de>
parents: 937
diff changeset
44 `-- queries.properties # SQL configuration according to products
2d84fc30ab58 Added more chapters in config-manual
Hans Plum <hans.plum@intevation.de>
parents: 937
diff changeset
45 \end{lstlisting}
2d84fc30ab58 Added more chapters in config-manual
Hans Plum <hans.plum@intevation.de>
parents: 937
diff changeset
46
2d84fc30ab58 Added more chapters in config-manual
Hans Plum <hans.plum@intevation.de>
parents: 937
diff changeset
47
2d84fc30ab58 Added more chapters in config-manual
Hans Plum <hans.plum@intevation.de>
parents: 937
diff changeset
48 The central config-file {\tt conf/conf.xml} is XML-based and contains the
2d84fc30ab58 Added more chapters in config-manual
Hans Plum <hans.plum@intevation.de>
parents: 937
diff changeset
49 following main elements:
2d84fc30ab58 Added more chapters in config-manual
Hans Plum <hans.plum@intevation.de>
parents: 937
diff changeset
50
2d84fc30ab58 Added more chapters in config-manual
Hans Plum <hans.plum@intevation.de>
parents: 937
diff changeset
51 \begin{lstlisting}
2d84fc30ab58 Added more chapters in config-manual
Hans Plum <hans.plum@intevation.de>
parents: 937
diff changeset
52 artifact-database
2d84fc30ab58 Added more chapters in config-manual
Hans Plum <hans.plum@intevation.de>
parents: 937
diff changeset
53 |-- geo-backend # pointing to database connection, SQL configuration
2d84fc30ab58 Added more chapters in config-manual
Hans Plum <hans.plum@intevation.de>
parents: 937
diff changeset
54 |-- rest-server # port, listen addresses
2d84fc30ab58 Added more chapters in config-manual
Hans Plum <hans.plum@intevation.de>
parents: 937
diff changeset
55 |-- database # internal database storing artifacts
2d84fc30ab58 Added more chapters in config-manual
Hans Plum <hans.plum@intevation.de>
parents: 937
diff changeset
56 |-- ehcache # pointing to cache configuration
2d84fc30ab58 Added more chapters in config-manual
Hans Plum <hans.plum@intevation.de>
parents: 937
diff changeset
57 |-- cleaner # time of cleanups FIXME
2d84fc30ab58 Added more chapters in config-manual
Hans Plum <hans.plum@intevation.de>
parents: 937
diff changeset
58 |-- export-secret # signing project files
2d84fc30ab58 Added more chapters in config-manual
Hans Plum <hans.plum@intevation.de>
parents: 937
diff changeset
59 |-- factories # list of expert information systems
2d84fc30ab58 Added more chapters in config-manual
Hans Plum <hans.plum@intevation.de>
parents: 937
diff changeset
60 |-- artifacts # list of products
2d84fc30ab58 Added more chapters in config-manual
Hans Plum <hans.plum@intevation.de>
parents: 937
diff changeset
61 |-- gnv # charts, palettes, interpolation parameters
2d84fc30ab58 Added more chapters in config-manual
Hans Plum <hans.plum@intevation.de>
parents: 937
diff changeset
62 |-- mapserver # integration of mapserver
2d84fc30ab58 Added more chapters in config-manual
Hans Plum <hans.plum@intevation.de>
parents: 937
diff changeset
63 `-- velocity # templating language used in maptemplates
2d84fc30ab58 Added more chapters in config-manual
Hans Plum <hans.plum@intevation.de>
parents: 937
diff changeset
64 \end{lstlisting}
2d84fc30ab58 Added more chapters in config-manual
Hans Plum <hans.plum@intevation.de>
parents: 937
diff changeset
65
2d84fc30ab58 Added more chapters in config-manual
Hans Plum <hans.plum@intevation.de>
parents: 937
diff changeset
66 The documentation of the configuration will be split up in 4 sections
2d84fc30ab58 Added more chapters in config-manual
Hans Plum <hans.plum@intevation.de>
parents: 937
diff changeset
67 addressing different tasks:
2d84fc30ab58 Added more chapters in config-manual
Hans Plum <hans.plum@intevation.de>
parents: 937
diff changeset
68 \begin{enumerate}
947
9a28846dfb9c Final QS for V1.0
Hans Plum <hans.plum@intevation.de>
parents: 945
diff changeset
69 \item "Configuring and Running Artifact-Server" covering the main elements
9a28846dfb9c Final QS for V1.0
Hans Plum <hans.plum@intevation.de>
parents: 945
diff changeset
70 \texttt{
938
2d84fc30ab58 Added more chapters in config-manual
Hans Plum <hans.plum@intevation.de>
parents: 937
diff changeset
71 geo-backend, rest-server, database, ehcache, cleaner, export-secret}
2d84fc30ab58 Added more chapters in config-manual
Hans Plum <hans.plum@intevation.de>
parents: 937
diff changeset
72 \item "Generating Charts -- Background and Configuration" covering
2d84fc30ab58 Added more chapters in config-manual
Hans Plum <hans.plum@intevation.de>
parents: 937
diff changeset
73 the main element {\tt gnv}
2d84fc30ab58 Added more chapters in config-manual
Hans Plum <hans.plum@intevation.de>
parents: 937
diff changeset
74 \item "Generating Maps -- Background and Configuration" covering the
2d84fc30ab58 Added more chapters in config-manual
Hans Plum <hans.plum@intevation.de>
parents: 937
diff changeset
75 main elements {\tt mapserver, velocity}
2d84fc30ab58 Added more chapters in config-manual
Hans Plum <hans.plum@intevation.de>
parents: 937
diff changeset
76 \item "Configuring FIS, Products, States, Transitions and
2d84fc30ab58 Added more chapters in config-manual
Hans Plum <hans.plum@intevation.de>
parents: 937
diff changeset
77 SQL-Statements" covering the main elements {\tt factories,
2d84fc30ab58 Added more chapters in config-manual
Hans Plum <hans.plum@intevation.de>
parents: 937
diff changeset
78 artifacts}
2d84fc30ab58 Added more chapters in config-manual
Hans Plum <hans.plum@intevation.de>
parents: 937
diff changeset
79 \end{enumerate}

http://dive4elements.wald.intevation.org