Mercurial > dive4elements > gnv-client

comparison doc/admin-manual/installation-base.tex @ 921:fb1e051713cc

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Improved artifact, webclient and operations section doc/trunk@1058 c6561f87-3c4e-4783-a992-168aeb5c3f6f
author Hans Plum <hans.plum@intevation.de>
date Wed, 05 May 2010 10:07:24 +0000
parents 1ebde13e620f
children 237f3a809aee
comparison
equal deleted inserted replaced
920:63bc0044ff72 921:fb1e051713cc
6 6
7 For installing and operating the GNV-system access with {\bf root 7 For installing and operating the GNV-system access with {\bf root
8 rights} is needed. If other permissions are needed, there will be a 8 rights} is needed. If other permissions are needed, there will be a
9 hint in this manual. 9 hint in this manual.
10 10
11 % FIXME: Schreibweise bei Zeilen + und - 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|-|.
12 13
13 \subsection{Preconditions} 14 \subsection{Preconditions}
14 15
15 \subsubsection{System} 16 \subsubsection{System}
16 17
85 This step is optional but recommended. 86 This step is optional but recommended.
86 87
87 For a better support of the native server technologies, the package 88 For a better support of the native server technologies, the package
88 \verb+libtcnative+ can be installed. 89 \verb+libtcnative+ can be installed.
89 90
90 \verb+ apt-get install libtcnative-1+ 91 \begin{lstlisting}
91 92 apt-get install libtcnative-1
92 % FIXME: Setzen des softlink 93 cd /usr/lib/jvm/java-6-sun/jre/lib/i386/client
94 ln -s /usr/lib/libtcnative-1.so
95 \end{lstlisting}
93 96
94 \subsubsection*{Configuration} 97 \subsubsection*{Configuration}
95 98
96 To ensure that the Apache Tomcat and the GNV Artefact Server will use 99 To ensure that the Apache Tomcat and the GNV Artefact Server will use
97 Sun Java 6 exclusively, switch to the default Java version 100 Sun Java 6 exclusively, switch to the default Java version
148 \subsubsection*{Installation} 151 \subsubsection*{Installation}
149 152
150 To install the Tomcat Application-Server and its dependencies, execute: 153 To install the Tomcat Application-Server and its dependencies, execute:
151 154
152 \verb+ apt-get install tomcat5.5+ 155 \verb+ apt-get install tomcat5.5+
153 % FIXME: check for depencenies 156
154 157 \subsubsection*{Configuration}
155 \subsubsection{Configuration}
156 158
157 Adapt some run-time specific properties in 159 Adapt some run-time specific properties in
158 \verb+/etc/default/tomcat5.5+: 160 \verb+/etc/default/tomcat5.5+:
159 161
160 \begin{lstlisting} 162 \begin{lstlisting}
215 \verb+ apt-get --purge remove tomcat5.5+ 217 \verb+ apt-get --purge remove tomcat5.5+
216 218
217 219
218 \subsection{Apache Webserver} 220 \subsection{Apache Webserver}
219 This section describes the required steps for the installation and configuration 221 This section describes the required steps for the installation and configuration
220 of the Apache Webserver Version 2.2. 222 of the Apache Webserver Version 2.2. Apache WebServer controls all
223 HTTP-Connections to the outside of the system. Apache Tomcat is
224 integrated via mod\_jk.
221 225
222 \subsubsection*{Installation} 226 \subsubsection*{Installation}
223 227
224 To install the Apache Webserver you have to execute the following command: 228 To install the Apache Webserver you have to execute the following command:
225 229
226 * apt-get install apache2 230 \verb+ apt-get install apache2+
227 231
228 - Additional Modules 232 To establish the connection between the Tomcat application server and
229 To establish the Connection between the Tomcat Application Server and the 233 Apache Webserver an additional Module "mod\_jk" has to be installed.
230 Apache Webserver we have to install an additional Module named Mod-JK 234
231 235 \verb+ apt-get install libapache2-mod-jk+
232 * apt-get install libapache2-mod-jk 236
233 237 \subsubsection*{Configuring mod\_jk}
234 - Configuration 238
235 239 Edit the settings for mod\_jk in
236 -- Edit the Settings for mod-jk 240 file \verb+ /etc/libapache2-mod-jk/workers.properties+:
237 241
238 Edit the Settings for mod-jk in File /etc/libapache2-mod-jk/workers.propertie
239 as follows:
240 242
241 \begin{lstlisting} 243 \begin{lstlisting}
242 - workers.java_home= /usr/lib/jvm/java-gcj/ 244 - workers.java_home= /usr/lib/jvm/java-gcj/
243 + workers.java_home=/usr/lib/jvm/java-6-sun 245 + workers.java_home=/usr/lib/jvm/java-6-sun
244 \end{lstlisting} 246 \end{lstlisting}
245 247
246 -- Enable mod-jk in Apache Webserver 248 In file \verb+ /etc/apache2/httpd.conf+:
247
248 For this add the follwing Lines to File /etc/apache2/httpd.conf:
249 249
250 \begin{lstlisting} 250 \begin{lstlisting}
251 + JkWorkersFile "/etc/libapache2-mod-jk/workers.properties" 251 + JkWorkersFile "/etc/libapache2-mod-jk/workers.properties"
252 + JkLogFile "/var/log/mod_jk.log" 252 + JkLogFile "/var/log/mod_jk.log"
253 \end{lstlisting} 253 \end{lstlisting}
254 254
255 --Disable default Site of Apache Webserver 255 After finishing the configuration, enable the module in Apache
256 256 WebServer: \verb+ a2enmod jk+ and restart the server
257 * a2dissite default 257 \verb+ /etc/init.d/apache restart+.
258 258
259 --Enable the specific Site of GNV 259
260 260 \subsubsection*{Publish the site in Apache WebServer}
261 * Copy File FIXME/gnv to /etc/apache2/sites-available 261
262 262 Depending of the existing configuration of Apache WebServer, the
263 %FIXME: Configure contact address for Webserver 263 following steps can differ. In this case, a vanilla configuration is
264 264 assumed.
265 * a2ensite gnv 265
266 266 Disable default configuration
267 --Reload the Configuration of Apache Webserver 267 \verb+ a2dissite default+
268 268
269 * /etc/init.d/apache2 reload 269 Adapt eMail-address for configuration in
270 \verb+ $ARTIFACT_SERVER_HOME/install/debian/apache2/gnv+.
271
272 Enable the specific site (VirtualHost) in Apache WebServer:
273 \begin{lstlisting}
274 cp -i $ARTIFACT_SERVER_HOME/install/debian/apache2 to /etc/apache2/sites-available
275 # Activate site for GNV
276 a2ensite gnv
277 /etc/init.d/apache reload
278 \end{lstlisting}
279
270 280
271 \subsubsection*{Test of the Installation} 281 \subsubsection*{Test of the Installation}
272 282
273 You can test the Installation by executing the follwing url 283 You can test the installation by executing the following url:
274 284
275 * http://localhost/gnv/start.do 285 \verb+ wget http://localhost/gnv/ -O test+
286
287 After a successful installation, the file {test} will contain HTML describing
288 the startpage of the GNV WebClient.
276 289
277 290
278 \subsubsection*{Uninstalling the Apache Webserver} 291 \subsubsection*{Uninstalling the Apache Webserver}
279 292 To uninstall the Apache Webserver and its configuration, you can use the
280 To uninstall the Apache Webserver you can use the following Command: 293 following command:
281 * apt-get --purge remove apache2 294 \verb+ apt-get purge apache2+
282 295
283 296
284 \subsection{Installation of UMN MapServer} 297 \subsection{UMN MapServer: Installation and configuration}
298 The UMN MapServer is part of the artifact server. It is responsible for
299 rendering shapefiles produced by the artifact-server and publish them as
300 OGC Web Map Service.
285 301
286 \subsubsection*{Installation} 302 \subsubsection*{Installation}
287 -- Remove the installed old mapserver-Version from the System 303 It is recommended to use a more recent version than the one in Debian
288 304 Lenny. In the installation package, there is a debian package of
289 * apt-get remove cgi-mapserve 305 MapServer that should be installed.
290 306
291 -- Installing required Libraries 307 In order to verify the integrity of the installation package, it is necessary to import
292 308 a GPG-Key which was used to sign the packages:
293 * apt-get install ttf-freefont 309
294 * apt-get install libming0 libfribidi0 310 \begin{lstlisting}
295 311 gpg --keyserver hkp://keys.gnupg.net --recv-keys EC70B1B8
296 312 gpg --export EC70B1B8 | apt-key add -
297 -- Installing mapserver-gp 313 \end{lstlisting}
298 314
299 At first you have to configure the source for the Gispatcher-server where 315 Installing the mapserver-gp and its dependencies, executing the following command:
300 the Mapserverpackes are hosted by the Intevation. 316
301 For this we have to add the followin line to File /etc/apt/sources.list 317 \begin{lstlisting}
302 318 cd $ARTIFACT_SERVER_HOME/install/debian/umn-mapserver
303 deb http://apt.gispatcher.com/ lenny gispatcher 319 dpkg -i cgi-mapserver-gp_5.6.3-1~gp+1_i386.deb
304 320 \end{lstlisting}
305 Then it is necessary to import the Key which is used to sign the Packages: 321
306 322 Provide a possibility to integrate MapServer properly and transfer
307 TODO: gpg --keyserver hkp://keys.gnupg.net --recv-keys EC70B1B8 323 configurations to MapServer during runtime:
308 TODO: gpg --export EC70B1B8 | apt-key add - 324
309 325 \begin{lstlisting}
310 Then install the mapserver-gp executing the follwong command 326 cd /usr/lib/cgi-bin
311 327 cp -i $ARTIFACT_SERVER_HOME/install/debian/umn-mapserver/gnv-wrapper .
312 * apt-get install cgi-mapserv-gp 328 \end{lstlisting}
313 329
314 -- Installing mapserv-gp withou access to the Internet 330 For setting proper contact details in the WMS Capabilities response,
315 331 edit the file \verb+ $ARTIFACT_SERVER_HOME/conf/maptemplates/mapfile.vm+
316 If there is no access to the Internet it is possible to install the Mapserver 332 in the section WEB > METADATA.
317 manually.
318 For this do the following steps:
319
320 \begin{lstlisting}
321 * Copy the Packages of mapserver-gp via scp onto the Server
322 * http://apt.gispatcher.com/dists/lenny/gispatcher/binary-i386/cgi-mapserver-gp_5.6.3-1~gp+1_i386.deb
323 * dpkg -i cgi-mapserver-gp_5.6.3-1~gp+1_i386.deb
324 \end{lstlisting}
325
326 -- Make the Wrapper-Script available
327
328 To use the UMN-Mapserver without putting the Mapfile-Path into each URL it is
329 possible to use a Script which will do that.
330
331 For this you have to copy TODO FIXME to /usr/lib/cgi-bin
332
333 You also have to edit the Script and set the PATH where the Mapfile is stored
334 by the Artifact-Server into the Script.
335 \begin{lstlisting}
336 - export MS_MAPFILE=/opt/artifacts/mapfiles/mapfile.map
337 + export MS_MAPFILE=/opt/artefact-server/mapfiles/mapfile.map // TODO FIXME
338 \end{lstlisting}
339
340 %FIXME ERROR_LOGGING
341
342 % FIXME: Adapting contact data
343 333
344 \subsubsection*{Test of installation} 334 \subsubsection*{Test of installation}
345 You can chack if the Installation was sucsessful executing the following URl: 335 Check for a sucessful installation via:
346 336
347 * curl http://localhost/cgi-bin/mapserv-gp 337 \begin{lstlisting}
348 338 cd root
349 The response should look like this: 339 wget \
350 340 "http://localhost/cgi-bin/gnv-wrapper?service=WMS&request=GetCapabilities&version=1.1.1" \
351 No query information to decode. \verb+QUERY_STRING+ is set, but empty. 341 -O mapserver
352 342 \end{lstlisting}
353 \subsubsection*{Uninstall UMN- Mapserver} 343
354 344 For a sucessful configuration, the response document \verb+ mapserver+
355 To uninstall the UMN-mapserver you have to execute the following commands. 345 contains a XML document describing the capabilities of the mapserver.
356 346
357 * rm TODO FIXME wrapperscript 347
358 * apt-get --purge remove cgi-mapserv-gp 348 \subsubsection*{Un-installing UMN- Mapserver}
349
350 To uninstall the UMN-mapserver without its dependencies, execute the following:
351
352 \begin{lstlisting}
353 cd /usr/lib/cgi-bin
354 rm -i gnv-wrapper
355 apt-get purge cgi-mapserv-gp
356 \end{lstlisting}
http://dive4elements.wald.intevation.org