Mercurial > dive4elements > river

comparison doc/INSTALL_DE @ 7814:242e790fb4ee 3.1.2

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
More fixes for the Free Software installation.
author Sascha L. Teichmann <teichmann@intevation.de>
date Fri, 07 Mar 2014 18:38:35 +0100
parents 195233a91e04
children 553829e7666a
comparison
equal deleted inserted replaced
7813:56870a7d9811 7814:242e790fb4ee
11 _ tomcat6 6.0.35-6+deb7u1 11 _ tomcat6 6.0.35-6+deb7u1
12 _ postgresql-9.1-postgis 1.5.3-2 12 _ postgresql-9.1-postgis 1.5.3-2
13 _ apache2 2.2.22-13+deb7u1 13 _ apache2 2.2.22-13+deb7u1
14 _ cgi-mapserver 6.0.1-3.2+deb7u2 14 _ cgi-mapserver 6.0.1-3.2+deb7u2
15 _ ttf-freefont 20120503-1 15 _ ttf-freefont 20120503-1
16 _ libapache2-mod-jk 1.2.37-1
16 Für die Installation aus den Quellen: 17 Für die Installation aus den Quellen:
17 _ maven2 2.2.1-12 18 _ maven2 2.2.1-12
18 _ mercurial 2.2.2-3 19 _ mercurial 2.2.2-3
19 _ subversion 1.6.17dfsg-4+deb7u4 20 _ subversion 1.6.17dfsg-4+deb7u4
20 _ build-essential 11.5 21 _ build-essential 11.5
21 _ libapache2-mod-jk 1.2.37-1
22 22
23 Erforderliche Pakete zum Installieren von D4E-river 23 Erforderliche Pakete zum Installieren von D4E-river
24 =================================================== 24 ===================================================
25 $ su root 25 $ su root
26 $ apt-get install openjdk-7-jdk 26 # apt-get install openjdk-7-jdk
27 $ apt-get install tomcat6 postgresql-9.1-postgis \ 27 # apt-get install tmux
28 # apt-get install tomcat6 postgresql-9.1-postgis \
28 apache2 cgi-mapserver ttf-freefont libapache2-mod-jk 29 apache2 cgi-mapserver ttf-freefont libapache2-mod-jk
29 30
30 31
31 Benutzer und Verzeichnis für die Serverkomponente anlegen 32 Benutzer und Verzeichnis für die Serverkomponente anlegen
32 ========================================================= 33 =========================================================
33 $ useradd -D d4e 34 # useradd -d /home/d4e d4e
34 $ cd /opt/ 35 # cd /opt/
35 $ mkdir d4e-river 36 # mkdir d4e-river
36 $ chown d4e d4e-river/ 37 # chown d4e d4e-river/
37 38
38 39
39 Benutzer und Gruppe für das Logging anlegen 40 Benutzer und Gruppe für das Logging anlegen
40 =========================================== 41 ===========================================
41 $ groupadd d4e_log 42 # groupadd d4e_log
42 $ usermod -a -G d4e_log d4e 43 # usermod -a -G d4e_log d4e
43 $ usermod -a -G d4e_log tomcat6 44 # usermod -a -G d4e_log tomcat6
44 $ usermod -a -G d4e_log www-data 45 # usermod -a -G d4e_log www-data
45 46
46 47
47 Anlegen des Logging Verzeichnisses 48 Anlegen des Logging Verzeichnisses
48 ================================== 49 ==================================
49 $ mkdir /var/log/d4e-river 50 # mkdir /var/log/d4e-river
50 $ chgrp d4e_log /var/log/d4e-river 51 # chgrp d4e_log /var/log/d4e-river
51 $ chmod 775 /var/log/d4e-river 52 # chmod 775 /var/log/d4e-river
52 $ exit 53 # exit
53 54
54 55
55 Installation von D4E-river aus Binärpaket 56 Installation von D4E-river aus Binärpaket
56 ========================================= 57 =========================================
57 58
70 ========================================== 71 ==========================================
71 72
72 Pakete zum Bauen von D4E-river 73 Pakete zum Bauen von D4E-river
73 ------------------------------ 74 ------------------------------
74 $ su root 75 $ su root
75 $ apt-get install maven2 mercurial 76 # apt-get install maven2 mercurial
76 77
77 78
78 Installation der Intevationszertifikate für den Checkout von Wald 79 Installation der Intevationszertifikate für den Checkout von Wald
79 ----------------------------------------------------------------- 80 -----------------------------------------------------------------
80 Installation der Serverzertifikate von Intevation 81 Installation der Serverzertifikate von Intevation
81 (siehe auch https://ssl.intevation.de) 82 (siehe auch https://ssl.intevation.de)
82 83
83 $ apt-get install ca-certificates curl gnutls-bin 84 # apt-get install ca-certificates curl gnutls-bin
84 $ curl https://ssl.intevation.de/Intevation-Root-CA-2010.crt | \ 85 # curl https://ssl.intevation.de/Intevation-Root-CA-2010.crt | \
85 certtool -i | awk '/^-----BEGIN CERTIFICATE-----$/ , 0' > \ 86 certtool -i | awk '/^-----BEGIN CERTIFICATE-----$/ , 0' > \
86 /usr/local/share/ca-certificates/Intevation-Root-CA-2010.crt 87 /usr/local/share/ca-certificates/Intevation-Root-CA-2010.crt
87 $ update-ca-certificates 88 # update-ca-certificates
88 89
89 #. Mercurial beibringen die Zertifikate zu nutzen: 90 #. Mercurial beibringen die Zertifikate zu nutzen:
90 # hierzu kann beispielsweise die Systemweite mercurial Konfiguration 91 # hierzu kann beispielsweise die Systemweite mercurial Konfiguration
91 # editiert werden, z.B. mit dem Editor nano: 92 # editiert werden, z.B. mit dem Editor nano:
92 $ nano /etc/mercurial/hgrc 93 $ nano /etc/mercurial/hgrc
93 94
94 # Folgendes einfügen (siehe https://intranet.intevation.de/Mercurial#https) 95 # Folgendes einfügen (siehe https://intranet.intevation.de/Mercurial#https)
95 [web] 96 [web]
96 cacerts = /etc/ssl/certs/ca-certificates.crt 97 cacerts = /etc/ssl/certs/ca-certificates.crt
97 98
98 $ exit # d4euser werden 99 # exit # d4euser werden
99 100
100 101
101 Checkout der D4E-Quellen 102 Checkout der D4E-Quellen
102 ------------------------ 103 ------------------------
103 $ mkdir d4e-river 104 $ mkdir d4e-river
117 118
118 Folgenden Eintrag im Abschnitt 'the list of allowed hosts' hinzufügen 119 Folgenden Eintrag im Abschnitt 'the list of allowed hosts' hinzufügen
119 (darauf achten, dass die Einrückung mit den bestehenden Einträgen übereinstimmt): 120 (darauf achten, dass die Einrückung mit den bestehenden Einträgen übereinstimmt):
120 121
121 - !dnsMatch 122 - !dnsMatch
122 host: yourhost # Hier den Hostnamen verwenden auf dem der MapServer läuft. 123 host: localhost # Hier den Hostnamen verwenden auf dem der MapServer läuft.
123 port: 8081 # Den entsprechenden Port eintragen. 124 port: 8081 # Den entsprechenden Port eintragen.
124 125
125 126
126 Anpassen der Serverkonfiguration 127 Anpassen der Serverkonfiguration
127 -------------------------------- 128 --------------------------------
162 163
163 164
164 Kopieren der Serverkomponenten 165 Kopieren der Serverkomponenten
165 ------------------------------ 166 ------------------------------
166 $ su root 167 $ su root
167 $ su d4e 168 # su d4e
168 $ cd /opt/d4e-river/ 169 $ cd /opt/d4e-river/
169 $ mkdir -p bin/lib 170 $ mkdir -p bin/lib
170 $ cp /home/d4euser/d4e-river/river/artifacts/target/river-artifacts-1.0-SNAPSHOT.jar bin/lib/ 171 $ cp /home/d4euser/d4e-river/river/artifacts/target/river-artifacts-1.0-SNAPSHOT.jar bin/lib/
171 $ cp /home/d4euser/d4e-river/river/artifacts/target/dependency/* bin/lib/ 172 $ cp /home/d4euser/d4e-river/river/artifacts/target/dependency/* bin/lib/
172 $ mkdir conf 173 $ mkdir conf
190 ============================================ 191 ============================================
191 192
192 Anlegen und befüllen der Datenbanken 193 Anlegen und befüllen der Datenbanken
193 ------------------------------------ 194 ------------------------------------
194 #. Einspielen des Schemas für die Backenddatenbank 195 #. Einspielen des Schemas für die Backenddatenbank
195 $ su postgres 196 # su postgres
196 $ cd /home/d4euser/d4e-river/river/backend/doc/schema/ 197 $ cd /home/d4euser/d4e-river/river/backend/doc/schema/
197 $ ./postgresql-setup.sh d4e . localhost 198 $ ./postgresql-setup.sh d4e . localhost
198 199
199 #. Einspielen der Daten in die erstellte DB 200 #. Einspielen der Daten in die erstellte DB
200 # Demodaten von www.dive4elements.org herunterladen und entpacken 201 # Demodaten von www.dive4elements.org herunterladen und entpacken
210 $ exit 211 $ exit
211 212
212 213
213 Kopieren der DGMs 214 Kopieren der DGMs
214 ================= 215 =================
215 $ su d4e 216 # su d4e
216 $ mkdir /opt/d4e-river/dgm 217 $ mkdir /opt/d4e-river/dgm
217 $ cp /home/d4euser/d4e-river/demodaten/dem* /opt/d4e-river/dgm 218 $ cp /home/d4euser/d4e-river/demodaten/dem* /opt/d4e-river/dgm
218 $ exit 219 $ exit
219 $ exit 220 $ exit
220 221
223 ====================== 224 ======================
224 WSPLGEN kann als ausführbare Datei heruntergeladen werden 225 WSPLGEN kann als ausführbare Datei heruntergeladen werden
225 (https://wald.intevation.org/projects/wsplgen/). Die Datei muss 226 (https://wald.intevation.org/projects/wsplgen/). Die Datei muss
226 dann nur noch in das 'bin' Verzeichnis des D4E-river Servers kopiert werden. 227 dann nur noch in das 'bin' Verzeichnis des D4E-river Servers kopiert werden.
227 228
229 # su d4euser
228 $ cd ~/d4e-river 230 $ cd ~/d4e-river
231
232 Für 64bit Systeme:
233
229 $ wget https://wald.intevation.org/frs/download.php/1496/wsplgen-linux-64bit-static.gz 234 $ wget https://wald.intevation.org/frs/download.php/1496/wsplgen-linux-64bit-static.gz
230 $ gunzip wsplgen-linux-64bit-static.gz 235 $ gunzip wsplgen-linux-64bit-static.gz
231 $ echo "16d60047aa114d69e9435dbbe56b6981b4e1c445 wsplgen-linux-64bit-static" | \ 236 $ echo "16d60047aa114d69e9435dbbe56b6981b4e1c445 wsplgen-linux-64bit-static" | \
232 sha1sum -c 237 sha1sum -c
233 $ su root 238 $ su root
234 $ su d4e 239 # su d4e
235 $ cp /home/d4euser/d4e-river/wsplgen-linux-64bit-static /opt/d4e-river/bin 240 $ cp /home/d4euser/d4e-river/wsplgen-linux-64bit-static /opt/d4e-river/bin/wsplgen
236 $ chmod +x /opt/d4e-river/bin/wsplgen-linux-64bit-static 241 $ chmod +x /opt/d4e-river/bin/wsplgen
242 $ exit
243
244 Für 32bit Systeme:
245
246 $ wget https://wald.intevation.org/frs/download.php/1498/wsplgen-linux-32bit-static.gz
247 $ gunzip wsplgen-linux-32bit-static.gz
248 $ echo "aafd2b770ff8293d452ad3eb3321f2ed04f3f371 wsplgen-linux-32bit-static" | \
249 sha1sum -c
250 $ su root
251 # su d4e
252 $ cp /home/d4euser/d4e-river/wsplgen-linux-32bit-static /opt/d4e-river/bin/wsplgen
253 $ chmod +x /opt/d4e-river/bin/wsplgen
237 $ exit 254 $ exit
238 255
239 256
240 Einrichten des Mapserver und Apache 257 Einrichten des Mapserver und Apache
241 =================================== 258 ===================================
242 #. Anlegen der cgi-Skripte für die WMS-Dienste 259 #. Anlegen der cgi-Skripte für die WMS-Dienste
243 260
244 $ cd /usr/lib/cgi-bin/ 261 # cd /usr/lib/cgi-bin/
245 $ cat > user-wms <<EOF 262 # cat > user-wms <<EOF
246 #!/bin/sh 263 #!/bin/sh
247 export MS_MAPFILE=/opt/d4e-river/flys.map 264 export MS_MAPFILE=/opt/d4e-river/flys.map
248 ./mapserv 265 exec ./mapserv
249 EOF 266 EOF
250 $ cat > river-wms <<EOF 267 # cat > river-wms <<EOF
251 #!/bin/sh 268 #!/bin/sh
252 export MS_MAPFILE=/home/d4e-river/rivers.map 269 export MS_MAPFILE=/opt/d4e-river/rivers.map
253 ./mapserv 270 exec ./mapserv
254 EOF 271 EOF
255 $ chmod 755 user-wms 272 # chmod 755 user-wms
256 $ chmod 755 river-wms 273 # chmod 755 river-wms
257 274
258 Der Apache wird für den Mapserver, sowie als Proxy für den im Tomcat 275 Der Apache wird für den Mapserver, sowie als Proxy für den im Tomcat
259 laufenden d4e-river Client eingerichtet. Eine Beispielkonfiguration befindet 276 laufenden d4e-river Client eingerichtet. Eine Beispielkonfiguration befindet
260 sich in doc/d4e-apache.conf. Diese kann in den Ordner 277 sich in doc/d4e-apache.conf. Diese kann in den Ordner
261 /etc/apache2/sites-available/ kopiert werden. Folgende Schritte sind zusätzlich 278 /etc/apache2/sites-available/ kopiert werden. Folgende Schritte sind zusätzlich
262 notwendig: 279 notwendig:
263 280
264 $ su root 281 # cp /home/d4euser/d4e-river/river/doc/d4e-apache.conf /etc/apache2/sites-available/
265 $ a2ensite d4e-apache.conf 282 # a2ensite d4e-apache.conf
266 $ a2enmod proxy_ajp 283 # a2enmod proxy_ajp
267 $ sed -i s/80/8081/ /etc/apache2/ports.conf 284 # sed -i s/80/8081/ /etc/apache2/ports.conf
268 $ service apache2 restart 285 # service apache2 restart
269 $ exit
270 286
271 In der Datei 287 In der Datei
272 /var/lib/tomcat6/conf/server.xml 288 /var/lib/tomcat6/conf/server.xml
273 muss die Zeile 289 muss die Zeile
274 290
275 <Connector port="8009" protocol="AJP/1.3" redirectPort="8443" /> 291 <Connector port="8009" protocol="AJP/1.3" redirectPort="8443" />
276 292
277 einkommentiert werden. 293 einkommentiert werden.
294
295 # /etc/init.d/tomcat6 restart
278 296
279 Einrichtung der D4E-Benutzer und -Rollen 297 Einrichtung der D4E-Benutzer und -Rollen
280 ======================================== 298 ========================================
281 #. Authentifizierung über lokale Datei 299 #. Authentifizierung über lokale Datei
282 # Die Datei enthält durch Leerzeichen getrennt je Zeile 300 # Die Datei enthält durch Leerzeichen getrennt je Zeile
283 # Benutzer, Passwort und Gruppe 301 # Benutzer, Passwort und Gruppe
284 $ cd /usr/share/tomcat6/ 302 # cd /usr/share/tomcat6/
285 $ cat > flys_user_file <<EOF 303 # cat > flys_user_file <<EOF
286 d4e_demo demo d4e_demo_all 304 d4e_demo demo d4e_demo_all
287 d4e_demo1 demo 305 d4e_demo1 demo
288 d4e_demo_extern demo d4e_demo_extern 306 d4e_demo_extern demo d4e_demo_extern
289 EOF 307 EOF
290 308
292 # befindet sich in river/gwt-client/src/main/webapp/WEB-INF/features.xml 310 # befindet sich in river/gwt-client/src/main/webapp/WEB-INF/features.xml
293 311
294 312
295 Anlegen des Start-Skripts 313 Anlegen des Start-Skripts
296 ============================ 314 ============================
297 $ su d4e 315 # su d4e
298 $ cp /home/d4euser/d4e-river/river/contrib/make_flys_release/bin/run.sh /opt/d4e-river/bin/ 316 $ cp /home/d4euser/d4e-river/river/contrib/make_flys_release/bin/run.sh /opt/d4e-river/bin/
299 $ exit 317 $ exit
300 318
301 Client in Tomcat Servlet-Container ablegen 319 Client in Tomcat Servlet-Container ablegen
302 ========================================== 320 ==========================================
303 $ cp /home/d4euser/d4e-river/river/gwt-client/target/gwt-client-1.0-SNAPSHOT.war \ 321 # cp /home/d4euser/d4e-river/river/gwt-client/target/gwt-client-1.0-SNAPSHOT.war \
304 /var/lib/tomcat6/webapps/d4e-river.war 322 /var/lib/tomcat6/webapps/d4e-river.war
305 $ chown tomcat6 /var/lib/tomcat6/webapps/d4e-river.war 323 # chown tomcat6 /var/lib/tomcat6/webapps/d4e-river.war
306 324
307 Starten der Serverkomponente 325 Starten der Serverkomponente
308 ============================ 326 ============================
309 $ su d4e 327 # su d4e
310 $ cd /opt/d4e-river 328 $ cd /opt/d4e-river
311 $ bin/run.sh 329 $ tmux new -s SERVER bin/run.sh
312 330
313 Die Anwendung ist dann im Browser unter 331 Die Anwendung ist dann im Browser unter
314 332
315 http://yourhost:8080/d4e-river 333 http://yourhost:8081/d4e-river
316 334
317 erreichbar. 335 erreichbar.
http://dive4elements.wald.intevation.org