\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:
\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{}, p.\pageref{}), it can be adapted in the file
\verb+ 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}
  wget http://localhost/gnv/ -O gnv
\end{lstlisting}

The file \verb+gnv+ includes HTML describing the startpage of the
GNV-WebClient.

\subsubsection*{Uninstall the GNV-WebClient}
To uninstall the GNV-Client, the war-Archive can be removed.
\begin{lstlisting}
  rm /usr/share/tomcat5.5/webapps/gnv.war
\end{lstlisting}

The Tomcat application server should undeploy /remove the application
automatically. If not, execute the following commands additionally:

\begin{lstlisting}
  /etc/init.d/tomcat5.5 stop
  rm -rf /usr/share/tomcat5.5/webapps/gnv
  /etc/init.d/tomcat5.5 start
\end{lstlisting}