comparison doc/admin-manual/installation-base.tex @ 901:1ebde13e620f

Moved all admin-manual specific files in new directory admin-manual doc/trunk@1024 c6561f87-3c4e-4783-a992-168aeb5c3f6f
author Hans Plum <hans.plum@intevation.de>
date Wed, 28 Apr 2010 14:25:08 +0000
parents
children fb1e051713cc
comparison
equal deleted inserted replaced
900:6df869086544 901:1ebde13e620f
1 \section{Installationguide}
2
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
5 running X-Environment.
6
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
9 hint in this manual.
10
11 % FIXME: Schreibweise bei Zeilen + und -
12
13 \subsection{Preconditions}
14
15 \subsubsection{System}
16
17 \begin{itemize}
18 \item Storage for the delivered software: 100 MB
19 \item Current processor on a 32-bit Architecture (Beginning
20 2010)\footnote{Running on a 64-bit system should work out of the box
21 and improve scalibility issues.}
22 \item RAM: 1 GB for production as minimum.\footnote{This value depends
23 mainly on the amount of connected users.}
24 \item Network access to Database Backend
25 \item RW-Access to the filesystem for logging, shapefile-export,
26 caching
27 \end{itemize}
28
29 \subsubsection{Database: Software and Data}
30
31 The software has been developed for the following system:
32
33 \begin{itemize}
34 \item ESRI ArcSDE 9.3.1 on Oracle 10.2\footnote{The development
35 started in ESRI ArcSDE 9.2. There are known
36 problems with this version.}
37 \item ArcMarineBSH, model package "Time Series and Measurements"
38 \item ArcMarineBSH, model package " MeshFeature"
39 \item ArcMarineBSH, model package "Marine Feature"
40 \item ArcS57 -- International Hydrographic Organization (IHO) S-57 for
41 ENC Data Model. - ESRI Data Models. http://support.esri.com/datamodels
42 \item CONTIS -- Federal Maritime and Hydrographic Agency (BSH). Continental
43 Shelf Information System --
44 http://www.bsh.de/en/Marine\_uses/Industry/CONTIS\_maps/index.jsp
45 \item GNV specific schema MapViewer interface -- Schema for integrating with MapViewer and
46 their WMS services
47 \item GNV specific schema for managing the cache -- The central
48 dataware house is updated regulary. To keep the cache up-to-date,
49 needs to cleaned after database updates.
50 \end{itemize}
51
52
53 \subsection{Operating System}
54
55 {\em Hint}: Configuring of partitions, firewalls, etc. for the system is out of
56 the scope of this project.
57
58 \subsection{Java Environment}
59
60 \subsubsection*{Installation Sun Java 6}
61
62 This GNV-system is developed for Sun Java 6.
63
64 Add non-free packages of the Debian distribution to the system in
65 \verb+/etc/apt/sources.list+:
66
67 \begin{lstlisting}
68 [...]
69 deb http://ftp.de.debian.org/debian/ lenny main non-free
70 deb-src http://ftp.de.debian.org/debian/ lenny main
71
72 deb http://security.debian.org/ lenny/updates main
73 deb-src http://security.debian.org/ lenny/updates main
74 [...]
75 \end{lstlisting}
76
77
78 Install Sun Java 6 and its dependencies by executing the following:
79
80 \verb+ apt-get install sun-java6-jdk+
81
82
83 \subsubsection*{Install Native Components for Java6 (optional)}
84
85 This step is optional but recommended.
86
87 For a better support of the native server technologies, the package
88 \verb+libtcnative+ can be installed.
89
90 \verb+ apt-get install libtcnative-1+
91
92 % FIXME: Setzen des softlink
93
94 \subsubsection*{Configuration}
95
96 To ensure that the Apache Tomcat and the GNV Artefact Server will use
97 Sun Java 6 exclusively, switch to the default Java version
98 globally\footnote{This manual assumes that there are no other packages
99 depending to another Java version.}.
100
101 Use \verb+update-alternatives+ mechanism of the Debian system, execute:
102
103 \verb+ update-alternatives --list java+
104
105 Lists all installed Java-Environments. E.g.:
106
107 \begin{lstlisting}
108 Auswahl Alternative
109 -----------------------------------------------
110 1 /usr/bin/gij-4.3
111 + 2 /usr/lib/jvm/java-gcj/jre/bin/java
112 3 /usr/lib/jvm/java-1.5.0-sun/jre/bin/java
113 * 4 /usr/lib/jvm/java-6-sun/jre/bin/java
114 \end{lstlisting}
115
116
117 \verb+update-alternatives --config java+
118
119 Opens a dialog to reconfigure the java version which should be used as default.
120 Type the Number of the the java which should be used.
121 For the example above, type "4".
122
123 \subsubsection*{Test of the Installation}
124
125 Execute \verb+ java -version+
126
127 Check if a version of 1.6.0* has been set. Check:
128
129 \begin{lstlisting}
130 java version "1.6.0_12"
131 Java(TM) SE Runtime Environment (build 1.6.0_12-b04)
132 Java HotSpot(TM) Server VM (build 11.2-b01, mixed mode)
133 \end{lstlisting}
134
135
136 \subsubsection*{Uninstalling}
137
138 For removing Sun Java from the operating system, use:
139
140 \verb+apt-get --purge remove sun-java6-jdk+
141
142
143 \subsection{Tomcat Application Server}
144 To run the GNV-System a Apache Tomcat Server Version 5.5 is required.
145 This section describes the steps for installing and configuring
146 Apache Tomcat.
147
148 \subsubsection*{Installation}
149
150 To install the Tomcat Application-Server and its dependencies, execute:
151
152 \verb+ apt-get install tomcat5.5+
153 % FIXME: check for depencenies
154
155 \subsubsection{Configuration}
156
157 Adapt some run-time specific properties in
158 \verb+/etc/default/tomcat5.5+:
159
160 \begin{lstlisting}
161 - #JAVA_OPTS="-Djava.awt.headless=true -Xmx128M"
162 + JAVA_OPTS="-Djava.awt.headless=true -Xmx1024m -server"
163
164 - #TOMCAT5_SECURITY=yes
165 + TOMCAT5_SECURITY=no
166 \end{lstlisting}
167
168 {\bf Hint: As there is no Java security policy for the GNV WebClient,
169 Java Security Management is switched off.}
170
171 The Apache Tomcat is integrate with Apache WebServer just via the Apache
172 JServ Protocoll (AJP). To secure the connection, just local connections
173 are allowed for AJP on Tomcat.
174
175 Modify the \verb+ /etc/tomcat5.5/server.xml+:
176 \begin{lstlisting}
177
178 # Deactivate Standard HTTP Connector:
179
180 +<!--
181 <Connector port="8180" maxHttpHeaderSize="8192" address="127.0.0.1"
182 maxThreads="150" minSpareThreads="25" maxSpareThreads="75"
183 enableLookups="false" redirectPort="8443" acceptCount="100"
184 connectionTimeout="20000" disableUploadTimeout="true" />
185 +-->
186
187 - <Connector port="8009"
188 - enableLookups="false" redirectPort="8443" protocol="AJP/1.3" />
189
190 + <Connector port="8009"
191 + enableLookups="false" redirectPort="8443" protocol="AJP/1.3" address="127.0.0.1"/>
192 \end{lstlisting}
193
194 To activate these changes, restart Apache Tomcat:
195
196 \verb+ /etc/init.d/tomcat5.5 restart+
197
198 \subsubsection*{Test of the Installation}
199
200 Check if the port 8009 is opened via:
201 \verb+ netstat -nltp | grep 8009+
202
203 A possible listing looks like this:
204 \begin{lstlisting}
205 tcp 0 0 127.0.0.1:8009 0.0.0.0:* LISTEN 19252/jsvc
206 \end{lstlisting}
207
208 So fare, there is no commandline client for AJP to test the connection.
209 If there are problems, setup \verb+ mod_jk+ module in Apache WebServer
210 and check its according log files.
211
212 \subsubsection*{Uninstalling Apache Tomcat}
213
214 To uninstall the Apache Tomcat, use the following:
215 \verb+ apt-get --purge remove tomcat5.5+
216
217
218 \subsection{Apache Webserver}
219 This section describes the required steps for the installation and configuration
220 of the Apache Webserver Version 2.2.
221
222 \subsubsection*{Installation}
223
224 To install the Apache Webserver you have to execute the following command:
225
226 * apt-get install apache2
227
228 - Additional Modules
229 To establish the Connection between the Tomcat Application Server and the
230 Apache Webserver we have to install an additional Module named Mod-JK
231
232 * apt-get install libapache2-mod-jk
233
234 - Configuration
235
236 -- Edit the Settings for mod-jk
237
238 Edit the Settings for mod-jk in File /etc/libapache2-mod-jk/workers.propertie
239 as follows:
240
241 \begin{lstlisting}
242 - workers.java_home= /usr/lib/jvm/java-gcj/
243 + workers.java_home=/usr/lib/jvm/java-6-sun
244 \end{lstlisting}
245
246 -- Enable mod-jk in Apache Webserver
247
248 For this add the follwing Lines to File /etc/apache2/httpd.conf:
249
250 \begin{lstlisting}
251 + JkWorkersFile "/etc/libapache2-mod-jk/workers.properties"
252 + JkLogFile "/var/log/mod_jk.log"
253 \end{lstlisting}
254
255 --Disable default Site of Apache Webserver
256
257 * a2dissite default
258
259 --Enable the specific Site of GNV
260
261 * Copy File FIXME/gnv to /etc/apache2/sites-available
262
263 %FIXME: Configure contact address for Webserver
264
265 * a2ensite gnv
266
267 --Reload the Configuration of Apache Webserver
268
269 * /etc/init.d/apache2 reload
270
271 \subsubsection*{Test of the Installation}
272
273 You can test the Installation by executing the follwing url
274
275 * http://localhost/gnv/start.do
276
277
278 \subsubsection*{Uninstalling the Apache Webserver}
279
280 To uninstall the Apache Webserver you can use the following Command:
281 * apt-get --purge remove apache2
282
283
284 \subsection{Installation of UMN MapServer}
285
286 \subsubsection*{Installation}
287 -- Remove the installed old mapserver-Version from the System
288
289 * apt-get remove cgi-mapserve
290
291 -- Installing required Libraries
292
293 * apt-get install ttf-freefont
294 * apt-get install libming0 libfribidi0
295
296
297 -- Installing mapserver-gp
298
299 At first you have to configure the source for the Gispatcher-server where
300 the Mapserverpackes are hosted by the Intevation.
301 For this we have to add the followin line to File /etc/apt/sources.list
302
303 deb http://apt.gispatcher.com/ lenny gispatcher
304
305 Then it is necessary to import the Key which is used to sign the Packages:
306
307 TODO: gpg --keyserver hkp://keys.gnupg.net --recv-keys EC70B1B8
308 TODO: gpg --export EC70B1B8 | apt-key add -
309
310 Then install the mapserver-gp executing the follwong command
311
312 * apt-get install cgi-mapserv-gp
313
314 -- Installing mapserv-gp withou access to the Internet
315
316 If there is no access to the Internet it is possible to install the Mapserver
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
344 \subsubsection*{Test of installation}
345 You can chack if the Installation was sucsessful executing the following URl:
346
347 * curl http://localhost/cgi-bin/mapserv-gp
348
349 The response should look like this:
350
351 No query information to decode. \verb+QUERY_STRING+ is set, but empty.
352
353 \subsubsection*{Uninstall UMN- Mapserver}
354
355 To uninstall the UMN-mapserver you have to execute the following commands.
356
357 * rm TODO FIXME wrapperscript
358 * apt-get --purge remove cgi-mapserv-gp

http://dive4elements.wald.intevation.org