Mercurial > dive4elements > gnv-client
comparison doc/admin-manual/installation-webclient.tex @ 949:11d8cc2deb92 1.0
merged doc/1.0
| author | Thomas Arendsen Hein <thomas@intevation.de> |
|---|---|
| date | Fri, 28 Sep 2012 12:13:58 +0200 |
| parents | 9d94bf77e442 |
| children | 17c3770e6c63 |
comparison
equal
deleted
inserted
replaced
| 899:3f9fc88aec2b | 949:11d8cc2deb92 |
|---|---|
| 1 \subsection{GNV-WebClient} | |
| 2 The last step of the installationprcess is to install the WebClient called | |
| 3 GNV-Client. The GNV-Client is a web Application ARchive (WAR) which has to be published | |
| 4 via Apache Tomcat. | |
| 5 | |
| 6 | |
| 7 \subsubsection*{Installation} | |
| 8 | |
| 9 Make sure, the Apache Tomcat is stopped. Deploying the | |
| 10 WAR-file\footnote{There are several ways of deployment in Apache Tomcat. | |
| 11 Background information can be found at | |
| 12 \url{http://tomcat.apache.org/tomcat-5.5-doc/deployer-howto.html}}: | |
| 13 \begin{lstlisting} | |
| 14 cp -i gnv-\$VERSION.war /usr/share/tomcat5.5/webapps/gnv.war | |
| 15 # Start Tomcat: | |
| 16 /etc/init.d/tomcat5.5 start | |
| 17 \end{lstlisting} | |
| 18 | |
| 19 | |
| 20 \subsubsection*{Configuration} | |
| 21 \label{ref:webclient-config} | |
| 22 | |
| 23 As default, the GNV-Client looks for an artifact-server running on | |
| 24 \verb+ http://localhost:8181/+. If this address needs not to be changed, | |
| 25 there is nothing to do to considering the execution environment. | |
| 26 | |
| 27 If the address of the artifact-server has been changed (c.f. | |
| 28 chapter~\ref{ref:artifact-server-install}, | |
| 29 p.\pageref{ref:artifact-server-install}), it can be adapted in the file {\tt | |
| 30 WEB-INF/web.xml} for the parameter name | |
| 31 \verb+de.intevation.gnv.artifactdatabase.client.ArtifactDatabase.url.1+. | |
| 32 | |
| 33 As default log information is written into the file | |
| 34 \verb+/usr/share/tomcat5.5/logs/gnv.log+. The log level can be adjusted | |
| 35 in the file \verb+WEB-INF/classes/log4j.properties+. For further | |
| 36 instructions look into the file. | |
| 37 | |
| 38 {\em Hint: The changes need to be done within the compressed | |
| 39 war-file because of the deployment mechanism of Apache Tomcat in case of | |
| 40 a restart. Keep in mind to repackage the war-file for a solution | |
| 41 surveiving a restart of Tomcat.} | |
| 42 | |
| 43 | |
| 44 \subsubsection*{Test of the Installation} | |
| 45 | |
| 46 Testing the installation via Apache WebServer, mod\_jk and Apache Tomcat: | |
| 47 \begin{lstlisting} | |
| 48 curl "http://localhost/gnv/" -o gnv | |
| 49 \end{lstlisting} | |
| 50 | |
| 51 The file \verb+gnv+ includes HTML describing the startpage of the | |
| 52 GNV-WebClient. |