Mercurial > dive4elements > river

comparison artifacts/doc/installation_de.rst @ 7453:affad83fd785

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Rechtschreibkorrektur (durchgeführt von Bettina)
author Andre Heinecke <aheinecke@intevation.de>
date Mon, 28 Oct 2013 14:22:02 +0100
parents b6e954fa8b82
children d9488ca6090b
comparison
equal deleted inserted replaced
7452:b6e954fa8b82 7453:affad83fd785
7 Übersicht 7 Übersicht
8 --------- 8 ---------
9 9
10 Dieses Dokument beschreibt die Installation des Fachdienstes FLYS. 10 Dieses Dokument beschreibt die Installation des Fachdienstes FLYS.
11 11
12 Abgehandelt werden die Installation der Server Anwendung (D4E-River), 12 Abgehandelt werden die Installation der Server-Anwendung (D4E-River),
13 der Webanwendung, die Einrichtung der Datenbanken sowie die Einrichtung 13 der Web-Anwendung, die Einrichtung der Datenbanken sowie die Einrichtung
14 des Moin Wikis. 14 des Moin-Wikis.
15 15
16 Als Basis dient ein SUSE Linux Enterprise Server in Version 11.2. 16 Als Basis dient ein SUSE Linux Enterprise Server in Version 11.2.
17 17
18 Vorbereitung des Systems 18 Vorbereitung des Systems
19 --------------------------- 19 ---------------------------
20 20
21 Die Vorbereitung des Systems ist als Root auf dem Zielsystem durchzuführen. 21 Die Vorbereitung des Systems ist als Root auf dem Zielsystem durchzuführen.
22 22
23 #. Hinzufügen des OBS repositories von Intevation:: 23 #. Hinzufügen des OBS Repositorys von Intevation::
24 24
25 zypper addrepo -f \ 25 zypper addrepo -f \
26 http://download.opensuse.org/repositories/home:/intevation:/bfg/ 26 http://download.opensuse.org/repositories/home:/intevation:/bfg/
27 SLE_11_SP1/home:intevation:bfg.repo 27 SLE_11_SP1/home:intevation:bfg.repo
28 28
29 #. Installieren der Benötigten Pakete:: 29 #. Installieren der benötigten Pakete::
30 30
31 zypper install python-devel python-setuptools libxslt-devel libxml2-devel \ 31 zypper install python-devel python-setuptools libxslt-devel libxml2-devel \
32 mozilla-nss-devel apache2 tomcat6 java-1_6_0-ibm libgeos0 netcdf \ 32 mozilla-nss-devel apache2 tomcat6 java-1_6_0-ibm libgeos0 netcdf \
33 proj xerces-c FastCGI php MyODBC-unixODBC posgresql-libs 33 proj xerces-c FastCGI php MyODBC-unixODBC posgresql-libs
34 34
38 38
39 #. Anlegen des Flys Nutzers:: 39 #. Anlegen des Flys Nutzers::
40 40
41 useradd -G users,flys_log,www -m flys 41 useradd -G users,flys_log,www -m flys
42 42
43 #. tomcat und apache zur flys_log Gruppe hinzufügen:: 43 #. Tomcat und Apache zur flys_log Gruppe hinzufügen::
44 44
45 usermod -A flys_log tomcat 45 usermod -A flys_log tomcat
46 usermod -A flys_log wwwrun 46 usermod -A flys_log wwwrun
47 47
48 #. Logging Verzeichnis anlegen:: 48 #. Logging Verzeichnis anlegen::
49 49
50 mkdir /var/log/flys 50 mkdir /var/log/flys
51 chgrp flys_log /var/log/flys 51 chgrp flys_log /var/log/flys
52 chmod 775 /var/log/flys 52 chmod 775 /var/log/flys
53 53
54 #. Betriebsordner Anlegen:: 54 #. Betriebsordner anlegen::
55 55
56 mkdir /opt/flys 56 mkdir /opt/flys
57 chown flys /opt/flys 57 chown flys /opt/flys
58 58
59 #. Firewall ausschalten:: 59 #. Firewall ausschalten::
60 60
61 SuSEfirewall2 off 61 SuSEfirewall2 off
62 62
63 Der Key Fingerprint des Intevations Repositories ist: 63 Der Key-Fingerprint des Intevations Repositorys ist:
64 ``18F8 A017 6DFB 7FD1 22BC 20D6 A73E 24AF BC5A 7BAC`` 64 ``18F8 A017 6DFB 7FD1 22BC 20D6 A73E 24AF BC5A 7BAC``
65 65
66 Nun sollte der weitere Inhalt der beiliegenden CD nach /opt/flys 66 Nun sollte der weitere Inhalt der beiliegenden CD nach /opt/flys
67 kopiert werden und dem Benutzer flys zugänglich gemacht werden. 67 kopiert und dem Benutzer flys zugänglich gemacht werden.
68 68
69 Oracle client installieren 69 Oracle Client installieren
70 -------------------------- 70 --------------------------
71 71
72 #. Instantclient entpacken:: 72 #. Instantclient entpacken::
73 73
74 cd /opt 74 cd /opt
78 #. Library loader konfigurieren:: 78 #. Library loader konfigurieren::
79 79
80 cp /opt/flys/oci.conf /etc/ld.so.conf.d/oci.conf 80 cp /opt/flys/oci.conf /etc/ld.so.conf.d/oci.conf
81 81
82 82
83 Datenbank initalisieren 83 Datenbank initialisieren
84 ----------------------- 84 -----------------------
85 85
86 ``Datenbank erstellen`` 86 ``Datenbank erstellen``
87 ~~~~~~~~~~~~~~~~~~~~~~~ 87 ~~~~~~~~~~~~~~~~~~~~~~~
88 88
89 Das erstellen der Datenbank sollte vom zuständigen DB-Admin bereits durchgeführt worden 89 Das Erstellen der Datenbank sollte vom zuständigen DB-Admin bereits durchgeführt worden
90 sein. Wichtig ist insbesondere das der Nutzer zugriff auf die Spatial tabellen besitzt. 90 sein. Wichtig ist insbesondere, dass der Nutzer Zugriff auf die Spatial-Tabellen besitzt.
91 Im folgenden ein Beispiel:: 91 Im folgenden ein Beispiel::
92 92
93 --CREATE TABLESPACE for user 93 --CREATE TABLESPACE for user
94 CREATE TABLESPACE "flys3" DATAFILE 94 CREATE TABLESPACE "flys3" DATAFILE
95 '/u01/app/oracle/oradata/XE/flys3.dbf' SIZE 500M AUTOEXTEND ON NEXT 95 '/u01/app/oracle/oradata/XE/flys3.dbf' SIZE 500M AUTOEXTEND ON NEXT
111 111
112 ``Schema importieren`` 112 ``Schema importieren``
113 ~~~~~~~~~~~~~~~~~~~~~~ 113 ~~~~~~~~~~~~~~~~~~~~~~
114 114
115 Abweichend von der hier beschriebenen Vorgehensweise kann natürlich ein 115 Abweichend von der hier beschriebenen Vorgehensweise kann natürlich ein
116 alternativer client verwendet werden. Die SQL skripte liegen im unterordner 116 alternativer Client verwendet werden. Die SQL-Skripte liegen im Unterordner
117 DB-Schema. Wichtig ist das die folgenden 117 DB-Schema. Wichtig ist, dass die folgenden
118 SQL scripte in dieser Reihenfolge und in einer UTF-8 Umgebung 118 SQL-Skripte in dieser Reihenfolge und in einer UTF-8 Umgebung
119 ausgeführt werden: 119 ausgeführt werden:
120 120
121 #. oracle.sql 121 #. oracle.sql
122 #. oracle-minfo.sql 122 #. oracle-minfo.sql
123 #. oracle-spatial.sql 123 #. oracle-spatial.sql
124 #. oracle-spatial_idx.sql 124 #. oracle-spatial_idx.sql
125 125
126 126
127 Mit einem vorhandenden sqlplus unter /opt/instantclient_11_2:: 127 Mit einem vorhandenen sqlplus unter /opt/instantclient_11_2::
128 128
129 NLS_LANG=.AL32UTF8 rlwrap /opt/instantclient_11_2/sqlplus <user>/<pass>@<ip>:<port>/<dbname> 129 NLS_LANG=.AL32UTF8 rlwrap /opt/instantclient_11_2/sqlplus <user>/<pass>@<ip>:<port>/<dbname>
130 @oracle.sql 130 @oracle.sql
131 @oracle-minfo.sql 131 @oracle-minfo.sql
132 @oracle-spatial.sql 132 @oracle-spatial.sql
133 @oracle-spatial_idx.sql 133 @oracle-spatial_idx.sql
134 134
135 ``Schema löschen`` 135 ``Schema löschen``
136 ~~~~~~~~~~~~~~~~~~ 136 ~~~~~~~~~~~~~~~~~~
137 137
138 Zum löschen der im Schritt Schema importieren importierten Schemata 138 Zum Löschen der im Schritt Schema importieren importierten Schemata
139 liegen entsprechende drop Skripte bereit. Diese sollten bei Bedarf in 139 liegen entsprechende drop Skripte bereit. Diese sollten bei Bedarf in
140 folgender Reihenfolge ausgeführt werden:: 140 folgender Reihenfolge ausgeführt werden::
141 141
142 #. oracle-drop-spatial.sql 142 #. oracle-drop-spatial.sql
143 #. oracle-drop-minfo.sql 143 #. oracle-drop-minfo.sql
145 145
146 D4E-River Server Installieren 146 D4E-River Server Installieren
147 ----------------------------- 147 -----------------------------
148 148
149 Neue Versionen des gesamten FLYS Pakets werden üblicherweise als 149 Neue Versionen des gesamten FLYS Pakets werden üblicherweise als
150 GZIP komprimierter Tarball mit dem Namenschema flys-VERSION.tar.gz 150 GZIP komprimierter Tarball mit dem Namensschema flys-VERSION.tar.gz
151 zur verfügung gestellt. Als Beispiel wird hier die Version 3.0.16 151 zur Verfügung gestellt. Als Beispiel wird hier die Version 3.0.16
152 angenommen. 152 angenommen.
153 153
154 ``Server entpacken`` 154 ``Server entpacken``
155 ~~~~~~~~~~~~~~~~~~~~ 155 ~~~~~~~~~~~~~~~~~~~~
156 156
167 167
168 ln -s flys-3.0.16 current 168 ln -s flys-3.0.16 current
169 169
170 ``Server konfigurieren`` 170 ``Server konfigurieren``
171 ~~~~~~~~~~~~~~~~~~~~~~~~ 171 ~~~~~~~~~~~~~~~~~~~~~~~~
172 #. Datenbank Verbindung: 172 #. Datenbank-Verbindung:
173 173
174 Die externen Datenbanken von Dive4Element River werden in den Dateien 174 Die externen Datenbanken von Dive4Element River werden in den Dateien
175 server/conf/backend-db.xml und server/conf/seddb-db.xml konfiguriert. 175 server/conf/backend-db.xml und server/conf/seddb-db.xml konfiguriert.
176 176
177 In diesen sind Nutzername, Passwort und URL entsprechend den passenden 177 In diesen sind Nutzername, Passwort und URL entsprechend den passenden
189 z.B.:: 189 z.B.::
190 190
191 <connection-init-sqls>ALTER SESSION SET CURRENT_SCHEMA=SEDDB;</connection-init-sqls> 191 <connection-init-sqls>ALTER SESSION SET CURRENT_SCHEMA=SEDDB;</connection-init-sqls>
192 192
193 #. URL für Kartendienste 193 #. URL für Kartendienste
194 Sollte der Host Name des neuen Servers nicht flys3-devel.bafg.de lauten muss man 194 Sollte der Host-Name des neuen Servers nicht flys3-devel.bafg.de lauten, muss man
195 noch die entsprechenden Verweise auf den Kartendienst anpassen:: 195 noch die entsprechenden Verweise auf den Kartendienst anpassen::
196 196
197 cd /opt/flys/flys-3.0.16/server/conf 197 cd /opt/flys/flys-3.0.16/server/conf
198 sed -i s@flys3-devel.bafg.de@<neue_url>@ rivermap.xml floodmap.xml 198 sed -i s@flys3-devel.bafg.de@<neue_url>@ rivermap.xml floodmap.xml
199 199
200 #. URL für das Wiki: 200 #. URL für das Wiki:
201 Die URL unter welcher das flys wiki erwartet wird ist in server/conf/conf.xml 201 Die URL unter welcher das Flys-Wiki erwartet wird ist in server/conf/conf.xml
202 im Eintrag <help-url> konfiguriert. Dies muss auch ggf. auf den neuen Host Namen 202 im Eintrag <help-url> konfiguriert. Dies muss auch ggf. auf den neuen Host-Namen
203 angepasst werden. Standard ist: https://flys3-devel.bafg.de/wiki 203 angepasst werden. Standard ist: https://flys3-devel.bafg.de/wiki
204 204
205 #. Gewässerdaten: 205 #. Gewässerdaten:
206 Zur Berechnung von Überschwemmungsflächen werden Digitale Geländemodelle benötigt. 206 Zur Berechnung von Überschwemmungsflächen werden digitale Geländemodelle benötigt.
207 207
208 Der Ort an dem diese Daten liegen ist in der Datei server/conf/conf.xml als <dgm-path> 208 Der Ort an dem diese Daten liegen ist in der Datei server/conf/conf.xml als <dgm-path>
209 zu konfigurieren. z.B.:: 209 zu konfigurieren. z.B.::
210 210
211 <dgm-path>/home/teichmann/gewaesser-final/</dgm-path> 211 <dgm-path>/home/teichmann/gewaesser-final/</dgm-path>
215 215
216 #. Zurück auf root wechseln:: 216 #. Zurück auf root wechseln::
217 217
218 exit 218 exit
219 219
220 #. Startscript hinterlegen:: 220 #. Startskript hinterlegen::
221 221
222 cp /opt/flys/d4e-river /etc/init.d 222 cp /opt/flys/d4e-river /etc/init.d
223 chmod u+x /etc/init.d/d4e-river 223 chmod u+x /etc/init.d/d4e-river
224 cd /etc/init.d/rc3.d 224 cd /etc/init.d/rc3.d
225 ln -s ../d4e-river S10d4e-river 225 ln -s ../d4e-river S10d4e-river
230 230
231 #. Server starten:: 231 #. Server starten::
232 232
233 /etc/init.d/d4e-river start 233 /etc/init.d/d4e-river start
234 234
235 Nun kann sich mit einem Blick in /var/log/server-3.0.16.log 235 Nun kann man sich mit einem Blick in /var/log/server-3.0.16.log
236 vergewissern das der Server korrekt gestartet wurde. In diesem 236 vergewissern, dass der Server korrekt gestartet wurde. In diesem
237 Fall wäre die Letze Zeile des logs in der Art:: 237 Fall wäre die letze Zeile des Logs in der Art::
238 238
239 INFO Standalone - Starting org.dive4elements.artifactdatabase.rest.Standalone HTTP server on localhost:18989 239 INFO Standalone - Starting org.dive4elements.artifactdatabase.rest.Standalone HTTP server on localhost:18989
240 240
241 Kartendienste einrichten 241 Kartendienste einrichten
242 ------------------------ 242 ------------------------
250 Ob die Installation erfolgreich war kann man durch Abfrage der Mapserver 250 Ob die Installation erfolgreich war kann man durch Abfrage der Mapserver
251 Version testen:: 251 Version testen::
252 252
253 /srv/www/cgi-bin/mapserv -v 253 /srv/www/cgi-bin/mapserv -v
254 254
255 Nun können die Kartendienste (river-wms, user-wms) von flys eingerichtet 255 Nun können die Kartendienste (river-wms, user-wms) von Flys eingerichtet
256 werden (als root):: 256 werden (als root)::
257 257
258 cp /opt/flys/*-wms /srv/www/cgi-bin/ 258 cp /opt/flys/*-wms /srv/www/cgi-bin/
259 chmod a+x /srv/www/cgi-bin/*-wms 259 chmod a+x /srv/www/cgi-bin/*-wms
260 260
274 ``HTTPS einrichten`` 274 ``HTTPS einrichten``
275 ~~~~~~~~~~~~~~~~~~~~ 275 ~~~~~~~~~~~~~~~~~~~~
276 276
277 Um verschlüsselten Zugriff über https einzurichten kann man o.g. Konfiguration 277 Um verschlüsselten Zugriff über https einzurichten kann man o.g. Konfiguration
278 entsprechend anpassen. Wie dies zu geschehen hat ist der Apache Dokumentation 278 entsprechend anpassen. Wie dies zu geschehen hat ist der Apache Dokumentation
279 zu entnehmen und soll nicht teil dieser Anleitung sein. Allerdings ist bemerkenswert 279 zu entnehmen und soll nicht Teil dieser Anleitung sein. Allerdings ist zu bemerken,
280 das darauf geachtet werden sollte es weiterhin zu ermöglichen Kartendienste über 280 dass darauf geachtet werden sollte, es weiterhin zu ermöglichen Kartendienste über
281 http abzurufen. Dies kann man durch einen Bedingten redirect in der Konfiguration 281 http abzurufen. Dies kann man durch einen bedingten Redirect in der Konfiguration
282 des VirtualHosts auf Port 80 erreichen:: 282 des VirtualHosts auf Port 80 erreichen::
283 283
284 RewriteEngine on 284 RewriteEngine on
285 RewriteCond %{REQUEST_URI} !^/cgi-bin/ 285 RewriteCond %{REQUEST_URI} !^/cgi-bin/
286 RewriteRule (.*) https://flys3-devel.bafg.de/$1 [R=301,L] 286 RewriteRule (.*) https://flys3-devel.bafg.de/$1 [R=301,L]
287 287
288 288
289 Web Client Installieren 289 Web Client Installieren
290 ----------------------- 290 -----------------------
291 291
292 Der Web client läuft als Tomcat Webapp. Damit tomcat diesen startet 292 Der Web Client läuft als Tomcat Webapp. Damit Tomcat diesen startet
293 muss der client nur an die Richtige stelle kopiert werden.:: 293 muss der Client nur an die richtige Stelle kopiert werden.::
294 294
295 /etc/init.d/tomcat6 stop 295 /etc/init.d/tomcat6 stop
296 cp /opt/flys/flys-3.0.16/client/flys-3.0.16.war /usr/share/tomcat6/webapps 296 cp /opt/flys/flys-3.0.16/client/flys-3.0.16.war /usr/share/tomcat6/webapps
297 /etc/init.d/tomcat6 start 297 /etc/init.d/tomcat6 start
298 298
299 Das neustarten des Tomcat Servers ist hierbei optional. Kann aber dazu dienen 299 Das Neustarten des Tomcat Servers ist hierbei optional, kann aber dazu dienen
300 die Stabilität des Tomcat Servers zu verbessern. 300 die Stabilität des Tomcat Servers zu verbessern.
301 301
302 Wiki Installieren 302 Wiki installieren
303 ----------------- 303 -----------------
304 304
305 Das Wiki für den Fachdienst Flys ist so konfiguriert das es 305 Das Wiki für den Fachdienst Flys ist so konfiguriert, dass es
306 unter /home/flys/wiki erwartet wird. 306 unter /home/flys/wiki erwartet wird.
307 307
308 Wiki entpacken:: 308 Wiki entpacken::
309 309
310 su - flys 310 su - flys
http://dive4elements.wald.intevation.org