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@921: Make sure, the Apache Tomcat is stopped. Deploying the WAR-file:
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@921: chapter~\ref{}, p.\pageref{}), it can be adapted in the file
hans@921: \verb+ 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}
hans@921:   wget http://localhost/gnv/ -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.
hans@901: 
hans@921: \subsubsection*{Uninstall the GNV-WebClient}
hans@921: To uninstall the GNV-Client, the war-Archive can be removed.
hans@921: \begin{lstlisting}
hans@921:   rm /usr/share/tomcat5.5/webapps/gnv.war
hans@921: \end{lstlisting}
hans@901: 
hans@921: The Tomcat application server should undeploy /remove the application
hans@921: automatically. If not, execute the following commands additionally:
hans@901: 
hans@921: \begin{lstlisting}
hans@921:   /etc/init.d/tomcat5.5 stop
hans@921:   rm -rf /usr/share/tomcat5.5/webapps/gnv
hans@921:   /etc/init.d/tomcat5.5 start
hans@921: \end{lstlisting}