|
900
|
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 |
