Mercurial > dive4elements > river
annotate doc/INSTALL_DE @ 7779:abf3cb9cb6c4
INSTALL_DE: remove obsolete client configuration.
| author | Tom Gottfried <tom@intevation.de> |
|---|---|
| date | Tue, 04 Mar 2014 18:40:00 +0100 |
| parents | b972c7e1bfbe |
| children | be4b37839015 |
| rev | line source |
|---|---|
| 7769 | 1 =============================================================================== |
| 2 Installation Dive4Elements-river | |
| 3 =============================================================================== | |
| 4 | |
| 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. | |
| 7 | |
|
7776
b972c7e1bfbe
INSTALL_DE: mention tested system and simplify dependency installation.
Tom Gottfried <tom@intevation.de>
parents:
7769
diff
changeset
|
8 Die Installationsanleitung wurde mit Debian wheezy getestet. Die Versionen |
|
b972c7e1bfbe
INSTALL_DE: mention tested system and simplify dependency installation.
Tom Gottfried <tom@intevation.de>
parents:
7769
diff
changeset
|
9 der im nächsten Schritt installierten Pakete waren zu diesem Zeitpunkt: |
|
b972c7e1bfbe
INSTALL_DE: mention tested system and simplify dependency installation.
Tom Gottfried <tom@intevation.de>
parents:
7769
diff
changeset
|
10 _ openjdk-7-jdk 7u25-2.3.10-1~deb7u1 |
|
b972c7e1bfbe
INSTALL_DE: mention tested system and simplify dependency installation.
Tom Gottfried <tom@intevation.de>
parents:
7769
diff
changeset
|
11 _ tomcat6 6.0.35-6+deb7u1 |
|
b972c7e1bfbe
INSTALL_DE: mention tested system and simplify dependency installation.
Tom Gottfried <tom@intevation.de>
parents:
7769
diff
changeset
|
12 _ postgresql-9.1-postgis 1.5.3-2 |
|
b972c7e1bfbe
INSTALL_DE: mention tested system and simplify dependency installation.
Tom Gottfried <tom@intevation.de>
parents:
7769
diff
changeset
|
13 _ apache2 2.2.22-13+deb7u1 |
|
b972c7e1bfbe
INSTALL_DE: mention tested system and simplify dependency installation.
Tom Gottfried <tom@intevation.de>
parents:
7769
diff
changeset
|
14 _ cgi-mapserver 6.0.1-3.2+deb7u2 |
|
b972c7e1bfbe
INSTALL_DE: mention tested system and simplify dependency installation.
Tom Gottfried <tom@intevation.de>
parents:
7769
diff
changeset
|
15 _ ttf-freefont 20120503-1 |
|
b972c7e1bfbe
INSTALL_DE: mention tested system and simplify dependency installation.
Tom Gottfried <tom@intevation.de>
parents:
7769
diff
changeset
|
16 Für die Installation aus den Quellen: |
|
b972c7e1bfbe
INSTALL_DE: mention tested system and simplify dependency installation.
Tom Gottfried <tom@intevation.de>
parents:
7769
diff
changeset
|
17 _ maven2 2.2.1-12 |
|
b972c7e1bfbe
INSTALL_DE: mention tested system and simplify dependency installation.
Tom Gottfried <tom@intevation.de>
parents:
7769
diff
changeset
|
18 _ mercurial 2.2.2-3 |
|
b972c7e1bfbe
INSTALL_DE: mention tested system and simplify dependency installation.
Tom Gottfried <tom@intevation.de>
parents:
7769
diff
changeset
|
19 _ subversion 1.6.17dfsg-4+deb7u4 |
|
b972c7e1bfbe
INSTALL_DE: mention tested system and simplify dependency installation.
Tom Gottfried <tom@intevation.de>
parents:
7769
diff
changeset
|
20 _ build-essential 11.5 |
| 7769 | 21 |
| 22 Erforderliche Pakete zum Installieren von D4E-river | |
| 23 =================================================== | |
| 24 $ su root | |
|
7776
b972c7e1bfbe
INSTALL_DE: mention tested system and simplify dependency installation.
Tom Gottfried <tom@intevation.de>
parents:
7769
diff
changeset
|
25 $ apt-get install openjdk-7-jdk tomcat6 postgresql-9.1-postgis \ |
|
b972c7e1bfbe
INSTALL_DE: mention tested system and simplify dependency installation.
Tom Gottfried <tom@intevation.de>
parents:
7769
diff
changeset
|
26 apache2 cgi-mapserver ttf-freefont |
| 7769 | 27 |
| 28 | |
| 29 Benutzer und Verzeichnis für die Serverkomponente anlegen | |
| 30 ========================================================= | |
| 31 $ useradd d4e | |
| 32 $ cd /opt/ | |
| 33 $ mkdir d4e-river | |
| 34 $ chown d4e d4e-river/ | |
| 35 | |
| 36 | |
| 37 Benutzer und Gruppe für das Logging anlegen | |
| 38 =========================================== | |
| 39 $ su root | |
| 40 $ groupadd d4e_log | |
| 41 $ usermod -a -G d4e_log d4e | |
| 42 $ usermod -a -G d4e_log tomcat6 | |
| 43 $ usermod -a -G d4e_log www-data | |
| 44 | |
| 45 | |
| 46 Anlegen des Logging Verzeichnisses | |
| 47 ================================== | |
| 48 $ mkdir /var/log/d4e-river | |
| 49 $ chgrp d4e_log /var/log/d4e-river | |
| 50 $ chmod 775 /var/log/d4e-river | |
| 51 $ exit | |
| 52 | |
| 53 | |
| 54 Entpacken des Dive4Elements-river Installer-Pakets | |
| 55 ================================================== | |
| 56 $ tar -xzf d4e-river.tar.gz | |
| 57 @TODO: eventuell anpassen | |
| 58 | |
| 59 | |
| 60 Installation von D4E-river aus den Quellen | |
| 61 ========================================== | |
| 62 Erfolgt die Installation von D4E-river aus den Binärpaketen, können die | |
| 63 folgenden Schritte übersprungen werden. | |
| 64 Die weiteren Schritte sind ab dem Abschnitt 'Backenddatenbanken' | |
| 65 beschrieben. | |
| 66 | |
| 67 | |
| 68 Pakete zum Bauen von D4E-river | |
| 69 ------------------------------ | |
|
7776
b972c7e1bfbe
INSTALL_DE: mention tested system and simplify dependency installation.
Tom Gottfried <tom@intevation.de>
parents:
7769
diff
changeset
|
70 $ apt-get install maven2 mercurial |
| 7769 | 71 |
| 72 | |
| 73 Pakete zum Bauen von WSPLGEN | |
| 74 ---------------------------- | |
|
7776
b972c7e1bfbe
INSTALL_DE: mention tested system and simplify dependency installation.
Tom Gottfried <tom@intevation.de>
parents:
7769
diff
changeset
|
75 $ apt-get install subversion build-essential |
| 7769 | 76 |
| 77 | |
| 78 Installation der Intevationszertifikate für den Checkout von Wald. | |
| 79 ------------------------------------------------------------------ | |
| 80 Die Serverzertifikate von Intevation müssen für die Kommunikation mit | |
| 81 wald.intevation.org installiert werden, da sonst ein checkout der | |
| 82 hg-Repositories nicht möglich ist. | |
| 83 Siehe auch Anleitung im Intranet: | |
| 84 https://intranet.intevation.de/SSL-Zertifikate#system | |
| 85 | |
| 86 $ apt-get install ca-certificates curl gnutls-bin | |
| 87 $ curl https://ssl.intevation.de/Intevation-Root-CA-2010.crt | \ | |
| 88 certtool -i | awk '/^-----BEGIN CERTIFICATE-----$/ , 0' > \ | |
| 89 /usr/local/share/ca-certificates/Intevation-Root-CA-2010.crt | |
| 90 $ update-ca-certificates | |
| 91 | |
| 92 #. Mercurial beibringen die Zertifikate zu nutzen | |
| 93 $ vi /etc/mercurial/hgrc | |
| 94 | |
| 95 # Folgendes einfügen (siehe https://intranet.intevation.de/Mercurial#https) | |
| 96 [web] | |
| 97 cacerts = /etc/ssl/certs/ca-certificates.crt | |
| 98 | |
| 99 $ exit (d4euser werden) | |
| 100 | |
| 101 | |
| 102 Checkout der D4E-Quellen | |
| 103 ------------------------ | |
| 104 $ mkdir d4e-river | |
| 105 $ cd d4e-river | |
| 106 $ hg clone https://scm.wald.intevation.org/hg/dive4elements/framework/ | |
| 107 $ hg clone https://scm.wald.intevation.org/hg/dive4elements/http-client/ | |
| 108 $ hg clone https://scm.wald.intevation.org/hg/dive4elements/river/ | |
| 109 | |
| 110 | |
| 111 Anpassen der Clientkonfiguration | |
| 112 -------------------------------- | |
| 113 $ cd river/gwt-client/src/main/webapp/WEB-INF/ | |
| 114 | |
| 115 #. Mapfishprint config.yaml anpassen | |
| 116 | |
| 117 $ vi config.yaml | |
| 118 | |
| 119 Folgenden Eintrag im Abschnitt 'the list of allowed hosts' hinzufügen: | |
| 120 | |
| 121 - !dnsMatch | |
| 122 host: menippe # Hier den Hostnamen verwenden auf dem der MapServer läuft. | |
| 123 port: 8081 # Den entsprechenden Port eintragen. | |
| 124 | |
| 125 | |
| 126 Anpassen der Serverkonfiguration | |
| 127 -------------------------------- | |
| 128 $ cd ~/de4-river/river/artifacts/doc/conf/ | |
| 129 | |
| 130 #. Pfad zu den DGMs anpassen: | |
| 131 $ vi conf.xml | |
| 132 <dgm-path>${artifacts.config.dir}/../dgm/</dgm-path> | |
| 133 | |
| 134 #. Einstellen der WMS Urls | |
| 135 # Anstatt mennippe:8081 den korrekten Host eintragen! | |
| 136 $ vi rivermap.xml | |
| 137 # Den Inhalt durch folgendes ersetzen | |
| 138 | |
| 139 <?xml version="1.0" encoding="UTF-8" ?> | |
| 140 <!--// configuration fragment for static river WMS //--> | |
| 141 <rivermap> | |
| 142 <mapserver> | |
| 143 <server path="http://menippe:8081/cgi-bin/"/> | |
| 144 <mapfile path="${artifacts.config.dir}/../rivers.map"/> | |
| 145 <templates path="${artifacts.config.dir}/mapserver/"/> | |
| 146 <map-template path="river-mapfile.vm"/> | |
| 147 </mapserver> | |
| 148 | |
| 149 <velocity> | |
| 150 <logfile path="${artifacts.config.dir}/../rivermap_velocity.log"/> | |
| 151 </velocity> | |
| 152 | |
| 153 <river name="Beispielfluss"> | |
| 154 <srid value="31467"/> | |
| 155 <river-wms url="http://menippe:8081/cgi-bin/river-wms" layers="Beispielfluss"/> | |
| 156 <background-wms url="http://osm.intevation.de/bfg/service?" layers="OSM-WMS-Dienst"/> | |
| 157 </river> | |
| 158 </rivermap> | |
| 159 | |
| 160 $ vi floodmap.xml | |
| 161 # Den Inhalt durch folgendes ersetzen | |
| 162 | |
| 163 <?xml version="1.0" encoding="UTF-8" ?> | |
| 164 <floodmap> | |
| 165 <shapefile-path value="${artifacts.config.dir}/../shapefiles"/> | |
| 166 <mapserver> | |
| 167 <server path="http://menippe:8081/cgi-bin/"/> | |
| 168 <mapfile path="${artifacts.config.dir}/../flys.map"/> | |
| 169 <templates path="${artifacts.config.dir}/mapserver/"/> | |
| 170 <map-template path="mapfile.vm"/> | |
| 171 </mapserver> | |
| 172 | |
| 173 <velocity> | |
| 174 <logfile path="${artifacts.config.dir}/../velocity.log"/> | |
| 175 </velocity> | |
| 176 | |
| 177 <river name="Beispielfluss"> | |
| 178 <srid value="31467"/> | |
| 179 <river-wms url="http://menippe:8081/cgi-bin/river-wms" layers="Beispielfluss"/> | |
| 180 <background-wms url="http://osm.intevation.de/bfg/service?" layers="OSM-WMS-Dienst"/> | |
| 181 </river> | |
| 182 </floodmap> | |
| 183 | |
| 184 | |
| 185 Konfigurieren des Logging | |
| 186 ------------------------- | |
| 187 #. Pfade in den log4j.properties anpassen | |
| 188 | |
| 189 $ vi river/gwt-client/src/main/webapp/WEB-INF/log4j.properties | |
| 190 | |
| 191 # Die Zeile | |
| 192 | |
| 193 log4j.appender.FLYS.File=/tmp/flys-client.log | |
| 194 | |
| 195 # ändern in: | |
| 196 | |
| 197 log4j.appender.FLYS.File=/var/log/d4e-river/d4e-client.log | |
| 198 | |
| 199 $ vi river/artifacts/doc/conf/log4j.properties | |
| 200 | |
| 201 # Den Inhalt mit folgendem ersetzen: | |
| 202 | |
| 203 # Set root logger level to DEBUG and its only appender to A1. | |
| 204 log4j.rootLogger=DEBUG, A1 | |
| 205 | |
| 206 # A1 uses PatternLayout. | |
| 207 log4j.appender.A1.layout=org.apache.log4j.PatternLayout | |
| 208 log4j.appender.A1.layout.ConversionPattern=%d [%t] %-5p %c - %m%n | |
| 209 | |
| 210 log4j.appender.A1=org.apache.log4j.RollingFileAppender | |
| 211 log4j.appender.A1.File=/var/log/d4e-river/d4e-server.log | |
| 212 log4j.appender.A1.MaxFileSize=5000KB | |
| 213 log4j.appender.A1.MaxBackupIndex=3 | |
| 214 | |
| 215 | |
| 216 Bauen der Server- und Clientkomponenten | |
| 217 --------------------------------------- | |
| 218 $ cd framework/ | |
| 219 $ mvn clean compile package install | |
| 220 $ cd ../http-client/ | |
| 221 $ mvn clean compile package install | |
| 222 $ cd ../river/backend/ | |
| 223 $ mvn clean compile package install | |
| 224 $ cd ../artifacts/ | |
| 225 $ mvn clean compile package dependency:copy-dependencies | |
| 226 $ cd ../gwt-client/ | |
| 227 $ curl -O http://openlayers.org/download/OpenLayers-2.11.tar.gz | |
| 228 $ tar xvfz OpenLayers-2.11.tar.gz | |
| 229 $ mv OpenLayers-2.11 src/main/webapp/ | |
| 230 $ mvn clean compile package | |
| 231 $ cd ../../ | |
| 232 | |
| 233 | |
| 234 Kopieren der Serverkomponenten | |
| 235 ------------------------------ | |
| 236 $ su root | |
| 237 $ su d4e | |
| 238 $ cd /opt/d4e-river/ | |
| 239 $ mkdir -p bin/lib | |
| 240 $ cp /home/d4euser/d4e-river/river/artifacts/target/river-artifacts-1.0-SNAPSHOT.jar bin/lib/ | |
| 241 $ cp /home/d4euser/d4e-river/river/artifacts/target/dependency/* bin/lib/ | |
| 242 $ mkdir conf | |
| 243 $ cp /home/d4euser/d4e-river/framework/artifact-database/doc/example-conf/log4j.properties conf/ | |
| 244 $ cp -R ../river/artifacts/doc/conf/* conf/ | |
| 245 | |
| 246 | |
| 247 Artefaktdatenbank erstellen | |
| 248 =========================== | |
| 249 $ su root | |
| 250 $ su d4e | |
| 251 $ cd /opt/d4e-river/ | |
| 252 $ /home/d4euser/d4e-river/river/contrib/make_flys_release/h2/createArtifacts.sh \ | |
| 253 /home/d4euser/d4e-river/framework/artifact-database/doc/schema-h2.sql | |
| 254 $ exit | |
| 255 $ exit | |
| 256 | |
| 257 | |
| 258 Datenkorbdatenbank erstellen | |
| 259 ============================ | |
| 260 $ su root | |
| 261 $ su d4e | |
| 262 $ cd /opt/d4e-river/ | |
| 263 $ /home/d4euser/d4e-river/river/contrib/make_flys_release/h2/createDatacage.sh \ | |
| 264 /home/d4euser/d4e-river/river/artifacts/doc/conf/datacage.sql | |
| 265 $ exit | |
| 266 $ exit | |
| 267 | |
| 268 | |
| 269 Backenddatenbanken (Fachdatenbank und Seddb) | |
| 270 ============================================ | |
| 271 | |
| 272 Anlegen und befüllen der Datenbanken | |
| 273 ------------------------------------ | |
| 274 #. Einspielen des Schemas für die Backenddatenbank | |
| 275 $ su root | |
| 276 $ su postgres | |
| 277 $ cd /home/d4euser/d4e-river/river/backend/doc/schema/ | |
| 278 $ ./postgresql-setup.sh d4e . localhost | |
| 279 | |
| 280 #. Einspielen der Daten in die erstellte DB | |
| 281 $ psql -d d4e -f /home/d4euser/d4e-river/d4e_demodata.dump.sql | |
| 282 | |
| 283 #. Erstellen der Seddb | |
| 284 $ createuser -S -D -R sedb | |
| 285 $ createdb seddb | |
| 286 $ psql -d seddb -c "ALTER USER sedb WITH PASSWORD 'sedb';" | |
| 287 $ psql -d seddb -U sedb -h localhost -f /home/d4euser/d4e-river/seddb.dump.sql | |
| 288 | |
| 289 #. wieder d4euser werden | |
| 290 $ exit | |
| 291 $ exit | |
| 292 | |
| 293 | |
| 294 Konfiguration der Datenbankverbindungen | |
| 295 --------------------------------------- | |
| 296 #. Anpassen des Benutzers und des Datenbanknames | |
| 297 $ su root | |
| 298 $ su d4e | |
| 299 $ cd /opt/d4e-river/conf/ | |
| 300 $ sed -i s@flys@d4e@ backend-db.xml | |
| 301 | |
| 302 | |
| 303 Kopieren der DGMs | |
| 304 ================= | |
| 305 $ su root | |
| 306 $ su d4e | |
| 307 $ mkdir /opt/d4e-river/dgm | |
| 308 $ cp /home/d4euser/d4e-river/dgm/* /opt/d4e-river/dgm | |
| 309 | |
| 310 | |
| 311 Einrichten von WSPLGEN | |
| 312 ====================== | |
| 313 | |
| 314 Bauen von WSPLGEN aus den Quellen | |
| 315 --------------------------------- | |
| 316 Die Quellen und die Dokumentation von WSPLGEN sind zu finden unter | |
| 317 | |
| 318 https://wald.intevation.org/projects/wsplgen/ | |
| 319 | |
| 320 Das nach der Anleitung erstellte Binary muss in das 'bin' Verzeichnis des | |
| 321 D4E-river Servers kopiert werden. | |
| 322 | |
| 323 $ su root | |
| 324 $ su d4e | |
| 325 $ cp /path/to/wsplgen.exe /opt/d4e-river/bin | |
| 326 | |
| 327 | |
| 328 WSPLGEN Binary | |
| 329 -------------- | |
| 330 WSPLGEN kann als ausführbare Datei heruntergeladen werden | |
| 331 (https://wald.intevation.org/projects/wsplgen/). Die Datei 'wsplgen.exe' muss | |
| 332 dann nur noch in das 'bin' Verzeichnis des D4E-river Servers kopiert werden. | |
| 333 | |
| 334 $ su root | |
| 335 $ su d4e | |
| 336 $ cp /path/to/wsplgen.exe /opt/d4e-river/bin | |
| 337 | |
| 338 | |
| 339 Einrichten des Mapserver und Apache | |
| 340 =================================== | |
| 341 #. Anlegen der cgi-Skripte für die WMS-Dienste | |
| 342 | |
| 343 $ su root | |
| 344 $ cd /usr/lib/cgi-bin/ | |
| 345 $ touch user-wms | |
| 346 $ vi user-wms | |
| 347 # folgendes einfügen: | |
| 348 #!/bin/sh | |
| 349 export MS_MAPFILE=/opt/d4e-river/flys.map | |
| 350 ./mapserv | |
| 351 $ touch river-wms | |
| 352 $ vi river-wms | |
| 353 # folgendes einfügen: | |
| 354 #!/bin/sh | |
| 355 export MS_MAPFILE=/home/d4e-river/rivers.map | |
| 356 ./mapserv | |
| 357 $ chmod 755 user-wms | |
| 358 $ chmod 755 river-wms | |
| 359 $ exit | |
| 360 | |
| 361 #. Der Apache ist vorkonfiguriert und braucht keine weitere Anpassung. | |
| 362 | |
| 363 | |
| 364 Einrichtung der D4E-Benutzer und -Rollen | |
| 365 ======================================== | |
| 366 #. Authentifizierung über lokale Datei | |
| 367 $ su root | |
| 368 $ cd /usr/share/tomcat6/ | |
| 369 $ touch flys_user_file | |
| 370 $ vi flys_user_file | |
| 371 # folgendes einfügen: | |
| 372 d4e_demo demo d4e_demo_all | |
| 373 d4e_demo1 demo | |
| 374 d4e_demo_extern demo d4e_demo_extern | |
| 375 $ exit | |
| 376 | |
| 377 Anlegen des Start-Skripts | |
| 378 ============================ | |
| 379 $ su root | |
| 380 $ su d4e | |
| 381 $ cp /home/d4euser/d4e-river/river/contrib/make_flys_release/bin/run.sh /opt/d4e-river/bin/ | |
| 382 $ exit | |
| 383 $ exit | |
| 384 | |
| 385 Client in Tomcat Servlet-Container ablegen | |
| 386 ========================================== | |
| 387 $ su root | |
| 388 $ cp /home/d4euser/d4e-river/river/gwt-client/target/gwt-client-1.0-SNAPSHOT.war /var/lib/tomcat6/webapps/d4e-river.war | |
| 389 $ chown tomcat6 /var/lib/tomcat6/webapps/d4e-river.war | |
| 390 $ exit | |
| 391 | |
| 392 Starten der Serverkomponente | |
| 393 ============================ | |
| 394 $ su root | |
| 395 $ su d4e | |
| 396 $ cd /opt/d4e-river | |
| 397 $ bin/run.sh | |
| 398 | |
| 399 Die Anwendung ist dann im Browser unter | |
| 400 | |
| 401 http://servername:8080/d4e-river | |
| 402 | |
| 403 erreichbar. |