changeset 1136:17c3770e6c63

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 706df18f0c01
children bc1d817b80a4
files doc/ChangeLog doc/admin-manual/installation-artifact-server.tex doc/admin-manual/installation-base.tex doc/admin-manual/installation-webclient.tex doc/admin-manual/operating-the-system.tex
diffstat 5 files changed, 65 insertions(+), 17 deletions(-) [+]
line wrap: on
line diff
--- 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 <tim@intevation.de>
+
+	* 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 <ingo.weinzierl@intevation.de>
 
 	* admin-manual/installation-base.tex: Some refactoring of the proxy
--- 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
--- 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}
-<html><body><h1>It works!</h1></body></html>
+TODO: QUERYSTRING WAS EMPTY HINZUFUEGEN
 \end{lstlisting}
 
--- 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
--- 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

http://dive4elements.wald.intevation.org