annotate 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
rev   line source
901
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
1 \subsection{GNV-WebClient}
921
fb1e051713cc Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents: 901
diff changeset
2 The last step of the installationprcess is to install the WebClient called
fb1e051713cc Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents: 901
diff changeset
3 GNV-Client. The GNV-Client is a web Application ARchive (WAR) which has to be published
fb1e051713cc Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents: 901
diff changeset
4 via Apache Tomcat.
901
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
5
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
6
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
7 \subsubsection*{Installation}
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
8
921
fb1e051713cc Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents: 901
diff changeset
9 Make sure, the Apache Tomcat is stopped. Deploying the WAR-file:
fb1e051713cc Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents: 901
diff changeset
10 \begin{lstlisting}
fb1e051713cc Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents: 901
diff changeset
11 cp -i gnv-\$VERSION.war /usr/share/tomcat5.5/webapps/gnv.war
fb1e051713cc Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents: 901
diff changeset
12 # Start Tomcat:
fb1e051713cc Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents: 901
diff changeset
13 /etc/init.d/tomcat5.5 start
fb1e051713cc Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents: 901
diff changeset
14 \end{lstlisting}
901
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
15
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
16
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
17 \subsubsection*{Configuration}
921
fb1e051713cc Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents: 901
diff changeset
18 \label{ref:webclient-config}
901
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
19
921
fb1e051713cc Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents: 901
diff changeset
20 As default, the GNV-Client looks for an artifact-server running on
fb1e051713cc Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents: 901
diff changeset
21 \verb+ http://localhost:8181/+. If this address needs not to be changed,
fb1e051713cc Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents: 901
diff changeset
22 there is nothing to do to considering the execution environment.
901
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
23
921
fb1e051713cc Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents: 901
diff changeset
24 If the address of the artifact-server has been changed (c.f.
fb1e051713cc Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents: 901
diff changeset
25 chapter~\ref{}, p.\pageref{}), it can be adapted in the file
fb1e051713cc Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents: 901
diff changeset
26 \verb+ WEB-INF/web.xml+ for the parameter name
fb1e051713cc Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents: 901
diff changeset
27 \verb+de.intevation.gnv.artifactdatabase.client.ArtifactDatabase.url.1+.
fb1e051713cc Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents: 901
diff changeset
28
fb1e051713cc Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents: 901
diff changeset
29 As default log information is written into the file
fb1e051713cc Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents: 901
diff changeset
30 \verb+/usr/share/tomcat5.5/logs/gnv.log+. The log level can be adjusted
fb1e051713cc Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents: 901
diff changeset
31 in the file \verb+WEB-INF/classes/log4j.properties+. For further
fb1e051713cc Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents: 901
diff changeset
32 instructions look into the file.
fb1e051713cc Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents: 901
diff changeset
33
fb1e051713cc Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents: 901
diff changeset
34 {\em Hint: The changes need to be done within the compressed
fb1e051713cc Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents: 901
diff changeset
35 war-file because of the deployment mechanism of Apache Tomcat in case of
fb1e051713cc Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents: 901
diff changeset
36 a restart. Keep in mind to repackage the war-file for a solution
fb1e051713cc Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents: 901
diff changeset
37 surveiving a restart of Tomcat.}
fb1e051713cc Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents: 901
diff changeset
38
901
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
39
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
40 \subsubsection*{Test of the Installation}
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
41
921
fb1e051713cc Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents: 901
diff changeset
42 Testing the installation via Apache WebServer, mod\_jk and Apache Tomcat:
fb1e051713cc Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents: 901
diff changeset
43 \begin{lstlisting}
fb1e051713cc Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents: 901
diff changeset
44 wget http://localhost/gnv/ -O gnv
fb1e051713cc Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents: 901
diff changeset
45 \end{lstlisting}
901
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
46
921
fb1e051713cc Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents: 901
diff changeset
47 The file \verb+gnv+ includes HTML describing the startpage of the
fb1e051713cc Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents: 901
diff changeset
48 GNV-WebClient.

http://dive4elements.wald.intevation.org