Mercurial > dive4elements > river
comparison artifacts/doc/installation_de.rst @ 7453:affad83fd785
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 |