Mercurial > dive4elements > river

comparison artifacts/doc/installation_de.rst @ 7452:b6e954fa8b82

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
More installation documentation
author Andre Heinecke <aheinecke@intevation.de>
date Mon, 28 Oct 2013 14:15:53 +0100
parents 5363047c8274
children affad83fd785
comparison
equal deleted inserted replaced
7451:6b8d9c001329 7452:b6e954fa8b82
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::
24
25 zypper addrepo -f \
26 http://download.opensuse.org/repositories/home:/intevation:/bfg/
27 SLE_11_SP1/home:intevation:bfg.repo
28
23 #. Installieren der Benötigten Pakete:: 29 #. Installieren der Benötigten Pakete::
24 30
25 zypper install python-devel python-setuptools libxslt-devel libxml2-devel \ 31 zypper install python-devel python-setuptools libxslt-devel libxml2-devel \
26 mozilla-nss-devel apache2 tomcat6 mapserver 32 mozilla-nss-devel apache2 tomcat6 java-1_6_0-ibm libgeos0 netcdf \
33 proj xerces-c FastCGI php MyODBC-unixODBC posgresql-libs
27 34
28 #. Anlegen der Logger Gruppe:: 35 #. Anlegen der Logger Gruppe::
29 36
30 gropadd flys_log 37 gropadd flys_log
31 38
32 #. Anlegen des Flys Nutzers:: 39 #. Anlegen des Flys Nutzers::
33 40
34 useradd -g flys -G users,flys_log,www -m -c "Flys Service User" flys 41 useradd -G users,flys_log,www -m flys
35 42
36 #. tomcat und apache zur flys_log Gruppe hinzufügen:: 43 #. tomcat und apache zur flys_log Gruppe hinzufügen::
37 44
38 usermod -G flys_log,tomcat tomcat 45 usermod -A flys_log tomcat
39 usermod -G flys_log,wwwrun,www wwwrun 46 usermod -A flys_log wwwrun
40 47
41 #. Logging Verzeichnis anlegen:: 48 #. Logging Verzeichnis anlegen::
42 49
43 mkdir /var/log/flys 50 mkdir /var/log/flys
44 chgrp flys_log /var/log/flys 51 chgrp flys_log /var/log/flys
45 chmod 770 /var/log/flys 52 chmod 775 /var/log/flys
46 53
47 #. Betriebsordner Anlegen:: 54 #. Betriebsordner Anlegen::
48 55
49 mkdir /opt/flys 56 mkdir /opt/flys
50 chown flys /opt/flys 57 chown flys /opt/flys
51 58
52 Anschließend sollte der weitere Inhalt der beiliegenden CD nach /opt/flys 59 #. Firewall ausschalten::
53 kopiert werden und dem Benutzer flys zugägnlich gemacht werden. 60
61 SuSEfirewall2 off
62
63 Der Key Fingerprint des Intevations Repositories ist:
64 ``18F8 A017 6DFB 7FD1 22BC 20D6 A73E 24AF BC5A 7BAC``
65
66 Nun sollte der weitere Inhalt der beiliegenden CD nach /opt/flys
67 kopiert werden und dem Benutzer flys zugänglich gemacht werden.
68
69 Oracle client installieren
70 --------------------------
71
72 #. Instantclient entpacken::
73
74 cd /opt
75 tar -xf /opt/flys/instantclient_11_2.tar.gz
76 chown -R flys /opt/instantclient_11_2
77
78 #. Library loader konfigurieren::
79
80 cp /opt/flys/oci.conf /etc/ld.so.conf.d/oci.conf
81
54 82
55 Datenbank initalisieren 83 Datenbank initalisieren
56 ----------------------- 84 -----------------------
57 85
58 ``Datenbank erstellen`` 86 ``Datenbank erstellen``
59 ~~~~~~~~~~~~~~~~~~~~~~~ 87 ~~~~~~~~~~~~~~~~~~~~~~~
60 88
61 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
62 sein. Wichtig ist insbesondere das der Nutzer zugriff auf die Spatial tabellen besitzt. 90 sein. Wichtig ist insbesondere das der Nutzer zugriff auf die Spatial tabellen besitzt.
63 Im folgenden ein Beispiel: 91 Im folgenden ein Beispiel::
64
65 .. code:: sql
66 92
67 --CREATE TABLESPACE for user 93 --CREATE TABLESPACE for user
68 CREATE TABLESPACE "flys3" DATAFILE 94 CREATE TABLESPACE "flys3" DATAFILE
69 '/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
70 100M MAXSIZE 1G LOGGING ONLINE PERMANENT BLOCKSIZE 8192 EXTENT 96 100M MAXSIZE 1G LOGGING ONLINE PERMANENT BLOCKSIZE 8192 EXTENT
82 GRANT CREATE VIEW TO flys3; 108 GRANT CREATE VIEW TO flys3;
83 GRANT CONNECT, RESOURCE TO flys3; 109 GRANT CONNECT, RESOURCE TO flys3;
84 110
85 111
86 ``Schema importieren`` 112 ``Schema importieren``
113 ~~~~~~~~~~~~~~~~~~~~~~
87 114
88 Abweichend von der hier beschriebenen Vorgehensweise kann natürlich ein 115 Abweichend von der hier beschriebenen Vorgehensweise kann natürlich ein
89 alternativer client verwendet werden. Wichtig ist das die folgenden 116 alternativer client verwendet werden. Die SQL skripte liegen im unterordner
117 DB-Schema. Wichtig ist das die folgenden
90 SQL scripte in dieser Reihenfolge und in einer UTF-8 Umgebung 118 SQL scripte in dieser Reihenfolge und in einer UTF-8 Umgebung
91 ausgeführt werden: 119 ausgeführt werden:
92 120
93 #. oracle.sql 121 #. oracle.sql
94 #. oracle-minfo.sql 122 #. oracle-minfo.sql
135 cd /opt/flys 163 cd /opt/flys
136 tar -xf flys-3.0.16.tar.gz 164 tar -xf flys-3.0.16.tar.gz
137 165
138 #. Symlink für die aktuelle Version anlegen:: 166 #. Symlink für die aktuelle Version anlegen::
139 167
140 rm -f flys-current 168 ln -s flys-3.0.16 current
141 ln -s flys-3.0.16 flys-current
142 169
143 ``Server konfigurieren`` 170 ``Server konfigurieren``
144 ~~~~~~~~~~~~~~~~~~~~~~~~ 171 ~~~~~~~~~~~~~~~~~~~~~~~~
145 #. Datenbank verbindung: 172 #. Datenbank Verbindung:
146 173
147 Die externen Datenbanken von Dive4Element River werden in den Dateien 174 Die externen Datenbanken von Dive4Element River werden in den Dateien
148 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.
149 176
150 In diesen sind Nutzername, Passwort und URL entsprechend den passenden 177 In diesen sind Nutzername, Passwort und URL entsprechend den passenden
156 Mithilfe des Eintrags:: 183 Mithilfe des Eintrags::
157 184
158 <connection-init-sqls>ALTER SESSION SET CURRENT_SCHEMA=$SCHEMA;</connection-init-sqls> 185 <connection-init-sqls>ALTER SESSION SET CURRENT_SCHEMA=$SCHEMA;</connection-init-sqls>
159 186
160 kann man den initalen Schema Präfix der Datenbank ändern. 187 kann man den initalen Schema Präfix der Datenbank ändern.
161 Wobei $SCHEMA ein Platzhalterfür das zu verwendende Schema ist. 188 Wobei $SCHEMA ein Platzhalter für das zu verwendende Schema ist.
162 z.B.:: 189 z.B.::
163 190
164 <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>
165 192
166 #. URL für Kartendienste 193 #. URL für Kartendienste
167 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
168 noch die entsprechenden Verweise auf den Kartendienst anpassen:: 195 noch die entsprechenden Verweise auf den Kartendienst anpassen::
169 196
170 cd /opt/flys/flys-3.0.16/server/conf 197 cd /opt/flys/flys-3.0.16/server/conf
171 sed -i @flys3-devel.bafg.de@<neue_url>@ rivermap.xml floodmap.xml 198 sed -i s@flys3-devel.bafg.de@<neue_url>@ rivermap.xml floodmap.xml
172 199
173 #. URL für das Wiki: 200 #. URL für das Wiki:
174 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
175 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
176 angepasst werden. Standard ist: https://flys3-devel.bafg.de/wiki 203 angepasst werden. Standard ist: https://flys3-devel.bafg.de/wiki
191 exit 218 exit
192 219
193 #. Startscript hinterlegen:: 220 #. Startscript hinterlegen::
194 221
195 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
196 cd /etc/init.d/rc3.d 224 cd /etc/init.d/rc3.d
197 ln -s S10d4e-river ../d4e-river 225 ln -s ../d4e-river S10d4e-river
198 ln -s K10d4e-river ../d4e-river 226 ln -s ../d4e-river K10d4e-river
199 cd /etc/init.d/rc5.d 227 cd /etc/init.d/rc5.d
200 ln -s S10d4e-river ../d4e-river 228 ln -s ../d4e-river S10d4e-river
201 ln -s K10d4e-river ../d4e-river 229 ln -s ../d4e-river K10d4e-river
202 230
203 #. Server starten:: 231 #. Server starten::
204 232
205 /etc/init.d/d4e-river start 233 /etc/init.d/d4e-river start
206 234
211 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
212 240
213 Kartendienste einrichten 241 Kartendienste einrichten
214 ------------------------ 242 ------------------------
215 243
244 In SuSE Linux Enterprise ist kein Paket für den benötigten Mapserver
245 vorhanden. Dieses muss manuell installiert werden::
246
247 cd /opt/flys/mapserver-pakete
248 rpm -i --nodeps *.rpm
249
250 Ob die Installation erfolgreich war kann man durch Abfrage der Mapserver
251 Version testen::
252
253 /srv/www/cgi-bin/mapserv -v
254
216 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
217 werden (als root):: 256 werden (als root)::
218 257
219 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
220 260
221 Apache konfigurieren 261 Apache konfigurieren
222 -------------------- 262 --------------------
223 263
224 ** TODO ** 264 Eine Beispielkonfiguration für den Apache Webserver ist die Datei flys.conf
265 auf der beigelegten CD. Diese kann in das Apache vhosts.d Verzeichnis kopiert
266 werden. In dieser muss ggf. der Redirect für das Geoportal angepasst werden,
267 da in diesem die URL enthalten ist.
268
269 Apache Konfiguration kopieren::
270
271 cp /opt/flys/flys.conf /etc/apache2/vhosts.d
272 /etc/init.d/apache2 reload
225 273
226 ``HTTPS einrichten`` 274 ``HTTPS einrichten``
227 ~~~~~~~~~~~~~~~~~~~~ 275 ~~~~~~~~~~~~~~~~~~~~
228 276
229 ** TODO ** 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
279 zu entnehmen und soll nicht teil dieser Anleitung sein. Allerdings ist bemerkenswert
280 das darauf geachtet werden sollte es weiterhin zu ermöglichen Kartendienste über
281 http abzurufen. Dies kann man durch einen Bedingten redirect in der Konfiguration
282 des VirtualHosts auf Port 80 erreichen::
283
284 RewriteEngine on
285 RewriteCond %{REQUEST_URI} !^/cgi-bin/
286 RewriteRule (.*) https://flys3-devel.bafg.de/$1 [R=301,L]
287
230 288
231 Web Client Installieren 289 Web Client Installieren
232 ----------------------- 290 -----------------------
233 291
234 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
237 /etc/init.d/tomcat6 stop 295 /etc/init.d/tomcat6 stop
238 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
239 /etc/init.d/tomcat6 start 297 /etc/init.d/tomcat6 start
240 298
241 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
242 die stabilität des Tomcat Servers zu verbessern. 300 die Stabilität des Tomcat Servers zu verbessern.
243 301
244 Wiki Installieren 302 Wiki Installieren
245 ----------------- 303 -----------------
246 304
247 ** TODO ** 305 Das Wiki für den Fachdienst Flys ist so konfiguriert das es
248 306 unter /home/flys/wiki erwartet wird.
249 ``SAML`` 307
250 ~~~~~~~~ 308 Wiki entpacken::
251 309
252 ** TODO ** 310 su - flys
253 311 cd /home/flys
312 tar -xf /opt/flys/flys-wiki.tar.gz
http://dive4elements.wald.intevation.org