diff doc/admin-manual/installation-base.tex @ 924:9d94bf77e442

Finalized documentation with references, unifying tools, adding logos. doc/trunk@1061 c6561f87-3c4e-4783-a992-168aeb5c3f6f
author Hans Plum <hans.plum@intevation.de>
date Thu, 06 May 2010 06:24:41 +0000
parents 237f3a809aee
children 3b67f53ff57b
line wrap: on
line diff
--- a/doc/admin-manual/installation-base.tex	Thu May 06 05:57:12 2010 +0000
+++ b/doc/admin-manual/installation-base.tex	Thu May 06 06:24:41 2010 +0000
@@ -1,15 +1,13 @@
 \section{Installation and Configuration}
 
-This section describes preconditions for the entire system and an
-installation on a Debian 5.0.x (Lenny) for the GNV-System without an
-running X-Environment.
+This section describes preconditions for the entire system and an installation
+on a Debian 5.0.x (Lenny) for the GNV-System without an running X-Environment.
+Mostly, the debian package management\footnote{Further information at
+\url{http://www.debian.org/doc/manuals/debian-reference/ch02.en.html}}
+using \verb+ aptitude+ is used in this manual.
 
-For installing and operating the GNV-system access with {\bf root
-rights} is needed.  If other permissions are needed, there will be a
-hint in this manual.
-
-If existing configurations have to be changed, the following notation will be used:
-\verb|+| for adding a line replacing the marked by \verb|-|.
+If existing configurations have to be changed, the following notation will be
+used: \verb|+| for adding a line replacing the marked by \verb|-|.
 
 \subsection{Preconditions}
 
@@ -19,7 +17,7 @@
   \item Storage for the delivered software: 100 MB
   \item Current processor on a 32-bit Architecture (Beginning
     2010)\footnote{Running on a 64-bit system should work out of the box
-    and improve scalibility issues.}
+    and improve scalibility issues (not tested yet).}
   \item RAM: 1 GB for production as minimum.\footnote{This value depends
     mainly on the amount of connected users.}
   \item Network access to Database Backend
@@ -41,7 +39,7 @@
   \item ArcS57 -- International Hydrographic Organization (IHO) S-57 for
     ENC Data Model. - ESRI Data Models. http://support.esri.com/datamodels
   \item CONTIS -- Federal Maritime and Hydrographic Agency (BSH). Continental 
-    Shelf Information System --
+    Shelf Information System -- \\
     \url{http://www.bsh.de/en/Marine\_uses/Industry/CONTIS\_maps/index.jsp}
   \item GNV specific schema MapViewer interface -- Schema for integrating with MapViewer and
     their WMS services
@@ -83,7 +81,8 @@
 
 \subsubsection*{Install Native Components for Java6 (optional)}
 
-This step is optional but recommended.
+This step is optional but recommended\footnote{For background
+information, c.f. \url{http://tomcat.apache.org/tomcat-5.5-doc/apr.html}}.
 
 For a better support of the native server technologies, the package
 \verb+libtcnative+ can be installed.
@@ -101,7 +100,8 @@
 globally\footnote{This manual assumes that there are no other packages
 depending to another Java version.}.
 
-Use  \verb+update-alternatives+ mechanism of the Debian system, execute:
+Use  \verb+update-alternatives+ mechanism of the Debian
+system\footnote{Background information: {\tt man update-alternatives}}, execute:
 
 \verb+ update-alternatives --list java+
 
@@ -165,7 +165,8 @@
 
 The Apache Tomcat is integrate with Apache WebServer just via the Apache
 JServ Protocoll (AJP). To secure the connection, just local connections
-are allowed for AJP on Tomcat.
+are allowed for AJP on Tomcat\footnote{For background information, c.f.
+\url{http://tomcat.apache.org/tomcat-5.5-doc/connectors.html}}.
 
 Modify the \verb+ /etc/tomcat5.5/server.xml+:
 \begin{lstlisting}
@@ -224,7 +225,10 @@
 \subsubsection*{Configuring mod\_jk}
 
 Edit the settings for mod\_jk in
-file \verb+ /etc/libapache2-mod-jk/workers.properties+:
+file \verb+ /etc/libapache2-mod-jk/workers.properties+. For further
+information, there are comments in the configuration file\footnote{Background
+information can be found at \\
+\url{http://tomcat.apache.org/connectors-doc/generic\_howto/workers.html}}.
 
 
 \begin{lstlisting}
@@ -248,7 +252,8 @@
 
 Depending of the existing configuration of Apache WebServer, the
 following steps can differ. In this case, a vanilla configuration is
-assumed.
+assumed\footnote{Background information about Apache WebServer can
+be found at \url{http://httpd.apache.org/docs/2.2/}}.
 
 Disable default configuration
 \verb+ a2dissite default+
@@ -269,7 +274,7 @@
 
 You can test the installation by executing the following url:
 
-\verb+ wget http://localhost/gnv/ -O test+
+\verb+ curl "http://localhost/gnv/" -o test+
 
 After a successful installation, the file {test} will contain HTML describing
 the startpage of the GNV WebClient.
@@ -317,9 +322,9 @@
 
 \begin{lstlisting}
 cd root
-wget \
+curl \
 "http://localhost/cgi-bin/gnv-wrapper?service=WMS&request=GetCapabilities&version=1.1.1" \
--O mapserver
+-o mapserver
 \end{lstlisting}
 
 For a sucessful configuration, the response document \verb+ mapserver+

http://dive4elements.wald.intevation.org