Mercurial > dive4elements > gnv-client

annotate doc/admin-manual/operating-the-system.tex @ 1136:17c3770e6c63

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Added corrections and wishes of the training on the installation which was given to the BSH. doc/trunk@1257 c6561f87-3c4e-4783-a992-168aeb5c3f6f
author Tim Englich <tim.englich@intevation.de>
date Fri, 13 Aug 2010 09:15:20 +0000
parents ec28a68b5a87
children
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 \section{Management of operational processes}
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
2
921
fb1e051713cc Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents: 901
diff changeset
3 For running the entire GNV-system the following components have to be
fb1e051713cc Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents: 901
diff changeset
4 available in the described sequence:
fb1e051713cc Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents: 901
diff changeset
5 \begin{enumerate}
fb1e051713cc Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents: 901
diff changeset
6 \item Database server
925
ec28a68b5a87 Unified naming of artefact to artifact
Hans Plum <hans.plum@intevation.de>
parents: 924
diff changeset
7 \item Artifact-server
921
fb1e051713cc Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents: 901
diff changeset
8 \item Apache Tomcat running the WebClient
fb1e051713cc Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents: 901
diff changeset
9 \item Apache WebServer
fb1e051713cc Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents: 901
diff changeset
10 \end{enumerate}
901
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
11
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
12 During a server startup the installed components get started
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
13 automatically.
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
14
921
fb1e051713cc Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents: 901
diff changeset
15 \subsection{Managing the Artifact Server}
901
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
16
921
fb1e051713cc Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents: 901
diff changeset
17 \subsubsection*{Starting and Stopping}
901
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
18
921
fb1e051713cc Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents: 901
diff changeset
19 The artifact-server can be restarted without stopping the WebClient.
901
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
20 During the restart-process client accessing the server get an approriate
925
ec28a68b5a87 Unified naming of artefact to artifact
Hans Plum <hans.plum@intevation.de>
parents: 924
diff changeset
21 message. Their session data will not be lost if the artifact database
901
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
22 will remain untouched.
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 Stopping artifact-server:
fb1e051713cc Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents: 901
diff changeset
25 \begin{lstlisting}
925
ec28a68b5a87 Unified naming of artefact to artifact
Hans Plum <hans.plum@intevation.de>
parents: 924
diff changeset
26 /etc/init.d/artifact-server stop
921
fb1e051713cc Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents: 901
diff changeset
27 \end{lstlisting}
901
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
28
921
fb1e051713cc Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents: 901
diff changeset
29 Starting artifact server
fb1e051713cc Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents: 901
diff changeset
30 \begin{lstlisting}
925
ec28a68b5a87 Unified naming of artefact to artifact
Hans Plum <hans.plum@intevation.de>
parents: 924
diff changeset
31 /etc/init.d/artifact-server start
921
fb1e051713cc Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents: 901
diff changeset
32 \end{lstlisting}
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 Restarting artifact server
fb1e051713cc Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents: 901
diff changeset
35 \begin{lstlisting}
925
ec28a68b5a87 Unified naming of artefact to artifact
Hans Plum <hans.plum@intevation.de>
parents: 924
diff changeset
36 /etc/init.d/artifact-server restart
921
fb1e051713cc Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents: 901
diff changeset
37 \end{lstlisting}
901
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
38
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
39 \subsubsection*{Troubleshooting}
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
40
921
fb1e051713cc Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents: 901
diff changeset
41 \paragraph*{Database problems}
fb1e051713cc Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents: 901
diff changeset
42 For checking problems with the connection to the database server, check
fb1e051713cc Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents: 901
diff changeset
43 the logfile of the artifact-server (c.f.
1136
17c3770e6c63 Added corrections and wishes of the training on the installation which was given to the BSH.
Tim Englich <tim.englich@intevation.de>
parents: 925
diff changeset
44 Chapter~\ref{ref:artifact-server-install},
17c3770e6c63 Added corrections and wishes of the training on the installation which was given to the BSH.
Tim Englich <tim.englich@intevation.de>
parents: 925
diff changeset
45 p.~\pageref{ref:artifact-server-install}).
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 In most cases, a restart of the artifact-server will help to solve
fb1e051713cc Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents: 901
diff changeset
48 problems in the artifact-server. If you still encounter problems, check
901
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
49 for the network connection to the database server and the maturity of
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
50 the database server.
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
51
921
fb1e051713cc Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents: 901
diff changeset
52 \paragraph*{Caching problems}
fb1e051713cc Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents: 901
diff changeset
53 Inconsistencies between original data and cached data:
925
ec28a68b5a87 Unified naming of artefact to artifact
Hans Plum <hans.plum@intevation.de>
parents: 924
diff changeset
54 The artifact-server stores result sets of the database in a cache and
901
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
55 provides maps via configuration files for MapServer based on shapefiles.
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
56 In case of inconsistencies showing up for longer than twice the
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
57 maximum of the update cycle of internal ETL processes, do the following
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
58 as user \verb+root+:
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
59
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
60 \begin{lstlisting}
925
ec28a68b5a87 Unified naming of artefact to artifact
Hans Plum <hans.plum@intevation.de>
parents: 924
diff changeset
61 cd /opt/artifact-server
ec28a68b5a87 Unified naming of artefact to artifact
Hans Plum <hans.plum@intevation.de>
parents: 924
diff changeset
62 /etc/init.d/artifact-server stop
ec28a68b5a87 Unified naming of artefact to artifact
Hans Plum <hans.plum@intevation.de>
parents: 924
diff changeset
63 rm -ri cache/*
ec28a68b5a87 Unified naming of artefact to artifact
Hans Plum <hans.plum@intevation.de>
parents: 924
diff changeset
64 /etc/init.d/artifact-server start
901
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
65 \end{lstlisting}
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
66
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
67 \subsection{Managing the GNV-Client}
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
68 \subsubsection*{Start Stop Restart}
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
69
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
70 The GNV-WebClient can be managed by controlling Apache Tomcat instance:
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
71
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
72 Status GNV-WebClient
921
fb1e051713cc Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents: 901
diff changeset
73 \begin{lstlisting}
fb1e051713cc Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents: 901
diff changeset
74 /etc/init.d/tomcat5.5 status
fb1e051713cc Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents: 901
diff changeset
75 \end{lstlisting}
901
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
76
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
77 Stopping GNV-WebClient
921
fb1e051713cc Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents: 901
diff changeset
78 \begin{lstlisting}
fb1e051713cc Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents: 901
diff changeset
79 /etc/init.d/tomcat5.5 stop
fb1e051713cc Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents: 901
diff changeset
80 \end{lstlisting}
901
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
81
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
82 Starting GNV-WebClient
921
fb1e051713cc Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents: 901
diff changeset
83 \begin{lstlisting}
fb1e051713cc Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents: 901
diff changeset
84 /etc/init.d/tomcat5.5 start
fb1e051713cc Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents: 901
diff changeset
85 \end{lstlisting}
901
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
86
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
87 Restarting GNV-WebClient
921
fb1e051713cc Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents: 901
diff changeset
88 \begin{lstlisting}
fb1e051713cc Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents: 901
diff changeset
89 /etc/init.d/tomcat5.5 restart
fb1e051713cc Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents: 901
diff changeset
90 \end{lstlisting}
901
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
91
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
92 \subsubsection*{Troubleshooting}
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
93
921
fb1e051713cc Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents: 901
diff changeset
94 If the GNV-WebClient can not be accessed through the Apache WebServer, do the
901
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
95 following:
921
fb1e051713cc Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents: 901
diff changeset
96 \begin{lstlisting}
fb1e051713cc Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents: 901
diff changeset
97 1. /etc/init.d/apache2 restart
fb1e051713cc Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents: 901
diff changeset
98 2. Check in your browser at http://$SERVERNAME/gnv
fb1e051713cc Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents: 901
diff changeset
99 \end{lstlisting}
901
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
100
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
101 If you still encounter problems, follow the next these steps:
921
fb1e051713cc Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents: 901
diff changeset
102
901
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
103 {\bf Caution: The entire application will be down until the WebServer is
921
fb1e051713cc Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents: 901
diff changeset
104 back up.}
901
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
105 \begin{lstlisting}
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
106 /etc/init.d/apache2 stop
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
107 /etc/init.d/tomcat5.5 stop
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
108 rm -r /usr/share/tomcat5.5/work/Catalina/localhost/gnv/*
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
109 /etc/init.d/tomcat5.5 start # wait until tomcat is up
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
110 /etc/init.d/apache2 start
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
111 \end{lstlisting}
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
112
921
fb1e051713cc Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents: 901
diff changeset
113 For further information, you look into the log information during the use of the
901
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
114 GNV WebClient
921
fb1e051713cc Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents: 901
diff changeset
115 \begin{lstlisting}
fb1e051713cc Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents: 901
diff changeset
116 tail -f -n 50 /usr/share/tomcat5.5/logs/gnv.log
fb1e051713cc Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents: 901
diff changeset
117 \end{lstlisting}
901
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
118
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
119 To get even more logging, do the following:
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
120
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
121 {\bf Caution: The entire application will be down until the Apache Tomcat
921
fb1e051713cc Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents: 901
diff changeset
122 has been started properly; the higher log-level can affect the
fb1e051713cc Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents: 901
diff changeset
123 runtime-behaviour of the client. For further instructions, c.f.
fb1e051713cc Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents: 901
diff changeset
124 Chapter~\ref{ref:webclient-config}, p.~\pageref{ref:webclient-config}.}
fb1e051713cc Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents: 901
diff changeset
125
901
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
126 \begin{lstlisting}
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
127 /etc/init.d/tomcat5.5 stop
921
fb1e051713cc Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents: 901
diff changeset
128 Set logging to DEBUG
901
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
129 vim /usr/share/tomcat5.5/webapps/gnv/WEB-INF/classes/log4j.properties
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
130 /etc/init.d/tomcat5.5 start # wait until tomcat is up
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
131 tail -f -n 50 /usr/share/tomcat5.5/logs/gnv.log
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
132 \end{lstlisting}
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
133
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
134 It is recommended to undo the logging configuration, after the relevant
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
135 part has been found.
http://dive4elements.wald.intevation.org