Mercurial > dive4elements > gnv-client

comparison doc/admin-manual/installation-base.tex @ 1136:17c3770e6c63

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
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
comparison
equal deleted inserted replaced
1135:706df18f0c01 1136:17c3770e6c63
52 \subsection{Operating System} 52 \subsection{Operating System}
53 53
54 {\em Hint}: Configuring of partitions, firewalls, etc. for the system is out of 54 {\em Hint}: Configuring of partitions, firewalls, etc. for the system is out of
55 the scope of this documentation. 55 the scope of this documentation.
56 56
57 \subsection{Preparations}
58
59 In some steps it is required to use templates wich are packed in
60 \verb+ artifact-server-$VERSION.tar.bz2+ to get access to those files.
61
62 Please extract the tar.bz2 file as explained in
63 Chapter~\ref{ref:artifact-server-install},
64 p.~\pageref{ref:artifact-server-install}.
65
66 The complete document use the system-variable \verb+$ARTIFACT_SERVER_HOME+
67 to refer the root-directory of the Artifac-Server.
68 It might be helpful to export this variable using the following command:
69
70 \verb+ export ARTIFACT_SERVER_HOME=/opt/artifact-server+
71
57 \subsection{Java Environment} 72 \subsection{Java Environment}
58 73
59 \subsubsection*{Installation Sun Java 6} 74 \subsubsection*{Installation Sun Java 6}
60 75
61 This GNV-system is developed for Sun Java 6. 76 This GNV-system is developed for Sun Java 6.
74 \end{lstlisting} 89 \end{lstlisting}
75 90
76 91
77 Install Sun Java 6 and its dependencies by executing the following: 92 Install Sun Java 6 and its dependencies by executing the following:
78 93
79 \verb+ apt-get install sun-java6-jdk+ 94 \begin{lstlisting}
80 95 apt-get update
96 apt-get install sun-java6-jdk
97 \end{lstlisting}
81 98
82 \subsubsection*{Install Native Components for Java6 (optional)} 99 \subsubsection*{Install Native Components for Java6 (optional)}
83 100
84 This step is optional but recommended\footnote{For background 101 This step is optional but recommended\footnote{For background
85 information, c.f. \url{http://tomcat.apache.org/tomcat-5.5-doc/apr.html}}. 102 information, c.f. \url{http://tomcat.apache.org/tomcat-5.5-doc/apr.html}}.
128 Execute \verb+ java -version+ 145 Execute \verb+ java -version+
129 146
130 Check if a version of 1.6.0* has been set. Check: 147 Check if a version of 1.6.0* has been set. Check:
131 148
132 \begin{lstlisting} 149 \begin{lstlisting}
133 java version "1.6.0_12" 150 java version "1.6.0_20-b02"
134 Java(TM) SE Runtime Environment (build 1.6.0_12-b04) 151 Java(TM) SE Runtime Environment (build 1.6.0_20-b02)
135 Java HotSpot(TM) Server VM (build 11.2-b01, mixed mode) 152 Java HotSpot(TM) Server VM (build 11.2-b01, mixed mode)
136 \end{lstlisting} 153 \end{lstlisting}
137 154
138 155
139 \subsection{Tomcat Application Server} 156 \subsection{Tomcat Application Server}
151 168
152 Adapt some run-time specific properties in 169 Adapt some run-time specific properties in
153 \verb+/etc/default/tomcat5.5+: 170 \verb+/etc/default/tomcat5.5+:
154 171
155 \begin{lstlisting} 172 \begin{lstlisting}
173 - #JAVA_HOME="/usr/lib/jvm/java-6-sun/"
174 + JAVA_HOME="/usr/lib/jvm/java-6-sun/"
175
156 - #JAVA_OPTS="-Djava.awt.headless=true -Xmx128M" 176 - #JAVA_OPTS="-Djava.awt.headless=true -Xmx128M"
157 + JAVA_OPTS="-Djava.awt.headless=true -Xmx1024m -server" 177 + JAVA_OPTS="-Djava.awt.headless=true -Xmx1024m -server"
158 178
159 - #TOMCAT5_SECURITY=yes 179 - #TOMCAT5_SECURITY=yes
160 + TOMCAT5_SECURITY=no 180 + TOMCAT5_SECURITY=no
243 + JkLogFile "/var/log/mod_jk.log" 263 + JkLogFile "/var/log/mod_jk.log"
244 \end{lstlisting} 264 \end{lstlisting}
245 265
246 After finishing the configuration, enable the module in Apache 266 After finishing the configuration, enable the module in Apache
247 WebServer: \verb+ a2enmod jk+ and restart the server 267 WebServer: \verb+ a2enmod jk+ and restart the server
248 \verb+ /etc/init.d/apache restart+. 268 \verb+ /etc/init.d/apache2 restart+.
249 269
250 270
251 \subsubsection*{Publish the site in Apache WebServer} 271 \subsubsection*{Publish the site in Apache WebServer}
252 272
253 Depending of the existing configuration of Apache WebServer, the 273 Depending of the existing configuration of Apache WebServer, the
261 Adapt eMail-address for configuration in 281 Adapt eMail-address for configuration in
262 \verb+ $ARTIFACT_SERVER_HOME/install/debian/apache2/gnv+. 282 \verb+ $ARTIFACT_SERVER_HOME/install/debian/apache2/gnv+.
263 283
264 Enable the specific site (VirtualHost) in Apache WebServer: 284 Enable the specific site (VirtualHost) in Apache WebServer:
265 \begin{lstlisting} 285 \begin{lstlisting}
266 cp -i $ARTIFACT_SERVER_HOME/install/debian/apache2 to /etc/apache2/sites-available 286 cp -i $ARTIFACT_SERVER_HOME/install/debian/apache2/gnv to /etc/apache2/sites-available
267 # Activate site for GNV 287 # Activate site for GNV
268 a2ensite gnv 288 a2ensite gnv
269 /etc/init.d/apache reload 289 /etc/init.d/apache reload
270 \end{lstlisting} 290 \end{lstlisting}
271 291
303 \begin{lstlisting} 323 \begin{lstlisting}
304 cd $ARTIFACT_SERVER_HOME/install/debian/umn-mapserver 324 cd $ARTIFACT_SERVER_HOME/install/debian/umn-mapserver
305 dpkg -i cgi-mapserver-gp_5.6.3-1~gp+1_i386.deb 325 dpkg -i cgi-mapserver-gp_5.6.3-1~gp+1_i386.deb
306 \end{lstlisting} 326 \end{lstlisting}
307 327
308 Provide a possibility to integrate MapServer properly and transfer 328 If there are libraries which are required by the Mapserver but not
329 installed yet run the following command:
330 \begin{lstlisting}
331 apt-get -f install
332 \end{lstlisting}
333
334
335 Provide a possibility to integrate Mapserver properly and transfer
309 configurations to MapServer during runtime: 336 configurations to MapServer during runtime:
310 337
311 \begin{lstlisting} 338 \begin{lstlisting}
312 cd /usr/lib/cgi-bin 339 cd /usr/lib/cgi-bin
313 cp -i $ARTIFACT_SERVER_HOME/install/debian/umn-mapserver/gnv-wms . 340 cp -i $ARTIFACT_SERVER_HOME/install/debian/umn-mapserver/gnv-wms .
341 chmod +x gnv-wms
314 \end{lstlisting} 342 \end{lstlisting}
315 343
316 For setting proper contact details in the WMS Capabilities response, 344 For setting proper contact details in the WMS Capabilities response,
317 edit the file \verb+ $ARTIFACT_SERVER_HOME/conf/maptemplates/mapfile.vm+ 345 edit the file \verb+ $ARTIFACT_SERVER_HOME/conf/maptemplates/mapfile.vm+
318 in the section WEB $\rightarrow$ METADATA. 346 in the section WEB $\rightarrow$ METADATA.
319 347
348 The Mapserver will need fonts for rendering lables in the map.
349 To provide this it is required to install the freefonts.
350 \begin{lstlisting}
351 apt-get install ttf-freefont
352 \end{lstlisting}
353
354
320 \subsubsection*{Test of installation} 355 \subsubsection*{Test of installation}
321 Check for a sucessful installation via: 356 Check for a sucessful installation via:
322 357
323 \begin{lstlisting} 358 \begin{lstlisting}
324 cd root 359 cd root
325 curl \ 360 curl \
326 "http://localhost/cgi-bin/gnv-wms?service=WMS&request=GetCapabilities&version=1.1.1" \ 361 "http://localhost/cgi-bin/gnv-wms" \
327 -o mapserver 362 -o mapserver
328 \end{lstlisting} 363 \end{lstlisting}
329 364
330 For a sucessful configuration, the response document \verb+ mapserver+ 365 For a sucessful configuration, the response document \verb+ mapserver+
331 contains a XML document describing the capabilities of the mapserver. 366 contains a Value which contains the following message of the mapserver.
367
368 TODO: QUERYSTRING WAS EMPTY HINZUFUEGEN
332 369
333 \subsection{Proxy-Script: Installation and Configuration} 370 \subsection{Proxy-Script: Installation and Configuration}
334 The Proxy-Script is required to allow the Map-Client to request external 371 The Proxy-Script is required to allow the Map-Client to request external
335 services. Security policies forbit and prevent requesting those services - like 372 services. Security policies forbit and prevent requesting those services - like
336 a GetFeatureInfo request - directly. 373 a GetFeatureInfo request - directly.
364 \subsubsection{Test of installation} 401 \subsubsection{Test of installation}
365 402
366 It is possible to test the installation using the following command: 403 It is possible to test the installation using the following command:
367 404
368 \begin{lstlisting} 405 \begin{lstlisting}
369 curl http://localhost/cgi-bin/proxy.cgi?url=http%3A%2F%2Flocalhost 406 curl http://localhost/cgi-bin/proxy.cgi?url=http%3A%2F%2Flocalhost/cgi-bin/mapserv-gp
370 \end{lstlisting} 407 \end{lstlisting}
371 408
372 If localhost is allowed in the proxy-script the result might be this: 409 If localhost is allowed in the proxy-script the result might be this:
373 410
374 \begin{lstlisting} 411 \begin{lstlisting}
375 <html><body><h1>It works!</h1></body></html> 412 TODO: QUERYSTRING WAS EMPTY HINZUFUEGEN
376 \end{lstlisting} 413 \end{lstlisting}
377 414
http://dive4elements.wald.intevation.org