Mercurial > dive4elements > gnv-client

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

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
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
comparison
equal deleted inserted replaced
923:95b48f7d0acf 924:9d94bf77e442
1 \section{Installation and Configuration} 1 \section{Installation and Configuration}
2 2
3 This section describes preconditions for the entire system and an 3 This section describes preconditions for the entire system and an installation
4 installation on a Debian 5.0.x (Lenny) for the GNV-System without an 4 on a Debian 5.0.x (Lenny) for the GNV-System without an running X-Environment.
5 running X-Environment. 5 Mostly, the debian package management\footnote{Further information at
6 6 \url{http://www.debian.org/doc/manuals/debian-reference/ch02.en.html}}
7 For installing and operating the GNV-system access with {\bf root 7 using \verb+ aptitude+ is used in this manual.
8 rights} is needed. If other permissions are needed, there will be a 8
9 hint in this manual. 9 If existing configurations have to be changed, the following notation will be
10 10 used: \verb|+| for adding a line replacing the marked by \verb|-|.
11 If existing configurations have to be changed, the following notation will be used:
12 \verb|+| for adding a line replacing the marked by \verb|-|.
13 11
14 \subsection{Preconditions} 12 \subsection{Preconditions}
15 13
16 \subsubsection*{System} 14 \subsubsection*{System}
17 15
18 \begin{itemize} 16 \begin{itemize}
19 \item Storage for the delivered software: 100 MB 17 \item Storage for the delivered software: 100 MB
20 \item Current processor on a 32-bit Architecture (Beginning 18 \item Current processor on a 32-bit Architecture (Beginning
21 2010)\footnote{Running on a 64-bit system should work out of the box 19 2010)\footnote{Running on a 64-bit system should work out of the box
22 and improve scalibility issues.} 20 and improve scalibility issues (not tested yet).}
23 \item RAM: 1 GB for production as minimum.\footnote{This value depends 21 \item RAM: 1 GB for production as minimum.\footnote{This value depends
24 mainly on the amount of connected users.} 22 mainly on the amount of connected users.}
25 \item Network access to Database Backend 23 \item Network access to Database Backend
26 \item RW-Access to the filesystem for logging, shapefile-export, 24 \item RW-Access to the filesystem for logging, shapefile-export,
27 caching 25 caching
39 \item ArcMarineBSH, model package " MeshFeature" 37 \item ArcMarineBSH, model package " MeshFeature"
40 \item ArcMarineBSH, model package "Marine Feature" 38 \item ArcMarineBSH, model package "Marine Feature"
41 \item ArcS57 -- International Hydrographic Organization (IHO) S-57 for 39 \item ArcS57 -- International Hydrographic Organization (IHO) S-57 for
42 ENC Data Model. - ESRI Data Models. http://support.esri.com/datamodels 40 ENC Data Model. - ESRI Data Models. http://support.esri.com/datamodels
43 \item CONTIS -- Federal Maritime and Hydrographic Agency (BSH). Continental 41 \item CONTIS -- Federal Maritime and Hydrographic Agency (BSH). Continental
44 Shelf Information System -- 42 Shelf Information System -- \\
45 \url{http://www.bsh.de/en/Marine\_uses/Industry/CONTIS\_maps/index.jsp} 43 \url{http://www.bsh.de/en/Marine\_uses/Industry/CONTIS\_maps/index.jsp}
46 \item GNV specific schema MapViewer interface -- Schema for integrating with MapViewer and 44 \item GNV specific schema MapViewer interface -- Schema for integrating with MapViewer and
47 their WMS services 45 their WMS services
48 \item GNV specific schema for managing the cache -- The central 46 \item GNV specific schema for managing the cache -- The central
49 dataware house is updated regulary. To keep the cache up-to-date, 47 dataware house is updated regulary. To keep the cache up-to-date,
81 \verb+ apt-get install sun-java6-jdk+ 79 \verb+ apt-get install sun-java6-jdk+
82 80
83 81
84 \subsubsection*{Install Native Components for Java6 (optional)} 82 \subsubsection*{Install Native Components for Java6 (optional)}
85 83
86 This step is optional but recommended. 84 This step is optional but recommended\footnote{For background
85 information, c.f. \url{http://tomcat.apache.org/tomcat-5.5-doc/apr.html}}.
87 86
88 For a better support of the native server technologies, the package 87 For a better support of the native server technologies, the package
89 \verb+libtcnative+ can be installed. 88 \verb+libtcnative+ can be installed.
90 89
91 \begin{lstlisting} 90 \begin{lstlisting}
99 To ensure that the Apache Tomcat and the GNV Artifact-Server will use 98 To ensure that the Apache Tomcat and the GNV Artifact-Server will use
100 Sun Java 6 exclusively, switch to the default Java version 99 Sun Java 6 exclusively, switch to the default Java version
101 globally\footnote{This manual assumes that there are no other packages 100 globally\footnote{This manual assumes that there are no other packages
102 depending to another Java version.}. 101 depending to another Java version.}.
103 102
104 Use \verb+update-alternatives+ mechanism of the Debian system, execute: 103 Use \verb+update-alternatives+ mechanism of the Debian
104 system\footnote{Background information: {\tt man update-alternatives}}, execute:
105 105
106 \verb+ update-alternatives --list java+ 106 \verb+ update-alternatives --list java+
107 107
108 Lists all installed Java-Environments. E.g.: 108 Lists all installed Java-Environments. E.g.:
109 109
163 {\bf Hint: As there is no Java security policy for the GNV WebClient, 163 {\bf Hint: As there is no Java security policy for the GNV WebClient,
164 Java Security Management is switched off.} 164 Java Security Management is switched off.}
165 165
166 The Apache Tomcat is integrate with Apache WebServer just via the Apache 166 The Apache Tomcat is integrate with Apache WebServer just via the Apache
167 JServ Protocoll (AJP). To secure the connection, just local connections 167 JServ Protocoll (AJP). To secure the connection, just local connections
168 are allowed for AJP on Tomcat. 168 are allowed for AJP on Tomcat\footnote{For background information, c.f.
169 \url{http://tomcat.apache.org/tomcat-5.5-doc/connectors.html}}.
169 170
170 Modify the \verb+ /etc/tomcat5.5/server.xml+: 171 Modify the \verb+ /etc/tomcat5.5/server.xml+:
171 \begin{lstlisting} 172 \begin{lstlisting}
172 173
173 # Deactivate Standard HTTP Connector: 174 # Deactivate Standard HTTP Connector:
222 \verb+ apt-get install libapache2-mod-jk+ 223 \verb+ apt-get install libapache2-mod-jk+
223 224
224 \subsubsection*{Configuring mod\_jk} 225 \subsubsection*{Configuring mod\_jk}
225 226
226 Edit the settings for mod\_jk in 227 Edit the settings for mod\_jk in
227 file \verb+ /etc/libapache2-mod-jk/workers.properties+: 228 file \verb+ /etc/libapache2-mod-jk/workers.properties+. For further
229 information, there are comments in the configuration file\footnote{Background
230 information can be found at \\
231 \url{http://tomcat.apache.org/connectors-doc/generic\_howto/workers.html}}.
228 232
229 233
230 \begin{lstlisting} 234 \begin{lstlisting}
231 - workers.java_home= /usr/lib/jvm/java-gcj/ 235 - workers.java_home= /usr/lib/jvm/java-gcj/
232 + workers.java_home=/usr/lib/jvm/java-6-sun 236 + workers.java_home=/usr/lib/jvm/java-6-sun
246 250
247 \subsubsection*{Publish the site in Apache WebServer} 251 \subsubsection*{Publish the site in Apache WebServer}
248 252
249 Depending of the existing configuration of Apache WebServer, the 253 Depending of the existing configuration of Apache WebServer, the
250 following steps can differ. In this case, a vanilla configuration is 254 following steps can differ. In this case, a vanilla configuration is
251 assumed. 255 assumed\footnote{Background information about Apache WebServer can
256 be found at \url{http://httpd.apache.org/docs/2.2/}}.
252 257
253 Disable default configuration 258 Disable default configuration
254 \verb+ a2dissite default+ 259 \verb+ a2dissite default+
255 260
256 Adapt eMail-address for configuration in 261 Adapt eMail-address for configuration in
267 272
268 \subsubsection*{Test of the Installation} 273 \subsubsection*{Test of the Installation}
269 274
270 You can test the installation by executing the following url: 275 You can test the installation by executing the following url:
271 276
272 \verb+ wget http://localhost/gnv/ -O test+ 277 \verb+ curl "http://localhost/gnv/" -o test+
273 278
274 After a successful installation, the file {test} will contain HTML describing 279 After a successful installation, the file {test} will contain HTML describing
275 the startpage of the GNV WebClient. 280 the startpage of the GNV WebClient.
276 281
277 282
315 \subsubsection*{Test of installation} 320 \subsubsection*{Test of installation}
316 Check for a sucessful installation via: 321 Check for a sucessful installation via:
317 322
318 \begin{lstlisting} 323 \begin{lstlisting}
319 cd root 324 cd root
320 wget \ 325 curl \
321 "http://localhost/cgi-bin/gnv-wrapper?service=WMS&request=GetCapabilities&version=1.1.1" \ 326 "http://localhost/cgi-bin/gnv-wrapper?service=WMS&request=GetCapabilities&version=1.1.1" \
322 -O mapserver 327 -o mapserver
323 \end{lstlisting} 328 \end{lstlisting}
324 329
325 For a sucessful configuration, the response document \verb+ mapserver+ 330 For a sucessful configuration, the response document \verb+ mapserver+
326 contains a XML document describing the capabilities of the mapserver. 331 contains a XML document describing the capabilities of the mapserver.
http://dive4elements.wald.intevation.org