Mercurial > dive4elements > gnv-client

comparison doc/admin-manual/installation-base.tex @ 922:237f3a809aee

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Removed sections that were not tested doc/trunk@1059 c6561f87-3c4e-4783-a992-168aeb5c3f6f
author Hans Plum <hans.plum@intevation.de>
date Wed, 05 May 2010 10:33:25 +0000
parents fb1e051713cc
children 9d94bf77e442
comparison
equal deleted inserted replaced
921:fb1e051713cc 922:237f3a809aee
1 \section{Installationguide} 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
4 installation on a Debian 5.0.x (Lenny) for the GNV-System without an 4 installation on a Debian 5.0.x (Lenny) for the GNV-System without an
5 running X-Environment. 5 running X-Environment.
6 6
11 If existing configurations have to be changed, the following notation will be used: 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 \verb|+| for adding a line replacing the marked by \verb|-|.
13 13
14 \subsection{Preconditions} 14 \subsection{Preconditions}
15 15
16 \subsubsection{System} 16 \subsubsection*{System}
17 17
18 \begin{itemize} 18 \begin{itemize}
19 \item Storage for the delivered software: 100 MB 19 \item Storage for the delivered software: 100 MB
20 \item Current processor on a 32-bit Architecture (Beginning 20 \item Current processor on a 32-bit Architecture (Beginning
21 2010)\footnote{Running on a 64-bit system should work out of the box 21 2010)\footnote{Running on a 64-bit system should work out of the box
25 \item Network access to Database Backend 25 \item Network access to Database Backend
26 \item RW-Access to the filesystem for logging, shapefile-export, 26 \item RW-Access to the filesystem for logging, shapefile-export,
27 caching 27 caching
28 \end{itemize} 28 \end{itemize}
29 29
30 \subsubsection{Database: Software and Data} 30 \subsubsection*{Database: Software and Data}
31 31
32 The software has been developed for the following system: 32 The software has been developed for the following system:
33 33
34 \begin{itemize} 34 \begin{itemize}
35 \item ESRI ArcSDE 9.3.1 on Oracle 10.2\footnote{The development 35 \item ESRI ArcSDE 9.3.1 on Oracle 10.2\footnote{The development
40 \item ArcMarineBSH, model package "Marine Feature" 40 \item ArcMarineBSH, model package "Marine Feature"
41 \item ArcS57 -- International Hydrographic Organization (IHO) S-57 for 41 \item ArcS57 -- International Hydrographic Organization (IHO) S-57 for
42 ENC Data Model. - ESRI Data Models. http://support.esri.com/datamodels 42 ENC Data Model. - ESRI Data Models. http://support.esri.com/datamodels
43 \item CONTIS -- Federal Maritime and Hydrographic Agency (BSH). Continental 43 \item CONTIS -- Federal Maritime and Hydrographic Agency (BSH). Continental
44 Shelf Information System -- 44 Shelf Information System --
45 http://www.bsh.de/en/Marine\_uses/Industry/CONTIS\_maps/index.jsp 45 \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 46 \item GNV specific schema MapViewer interface -- Schema for integrating with MapViewer and
47 their WMS services 47 their WMS services
48 \item GNV specific schema for managing the cache -- The central 48 \item GNV specific schema for managing the cache -- The central
49 dataware house is updated regulary. To keep the cache up-to-date, 49 dataware house is updated regulary. To keep the cache up-to-date,
50 needs to cleaned after database updates. 50 needs to cleaned after database updates.
52 52
53 53
54 \subsection{Operating System} 54 \subsection{Operating System}
55 55
56 {\em Hint}: Configuring of partitions, firewalls, etc. for the system is out of 56 {\em Hint}: Configuring of partitions, firewalls, etc. for the system is out of
57 the scope of this project. 57 the scope of this documentation.
58 58
59 \subsection{Java Environment} 59 \subsection{Java Environment}
60 60
61 \subsubsection*{Installation Sun Java 6} 61 \subsubsection*{Installation Sun Java 6}
62 62
94 ln -s /usr/lib/libtcnative-1.so 94 ln -s /usr/lib/libtcnative-1.so
95 \end{lstlisting} 95 \end{lstlisting}
96 96
97 \subsubsection*{Configuration} 97 \subsubsection*{Configuration}
98 98
99 To ensure that the Apache Tomcat and the GNV Artefact Server will use 99 To ensure that the Apache Tomcat and the GNV Artifact-Server will use
100 Sun Java 6 exclusively, switch to the default Java version 100 Sun Java 6 exclusively, switch to the default Java version
101 globally\footnote{This manual assumes that there are no other packages 101 globally\footnote{This manual assumes that there are no other packages
102 depending to another Java version.}. 102 depending to another Java version.}.
103 103
104 Use \verb+update-alternatives+ mechanism of the Debian system, execute: 104 Use \verb+update-alternatives+ mechanism of the Debian system, execute:
134 Java(TM) SE Runtime Environment (build 1.6.0_12-b04) 134 Java(TM) SE Runtime Environment (build 1.6.0_12-b04)
135 Java HotSpot(TM) Server VM (build 11.2-b01, mixed mode) 135 Java HotSpot(TM) Server VM (build 11.2-b01, mixed mode)
136 \end{lstlisting} 136 \end{lstlisting}
137 137
138 138
139 \subsubsection*{Uninstalling}
140
141 For removing Sun Java from the operating system, use:
142
143 \verb+apt-get --purge remove sun-java6-jdk+
144
145
146 \subsection{Tomcat Application Server} 139 \subsection{Tomcat Application Server}
147 To run the GNV-System a Apache Tomcat Server Version 5.5 is required. 140 To run the GNV-System a Apache Tomcat Server Version 5.5 is required.
148 This section describes the steps for installing and configuring 141 This section describes the steps for installing and configuring
149 Apache Tomcat. 142 Apache Tomcat.
150 143
209 202
210 So fare, there is no commandline client for AJP to test the connection. 203 So fare, there is no commandline client for AJP to test the connection.
211 If there are problems, setup \verb+ mod_jk+ module in Apache WebServer 204 If there are problems, setup \verb+ mod_jk+ module in Apache WebServer
212 and check its according log files. 205 and check its according log files.
213 206
214 \subsubsection*{Uninstalling Apache Tomcat}
215
216 To uninstall the Apache Tomcat, use the following:
217 \verb+ apt-get --purge remove tomcat5.5+
218
219
220 \subsection{Apache Webserver} 207 \subsection{Apache Webserver}
221 This section describes the required steps for the installation and configuration 208 This section describes the required steps for the installation and configuration
222 of the Apache Webserver Version 2.2. Apache WebServer controls all 209 of the Apache Webserver Version 2.2. Apache WebServer controls all
223 HTTP-Connections to the outside of the system. Apache Tomcat is 210 HTTP-Connections to the outside of the system. Apache Tomcat is
224 integrated via mod\_jk. 211 integrated via mod\_jk.
286 273
287 After a successful installation, the file {test} will contain HTML describing 274 After a successful installation, the file {test} will contain HTML describing
288 the startpage of the GNV WebClient. 275 the startpage of the GNV WebClient.
289 276
290 277
291 \subsubsection*{Uninstalling the Apache Webserver}
292 To uninstall the Apache Webserver and its configuration, you can use the
293 following command:
294 \verb+ apt-get purge apache2+
295
296
297 \subsection{UMN MapServer: Installation and configuration} 278 \subsection{UMN MapServer: Installation and configuration}
298 The UMN MapServer is part of the artifact server. It is responsible for 279 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 280 rendering shapefiles produced by the artifact-server and publish them as
300 OGC Web Map Service. 281 OGC Web Map Service.
301 282
341 -O mapserver 322 -O mapserver
342 \end{lstlisting} 323 \end{lstlisting}
343 324
344 For a sucessful configuration, the response document \verb+ mapserver+ 325 For a sucessful configuration, the response document \verb+ mapserver+
345 contains a XML document describing the capabilities of the mapserver. 326 contains a XML document describing the capabilities of the mapserver.
346
347
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