Mercurial > dive4elements > gnv-client
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+