Mercurial > dive4elements > gnv-client
comparison doc/config-manual/administering_artifact-server.tex @ 949:11d8cc2deb92 1.0
merged doc/1.0
| author | Thomas Arendsen Hein <thomas@intevation.de> |
|---|---|
| date | Fri, 28 Sep 2012 12:13:58 +0200 |
| parents | 975bb59bb136 |
| children |
comparison
equal
deleted
inserted
replaced
| 899:3f9fc88aec2b | 949:11d8cc2deb92 |
|---|---|
| 1 \subsection{Configuring and Running the Artifact-Server} | |
| 2 | |
| 3 This section describes the possibilities to configure the | |
| 4 artifact-server. The following properties do affect mostly technical | |
| 5 funtions of the server. | |
| 6 | |
| 7 This section describes the possibilities in a kind of a reference | |
| 8 manual. Information for the process of installing and integration can be | |
| 9 found in the Administration Manual of the GNV-System. | |
| 10 The following elements are covered here: | |
| 11 | |
| 12 \begin{lstlisting} | |
| 13 artifact-database | |
| 14 |-- geo-backend # pointing to database connection, SQL configuration | |
| 15 |-- rest-server # port, listen addresses | |
| 16 |-- database # internal database storing artifacts | |
| 17 |-- ehcache # pointing to cache configuration | |
| 18 |-- cleaner # time of cleanups FIXME | |
| 19 `-- export-secret # signing project files | |
| 20 \end{lstlisting} | |
| 21 | |
| 22 \paragraph*{geo-backend} | |
| 23 {\em Function}: The geo-backend encapsulates the logic for accessing the | |
| 24 database backend. At this time, the use of ESRI ArcSDE 9.3.1 is supported. | |
| 25 | |
| 26 At least, the following options for configuring the element {\tt | |
| 27 geo-backend} are required: | |
| 28 | |
| 29 \begin{itemize} | |
| 30 \item {\tt backend-configuration}: path to the file defining the | |
| 31 connection properties to the database backend, preconfigured to {\tt | |
| 32 arcsdeconnection.properties}. Normally, just the | |
| 33 connection parameters have to de adapted. Further information can be | |
| 34 found in the file itself. | |
| 35 | |
| 36 \item {\tt query-configuration}: path to the file listing a SQL statements,\\ | |
| 37 preconfigured to \texttt{queries.properties}. Further information can be | |
| 38 found at chapter~\ref{ref:queries.properties}, | |
| 39 p.~\ref{ref:queries.properties} | |
| 40 \end{itemize} | |
| 41 | |
| 42 | |
| 43 \paragraph*{rest-server} | |
| 44 {\em Function}: The REST-Server needs a HTTP binding configured via: | |
| 45 | |
| 46 \begin{itemize} | |
| 47 \item {\tt port}: port the server should listen on. Preconfigured on | |
| 48 8181. | |
| 49 \item {\tt listen}: for security reason the accessibility can be | |
| 50 limited. The parameter needs an IP-address or a hostname. | |
| 51 Accessibility to the entire network can be done by | |
| 52 removing/commenting out of the element. | |
| 53 \end{itemize} | |
| 54 | |
| 55 | |
| 56 \paragraph*{database} | |
| 57 {\em Function}: The internal database of the system for storing | |
| 58 artifacts representing a parameterisation of a client session. So fare, | |
| 59 the filebased database H2 is supported. Connecting to other backends can | |
| 60 be provided. | |
| 61 | |
| 62 \begin{itemize} | |
| 63 \item {\tt user}: database user for connecting to the | |
| 64 artifact-database. In new installations "SA" is used. | |
| 65 \item {\tt password}: password of the database user for | |
| 66 authentification. | |
| 67 \item {\tt url}: Connection URL to the database-files. | |
| 68 In the preconfiguration, they are written to \\ | |
| 69 \verb| ${artifacts.config.dir}/../artifactdb| | |
| 70 \end{itemize} | |
| 71 | |
| 72 | |
| 73 \paragraph*{ehcache} | |
| 74 {\em Function}: The cache for storing result sets of the database. The | |
| 75 configuration in {\tt ehcache.xml} should not been adapted. Changing has | |
| 76 at least consequence to the system requirements. | |
| 77 | |
| 78 \begin{itemize} | |
| 79 \item {\tt configuration}: the path to the configuration file. \\ | |
| 80 Preconfigured: \verb+${artifacts.config.dir}/ehcache.xml+ | |
| 81 \end{itemize} | |
| 82 | |
| 83 | |
| 84 \paragraph*{cleaner} | |
| 85 {\em Function}: Process for cleaning up the artifact-database. Artifacts | |
| 86 have a time-to-life. Died artifacts need to be removed. Changing the | |
| 87 interval has consequences to the size of the database. | |
| 88 | |
| 89 \begin{itemize} | |
| 90 \item {\tt sleep-time}: Time interval in milliseconds between 2 | |
| 91 checks. Preconfigured: 60000 (1 minute) | |
| 92 \end{itemize} | |
| 93 | |
| 94 | |
| 95 \paragraph*{export-secret} | |
| 96 {\em Function}: Signature for signing project files that were created by | |
| 97 the artifact-server instance. Before reading a projectfile the server | |
| 98 checks the file against that signature/check sum. | |
| 99 | |
| 100 {\bf Be aware, changing the signature of updating the source code of | |
| 101 artifacts will prevent of using existing project-files.} | |
| 102 | |
| 103 For setting up the secret, c.f. the tips in the admin manual. |