# HG changeset patch # User Tim Englich # Date 1281690920 0 # Node ID 17c3770e6c6300144e8084ae8444bac4b5bf8f64 # Parent 706df18f0c01893b2520b8173a05e19b95485753 Added corrections and wishes of the training on the installation which was given to the BSH. doc/trunk@1257 c6561f87-3c4e-4783-a992-168aeb5c3f6f diff -r 706df18f0c01 -r 17c3770e6c63 doc/ChangeLog --- a/doc/ChangeLog Wed Jun 30 09:33:47 2010 +0000 +++ b/doc/ChangeLog Fri Aug 13 09:15:20 2010 +0000 @@ -1,3 +1,12 @@ +2010-08-13 Tim Englich + + * admin-manual/installation-artifact-server.tex, + admin-manual/operating-the-system.tex, + admin-manual/installation-base.tex, + admin-manual/installation-webclient.tex: + Added corrections and wishes of the training on the installation + which was given to the BSH. + 2010-06-30 Ingo Weinzierl * admin-manual/installation-base.tex: Some refactoring of the proxy diff -r 706df18f0c01 -r 17c3770e6c63 doc/admin-manual/installation-artifact-server.tex --- a/doc/admin-manual/installation-artifact-server.tex Wed Jun 30 09:33:47 2010 +0000 +++ b/doc/admin-manual/installation-artifact-server.tex Fri Aug 13 09:15:20 2010 +0000 @@ -17,6 +17,7 @@ \begin{lstlisting} cd /var/log mkdir artifacts + chown -r root:artifacts artifacts chmod 770 artifacts chmod g+s artifacts \end{lstlisting} @@ -85,7 +86,8 @@ Integrate artifact-server in startup-process of operating system: \begin{lstlisting} - cp -i /opt/artifact-server/bin/debian/artifact-server /etc/init.d/ + cp -i /opt/artifact-server/install/debian/artifact-server/artifact-server-init-scipt + /etc/init.d/artifact-server chmod +x /etc/init.d/artifact-server update-rc.d artifact-server defaults \end{lstlisting} @@ -115,14 +117,14 @@ 19509 Jps 19441 App - cat /var/run/artifact-server + cat /var/run/artifact-server.pid \end{lstlisting} Task: Compare the running process numbers. 2. Network: Check if the artifact-server opens a TCP-port (default: 8181) \begin{lstlisting} - netstat -nltp + netstat -nltp | grep 8181 # Check for an entry like: tcp 0 0 127.0.0.1:8181 0.0.0.0:* LISTEN 18648/java diff -r 706df18f0c01 -r 17c3770e6c63 doc/admin-manual/installation-base.tex --- a/doc/admin-manual/installation-base.tex Wed Jun 30 09:33:47 2010 +0000 +++ b/doc/admin-manual/installation-base.tex Fri Aug 13 09:15:20 2010 +0000 @@ -54,6 +54,21 @@ {\em Hint}: Configuring of partitions, firewalls, etc. for the system is out of the scope of this documentation. +\subsection{Preparations} + +In some steps it is required to use templates wich are packed in +\verb+ artifact-server-$VERSION.tar.bz2+ to get access to those files. + +Please extract the tar.bz2 file as explained in +Chapter~\ref{ref:artifact-server-install}, + p.~\pageref{ref:artifact-server-install}. + +The complete document use the system-variable \verb+$ARTIFACT_SERVER_HOME+ +to refer the root-directory of the Artifac-Server. +It might be helpful to export this variable using the following command: + +\verb+ export ARTIFACT_SERVER_HOME=/opt/artifact-server+ + \subsection{Java Environment} \subsubsection*{Installation Sun Java 6} @@ -76,8 +91,10 @@ Install Sun Java 6 and its dependencies by executing the following: -\verb+ apt-get install sun-java6-jdk+ - +\begin{lstlisting} + apt-get update + apt-get install sun-java6-jdk +\end{lstlisting} \subsubsection*{Install Native Components for Java6 (optional)} @@ -130,8 +147,8 @@ Check if a version of 1.6.0* has been set. Check: \begin{lstlisting} - java version "1.6.0_12" - Java(TM) SE Runtime Environment (build 1.6.0_12-b04) + java version "1.6.0_20-b02" + Java(TM) SE Runtime Environment (build 1.6.0_20-b02) Java HotSpot(TM) Server VM (build 11.2-b01, mixed mode) \end{lstlisting} @@ -153,6 +170,9 @@ \verb+/etc/default/tomcat5.5+: \begin{lstlisting} + - #JAVA_HOME="/usr/lib/jvm/java-6-sun/" + + JAVA_HOME="/usr/lib/jvm/java-6-sun/" + - #JAVA_OPTS="-Djava.awt.headless=true -Xmx128M" + JAVA_OPTS="-Djava.awt.headless=true -Xmx1024m -server" @@ -245,7 +265,7 @@ After finishing the configuration, enable the module in Apache WebServer: \verb+ a2enmod jk+ and restart the server -\verb+ /etc/init.d/apache restart+. +\verb+ /etc/init.d/apache2 restart+. \subsubsection*{Publish the site in Apache WebServer} @@ -263,7 +283,7 @@ Enable the specific site (VirtualHost) in Apache WebServer: \begin{lstlisting} - cp -i $ARTIFACT_SERVER_HOME/install/debian/apache2 to /etc/apache2/sites-available + cp -i $ARTIFACT_SERVER_HOME/install/debian/apache2/gnv to /etc/apache2/sites-available # Activate site for GNV a2ensite gnv /etc/init.d/apache reload @@ -305,30 +325,47 @@ dpkg -i cgi-mapserver-gp_5.6.3-1~gp+1_i386.deb \end{lstlisting} -Provide a possibility to integrate MapServer properly and transfer +If there are libraries which are required by the Mapserver but not +installed yet run the following command: +\begin{lstlisting} +apt-get -f install +\end{lstlisting} + + +Provide a possibility to integrate Mapserver properly and transfer configurations to MapServer during runtime: \begin{lstlisting} cd /usr/lib/cgi-bin cp -i $ARTIFACT_SERVER_HOME/install/debian/umn-mapserver/gnv-wms . +chmod +x gnv-wms \end{lstlisting} For setting proper contact details in the WMS Capabilities response, edit the file \verb+ $ARTIFACT_SERVER_HOME/conf/maptemplates/mapfile.vm+ in the section WEB $\rightarrow$ METADATA. +The Mapserver will need fonts for rendering lables in the map. +To provide this it is required to install the freefonts. +\begin{lstlisting} +apt-get install ttf-freefont +\end{lstlisting} + + \subsubsection*{Test of installation} Check for a sucessful installation via: \begin{lstlisting} cd root curl \ -"http://localhost/cgi-bin/gnv-wms?service=WMS&request=GetCapabilities&version=1.1.1" \ +"http://localhost/cgi-bin/gnv-wms" \ -o mapserver \end{lstlisting} For a sucessful configuration, the response document \verb+ mapserver+ -contains a XML document describing the capabilities of the mapserver. +contains a Value which contains the following message of the mapserver. + +TODO: QUERYSTRING WAS EMPTY HINZUFUEGEN \subsection{Proxy-Script: Installation and Configuration} The Proxy-Script is required to allow the Map-Client to request external @@ -366,12 +403,12 @@ It is possible to test the installation using the following command: \begin{lstlisting} -curl http://localhost/cgi-bin/proxy.cgi?url=http%3A%2F%2Flocalhost +curl http://localhost/cgi-bin/proxy.cgi?url=http%3A%2F%2Flocalhost/cgi-bin/mapserv-gp \end{lstlisting} If localhost is allowed in the proxy-script the result might be this: \begin{lstlisting} -

It works!

+TODO: QUERYSTRING WAS EMPTY HINZUFUEGEN \end{lstlisting} diff -r 706df18f0c01 -r 17c3770e6c63 doc/admin-manual/installation-webclient.tex --- a/doc/admin-manual/installation-webclient.tex Wed Jun 30 09:33:47 2010 +0000 +++ b/doc/admin-manual/installation-webclient.tex Fri Aug 13 09:15:20 2010 +0000 @@ -45,7 +45,7 @@ Testing the installation via Apache WebServer, mod\_jk and Apache Tomcat: \begin{lstlisting} - curl "http://localhost/gnv/" -o gnv + curl "http://localhost/gnv/start.do" -o gnv \end{lstlisting} The file \verb+gnv+ includes HTML describing the startpage of the diff -r 706df18f0c01 -r 17c3770e6c63 doc/admin-manual/operating-the-system.tex --- a/doc/admin-manual/operating-the-system.tex Wed Jun 30 09:33:47 2010 +0000 +++ b/doc/admin-manual/operating-the-system.tex Fri Aug 13 09:15:20 2010 +0000 @@ -41,8 +41,8 @@ \paragraph*{Database problems} For checking problems with the connection to the database server, check the logfile of the artifact-server (c.f. -chapter~\chapter{ref:artifact-server-install}, -p.~pageref{ref:artifact-server-install}. +Chapter~\ref{ref:artifact-server-install}, +p.~\pageref{ref:artifact-server-install}). In most cases, a restart of the artifact-server will help to solve problems in the artifact-server. If you still encounter problems, check