diff doc/admin-manual/installation-base.tex @ 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
line wrap: on
line diff
--- 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}
 

http://dive4elements.wald.intevation.org