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