Mercurial > dive4elements > river

comparison doc/INSTALL_DE @ 8797:a4b9a08c2181

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Update install docs.
author Tom Gottfried <tom@intevation.de>
date Wed, 16 Dec 2015 17:23:37 +0100
parents f39c080b3903
children a4d8b3c6fb57
comparison
equal deleted inserted replaced
8796:358a0fd48a00 8797:a4b9a08c2181
1 =============================================================================== 1 ===============================================================================
2 Installation Dive4Elements-river 2 Installation Dive4Elements-river
3 =============================================================================== 3 ===============================================================================
4 4
5 Diese Anleitung geht davon aus, dass ein Benutzer 'd4euser' existiert, der 5 Diese Anleitung geht davon aus, dass ein Benutzer 'd4euser' existiert, der
6 angemeldet ist und mit dem die Schritte der Installation durchgeführt werden. 6 angemeldet ist und mit dem die Installation begonnen werden kann.
7 7 Kommandos, die mit dem Prefix '#' angegeben sind, müssen als Nutzer 'root'
8 Die Installationsanleitung wurde mit Debian wheezy getestet. 8 ausgeführt werden, solche mit dem Prefix '$' als Nutzer 'd4euser' oder 'd4e'.
9
10 Die Installationsanleitung wurde mit Debian jessie getestet.
9 11
10 Erforderliche Pakete zum Installieren von D4E-river 12 Erforderliche Pakete zum Installieren von D4E-river
11 =================================================== 13 ===================================================
12 $ su root 14 $ su root
13 # apt-get install openjdk-7-jdk 15 # apt-get install openjdk-7-jdk
14 # apt-get install tmux 16 # apt-get install tomcat7 postgresql-9.4-postgis-2.1 postgis \
15 # apt-get install tomcat6 postgresql-9.1-postgis \
16 apache2 cgi-mapserver ttf-freefont libapache2-mod-jk 17 apache2 cgi-mapserver ttf-freefont libapache2-mod-jk
17 18
18 19
19 Benutzer und Verzeichnis für die Serverkomponente anlegen 20 Benutzer und Verzeichnis für die Serverkomponente anlegen
20 ========================================================= 21 =========================================================
26 27
27 Benutzer und Gruppe für das Logging anlegen 28 Benutzer und Gruppe für das Logging anlegen
28 =========================================== 29 ===========================================
29 # groupadd d4e_log 30 # groupadd d4e_log
30 # usermod -a -G d4e_log d4e 31 # usermod -a -G d4e_log d4e
31 # usermod -a -G d4e_log tomcat6 32 # usermod -a -G d4e_log tomcat7
32 # usermod -a -G d4e_log www-data 33 # usermod -a -G d4e_log www-data
33 34
34 35
35 Anlegen des Logging Verzeichnisses 36 Anlegen des Logging Verzeichnisses
36 ================================== 37 ==================================
41 42
42 43
43 Installation von D4E-river aus Binärpaket 44 Installation von D4E-river aus Binärpaket
44 ========================================= 45 =========================================
45 46
46 Herunterladen von 47 Installation der Intevationszertifikate für den Download von Wald
48 -----------------------------------------------------------------
49 Installation der Serverzertifikate von Intevation
50 (siehe auch https://ssl.intevation.de)
51
52 # apt-get install gnutls-bin
53 # wget -O - https://ssl.intevation.de/Intevation-Root-CA-2010.crt | \
54 certtool -i | awk '/^-----BEGIN CERTIFICATE-----$/ , 0' > \
55 /usr/local/share/ca-certificates/Intevation-Root-CA-2010.crt
56 # update-ca-certificates
57
58 Als Nutzer 'd4e' herunterladen von
47 - d4e-river-VERSION.tar.bz2 59 - d4e-river-VERSION.tar.bz2
48 - d4river-VERSION.war 60 - d4eriver-VERSION.war
49 VERSION ist hier und im Folgenden durch die entsprechende 61 VERSION ist hier und im Folgenden durch die entsprechende
50 Versionsbezeichnung im Paketnamen zu ersetzen. 62 Versionsbezeichnung im Paketnamen zu ersetzen.
51 63
52 Als root-User: 64 $ cd /opt/d4e-river
53 # cd /opt/ 65 $ tar xvjf d4e-river-VERSION.tar.bz2
54 # mkdir d4e-river
55 # cd d4e-river
56 # tar xvjf d4e-river-VERSION.tar.bz2
57 # chown -R d4e d4e-river
58 66
59 In das Verzeichnis /opt/d4e-river/dgm/ müssen noch die DGMs der 67 In das Verzeichnis /opt/d4e-river/dgm/ müssen noch die DGMs der
60 Demo-Daten kopiert werden. (s.u.) 68 Demo-Daten kopiert werden. (s.u.)
61 69
62 # mv d4river-VERSION.war /var/lib/tomcat6/webapps/d4e-river.war 70 # mv d4eriver-VERSION.war /var/lib/tomcat7/webapps/d4e-river.war
63 71
64 Der Tomcat muss wie unten dokumentiert konfiguriert werden. 72 Der Tomcat muss wie unten dokumentiert konfiguriert werden.
65 Gleiches gilt für die MapServer-Installation. 73 Gleiches gilt für die MapServer-Installation.
66 74
67 Erfolgt die Installation von D4E-river aus den Binärpaketen, können die 75 Erfolgt die Installation von D4E-river aus den Binärpaketen, können die
82 Installation der Intevationszertifikate für den Checkout von Wald 90 Installation der Intevationszertifikate für den Checkout von Wald
83 ----------------------------------------------------------------- 91 -----------------------------------------------------------------
84 Installation der Serverzertifikate von Intevation 92 Installation der Serverzertifikate von Intevation
85 (siehe auch https://ssl.intevation.de) 93 (siehe auch https://ssl.intevation.de)
86 94
87 # apt-get install ca-certificates curl gnutls-bin 95 # apt-get install gnutls-bin
88 # curl https://ssl.intevation.de/Intevation-Root-CA-2010.crt | \ 96 # wget -O - https://ssl.intevation.de/Intevation-Root-CA-2010.crt | \
89 certtool -i | awk '/^-----BEGIN CERTIFICATE-----$/ , 0' > \ 97 certtool -i | awk '/^-----BEGIN CERTIFICATE-----$/ , 0' > \
90 /usr/local/share/ca-certificates/Intevation-Root-CA-2010.crt 98 /usr/local/share/ca-certificates/Intevation-Root-CA-2010.crt
91 # update-ca-certificates 99 # update-ca-certificates
92 100
93 #. Mercurial beibringen die Zertifikate zu nutzen: 101 #. Mercurial beibringen die Zertifikate zu nutzen:
175 $ /home/d4euser/d4e-river/river/contrib/make_flys_release/h2/createDatacage.sh \ 183 $ /home/d4euser/d4e-river/river/contrib/make_flys_release/h2/createDatacage.sh \
176 /home/d4euser/d4e-river/river/artifacts/doc/conf/datacage.sql 184 /home/d4euser/d4e-river/river/artifacts/doc/conf/datacage.sql
177 $ exit 185 $ exit
178 186
179 187
188 Client in Tomcat Servlet-Container ablegen
189 ==========================================
190 # mv /home/d4euser/d4e-river/river/gwt-client/target/gwt-client-1.0-SNAPSHOT.war \
191 /var/lib/tomcat7/webapps/d4e-river.war
192
193
180 Backenddatenbanken (Fachdatenbank und Seddb) 194 Backenddatenbanken (Fachdatenbank und Seddb)
181 ============================================ 195 ============================================
182 196
183 Anlegen und befüllen der Datenbanken 197 Anlegen und befüllen der Datenbanken
184 ------------------------------------ 198 ------------------------------------
185 #. Einspielen des Schemas für die Backenddatenbank 199 #. Einspielen des Schemas für die Backenddatenbank
186 # su postgres 200 # su postgres
187 $ cd /home/d4euser/d4e-river/river/backend/doc/schema/ 201 $ cd /home/d4euser/d4e-river/river/backend/doc/schema/
188 $ ./postgresql-setup.sh d4e . localhost 202 $ ./postgresql-setup.sh
189 203
190 #. bzw. bei Installation aus den Binaries: 204 #. bzw. bei Installation aus den Binaries:
191 # su postgres 205 # su postgres
192 $ cd /opt/d4e-river/schema 206 $ cd /opt/d4e-river/schema
193 $ ./postgresql-setup.sh d4e . localhost 207 $ ./postgresql-setup.sh
194 208
195 #. Einspielen der Daten in die erstellte DB 209 #. Einspielen der Daten in die erstellte DB
196 # Demodaten von www.dive4elements.org herunterladen und entpacken 210 # Demodaten von www.dive4elements.org herunterladen und entpacken
197 $ psql -d d4e -f /home/d4euser/d4e-river/demodaten/d4e_demodata.dump.sql 211 $ psql -d d4e -f /home/d4euser/d4e-river/demodaten/d4e_demodata.dump.sql
198 212
199 #. Erstellen der SedDB 213 #. Erstellen der SedDB
200 $ createuser -S -D -R seddb 214 $ createuser -S -D -R seddb
201 $ createdb seddb 215 $ createdb seddb
202 $ psql -c "ALTER USER seddb WITH PASSWORD 'seddb';" 216 $ psql -c "ALTER USER seddb WITH PASSWORD 'seddb'"
203 $ psql -U seddb -h localhost -f /home/d4euser/d4e-river/demodaten/seddb_demodata.dump.sql 217 $ psql -U seddb -h localhost -f /home/d4euser/d4e-river/demodaten/seddb_demodata.dump.sql
204 218
205 #. wieder root werden 219 #. wieder root werden
206 $ exit 220 $ exit
207 221
230 $ gunzip wsplgen-linux-64bit-static.gz 244 $ gunzip wsplgen-linux-64bit-static.gz
231 $ echo "16d60047aa114d69e9435dbbe56b6981b4e1c445 wsplgen-linux-64bit-static" | \ 245 $ echo "16d60047aa114d69e9435dbbe56b6981b4e1c445 wsplgen-linux-64bit-static" | \
232 sha1sum -c 246 sha1sum -c
233 $ su root 247 $ su root
234 # su d4e 248 # su d4e
235 $ cp /home/d4euser/d4e-river/wsplgen-linux-64bit-static /opt/d4e-river/bin/wsplgen 249 $ cp /home/d4euser/d4e-river/wsplgen-linux-64bit-static \
250 /opt/d4e-river/bin/wsplgen
236 $ chmod +x /opt/d4e-river/bin/wsplgen 251 $ chmod +x /opt/d4e-river/bin/wsplgen
237 $ exit 252 $ exit
238 253
239 Für 32bit Systeme: 254 Für 32bit Systeme:
240 255
242 $ gunzip wsplgen-linux-32bit-static.gz 257 $ gunzip wsplgen-linux-32bit-static.gz
243 $ echo "aafd2b770ff8293d452ad3eb3321f2ed04f3f371 wsplgen-linux-32bit-static" | \ 258 $ echo "aafd2b770ff8293d452ad3eb3321f2ed04f3f371 wsplgen-linux-32bit-static" | \
244 sha1sum -c 259 sha1sum -c
245 $ su root 260 $ su root
246 # su d4e 261 # su d4e
247 $ cp /home/d4euser/d4e-river/wsplgen-linux-32bit-static /opt/d4e-river/bin/wsplgen 262 $ cp /home/d4euser/d4e-river/wsplgen-linux-32bit-static \
263 /opt/d4e-river/bin/wsplgen
248 $ chmod +x /opt/d4e-river/bin/wsplgen 264 $ chmod +x /opt/d4e-river/bin/wsplgen
249 $ exit 265 $ exit
250 266
251 267
252 Einrichten des Mapserver und Apache 268 Einrichten des Mapserver und Apache
267 # chmod 755 user-wms 283 # chmod 755 user-wms
268 # chmod 755 river-wms 284 # chmod 755 river-wms
269 285
270 Der Apache wird für den Mapserver, sowie als Proxy für den im Tomcat 286 Der Apache wird für den Mapserver, sowie als Proxy für den im Tomcat
271 laufenden d4e-river Client eingerichtet. Eine Beispielkonfiguration befindet 287 laufenden d4e-river Client eingerichtet. Eine Beispielkonfiguration befindet
272 sich in doc/d4e-apache.conf. Diese kann in den Ordner 288 sich in doc/d4e-apache.conf. Folgende Schritte sind notwendig:
273 /etc/apache2/sites-available/ kopiert werden. Folgende Schritte sind zusätzlich 289
274 notwendig: 290 # cp /home/d4euser/d4e-river/river/doc/d4e-apache.conf \
275 291 /etc/apache2/sites-available/
276 # cp /home/d4euser/d4e-river/river/doc/d4e-apache.conf /etc/apache2/sites-available/
277 # a2ensite d4e-apache.conf 292 # a2ensite d4e-apache.conf
278 # a2enmod proxy_ajp 293 # a2enmod proxy_ajp
279 # sed -i s/80/8081/ /etc/apache2/ports.conf 294 # sed -i s/80/8081/ /etc/apache2/ports.conf
280 # service apache2 restart 295 # service apache2 restart
281 296
282 In der Datei 297 In der Datei
283 /var/lib/tomcat6/conf/server.xml 298 /var/lib/tomcat7/conf/server.xml
284 muss die Zeile 299 muss die Zeile
285 300
286 <Connector port="8009" protocol="AJP/1.3" redirectPort="8443" /> 301 <Connector port="8009" protocol="AJP/1.3" redirectPort="8443" />
287 302
288 einkommentiert werden. 303 einkommentiert bzw. aktiviert werden.
289 304
290 # /etc/init.d/tomcat6 restart 305 # /etc/init.d/tomcat7 restart
291 306
292 Einrichtung der D4E-Benutzer und -Rollen 307 Einrichtung der D4E-Benutzer und -Rollen
293 ======================================== 308 ========================================
294 #. Authentifizierung über lokale Datei 309 #. Authentifizierung über lokale Datei
295 # Die Datei enthält durch Leerzeichen getrennt je Zeile 310 # Die Datei enthält durch Leerzeichen getrennt je Zeile
296 # Benutzer, Passwort und Gruppe 311 # Benutzer, Passwort und Gruppe
297 # cd /usr/share/tomcat6/ 312 # cd /usr/share/tomcat7/
298 # cat > flys_user_file <<EOF 313 # cat > flys_user_file <<EOF
299 d4e_demo demo d4e_demo_all 314 d4e_demo demo d4e_demo_all
300 d4e_demo1 demo 315 d4e_demo1 demo
301 d4e_demo_extern demo d4e_demo_extern 316 d4e_demo_extern demo d4e_demo_extern
302 EOF 317 EOF
303 318
304 # Die Konfiguration der je Gruppe freigeschalteten Module und Gewässer 319 # Die Konfiguration der je Gruppe freigeschalteten Module und Gewässer
305 # befindet sich in river/gwt-client/src/main/webapp/WEB-INF/features.xml 320 # befindet sich in river/gwt-client/src/main/webapp/WEB-INF/features.xml
306 321
307 322
308 Client in Tomcat Servlet-Container ablegen
309 ==========================================
310 # cp /home/d4euser/d4e-river/river/gwt-client/target/gwt-client-1.0-SNAPSHOT.war \
311 /var/lib/tomcat6/webapps/d4e-river.war
312 # chown tomcat6 /var/lib/tomcat6/webapps/d4e-river.war
313
314 Starten der Serverkomponente 323 Starten der Serverkomponente
315 ============================ 324 ============================
316 # su d4e 325 # su d4e
317 $ cd /opt/d4e-river 326 $ cd /opt/d4e-river
318 $ tmux new -s SERVER bin/run.sh 327 $ tmux new -s SERVER bin/run.sh
http://dive4elements.wald.intevation.org