# HG changeset patch # User Hans Plum # Date 1273132493 0 # Node ID ec28a68b5a874a965201a8bd3be07ec141dadeaf # Parent 9d94bf77e442ec896d93960e40e69e67831b52c8 Unified naming of artefact to artifact doc/trunk@1062 c6561f87-3c4e-4783-a992-168aeb5c3f6f diff -r 9d94bf77e442 -r ec28a68b5a87 doc/ChangeLog --- a/doc/ChangeLog Thu May 06 06:24:41 2010 +0000 +++ b/doc/ChangeLog Thu May 06 07:54:53 2010 +0000 @@ -1,3 +1,10 @@ +2010-05-06 Hans Plum + + * admin-manual/overview.tex, + admin-manual/operating-the-system.tex, + admin-manual/installation-artefact-server.tex: + Unified naming of artefact to artifact + 2010-05-06 Hans Plum * admin-manual/title.tex, diff -r 9d94bf77e442 -r ec28a68b5a87 doc/admin-manual/installation-artefact-server.tex --- a/doc/admin-manual/installation-artefact-server.tex Thu May 06 06:24:41 2010 +0000 +++ b/doc/admin-manual/installation-artefact-server.tex Thu May 06 07:54:53 2010 +0000 @@ -39,7 +39,7 @@ Configure connection to database: \begin{lstlisting} - cd /opt/artefact-server + cd /opt/artifact-server vim conf/arcsdeconnectionpool.properties # in conf/arcsdeconnectionpool.properties do: @@ -52,7 +52,7 @@ Configure address for finding the WMS-Server: \begin{lstlisting} - cd /opt/artefact-server/ + cd /opt/artifact-server/ vim conf/conf.xml # adapt the address in the element # artifact-database/gnv/mapserver/server. This is @@ -69,15 +69,15 @@ \begin{lstlisting} # generate a randomized string, e.g. - cd /opt/artefact-server/ + cd /opt/artifact-server/ pwgen -s 30 # populate the tag artifact-database/export-secret \end{lstlisting} -Adapt TCP-port of artefact-server, if the default has to be changed +Adapt TCP-port of artifact-server, if the default has to be changed (default:8181): \begin{lstlisting} - cd /opt/artefact-server + cd /opt/artifact-server vim conf/conf.xml # in conf/conf.xml edit the element artifact-database/rest-server/port @@ -85,7 +85,7 @@ Integrate artifact-server in startup-process of operating system: \begin{lstlisting} - cp -i /opt/artefact-server/bin/debian/artifact-server /etc/init.d/ + cp -i /opt/artifact-server/bin/debian/artifact-server /etc/init.d/ chmod +x /etc/init.d/artifact-server update-rc.d artifact-server defaults \end{lstlisting} @@ -102,7 +102,7 @@ \label{ref:artifact-server-testing} Start the server: \begin{lstlisting} - /etc/init.d/artefact-server start + /etc/init.d/artifact-server start \end{lstlisting} 1. Operating System: Check if the process of the server called "App" @@ -115,12 +115,12 @@ 19509 Jps 19441 App - cat /var/run/artefact-server + cat /var/run/artifact-server \end{lstlisting} Task: Compare the running process numbers. - 2. Network: Check if the artefact-server opens a TCP-port (default: 8181) + 2. Network: Check if the artifact-server opens a TCP-port (default: 8181) \begin{lstlisting} netstat -nltp @@ -128,7 +128,7 @@ tcp 0 0 127.0.0.1:8181 0.0.0.0:* LISTEN 18648/java \end{lstlisting} - 3. Artefact-Server ready for communication with client? + 3. Artifact-Server ready for communication with client? \begin{lstlisting} curl "http://localhost:8181/factories" | xmllint --format - \end{lstlisting} diff -r 9d94bf77e442 -r ec28a68b5a87 doc/admin-manual/operating-the-system.tex --- a/doc/admin-manual/operating-the-system.tex Thu May 06 06:24:41 2010 +0000 +++ b/doc/admin-manual/operating-the-system.tex Thu May 06 07:54:53 2010 +0000 @@ -4,7 +4,7 @@ available in the described sequence: \begin{enumerate} \item Database server - \item Artefact-server + \item Artifact-server \item Apache Tomcat running the WebClient \item Apache WebServer \end{enumerate} @@ -18,22 +18,22 @@ The artifact-server can be restarted without stopping the WebClient. During the restart-process client accessing the server get an approriate -message. Their session data will not be lost if the artefact database +message. Their session data will not be lost if the artifact database will remain untouched. Stopping artifact-server: \begin{lstlisting} - /etc/init.d/artefact-server stop + /etc/init.d/artifact-server stop \end{lstlisting} Starting artifact server \begin{lstlisting} - /etc/init.d/artefact-server start + /etc/init.d/artifact-server start \end{lstlisting} Restarting artifact server \begin{lstlisting} - /etc/init.d/artefact-server restart + /etc/init.d/artifact-server restart \end{lstlisting} \subsubsection*{Troubleshooting} @@ -51,16 +51,17 @@ \paragraph*{Caching problems} Inconsistencies between original data and cached data: -The artefact-server stores result sets of the database in a cache and +The artifact-server stores result sets of the database in a cache and provides maps via configuration files for MapServer based on shapefiles. In case of inconsistencies showing up for longer than twice the maximum of the update cycle of internal ETL processes, do the following as user \verb+root+: \begin{lstlisting} - /etc/init.d/artefact-server stop - rm -ri $ARTEFACT-SERVER-HOME/cache/* - /etc/init.d/artefact-server start + cd /opt/artifact-server + /etc/init.d/artifact-server stop + rm -ri cache/* + /etc/init.d/artifact-server start \end{lstlisting} \subsection{Managing the GNV-Client} diff -r 9d94bf77e442 -r ec28a68b5a87 doc/admin-manual/overview.tex --- a/doc/admin-manual/overview.tex Thu May 06 06:24:41 2010 +0000 +++ b/doc/admin-manual/overview.tex Thu May 06 07:54:53 2010 +0000 @@ -27,13 +27,13 @@ \item WMS-Server \\ The WMS-Server provides maps via the standardized interface of the OGC Web Map Service. The configuration is managed through the -artefact-server depending on the parameterization done be the user in +artifact-server depending on the parameterization done be the user in the GNV-WebClient \item GNV-WebClient \\ The GNV-WebClient is a thin webbased client providing a HTML-based user interface for the user to parameterize the FIS and products via the -XML-based protocol provided by the artefact-server through its +XML-based protocol provided by the artifact-server through its RESTful-interface. Within the client the user can manage these tasks: \begin{itemize} \item Select FIS, producs and their parameterisation @@ -59,7 +59,7 @@ \section{Deliverables} \begin{enumerate} - \item \verb+ artefact-server-$VERSION.tar.bz2+ -- Artifact-Server of the + \item \verb+ artifact-server-$VERSION.tar.bz2+ -- Artifact-Server of the GNV-System as package for installation \item \verb+ gnv-$VERSION.war+ -- Web Application Archive for deploying in Apache Tomcat