hans@901: \section{Management of operational processes}
hans@901: 
hans@901: Availability of the components
hans@901:   1. Database server 
hans@901:   2. Artefact-server
hans@901:   3. Apache Tomcat running the WebClient
hans@901:   4. Apache WebServer
hans@901: 
hans@901: During a server startup the installed components get started
hans@901: automatically.
hans@901: 
hans@901: \subsection{Managing the Artefact Server}
hans@901: 
hans@901: \subsubsection*{Start Stop Restart}
hans@901: 
hans@901: The artefact server can be restarted without stopping the WebClient.
hans@901: During the restart-process client accessing the server get an approriate
hans@901: message. Their session data will not be lost if the artefact database
hans@901: will remain untouched.
hans@901: 
hans@901:   Stopping artefact server
hans@901:   \verb+ /etc/init.d/artefact-server stop+
hans@901: 
hans@901:   Starting artefact server
hans@901:   \verb+ /etc/init.d/artefact-server start+
hans@901: 
hans@901:   Restarting artefact server
hans@901:   \verb+ /etc/init.d/artefact-server restart+
hans@901: 
hans@901: \subsubsection*{Monitoring the System}
hans@901: 
hans@901: C.f. Testing the installation for the levels: operating system,
hans@901: network and service availability
hans@901: 
hans@901: \subsubsection*{Troubleshooting}
hans@901: 
hans@901: Database problems
hans@901: For checking problems for problems with the connection to the database
hans@901: server, check the logfile of the artefact-server (c.f. FIXME
hans@901: installation) look for entries like FIXME.
hans@901: 
hans@901: In most cases, a restart of the artefact-server will help to solve
hans@901: problems in the artefact-server. If you still encounter problems, check
hans@901: for the network connection to the database server and the maturity of
hans@901: the database server.
hans@901: 
hans@901: 
hans@901: Inconsistencies between original data and cached data
hans@901: The artefact-server stores result sets of the database in a cache and
hans@901: provides maps via configuration files for MapServer based on shapefiles.
hans@901: In case of inconsistencies showing up for longer than twice the
hans@901: maximum of the update cycle of internal ETL processes, do the following
hans@901: as user \verb+root+:
hans@901: 
hans@901: \begin{lstlisting}
hans@901:   /etc/init.d/artefact-server stop
hans@901:   rm -ri \$ARTEFACT-SERVER-HOME/cache/*
hans@901:   /etc/init.d/artefact-server start
hans@901: \end{lstlisting}
hans@901: 
hans@901: \subsection{Managing the GNV-Client}
hans@901: \subsubsection*{Start Stop Restart}
hans@901: 
hans@901: The GNV-WebClient can be managed by controlling Apache Tomcat instance:
hans@901: 
hans@901:  Status GNV-WebClient
hans@901:  \verb+ /etc/init.d/tomcat5.5 status+
hans@901: 
hans@901:  Stopping GNV-WebClient
hans@901:  \verb+ /etc/init.d/tomcat5.5 stop+
hans@901: 
hans@901:  Starting GNV-WebClient
hans@901:  \verb+ /etc/init.d/tomcat5.5 start+
hans@901: 
hans@901:  Restarting GNV-WebClient
hans@901:  \verb+ /etc/init.d/tomcat5.5 restart+
hans@901: 
hans@901: \subsubsection*{Monitoring the System}
hans@901: 
hans@901: For different possibilities c.f. Testing the installation
hans@901: 
hans@901: \subsubsection*{Troubleshooting}
hans@901: 
hans@901: The GNV-WebClient can not accessed through the Apache WebServer, do the
hans@901: following:
hans@901: 1. \verb+ /etc/init.d/apache2 restart+
hans@901: 2. Check in your browser at \verb+ http://\$SERVERNAME/gnv+
hans@901: 
hans@901: If you still encounter problems, follow the next these steps:
hans@901: {\bf Caution: The entire application will be down until the WebServer is
hans@901: back up}
hans@901: \begin{lstlisting}
hans@901:   /etc/init.d/apache2 stop
hans@901:   /etc/init.d/tomcat5.5 stop
hans@901:   rm -r /usr/share/tomcat5.5/work/Catalina/localhost/gnv/*
hans@901:   /etc/init.d/tomcat5.5 start # wait until tomcat is up
hans@901:   /etc/init.d/apache2 start
hans@901: \end{lstlisting}
hans@901: 
hans@901: For further information, you look into the Logging during the use of the
hans@901: GNV WebClient
hans@901: \verb+ tail -f -n 50 /usr/share/tomcat5.5/logs/gnv.log+
hans@901: 
hans@901: To get even more logging, do the following:
hans@901: 
hans@901: {\bf Caution: The entire application will be down until the Apache Tomcat
hans@901: has started properly; the higher log-level can affect the
hans@901: runtime-behaviour of the client}
hans@901: \begin{lstlisting}
hans@901:   /etc/init.d/tomcat5.5 stop
hans@901:   Set logging to DEBUG (FIXME)
hans@901:   vim /usr/share/tomcat5.5/webapps/gnv/WEB-INF/classes/log4j.properties
hans@901:   /etc/init.d/tomcat5.5 start # wait until tomcat is up
hans@901:   tail -f -n 50 /usr/share/tomcat5.5/logs/gnv.log
hans@901: \end{lstlisting}
hans@901: 
hans@901: It is recommended to undo the logging configuration, after the relevant
hans@901: part has been found.
hans@901: 
hans@901: \section{Lists of References}
hans@901: FIXME
hans@901: 
hans@901: FIXME: How to adapt the address/port of connection to REST-server.E