Mercurial > dive4elements > gnv-client

comparison doc/admin-manual/operating-the-system.tex @ 921:fb1e051713cc

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
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 \section{Management of operational processes} 1 \section{Management of operational processes}
2 2
3 Availability of the components 3 For running the entire GNV-system the following components have to be
4 1. Database server 4 available in the described sequence:
5 2. Artefact-server 5 \begin{enumerate}
6 3. Apache Tomcat running the WebClient 6 \item Database server
7 4. Apache WebServer 7 \item Artefact-server
8 \item Apache Tomcat running the WebClient
9 \item Apache WebServer
10 \end{enumerate}
8 11
9 During a server startup the installed components get started 12 During a server startup the installed components get started
10 automatically. 13 automatically.
11 14
12 \subsection{Managing the Artefact Server} 15 \subsection{Managing the Artifact Server}
13 16
14 \subsubsection*{Start Stop Restart} 17 \subsubsection*{Starting and Stopping}
15 18
16 The artefact server can be restarted without stopping the WebClient. 19 The artifact-server can be restarted without stopping the WebClient.
17 During the restart-process client accessing the server get an approriate 20 During the restart-process client accessing the server get an approriate
18 message. Their session data will not be lost if the artefact database 21 message. Their session data will not be lost if the artefact database
19 will remain untouched. 22 will remain untouched.
20 23
21 Stopping artefact server 24 Stopping artifact-server:
22 \verb+ /etc/init.d/artefact-server stop+ 25 \begin{lstlisting}
26 /etc/init.d/artefact-server stop
27 \end{lstlisting}
23 28
24 Starting artefact server 29 Starting artifact server
25 \verb+ /etc/init.d/artefact-server start+ 30 \begin{lstlisting}
26 31 /etc/init.d/artefact-server start
27 Restarting artefact server 32 \end{lstlisting}
28 \verb+ /etc/init.d/artefact-server restart+ 33
34 Restarting artifact server
35 \begin{lstlisting}
36 /etc/init.d/artefact-server restart
37 \end{lstlisting}
29 38
30 \subsubsection*{Monitoring the System} 39 \subsubsection*{Monitoring the System}
31 40
32 C.f. Testing the installation for the levels: operating system, 41 C.f. Chapter~\ref{ref:artifact-server-testing},
33 network and service availability 42 p.~\pageref{ref:artifact-server-testing} for testing the installation on
43 different levels: operating system, network and service availability.
34 44
35 \subsubsection*{Troubleshooting} 45 \subsubsection*{Troubleshooting}
36 46
37 Database problems 47 \paragraph*{Database problems}
38 For checking problems for problems with the connection to the database 48 For checking problems with the connection to the database server, check
39 server, check the logfile of the artefact-server (c.f. FIXME 49 the logfile of the artifact-server (c.f.
40 installation) look for entries like FIXME. 50 chapter~\chapter{ref:artifact-server-install},
51 p.~pageref{ref:artifact-server-install}.
41 52
42 In most cases, a restart of the artefact-server will help to solve 53 In most cases, a restart of the artifact-server will help to solve
43 problems in the artefact-server. If you still encounter problems, check 54 problems in the artifact-server. If you still encounter problems, check
44 for the network connection to the database server and the maturity of 55 for the network connection to the database server and the maturity of
45 the database server. 56 the database server.
46 57
47 58 \paragraph*{Caching problems}
48 Inconsistencies between original data and cached data 59 Inconsistencies between original data and cached data:
49 The artefact-server stores result sets of the database in a cache and 60 The artefact-server stores result sets of the database in a cache and
50 provides maps via configuration files for MapServer based on shapefiles. 61 provides maps via configuration files for MapServer based on shapefiles.
51 In case of inconsistencies showing up for longer than twice the 62 In case of inconsistencies showing up for longer than twice the
52 maximum of the update cycle of internal ETL processes, do the following 63 maximum of the update cycle of internal ETL processes, do the following
53 as user \verb+root+: 64 as user \verb+root+:
54 65
55 \begin{lstlisting} 66 \begin{lstlisting}
56 /etc/init.d/artefact-server stop 67 /etc/init.d/artefact-server stop
57 rm -ri \$ARTEFACT-SERVER-HOME/cache/* 68 rm -ri $ARTEFACT-SERVER-HOME/cache/*
58 /etc/init.d/artefact-server start 69 /etc/init.d/artefact-server start
59 \end{lstlisting} 70 \end{lstlisting}
60 71
61 \subsection{Managing the GNV-Client} 72 \subsection{Managing the GNV-Client}
62 \subsubsection*{Start Stop Restart} 73 \subsubsection*{Start Stop Restart}
63 74
64 The GNV-WebClient can be managed by controlling Apache Tomcat instance: 75 The GNV-WebClient can be managed by controlling Apache Tomcat instance:
65 76
66 Status GNV-WebClient 77 Status GNV-WebClient
67 \verb+ /etc/init.d/tomcat5.5 status+ 78 \begin{lstlisting}
79 /etc/init.d/tomcat5.5 status
80 \end{lstlisting}
68 81
69 Stopping GNV-WebClient 82 Stopping GNV-WebClient
70 \verb+ /etc/init.d/tomcat5.5 stop+ 83 \begin{lstlisting}
84 /etc/init.d/tomcat5.5 stop
85 \end{lstlisting}
71 86
72 Starting GNV-WebClient 87 Starting GNV-WebClient
73 \verb+ /etc/init.d/tomcat5.5 start+ 88 \begin{lstlisting}
89 /etc/init.d/tomcat5.5 start
90 \end{lstlisting}
74 91
75 Restarting GNV-WebClient 92 Restarting GNV-WebClient
76 \verb+ /etc/init.d/tomcat5.5 restart+ 93 \begin{lstlisting}
94 /etc/init.d/tomcat5.5 restart
95 \end{lstlisting}
77 96
78 \subsubsection*{Monitoring the System} 97 \subsubsection*{Monitoring the System}
79 98
80 For different possibilities c.f. Testing the installation 99 For different possibilities c.f. Testing the installation
81 100
82 \subsubsection*{Troubleshooting} 101 \subsubsection*{Troubleshooting}
83 102
84 The GNV-WebClient can not accessed through the Apache WebServer, do the 103 If the GNV-WebClient can not be accessed through the Apache WebServer, do the
85 following: 104 following:
86 1. \verb+ /etc/init.d/apache2 restart+ 105 \begin{lstlisting}
87 2. Check in your browser at \verb+ http://\$SERVERNAME/gnv+ 106 1. /etc/init.d/apache2 restart
107 2. Check in your browser at http://$SERVERNAME/gnv
108 \end{lstlisting}
88 109
89 If you still encounter problems, follow the next these steps: 110 If you still encounter problems, follow the next these steps:
111
90 {\bf Caution: The entire application will be down until the WebServer is 112 {\bf Caution: The entire application will be down until the WebServer is
91 back up} 113 back up.}
92 \begin{lstlisting} 114 \begin{lstlisting}
93 /etc/init.d/apache2 stop 115 /etc/init.d/apache2 stop
94 /etc/init.d/tomcat5.5 stop 116 /etc/init.d/tomcat5.5 stop
95 rm -r /usr/share/tomcat5.5/work/Catalina/localhost/gnv/* 117 rm -r /usr/share/tomcat5.5/work/Catalina/localhost/gnv/*
96 /etc/init.d/tomcat5.5 start # wait until tomcat is up 118 /etc/init.d/tomcat5.5 start # wait until tomcat is up
97 /etc/init.d/apache2 start 119 /etc/init.d/apache2 start
98 \end{lstlisting} 120 \end{lstlisting}
99 121
100 For further information, you look into the Logging during the use of the 122 For further information, you look into the log information during the use of the
101 GNV WebClient 123 GNV WebClient
102 \verb+ tail -f -n 50 /usr/share/tomcat5.5/logs/gnv.log+ 124 \begin{lstlisting}
125 tail -f -n 50 /usr/share/tomcat5.5/logs/gnv.log
126 \end{lstlisting}
103 127
104 To get even more logging, do the following: 128 To get even more logging, do the following:
105 129
106 {\bf Caution: The entire application will be down until the Apache Tomcat 130 {\bf Caution: The entire application will be down until the Apache Tomcat
107 has started properly; the higher log-level can affect the 131 has been started properly; the higher log-level can affect the
108 runtime-behaviour of the client} 132 runtime-behaviour of the client. For further instructions, c.f.
133 Chapter~\ref{ref:webclient-config}, p.~\pageref{ref:webclient-config}.}
134
109 \begin{lstlisting} 135 \begin{lstlisting}
110 /etc/init.d/tomcat5.5 stop 136 /etc/init.d/tomcat5.5 stop
111 Set logging to DEBUG (FIXME) 137 Set logging to DEBUG
112 vim /usr/share/tomcat5.5/webapps/gnv/WEB-INF/classes/log4j.properties 138 vim /usr/share/tomcat5.5/webapps/gnv/WEB-INF/classes/log4j.properties
113 /etc/init.d/tomcat5.5 start # wait until tomcat is up 139 /etc/init.d/tomcat5.5 start # wait until tomcat is up
114 tail -f -n 50 /usr/share/tomcat5.5/logs/gnv.log 140 tail -f -n 50 /usr/share/tomcat5.5/logs/gnv.log
115 \end{lstlisting} 141 \end{lstlisting}
116 142
117 It is recommended to undo the logging configuration, after the relevant 143 It is recommended to undo the logging configuration, after the relevant
118 part has been found. 144 part has been found.
119 145
120 \section{Lists of References} 146 \section{Lists of References}
121 FIXME 147 %% TODO: List of references
122 148
123 FIXME: How to adapt the address/port of connection to REST-server.E
http://dive4elements.wald.intevation.org