Mercurial > dive4elements > gnv-client
comparison doc/admin-manual/installation-webclient.tex @ 921:fb1e051713cc
Improved artifact, webclient and operations section
doc/trunk@1058 c6561f87-3c4e-4783-a992-168aeb5c3f6f
| author | Hans Plum <hans.plum@intevation.de> |
|---|---|
| date | Wed, 05 May 2010 10:07:24 +0000 |
| parents | 1ebde13e620f |
| children | 237f3a809aee |
comparison
equal
deleted
inserted
replaced
| 920:63bc0044ff72 | 921:fb1e051713cc |
|---|---|
| 1 \subsection{GNV-WebClient} | 1 \subsection{GNV-WebClient} |
| 2 - Aim/Task | 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. | |
| 3 | 5 |
| 4 The last step of the Installationprcess ist to install the Webfrontent called | |
| 5 GNV-Client. | |
| 6 the GNV-Client is a Web application ARchive (WAR) which have to be published | |
| 7 using the Tomcat Applicationserver whe was installed in Section ??? FIXME. | |
| 8 | 6 |
| 9 \subsubsection*{Installation} | 7 \subsubsection*{Installation} |
| 10 Copy the File gnv.war into /usr/share/tomcat5.5/webapps/ | |
| 11 * cp gnv.war /usr/share/tomcat5.5/webapps/ | |
| 12 | 8 |
| 13 If the Server does not publish the new Archive automatically you have to restart | 9 Make sure, the Apache Tomcat is stopped. Deploying the WAR-file: |
| 14 the Server. | 10 \begin{lstlisting} |
| 11 cp -i gnv-\$VERSION.war /usr/share/tomcat5.5/webapps/gnv.war | |
| 12 # Start Tomcat: | |
| 13 /etc/init.d/tomcat5.5 start | |
| 14 \end{lstlisting} | |
| 15 | 15 |
| 16 * /etc/init.d/tomcat5.5 restart | |
| 17 | 16 |
| 18 \subsubsection*{Configuration} | 17 \subsubsection*{Configuration} |
| 18 \label{ref:webclient-config} | |
| 19 | 19 |
| 20 FIXME: How to adapt the address/port of connection to REST-server. | 20 As default, the GNV-Client looks for an artifact-server running on |
| 21 \verb+ http://localhost:8181/+. If this address needs not to be changed, | |
| 22 there is nothing to do to considering the execution environment. | |
| 21 | 23 |
| 22 There is nothing to customize consider the execution Environment. | 24 If the address of the artifact-server has been changed (c.f. |
| 25 chapter~\ref{}, p.\pageref{}), it can be adapted in the file | |
| 26 \verb+ WEB-INF/web.xml+ for the parameter name | |
| 27 \verb+de.intevation.gnv.artifactdatabase.client.ArtifactDatabase.url.1+. | |
| 28 | |
| 29 As default log information is written into the file | |
| 30 \verb+/usr/share/tomcat5.5/logs/gnv.log+. The log level can be adjusted | |
| 31 in the file \verb+WEB-INF/classes/log4j.properties+. For further | |
| 32 instructions look into the file. | |
| 33 | |
| 34 {\em Hint: The changes need to be done within the compressed | |
| 35 war-file because of the deployment mechanism of Apache Tomcat in case of | |
| 36 a restart. Keep in mind to repackage the war-file for a solution | |
| 37 surveiving a restart of Tomcat.} | |
| 38 | |
| 23 | 39 |
| 24 \subsubsection*{Test of the Installation} | 40 \subsubsection*{Test of the Installation} |
| 25 | 41 |
| 26 You are able to test the Installation by executing the following URl | 42 Testing the installation via Apache WebServer, mod\_jk and Apache Tomcat: |
| 43 \begin{lstlisting} | |
| 44 wget http://localhost/gnv/ -O gnv | |
| 45 \end{lstlisting} | |
| 27 | 46 |
| 28 * curl http://localhost/gnv/version.do | grep Version | 47 The file \verb+gnv+ includes HTML describing the startpage of the |
| 48 GNV-WebClient. | |
| 29 | 49 |
| 30 The Response should include the Version of the GNV-Client. | 50 \subsubsection*{Uninstall the GNV-WebClient} |
| 51 To uninstall the GNV-Client, the war-Archive can be removed. | |
| 52 \begin{lstlisting} | |
| 53 rm /usr/share/tomcat5.5/webapps/gnv.war | |
| 54 \end{lstlisting} | |
| 31 | 55 |
| 32 \subsubsection*{Uninstall the GNV-Client} | 56 The Tomcat application server should undeploy /remove the application |
| 33 To uninstall teh GNV-Client you only have to remove the war-Archive. | 57 automatically. If not, execute the following commands additionally: |
| 34 | 58 |
| 35 * rm /usr/share/tomcat5.5/webapps/gnv.war | 59 \begin{lstlisting} |
| 36 | 60 /etc/init.d/tomcat5.5 stop |
| 37 The Tomcat Application Server should undeploy /remove the Application automatically. | 61 rm -rf /usr/share/tomcat5.5/webapps/gnv |
| 38 | 62 /etc/init.d/tomcat5.5 start |
| 39 If not you can execute the following command aditional | 63 \end{lstlisting} |
| 40 | |
| 41 * rm -rf /usr/share/tomcat5.5/webapps/gnv |