view doc/admin-manual/installation-webclient.tex @ 1133:cbfe708b9a17

Issue309: Documentation of the installation of the prxy-script doc/trunk@1243 c6561f87-3c4e-4783-a992-168aeb5c3f6f
author Tim Englich <tim.englich@intevation.de>
date Tue, 29 Jun 2010 12:08:30 +0000
parents 9d94bf77e442
children 17c3770e6c63
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\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.

http://dive4elements.wald.intevation.org