Mercurial > dive4elements > river

comparison artifacts/doc/installation_de.rst @ 7449:5363047c8274

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Start installation documentation for specific client installation
author Andre Heinecke <andre.heinecke@intevation.de>
date Sun, 27 Oct 2013 17:30:38 +0100
parents
children b6e954fa8b82
comparison
equal deleted inserted replaced
7448:e5e25586189c 7449:5363047c8274
1 =================
2 FLYS Installation
3 =================
4
5 .. contents:: Inhalt
6
7 Übersicht
8 ---------
9
10 Dieses Dokument beschreibt die Installation des Fachdienstes FLYS.
11
12 Abgehandelt werden die Installation der Server Anwendung (D4E-River),
13 der Webanwendung, die Einrichtung der Datenbanken sowie die Einrichtung
14 des Moin Wikis.
15
16 Als Basis dient ein SUSE Linux Enterprise Server in Version 11.2.
17
18 Vorbereitung des Systems
19 ---------------------------
20
21 Die Vorbereitung des Systems ist als Root auf dem Zielsystem durchzuführen.
22
23 #. Installieren der Benötigten Pakete::
24
25 zypper install python-devel python-setuptools libxslt-devel libxml2-devel \
26 mozilla-nss-devel apache2 tomcat6 mapserver
27
28 #. Anlegen der Logger Gruppe::
29
30 gropadd flys_log
31
32 #. Anlegen des Flys Nutzers::
33
34 useradd -g flys -G users,flys_log,www -m -c "Flys Service User" flys
35
36 #. tomcat und apache zur flys_log Gruppe hinzufügen::
37
38 usermod -G flys_log,tomcat tomcat
39 usermod -G flys_log,wwwrun,www wwwrun
40
41 #. Logging Verzeichnis anlegen::
42
43 mkdir /var/log/flys
44 chgrp flys_log /var/log/flys
45 chmod 770 /var/log/flys
46
47 #. Betriebsordner Anlegen::
48
49 mkdir /opt/flys
50 chown flys /opt/flys
51
52 Anschließend sollte der weitere Inhalt der beiliegenden CD nach /opt/flys
53 kopiert werden und dem Benutzer flys zugägnlich gemacht werden.
54
55 Datenbank initalisieren
56 -----------------------
57
58 ``Datenbank erstellen``
59 ~~~~~~~~~~~~~~~~~~~~~~~
60
61 Das erstellen der Datenbank sollte vom zuständigen DB-Admin bereits durchgeführt worden
62 sein. Wichtig ist insbesondere das der Nutzer zugriff auf die Spatial tabellen besitzt.
63 Im folgenden ein Beispiel:
64
65 .. code:: sql
66
67 --CREATE TABLESPACE for user
68 CREATE TABLESPACE "flys3" DATAFILE
69 '/u01/app/oracle/oradata/XE/flys3.dbf' SIZE 500M AUTOEXTEND ON NEXT
70 100M MAXSIZE 1G LOGGING ONLINE PERMANENT BLOCKSIZE 8192 EXTENT
71 MANAGEMENT LOCAL AUTOALLOCATE DEFAULT NOCOMPRESS SEGMENT SPACE
72 MANAGEMENT AUTO;
73 --CREATE USER
74 CREATE USER flys3 IDENTIFIED BY flys3;
75 -- USER SQL
76 ALTER USER flys3 DEFAULT TABLESPACE "flys3" TEMPORARY TABLESPACE "TEMP"
77 ACCOUNT UNLOCK ;
78 -- QUOTA for user on TABLESPACE
79 ALTER USER flys3 QUOTA UNLIMITED ON "flys3";
80 GRANT ALL on "MDSYS"."ALL_SDO_GEOM_METADATA" to flys3 ;
81 GRANT CREATE SESSION TO flys3 ;
82 GRANT CREATE VIEW TO flys3;
83 GRANT CONNECT, RESOURCE TO flys3;
84
85
86 ``Schema importieren``
87
88 Abweichend von der hier beschriebenen Vorgehensweise kann natürlich ein
89 alternativer client verwendet werden. Wichtig ist das die folgenden
90 SQL scripte in dieser Reihenfolge und in einer UTF-8 Umgebung
91 ausgeführt werden:
92
93 #. oracle.sql
94 #. oracle-minfo.sql
95 #. oracle-spatial.sql
96 #. oracle-spatial_idx.sql
97
98
99 Mit einem vorhandenden sqlplus unter /opt/instantclient_11_2::
100
101 NLS_LANG=.AL32UTF8 rlwrap /opt/instantclient_11_2/sqlplus <user>/<pass>@<ip>:<port>/<dbname>
102 @oracle.sql
103 @oracle-minfo.sql
104 @oracle-spatial.sql
105 @oracle-spatial_idx.sql
106
107 ``Schema löschen``
108 ~~~~~~~~~~~~~~~~~~
109
110 Zum löschen der im Schritt Schema importieren importierten Schemata
111 liegen entsprechende drop Skripte bereit. Diese sollten bei Bedarf in
112 folgender Reihenfolge ausgeführt werden::
113
114 #. oracle-drop-spatial.sql
115 #. oracle-drop-minfo.sql
116 #. oracle-drop.sql
117
118 D4E-River Server Installieren
119 -----------------------------
120
121 Neue Versionen des gesamten FLYS Pakets werden üblicherweise als
122 GZIP komprimierter Tarball mit dem Namenschema flys-VERSION.tar.gz
123 zur verfügung gestellt. Als Beispiel wird hier die Version 3.0.16
124 angenommen.
125
126 ``Server entpacken``
127 ~~~~~~~~~~~~~~~~~~~~
128
129 #. Als Nutzer flys einloggen::
130
131 su - flys
132
133 #. Tarball entpacken::
134
135 cd /opt/flys
136 tar -xf flys-3.0.16.tar.gz
137
138 #. Symlink für die aktuelle Version anlegen::
139
140 rm -f flys-current
141 ln -s flys-3.0.16 flys-current
142
143 ``Server konfigurieren``
144 ~~~~~~~~~~~~~~~~~~~~~~~~
145 #. Datenbank verbindung:
146
147 Die externen Datenbanken von Dive4Element River werden in den Dateien
148 server/conf/backend-db.xml und server/conf/seddb-db.xml konfiguriert.
149
150 In diesen sind Nutzername, Passwort und URL entsprechend den passenden
151 Werten anzupassen.
152
153 Die URL ist dabei nach folgendem Schema aufgebaut:
154 jdbc:oracle:thin:@//<hostname>:<port>/<backend>
155
156 Mithilfe des Eintrags::
157
158 <connection-init-sqls>ALTER SESSION SET CURRENT_SCHEMA=$SCHEMA;</connection-init-sqls>
159
160 kann man den initalen Schema Präfix der Datenbank ändern.
161 Wobei $SCHEMA ein Platzhalterfür das zu verwendende Schema ist.
162 z.B.::
163
164 <connection-init-sqls>ALTER SESSION SET CURRENT_SCHEMA=SEDDB;</connection-init-sqls>
165
166 #. URL für Kartendienste
167 Sollte der Host Name des neuen Servers nicht flys3-devel.bafg.de lauten muss man
168 noch die entsprechenden Verweise auf den Kartendienst anpassen::
169
170 cd /opt/flys/flys-3.0.16/server/conf
171 sed -i @flys3-devel.bafg.de@<neue_url>@ rivermap.xml floodmap.xml
172
173 #. URL für das Wiki:
174 Die URL unter welcher das flys wiki erwartet wird ist in server/conf/conf.xml
175 im Eintrag <help-url> konfiguriert. Dies muss auch ggf. auf den neuen Host Namen
176 angepasst werden. Standard ist: https://flys3-devel.bafg.de/wiki
177
178 #. Gewässerdaten:
179 Zur Berechnung von Überschwemmungsflächen werden Digitale Geländemodelle benötigt.
180
181 Der Ort an dem diese Daten liegen ist in der Datei server/conf/conf.xml als <dgm-path>
182 zu konfigurieren. z.B.::
183
184 <dgm-path>/home/teichmann/gewaesser-final/</dgm-path>
185
186 ``Server starten``
187 ~~~~~~~~~~~~~~~~~~
188
189 #. Zurück auf root wechseln::
190
191 exit
192
193 #. Startscript hinterlegen::
194
195 cp /opt/flys/d4e-river /etc/init.d
196 cd /etc/init.d/rc3.d
197 ln -s S10d4e-river ../d4e-river
198 ln -s K10d4e-river ../d4e-river
199 cd /etc/init.d/rc5.d
200 ln -s S10d4e-river ../d4e-river
201 ln -s K10d4e-river ../d4e-river
202
203 #. Server starten::
204
205 /etc/init.d/d4e-river start
206
207 Nun kann sich mit einem Blick in /var/log/server-3.0.16.log
208 vergewissern das der Server korrekt gestartet wurde. In diesem
209 Fall wäre die Letze Zeile des logs in der Art::
210
211 INFO Standalone - Starting org.dive4elements.artifactdatabase.rest.Standalone HTTP server on localhost:18989
212
213 Kartendienste einrichten
214 ------------------------
215
216 Nun können die Kartendienste (river-wms, user-wms) von flys eingerichtet
217 werden (als root)::
218
219 cp /opt/flys/*-wms /srv/www/cgi-bin/
220
221 Apache konfigurieren
222 --------------------
223
224 ** TODO **
225
226 ``HTTPS einrichten``
227 ~~~~~~~~~~~~~~~~~~~~
228
229 ** TODO **
230
231 Web Client Installieren
232 -----------------------
233
234 Der Web client läuft als Tomcat Webapp. Damit tomcat diesen startet
235 muss der client nur an die Richtige stelle kopiert werden.::
236
237 /etc/init.d/tomcat6 stop
238 cp /opt/flys/flys-3.0.16/client/flys-3.0.16.war /usr/share/tomcat6/webapps
239 /etc/init.d/tomcat6 start
240
241 Das neustarten des Tomcat Servers ist hierbei optional. Kann aber dazu dienen
242 die stabilität des Tomcat Servers zu verbessern.
243
244 Wiki Installieren
245 -----------------
246
247 ** TODO **
248
249 ``SAML``
250 ~~~~~~~~
251
252 ** TODO **
253
http://dive4elements.wald.intevation.org