--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/doc/admin-manual/installation-webclient.tex	Fri Sep 28 12:13:58 2012 +0200
@@ -0,0 +1,52 @@
+\subsection{GNV-WebClient}
+The last step of the installationprcess is to install the WebClient called
+GNV-Client. The GNV-Client is a web Application ARchive (WAR) which has to be published
+via Apache Tomcat.
+
+
+\subsubsection*{Installation}
+
+Make sure, the Apache Tomcat is stopped. Deploying the
+WAR-file\footnote{There are several ways of deployment in Apache Tomcat.
+Background information can be found at
+\url{http://tomcat.apache.org/tomcat-5.5-doc/deployer-howto.html}}:
+\begin{lstlisting}
+  cp -i gnv-\$VERSION.war /usr/share/tomcat5.5/webapps/gnv.war
+  # Start Tomcat:
+  /etc/init.d/tomcat5.5 start
+\end{lstlisting}
+
+
+\subsubsection*{Configuration}
+\label{ref:webclient-config}
+
+As default, the GNV-Client looks for an artifact-server running on
+\verb+ http://localhost:8181/+. If this address needs not to be changed,
+there is nothing to do to considering the execution environment.
+
+If the address of the artifact-server has been changed (c.f.
+chapter~\ref{ref:artifact-server-install},
+p.\pageref{ref:artifact-server-install}), it can be adapted in the file {\tt
+WEB-INF/web.xml} for the parameter name 
+\verb+de.intevation.gnv.artifactdatabase.client.ArtifactDatabase.url.1+.
+
+As default log information is written into the file
+\verb+/usr/share/tomcat5.5/logs/gnv.log+. The log level can be adjusted
+in the file \verb+WEB-INF/classes/log4j.properties+. For further
+instructions look into the file.
+
+{\em Hint: The changes need to be done within the compressed
+war-file because of the deployment mechanism of Apache Tomcat in case of
+a restart. Keep in mind to repackage the war-file for a solution
+surveiving a restart of Tomcat.}
+
+
+\subsubsection*{Test of the Installation}
+
+Testing the installation via Apache WebServer, mod\_jk and Apache Tomcat:
+\begin{lstlisting}
+  curl "http://localhost/gnv/" -o gnv
+\end{lstlisting}
+
+The file \verb+gnv+ includes HTML describing the startpage of the
+GNV-WebClient.