view doc/admin-manual/installation-webclient.tex @ 923:95b48f7d0acf

Added a specialized Makefile doc/trunk@1060 c6561f87-3c4e-4783-a992-168aeb5c3f6f
author Hans Plum <hans.plum@intevation.de>
date Thu, 06 May 2010 05:57:12 +0000
parents 237f3a809aee
children 9d94bf77e442
line wrap: on
line source
\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.

http://dive4elements.wald.intevation.org